diff --git a/docs/uk/plugins/sdk-overview.md b/docs/uk/plugins/sdk-overview.md
index 8dc2ebfc2..0f043560e 100644
--- a/docs/uk/plugins/sdk-overview.md
+++ b/docs/uk/plugins/sdk-overview.md
@@ -7,27 +7,27 @@ sidebarTitle: SDK Overview
summary: Карта імпорту, довідник API реєстрації та архітектура SDK
title: Огляд Plugin SDK
x-i18n:
- generated_at: "2026-04-06T15:31:29Z"
+ generated_at: "2026-04-06T19:43:38Z"
model: gpt-5.4
provider: openai
- source_hash: a08fa2d63e82ec921d63310eeede4ef868c452471402a55a1133deeaf78db0a8
+ source_hash: 33539f020cbf2c8471b75d764124b8930c6e4a59c5b121d7e382ffd68040076b
source_path: plugins/sdk-overview.md
workflow: 15
---
# Огляд Plugin SDK
-Plugin SDK — це типізований контракт між плагінами та core. Ця сторінка —
-довідник про **що імпортувати** і **що можна реєструвати**.
+Plugin SDK — це типізований контракт між плагінами та ядром. Ця сторінка є
+довідником про **що імпортувати** і **що можна реєструвати**.
**Шукаєте практичний посібник?**
- Перший плагін? Почніть із [Getting Started](/uk/plugins/building-plugins)
- - Плагін каналу? Див. [Channel Plugins](/uk/plugins/sdk-channel-plugins)
- - Плагін провайдера? Див. [Provider Plugins](/uk/plugins/sdk-provider-plugins)
+ - Плагін каналу? Дивіться [Channel Plugins](/uk/plugins/sdk-channel-plugins)
+ - Плагін провайдера? Дивіться [Provider Plugins](/uk/plugins/sdk-provider-plugins)
-## Правило імпорту
+## Угода щодо імпорту
Завжди імпортуйте з конкретного підшляху:
@@ -36,25 +36,25 @@ import { definePluginEntry } from "openclaw/plugin-sdk/plugin-entry";
import { defineChannelPluginEntry } from "openclaw/plugin-sdk/channel-core";
```
-Кожен підшлях — це невеликий самодостатній модуль. Це зберігає швидкий запуск і
-запобігає проблемам із циклічними залежностями. Для специфічних для каналів
-entry/build helper-ів віддавайте перевагу `openclaw/plugin-sdk/channel-core`; `openclaw/plugin-sdk/core` залишайте для
-ширшої umbrella-поверхні та спільних helper-ів, таких як
+Кожен підшлях — це невеликий, самодостатній модуль. Це зберігає швидкий запуск і
+запобігає проблемам із циклічними залежностями. Для специфічних для каналу
+допоміжних засобів entry/build надавайте перевагу `openclaw/plugin-sdk/channel-core`; використовуйте `openclaw/plugin-sdk/core`
+для ширшої поверхні umbrella та спільних допоміжних функцій, як-от
`buildChannelConfigSchema`.
-Не додавайте й не використовуйте convenience-seam-інтерфейси з назвами провайдерів, як-от
+Не додавайте та не покладайтеся на зручні seam-и з назвами провайдерів, як-от
`openclaw/plugin-sdk/slack`, `openclaw/plugin-sdk/discord`,
`openclaw/plugin-sdk/signal`, `openclaw/plugin-sdk/whatsapp`, або
-helper-seam-інтерфейси з брендуванням каналів. Вбудовані плагіни повинні комбінувати загальні
-підшляхи SDK у власних barrel-файлах `api.ts` або `runtime-api.ts`, а core
-має або використовувати ці локальні barrel-файли плагіна, або додавати вузький загальний контракт SDK,
+допоміжні seam-и з брендуванням каналів. Вбудовані плагіни мають компонувати
+загальні підшляхи SDK у власних barrel-файлах `api.ts` або `runtime-api.ts`, а ядро
+має або використовувати ці локальні для плагіна barrel-файли, або додавати вузький загальний контракт SDK,
коли потреба справді є міжканальною.
-Згенерована карта export-ів усе ще містить невеликий набір helper-seam-інтерфейсів для вбудованих плагінів,
-таких як `plugin-sdk/feishu`, `plugin-sdk/feishu-setup`,
+Згенерована карта експорту все ще містить невеликий набір допоміжних
+seam-ів вбудованих плагінів, як-от `plugin-sdk/feishu`, `plugin-sdk/feishu-setup`,
`plugin-sdk/zalo`, `plugin-sdk/zalo-setup` і `plugin-sdk/matrix*`. Ці
-підшляхи існують лише для підтримки вбудованих плагінів і сумісності; вони
-навмисно не включені до загальної таблиці нижче й не є рекомендованим
+підшляхи існують лише для підтримки та сумісності вбудованих плагінів; їх
+навмисно пропущено в загальній таблиці нижче, і вони не є рекомендованим
шляхом імпорту для нових сторонніх плагінів.
## Довідник підшляхів
@@ -62,13 +62,13 @@ helper-seam-інтерфейси з брендуванням каналів. В
Найуживаніші підшляхи, згруповані за призначенням. Згенерований повний список із
понад 200 підшляхів міститься в `scripts/lib/plugin-sdk-entrypoints.json`.
-Зарезервовані helper-підшляхи вбудованих плагінів усе ще з’являються в цьому згенерованому списку.
-Розглядайте їх як деталі реалізації/поверхні сумісності, якщо лише сторінка документації
-явно не просуває якийсь із них як публічний.
+Зарезервовані допоміжні підшляхи вбудованих плагінів усе ще з’являються в цьому згенерованому списку.
+Розглядайте їх як поверхні деталей реалізації/сумісності, якщо лише сторінка документації
+явно не просуває один із них як публічний.
### Точка входу плагіна
-| Subpath | Key exports |
+| Subpath | Ключові експорти |
| --------------------------- | -------------------------------------------------------------------------------------------------------------------------------------- |
| `plugin-sdk/plugin-entry` | `definePluginEntry` |
| `plugin-sdk/core` | `defineChannelPluginEntry`, `createChatChannelPlugin`, `createChannelPluginBase`, `defineSetupPluginEntry`, `buildChannelConfigSchema` |
@@ -77,216 +77,218 @@ helper-seam-інтерфейси з брендуванням каналів. В
- | Subpath | Key exports |
+ | 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` | Спільні helper-и майстра налаштування, запити 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` | Helper-и багатoоблікової конфігурації/action-gate і helper-и резервного повернення до типового облікового запису |
- | `plugin-sdk/account-id` | `DEFAULT_ACCOUNT_ID`, helper-и нормалізації account-id |
- | `plugin-sdk/account-resolution` | Пошук облікового запису + helper-и резервного повернення до типового |
- | `plugin-sdk/account-helpers` | Вузькі helper-и списку облікових записів/дій з обліковими записами |
+ | `plugin-sdk/account-core` | Допоміжні засоби конфігурації/керування gate для кількох акаунтів, допоміжні засоби резервного використання акаунта за замовчуванням |
+ | `plugin-sdk/account-id` | `DEFAULT_ACCOUNT_ID`, допоміжні засоби нормалізації account-id |
+ | `plugin-sdk/account-resolution` | Допоміжні засоби пошуку акаунта + резервного використання за замовчуванням |
+ | `plugin-sdk/account-helpers` | Вузькі допоміжні засоби списку акаунтів/дій з акаунтами |
| `plugin-sdk/channel-pairing` | `createChannelPairingController` |
| `plugin-sdk/channel-reply-pipeline` | `createChannelReplyPipeline` |
| `plugin-sdk/channel-config-helpers` | `createHybridChannelConfigAdapter` |
- | `plugin-sdk/channel-config-schema` | Типи схем конфігурації каналу |
- | `plugin-sdk/telegram-command-config` | Helper-и нормалізації/валідації кастомних команд Telegram із резервною підтримкою вбудованого контракту |
+ | `plugin-sdk/channel-config-schema` | Типи схеми конфігурації каналу |
+ | `plugin-sdk/telegram-command-config` | Допоміжні засоби нормалізації/валідації власних команд Telegram із fallback для контракту вбудованого пакета |
| `plugin-sdk/channel-policy` | `resolveChannelGroupRequireMention` |
| `plugin-sdk/channel-lifecycle` | `createAccountStatusSink` |
- | `plugin-sdk/inbound-envelope` | Спільні helper-и побудови вхідних маршрутів і envelope |
- | `plugin-sdk/inbound-reply-dispatch` | Спільні helper-и запису та диспетчеризації вхідних повідомлень |
- | `plugin-sdk/messaging-targets` | Helper-и розбору/зіставлення цілей |
- | `plugin-sdk/outbound-media` | Спільні helper-и завантаження вихідних медіа |
- | `plugin-sdk/outbound-runtime` | Helper-и делегування вихідної ідентичності/надсилання |
- | `plugin-sdk/thread-bindings-runtime` | Helper-и життєвого циклу та адаптерів прив’язок потоків |
- | `plugin-sdk/agent-media-payload` | Застарілий builder медіапейлоада агента |
- | `plugin-sdk/conversation-runtime` | Helper-и прив’язки розмови/потоку, pairing і налаштованих прив’язок |
- | `plugin-sdk/runtime-config-snapshot` | Helper знімка конфігурації runtime |
- | `plugin-sdk/runtime-group-policy` | Helper-и розв’язання групової політики runtime |
- | `plugin-sdk/channel-status` | Спільні helper-и знімків/підсумків статусу каналу |
- | `plugin-sdk/channel-config-primitives` | Вузькі примітиви config-schema каналу |
- | `plugin-sdk/channel-config-writes` | Helper-и авторизації запису конфігурації каналу |
- | `plugin-sdk/channel-plugin-common` | Спільні експорти prelude для плагінів каналів |
- | `plugin-sdk/allowlist-config-edit` | Helper-и читання/редагування конфігурації allowlist |
- | `plugin-sdk/group-access` | Спільні helper-и рішень доступу до груп |
- | `plugin-sdk/direct-dm` | Спільні helper-и auth/guard для прямих DM |
- | `plugin-sdk/interactive-runtime` | Helper-и нормалізації/скорочення інтерактивних payload-ів відповіді |
- | `plugin-sdk/channel-inbound` | Debounce, зіставлення згадок, helper-и envelope |
- | `plugin-sdk/channel-send-result` | Типи результатів відповіді |
+ | `plugin-sdk/inbound-envelope` | Спільні допоміжні засоби побудови вхідних маршрутів і envelope |
+ | `plugin-sdk/inbound-reply-dispatch` | Спільні допоміжні засоби запису й диспетчеризації вхідних даних |
+ | `plugin-sdk/messaging-targets` | Допоміжні засоби розбору/зіставлення цілей |
+ | `plugin-sdk/outbound-media` | Спільні допоміжні засоби завантаження вихідних медіа |
+ | `plugin-sdk/outbound-runtime` | Допоміжні засоби делегатів вихідної ідентичності/надсилання |
+ | `plugin-sdk/thread-bindings-runtime` | Допоміжні засоби життєвого циклу та адаптера прив’язок потоків |
+ | `plugin-sdk/agent-media-payload` | Застарілий конструктор медіа 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/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/channel-inbound` | Debounce, зіставлення згадок, допоміжні засоби envelope |
+ | `plugin-sdk/channel-send-result` | Типи результату reply |
| `plugin-sdk/channel-actions` | `createMessageToolButtonsSchema`, `createMessageToolCardSchema` |
- | `plugin-sdk/channel-targets` | Helper-и розбору/зіставлення цілей |
+ | `plugin-sdk/channel-targets` | Допоміжні засоби розбору/зіставлення цілей |
| `plugin-sdk/channel-contract` | Типи контракту каналу |
| `plugin-sdk/channel-feedback` | Підключення feedback/reaction |
+ | `plugin-sdk/channel-secret-runtime` | Вузькі допоміжні засоби секретного контракту, такі як `collectSimpleChannelFieldAssignments`, `getChannelSurface`, `pushAssignment`, і типи secret target |
- | Subpath | Key exports |
+ | Subpath | Ключові експорти |
| --- | --- |
| `plugin-sdk/provider-entry` | `defineSingleProviderPluginEntry` |
- | `plugin-sdk/provider-setup` | Кураторські helper-и налаштування локальних/self-hosted провайдерів |
- | `plugin-sdk/self-hosted-provider-setup` | Спеціалізовані helper-и налаштування self-hosted провайдерів, сумісних з OpenAI |
- | `plugin-sdk/cli-backend` | Типові значення CLI-бекендів + константи watchdog |
- | `plugin-sdk/provider-auth-runtime` | Helper-и розв’язання API-ключів у runtime для плагінів провайдерів |
- | `plugin-sdk/provider-auth-api-key` | Helper-и онбордингу/запису профілю API-ключів, такі як `upsertApiKeyProfile` |
- | `plugin-sdk/provider-auth-result` | Стандартний builder результату OAuth-auth |
- | `plugin-sdk/provider-auth-login` | Спільні helper-и інтерактивного входу для плагінів провайдерів |
- | `plugin-sdk/provider-env-vars` | Helper-и пошуку env vars для auth провайдерів |
+ | `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-auth` | `createProviderApiKeyAuthMethod`, `ensureApiKeyFromOptionEnvOrPrompt`, `upsertAuthProfile`, `upsertApiKeyProfile`, `writeOAuthCredentials` |
- | `plugin-sdk/provider-model-shared` | `ProviderReplayFamily`, `buildProviderReplayFamilyHooks`, `normalizeModelCompat`, спільні builder-и replay-policy, helper-и endpoint-ів провайдерів і helper-и нормалізації model-id, такі як `normalizeNativeXaiModelId` |
+ | `plugin-sdk/provider-model-shared` | `ProviderReplayFamily`, `buildProviderReplayFamilyHooks`, `normalizeModelCompat`, спільні конструктори replay-policy, допоміжні засоби endpoint провайдера та допоміжні засоби нормалізації model-id, такі як `normalizeNativeXaiModelId` |
| `plugin-sdk/provider-catalog-shared` | `findCatalogTemplate`, `buildSingleProviderApiKeyCatalog`, `supportsNativeStreamingUsageCompat`, `applyProviderNativeStreamingUsageCompat` |
- | `plugin-sdk/provider-http` | Загальні helper-и HTTP/можливостей endpoint-ів провайдерів |
- | `plugin-sdk/provider-web-fetch` | Helper-и реєстрації/кешування web-fetch провайдерів |
- | `plugin-sdk/provider-web-search` | Helper-и реєстрації/кешування/конфігурації web-search провайдерів |
- | `plugin-sdk/provider-tools` | `ProviderToolCompatFamily`, `buildProviderToolCompatFamilyHooks`, очищення схеми Gemini + diagnostics, а також helper-и сумісності xAI, такі як `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` | Helper-и патчів конфігурації онбордингу |
- | `plugin-sdk/global-singleton` | Helper-и process-local singleton/map/cache |
+ | `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-onboard` | Допоміжні засоби patch конфігурації онбордингу |
+ | `plugin-sdk/global-singleton` | Допоміжні засоби локального для процесу singleton/map/cache |
- | Subpath | Key exports |
+ | Subpath | Ключові експорти |
| --- | --- |
- | `plugin-sdk/command-auth` | `resolveControlCommandGate`, helper-и реєстру команд, helper-и авторизації відправника |
- | `plugin-sdk/approval-auth-runtime` | Helper-и розв’язання того, хто схвалює, і action-auth у тому самому чаті |
- | `plugin-sdk/approval-client-runtime` | Helper-и профілів/фільтрів native exec approval |
- | `plugin-sdk/approval-delivery-runtime` | Адаптери можливостей/доставки native approval |
- | `plugin-sdk/approval-native-runtime` | Helper-и цілей native approval + прив’язки облікового запису |
- | `plugin-sdk/approval-reply-runtime` | Helper-и payload-ів відповіді для exec/plugin approval |
- | `plugin-sdk/command-auth-native` | Native command auth + helper-и цілей native session |
- | `plugin-sdk/command-detection` | Спільні helper-и виявлення команд |
- | `plugin-sdk/command-surface` | Helper-и нормалізації тіла команди та command-surface |
+ | `plugin-sdk/command-auth` | `resolveControlCommandGate`, допоміжні засоби реєстру команд, допоміжні засоби авторизації відправника |
+ | `plugin-sdk/approval-auth-runtime` | Допоміжні засоби визначення approver і action-auth в тому самому чаті |
+ | `plugin-sdk/approval-client-runtime` | Допоміжні засоби профілю/фільтра native exec approval |
+ | `plugin-sdk/approval-delivery-runtime` | Адаптери native approval capability/delivery |
+ | `plugin-sdk/approval-native-runtime` | Допоміжні засоби native approval target + account-binding |
+ | `plugin-sdk/approval-reply-runtime` | Допоміжні засоби payload відповіді на approve exec/plugin |
+ | `plugin-sdk/command-auth-native` | Допоміжні засоби native command auth + native session-target |
+ | `plugin-sdk/command-detection` | Спільні допоміжні засоби виявлення команд |
+ | `plugin-sdk/command-surface` | Допоміжні засоби нормалізації тіла команди та command-surface |
| `plugin-sdk/allow-from` | `formatAllowFromLowercase` |
- | `plugin-sdk/security-runtime` | Спільні helper-и довіри, DM-gating, external-content і збирання секретів |
- | `plugin-sdk/ssrf-policy` | Helper-и allowlist хостів і SSRF-політики приватних мереж |
- | `plugin-sdk/ssrf-runtime` | Helper-и pinned-dispatcher, fetch із SSRF-захистом і SSRF-політики |
- | `plugin-sdk/secret-input` | Helper-и розбору секретних входів |
- | `plugin-sdk/webhook-ingress` | Helper-и webhook-запитів/цілей |
- | `plugin-sdk/webhook-request-guards` | Helper-и розміру тіла запиту/timeout |
+ | `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/secret-input` | Допоміжні засоби розбору secret input |
+ | `plugin-sdk/webhook-ingress` | Допоміжні засоби запиту/цілі webhook |
+ | `plugin-sdk/webhook-request-guards` | Допоміжні засоби розміру тіла запиту/timeout |
-
- | Subpath | Key exports |
+
+ | Subpath | Ключові експорти |
| --- | --- |
- | `plugin-sdk/runtime` | Широкі helper-и runtime/logging/backup/встановлення плагінів |
- | `plugin-sdk/runtime-env` | Вузькі helper-и env runtime, logger, timeout, retry і backoff |
+ | `plugin-sdk/runtime` | Широкі допоміжні засоби часу виконання/логування/резервного копіювання/встановлення плагінів |
+ | `plugin-sdk/runtime-env` | Вузькі допоміжні засоби env часу виконання, logger, timeout, retry і backoff |
| `plugin-sdk/runtime-store` | `createPluginRuntimeStore` |
- | `plugin-sdk/plugin-runtime` | Спільні helper-и команд/хуків/http/interactive для плагінів |
- | `plugin-sdk/hook-runtime` | Спільні helper-и пайплайна webhook/internal hook |
- | `plugin-sdk/lazy-runtime` | Helper-и lazy import/binding runtime, такі як `createLazyRuntimeModule`, `createLazyRuntimeMethod` і `createLazyRuntimeSurface` |
- | `plugin-sdk/process-runtime` | Helper-и exec процесів |
- | `plugin-sdk/cli-runtime` | Helper-и форматування CLI, очікування та версій |
- | `plugin-sdk/gateway-runtime` | Helper-и клієнта шлюзу та patch-ів статусу каналу |
- | `plugin-sdk/config-runtime` | Helper-и завантаження/запису конфігурації |
- | `plugin-sdk/telegram-command-config` | Helper-и нормалізації назв/описів команд Telegram і перевірок дублікатів/конфліктів, навіть коли surface вбудованого контракту Telegram недоступний |
- | `plugin-sdk/approval-runtime` | Helper-и exec/plugin approval, builder-и approval-capability, helper-и auth/profile, helper-и native routing/runtime |
- | `plugin-sdk/reply-runtime` | Спільні helper-и runtime для inbound/reply, chunking, dispatch, heartbeat, planner відповіді |
- | `plugin-sdk/reply-dispatch-runtime` | Вузькі helper-и dispatch/finalize відповіді |
- | `plugin-sdk/reply-history` | Спільні helper-и короткого вікна історії відповідей, такі як `buildHistoryContext`, `recordPendingHistoryEntry` і `clearHistoryEntriesIfEnabled` |
+ | `plugin-sdk/plugin-runtime` | Спільні допоміжні засоби команд/хуків/http/interactive для плагінів |
+ | `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/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/reply-reference` | `createReplyReferencePlanner` |
- | `plugin-sdk/reply-chunking` | Вузькі helper-и chunking тексту/markdown |
- | `plugin-sdk/session-store-runtime` | Helper-и шляхів сховища сесій + updated-at |
- | `plugin-sdk/state-paths` | Helper-и шляхів для state/OAuth-каталогів |
- | `plugin-sdk/routing` | Helper-и маршруту/ключа сесії/прив’язки облікового запису, такі як `resolveAgentRoute`, `buildAgentSessionKey` і `resolveDefaultAgentBoundAccountId` |
- | `plugin-sdk/status-helpers` | Спільні helper-и підсумків статусу каналу/облікового запису, типові значення runtime-state і helper-и метаданих issue |
- | `plugin-sdk/target-resolver-runtime` | Спільні helper-и розв’язання цілей |
- | `plugin-sdk/string-normalization-runtime` | Helper-и нормалізації slug/рядків |
- | `plugin-sdk/request-url` | Витяг рядкових URL із fetch/request-подібних входів |
- | `plugin-sdk/run-command` | Runner команд із таймером і нормалізованими результатами stdout/stderr |
+ | `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` | Витяг канонічних полів цілі надсилання з аргументів tool |
- | `plugin-sdk/temp-path` | Спільні helper-и шляхів до тимчасових завантажень |
- | `plugin-sdk/logging-core` | Helper-и subsystem logger і redaction |
- | `plugin-sdk/markdown-table-runtime` | Helper-и режиму markdown-таблиць |
- | `plugin-sdk/json-store` | Невеликі helper-и читання/запису стану JSON |
- | `plugin-sdk/file-lock` | Re-entrant helper-и file-lock |
- | `plugin-sdk/persistent-dedupe` | Helper-и дискового dedupe-кешу |
- | `plugin-sdk/acp-runtime` | Helper-и runtime/сесій ACP і reply-dispatch |
- | `plugin-sdk/agent-config-primitives` | Вузькі примітиви config-schema runtime агента |
- | `plugin-sdk/boolean-param` | Гнучкий читач boolean-параметрів |
- | `plugin-sdk/dangerous-name-runtime` | Helper-и розв’язання збігів небезпечних назв |
- | `plugin-sdk/device-bootstrap` | Helper-и device bootstrap і pairing token |
- | `plugin-sdk/extension-shared` | Спільні примітиви helper-ів passive-channel, status і ambient proxy |
- | `plugin-sdk/models-provider-runtime` | Helper-и відповіді команди `/models`/провайдера |
- | `plugin-sdk/skill-commands-runtime` | Helper-и списку команд Skills |
- | `plugin-sdk/native-command-registry` | Helper-и реєстру/build/serialize native command |
- | `plugin-sdk/provider-zai-endpoint` | Helper-и визначення endpoint-ів Z.AI |
- | `plugin-sdk/infra-runtime` | Helper-и системних подій/heartbeat |
- | `plugin-sdk/collection-runtime` | Невеликі helper-и обмеженого кешу |
- | `plugin-sdk/diagnostic-runtime` | Helper-и diagnostic flag і event |
- | `plugin-sdk/error-runtime` | Граф помилок, форматування, спільні helper-и класифікації помилок, `isApprovalNotFoundError` |
- | `plugin-sdk/fetch-runtime` | Обгорнуті helper-и fetch, proxy і pinned lookup |
- | `plugin-sdk/host-runtime` | Helper-и нормалізації hostname і SCP-хостів |
- | `plugin-sdk/retry-runtime` | Helper-и конфігурації retry і runner-а retry |
- | `plugin-sdk/agent-runtime` | Helper-и каталогу/ідентичності/workspace агента |
- | `plugin-sdk/directory-runtime` | Запит/dedup каталогу з опорою на конфігурацію |
+ | `plugin-sdk/tool-send` | Витягування канонічних полів цілі надсилання з аргументів інструмента |
+ | `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/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/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/diagnostic-runtime` | Допоміжні засоби діагностичних прапорців і подій |
+ | `plugin-sdk/error-runtime` | Допоміжні засоби графа помилок, форматування, спільної класифікації помилок, `isApprovalNotFoundError` |
+ | `plugin-sdk/fetch-runtime` | Обгорнуті допоміжні засоби fetch, proxy та pinned lookup |
+ | `plugin-sdk/host-runtime` | Допоміжні засоби нормалізації hostname і SCP host |
+ | `plugin-sdk/retry-runtime` | Допоміжні засоби конфігурації retry і виконавця retry |
+ | `plugin-sdk/agent-runtime` | Допоміжні засоби каталогу/ідентичності/workspace агента |
+ | `plugin-sdk/directory-runtime` | Запит/дедуплікація каталогу на основі конфігурації |
| `plugin-sdk/keyed-async-queue` | `KeyedAsyncQueue` |
- | Subpath | Key exports |
+ | Subpath | Ключові експорти |
| --- | --- |
- | `plugin-sdk/media-runtime` | Спільні helper-и fetch/transform/store для медіа, а також builder-и медіапейлоадів |
- | `plugin-sdk/media-generation-runtime` | Спільні helper-и failover для генерації медіа, вибір candidate-ів і повідомлення про відсутню модель |
- | `plugin-sdk/media-understanding` | Типи провайдерів media understanding і provider-facing експорти helper-ів для зображень/аудіо |
- | `plugin-sdk/text-runtime` | Спільні helper-и тексту/markdown/logging, такі як видалення тексту, видимого асистенту, helper-и render/chunking/table для markdown, helper-и redaction, helper-и directive-tag і safe-text |
- | `plugin-sdk/text-chunking` | Helper chunking для вихідного тексту |
- | `plugin-sdk/speech` | Типи speech-провайдерів і provider-facing helper-и directive, registry і validation |
- | `plugin-sdk/speech-core` | Спільні типи speech-провайдерів, helper-и registry, directive і normalization |
- | `plugin-sdk/realtime-transcription` | Типи провайдерів realtime transcription і helper-и registry |
- | `plugin-sdk/realtime-voice` | Типи провайдерів realtime voice і helper-и registry |
+ | `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/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` | Спільні типи генерації зображень, helper-и failover, auth і registry |
- | `plugin-sdk/music-generation` | Типи провайдерів/запитів/результатів генерації музики |
- | `plugin-sdk/music-generation-core` | Спільні типи генерації музики, helper-и failover, пошук провайдера і розбір model-ref |
- | `plugin-sdk/video-generation` | Типи провайдерів/запитів/результатів генерації відео |
- | `plugin-sdk/video-generation-core` | Спільні типи генерації відео, helper-и failover, пошук провайдера і розбір model-ref |
- | `plugin-sdk/webhook-targets` | Helper-и реєстру цілей webhook і встановлення маршрутів |
- | `plugin-sdk/webhook-path` | Helper-и нормалізації шляхів webhook |
- | `plugin-sdk/web-media` | Спільні helper-и завантаження віддалених/локальних медіа |
+ | `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/webhook-path` | Допоміжні засоби нормалізації шляху webhook |
+ | `plugin-sdk/web-media` | Спільні допоміжні засоби завантаження віддалених/локальних медіа |
| `plugin-sdk/zod` | Повторно експортований `zod` для споживачів Plugin SDK |
| `plugin-sdk/testing` | `installCommonResolveTargetErrorCases`, `shouldAckReaction` |
- | Subpath | Key exports |
+ | Subpath | Ключові експорти |
| --- | --- |
- | `plugin-sdk/memory-core` | Поверхня helper-ів вбудованого memory-core для helper-ів manager/config/file/CLI |
- | `plugin-sdk/memory-core-engine-runtime` | Фасад runtime індексу/пошуку пам’яті |
+ | `plugin-sdk/memory-core` | Поверхня допоміжних засобів вбудованого memory-core для manager/config/file/CLI helpers |
+ | `plugin-sdk/memory-core-engine-runtime` | Runtime facade індексу/пошуку пам’яті |
| `plugin-sdk/memory-core-host-engine-foundation` | Експорти foundation engine хоста пам’яті |
- | `plugin-sdk/memory-core-host-engine-embeddings` | Експорти 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` | Мультимодальні helper-и хоста пам’яті |
- | `plugin-sdk/memory-core-host-query` | Helper-и запитів хоста пам’яті |
- | `plugin-sdk/memory-core-host-secret` | Helper-и секретів хоста пам’яті |
- | `plugin-sdk/memory-core-host-events` | Helper-и журналу подій хоста пам’яті |
- | `plugin-sdk/memory-core-host-status` | Helper-и статусу хоста пам’яті |
- | `plugin-sdk/memory-core-host-runtime-cli` | Helper-и CLI runtime хоста пам’яті |
- | `plugin-sdk/memory-core-host-runtime-core` | Helper-и core runtime хоста пам’яті |
- | `plugin-sdk/memory-core-host-runtime-files` | Helper-и файлів/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` | Спільні helper-и керованого markdown для плагінів, суміжних із пам’яттю |
- | `plugin-sdk/memory-host-search` | Активний фасад runtime пам’яті для доступу до search-manager |
- | `plugin-sdk/memory-host-status` | Нейтральний до вендора псевдонім для helper-ів статусу хоста пам’яті |
- | `plugin-sdk/memory-lancedb` | Поверхня helper-ів вбудованого memory-lancedb |
+ | `plugin-sdk/memory-core-host-multimodal` | Багатомодальні допоміжні засоби хоста пам’яті |
+ | `plugin-sdk/memory-core-host-query` | Допоміжні засоби запитів хоста пам’яті |
+ | `plugin-sdk/memory-core-host-secret` | Допоміжні засоби секретів хоста пам’яті |
+ | `plugin-sdk/memory-core-host-events` | Допоміжні засоби журналу подій хоста пам’яті |
+ | `plugin-sdk/memory-core-host-status` | Допоміжні засоби статусу хоста пам’яті |
+ | `plugin-sdk/memory-core-host-runtime-cli` | Допоміжні засоби CLI runtime хоста пам’яті |
+ | `plugin-sdk/memory-core-host-runtime-core` | Допоміжні засоби core runtime хоста пам’яті |
+ | `plugin-sdk/memory-core-host-runtime-files` | Допоміжні засоби 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 |
-
- | Family | Current subpaths | Intended use |
+
+ | 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` | Helper-и підтримки вбудованого 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 вбудованого Matrix |
- | Line | `plugin-sdk/line`, `plugin-sdk/line-core`, `plugin-sdk/line-runtime`, `plugin-sdk/line-surface` | Поверхня helper-ів/runtime вбудованого LINE |
- | IRC | `plugin-sdk/irc`, `plugin-sdk/irc-surface` | Поверхня helper-ів вбудованого IRC |
- | Channel-specific helpers | `plugin-sdk/googlechat`, `plugin-sdk/zalouser`, `plugin-sdk/bluebubbles`, `plugin-sdk/bluebubbles-policy`, `plugin-sdk/mattermost`, `plugin-sdk/mattermost-policy`, `plugin-sdk/feishu-conversation`, `plugin-sdk/msteams`, `plugin-sdk/nextcloud-talk`, `plugin-sdk/nostr`, `plugin-sdk/tlon`, `plugin-sdk/twitch` | Поверхні сумісності/helper-ів вбудованих каналів |
- | Auth/plugin-specific helpers | `plugin-sdk/github-copilot-login`, `plugin-sdk/github-copilot-token`, `plugin-sdk/diagnostics-otel`, `plugin-sdk/diffs`, `plugin-sdk/llm-task`, `plugin-sdk/thread-ownership`, `plugin-sdk/voice-call` | Поверхні helper-ів вбудованих функцій/плагінів; `plugin-sdk/github-copilot-token` наразі експортує `DEFAULT_COPILOT_API_BASE_URL`, `deriveCopilotApiBaseUrlFromToken` і `resolveCopilotApiToken` |
+ | Browser | `plugin-sdk/browser-cdp`, `plugin-sdk/browser-config-runtime`, `plugin-sdk/browser-config-support`, `plugin-sdk/browser-control-auth`, `plugin-sdk/browser-node-runtime`, `plugin-sdk/browser-profiles`, `plugin-sdk/browser-security-runtime`, `plugin-sdk/browser-setup-tools`, `plugin-sdk/browser-support` | Допоміжні засоби підтримки вбудованого browser plugin (`browser-support` лишається 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` |
@@ -297,57 +299,57 @@ helper-seam-інтерфейси з брендуванням каналів. В
### Реєстрація можливостей
-| Method | What it registers |
-| ------------------------------------------------ | -------------------------------- |
-| `api.registerProvider(...)` | Текстовий inference (LLM) |
-| `api.registerCliBackend(...)` | Локальний CLI-бекенд inference |
-| `api.registerChannel(...)` | Канал обміну повідомленнями |
-| `api.registerSpeechProvider(...)` | Синтез text-to-speech / STT |
-| `api.registerRealtimeTranscriptionProvider(...)` | Потокова realtime transcription |
-| `api.registerRealtimeVoiceProvider(...)` | Дуплексні сесії realtime voice |
-| `api.registerMediaUnderstandingProvider(...)` | Аналіз зображень/аудіо/відео |
-| `api.registerImageGenerationProvider(...)` | Генерація зображень |
-| `api.registerMusicGenerationProvider(...)` | Генерація музики |
-| `api.registerVideoGenerationProvider(...)` | Генерація відео |
-| `api.registerWebFetchProvider(...)` | Провайдер web fetch / scrape |
-| `api.registerWebSearchProvider(...)` | Вебпошук |
+| 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 | What it registers |
-| ------------------------------- | ------------------------------------------------------ |
+| Method | Що реєструє |
+| ------------------------------- | -------------------------------------------- |
| `api.registerTool(tool, opts?)` | Інструмент агента (обов’язковий або `{ optional: true }`) |
-| `api.registerCommand(def)` | Користувацька команда (оминає LLM) |
+| `api.registerCommand(def)` | Власна команда (обходить LLM) |
### Інфраструктура
-| Method | What it registers |
-| ---------------------------------------------- | ------------------------------------------ |
-| `api.registerHook(events, handler, opts?)` | Хук подій |
-| `api.registerHttpRoute(params)` | HTTP-endpoint шлюзу |
-| `api.registerGatewayMethod(name, handler)` | RPC-метод шлюзу |
-| `api.registerCli(registrar, opts?)` | Підкоманда CLI |
-| `api.registerService(service)` | Фоновий сервіс |
-| `api.registerInteractiveHandler(registration)` | Інтерактивний handler |
+| 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.registerMemoryCorpusSupplement(adapter)` | Адитивний корпус пошуку/читання пам’яті |
+| `api.registerMemoryCorpusSupplement(adapter)` | Адитивний корпус пошуку/читання пам’яті |
-Зарезервовані простори імен адміністрування core (`config.*`, `exec.approvals.*`, `wizard.*`,
+Зарезервовані простори назв адмін-функцій ядра (`config.*`, `exec.approvals.*`, `wizard.*`,
`update.*`) завжди залишаються `operator.admin`, навіть якщо плагін намагається призначити
-вужчий scope методу шлюзу. Віддавайте перевагу специфічним для плагіна префіксам для
-методів, що належать плагіну.
+вужчу область видимості gateway-методу. Для методів,
+якими володіє плагін, віддавайте перевагу специфічним для плагіна префіксам.
### Метадані реєстрації CLI
-`api.registerCli(registrar, opts?)` приймає два види метаданих верхнього рівня:
+`api.registerCli(registrar, opts?)` приймає два типи метаданих верхнього рівня:
- `commands`: явні корені команд, якими володіє registrar
-- `descriptors`: дескриптори команд на етапі розбору, які використовуються для кореневої довідки CLI,
- маршрутизації та lazy-реєстрації CLI плагіна
+- `descriptors`: дескриптори команд часу розбору, які використовуються для довідки кореневого CLI,
+ маршрутизації та лінивої реєстрації CLI плагіна
-Якщо ви хочете, щоб команда плагіна залишалася lazy-loaded у звичайному шляху кореневого CLI,
-надайте `descriptors`, які покривають кожен корінь команди верхнього рівня, що відкривається
-цим registrar.
+Якщо ви хочете, щоб команда плагіна залишалася ліниво завантажуваною у звичайному шляху кореневого CLI,
+надайте `descriptors`, які охоплюють кожен корінь команди верхнього рівня, що експонується цим
+registrar.
```typescript
api.registerCli(
@@ -359,7 +361,7 @@ api.registerCli(
descriptors: [
{
name: "matrix",
- description: "Керуйте обліковими записами Matrix, верифікацією, пристроями та станом профілю",
+ description: "Керування акаунтами Matrix, верифікацією, пристроями та станом профілю",
hasSubcommands: true,
},
],
@@ -367,79 +369,79 @@ api.registerCli(
);
```
-Використовуйте лише `commands`, тільки якщо вам не потрібна lazy-реєстрація кореневого CLI.
-Цей eager-шлях сумісності все ще підтримується, але він не встановлює
-placeholders на основі descriptor для lazy loading на етапі розбору.
+Використовуйте `commands` окремо лише тоді, коли вам не потрібна лінива реєстрація кореневого CLI.
+Цей eager-шлях сумісності залишається підтримуваним, але він не встановлює
+заповнювачі на основі descriptor для лінивого завантаження під час розбору.
-### Реєстрація CLI-бекенду
+### Реєстрація CLI backend
-`api.registerCliBackend(...)` дає плагіну змогу володіти типовою конфігурацією для локального
-AI CLI-бекенду, такого як `codex-cli`.
+`api.registerCliBackend(...)` дозволяє плагіну володіти конфігурацією за замовчуванням для локального
+backend AI CLI, такого як `codex-cli`.
-- `id` бекенду стає префіксом провайдера в посиланнях на моделі, як-от `codex-cli/gpt-5`.
-- `config` бекенду використовує ту саму форму, що й `agents.defaults.cliBackends.`.
-- Конфігурація користувача як і раніше має пріоритет. OpenClaw об’єднує `agents.defaults.cliBackends.` поверх
- типового значення плагіна перед запуском CLI.
-- Використовуйте `normalizeConfig`, коли бекенду потрібні переписування сумісності після злиття
- (наприклад, нормалізація старих форм прапорців).
+- `id` backend стає префіксом провайдера в model ref на кшталт `codex-cli/gpt-5`.
+- `config` backend використовує ту саму форму, що й `agents.defaults.cliBackends.`.
+- Конфігурація користувача все одно має пріоритет. OpenClaw об’єднує `agents.defaults.cliBackends.` поверх
+ значення за замовчуванням плагіна перед запуском CLI.
+- Використовуйте `normalizeConfig`, коли backend потребує переписувань для сумісності після об’єднання
+ (наприклад, нормалізації старих форм прапорців).
### Ексклюзивні слоти
-| Method | What it registers |
-| ------------------------------------------ | ---------------------------------------- |
-| `api.registerContextEngine(id, factory)` | Context engine (одночасно активний лише один) |
-| `api.registerMemoryPromptSection(builder)` | Builder розділу prompt пам’яті |
-| `api.registerMemoryFlushPlan(resolver)` | Resolver плану скидання пам’яті |
-| `api.registerMemoryRuntime(runtime)` | Адаптер runtime пам’яті |
+| Method | Що реєструє |
+| ------------------------------------------ | ----------------------------------- |
+| `api.registerContextEngine(id, factory)` | Контекстний engine (лише один активний одночасно) |
+| `api.registerMemoryPromptSection(builder)` | Конструктор розділу prompt пам’яті |
+| `api.registerMemoryFlushPlan(resolver)` | Resolver плану скидання пам’яті |
+| `api.registerMemoryRuntime(runtime)` | Адаптер runtime пам’яті |
-### Адаптери векторних подань пам’яті
+### Адаптери вбудовування пам’яті
-| Method | What it registers |
-| ---------------------------------------------- | --------------------------------------------------- |
-| `api.registerMemoryEmbeddingProvider(adapter)` | Адаптер векторних подань пам’яті для активного плагіна |
+| Method | Що реєструє |
+| ---------------------------------------------- | ------------------------------------------------ |
+| `api.registerMemoryEmbeddingProvider(adapter)` | Адаптер вбудовування пам’яті для активного плагіна |
- `registerMemoryPromptSection`, `registerMemoryFlushPlan` і
`registerMemoryRuntime` є ексклюзивними для плагінів пам’яті.
-- `registerMemoryEmbeddingProvider` дає активному плагіну пам’яті змогу реєструвати один
- або кілька id адаптерів векторних подань (наприклад, `openai`, `gemini` або
- користувацький id, визначений плагіном).
+- `registerMemoryEmbeddingProvider` дозволяє активному плагіну пам’яті реєструвати один
+ або кілька id адаптерів вбудовування (наприклад, `openai`, `gemini` або власний
+ id, визначений плагіном).
- Конфігурація користувача, така як `agents.defaults.memorySearch.provider` і
- `agents.defaults.memorySearch.fallback`, розв’язується відносно цих зареєстрованих
+ `agents.defaults.memorySearch.fallback`, визначається відносно цих зареєстрованих
id адаптерів.
### Події та життєвий цикл
-| Method | What it does |
-| -------------------------------------------- | ----------------------------- |
+| Method | Що робить |
+| -------------------------------------------- | ---------------------------- |
| `api.on(hookName, handler, opts?)` | Типізований хук життєвого циклу |
| `api.onConversationBindingResolved(handler)` | Зворотний виклик прив’язки розмови |
-### Семантика рішень hook
+### Семантика рішень хуків
-- `before_tool_call`: повернення `{ block: true }` є термінальним. Щойно будь-який handler встановлює це значення, handler-и з нижчим пріоритетом пропускаються.
+- `before_tool_call`: повернення `{ block: true }` є термінальним. Щойно будь-який обробник встановлює це значення, обробники з нижчим пріоритетом пропускаються.
- `before_tool_call`: повернення `{ block: false }` вважається відсутністю рішення (так само, як пропуск `block`), а не перевизначенням.
-- `before_install`: повернення `{ block: true }` є термінальним. Щойно будь-який handler встановлює це значення, handler-и з нижчим пріоритетом пропускаються.
+- `before_install`: повернення `{ block: true }` є термінальним. Щойно будь-який обробник встановлює це значення, обробники з нижчим пріоритетом пропускаються.
- `before_install`: повернення `{ block: false }` вважається відсутністю рішення (так само, як пропуск `block`), а не перевизначенням.
-- `reply_dispatch`: повернення `{ handled: true, ... }` є термінальним. Щойно будь-який handler заявляє про диспетчеризацію, handler-и з нижчим пріоритетом і типовий шлях диспетчеризації моделі пропускаються.
-- `message_sending`: повернення `{ cancel: true }` є термінальним. Щойно будь-який handler встановлює це значення, handler-и з нижчим пріоритетом пропускаються.
+- `reply_dispatch`: повернення `{ handled: true, ... }` є термінальним. Щойно будь-який обробник заявляє про диспетчеризацію, обробники з нижчим пріоритетом і шлях диспетчеризації моделі за замовчуванням пропускаються.
+- `message_sending`: повернення `{ cancel: true }` є термінальним. Щойно будь-який обробник встановлює це значення, обробники з нижчим пріоритетом пропускаються.
- `message_sending`: повернення `{ cancel: false }` вважається відсутністю рішення (так само, як пропуск `cancel`), а не перевизначенням.
### Поля об’єкта API
-| Field | Type | Description |
-| ------------------------ | ------------------------- | ------------------------------------------------------------------------------------------------ |
-| `api.id` | `string` | id плагіна |
-| `api.name` | `string` | Відображувана назва |
-| `api.version` | `string?` | Версія плагіна (необов’язково) |
-| `api.description` | `string?` | Опис плагіна (необов’язково) |
-| `api.source` | `string` | Шлях до джерела плагіна |
-| `api.rootDir` | `string?` | Кореневий каталог плагіна (необов’язково) |
-| `api.config` | `OpenClawConfig` | Поточний знімок конфігурації (активний in-memory знімок runtime, коли доступний) |
-| `api.pluginConfig` | `Record` | Конфігурація, специфічна для плагіна, з `plugins.entries..config` |
-| `api.runtime` | `PluginRuntime` | [Helper-и runtime](/uk/plugins/sdk-runtime) |
-| `api.logger` | `PluginLogger` | Logger з областю видимості (`debug`, `info`, `warn`, `error`) |
-| `api.registrationMode` | `PluginRegistrationMode` | Поточний режим завантаження; `"setup-runtime"` — це легке вікно запуску/налаштування до повного entry |
-| `api.resolvePath(input)` | `(string) => string` | Розв’язати шлях відносно кореня плагіна |
+| Field | Type | Description |
+| ------------------------ | ------------------------- | ------------------------------------------------------------------------------------------- |
+| `api.id` | `string` | Id плагіна |
+| `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.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` | Визначення шляху відносно кореня плагіна |
## Угода щодо внутрішніх модулів
@@ -455,41 +457,41 @@ my-plugin/
Ніколи не імпортуйте власний плагін через `openclaw/plugin-sdk/`
- з production-коду. Спрямовуйте внутрішні імпорти через `./api.ts` або
- `./runtime-api.ts`. Шлях SDK — це лише зовнішній контракт.
+ із production-коду. Маршрутизуйте внутрішні імпорти через `./api.ts` або
+ `./runtime-api.ts`. Шлях SDK є лише зовнішнім контрактом.
-Facade-loaded публічні поверхні вбудованих плагінів (`api.ts`, `runtime-api.ts`,
-`index.ts`, `setup-entry.ts` та подібні публічні entry-файли) тепер надають перевагу
-активному знімку конфігурації runtime, коли OpenClaw уже запущено. Якщо знімок runtime
-ще не існує, вони повертаються до розв’язаного файла конфігурації на диску.
+Публічні поверхні вбудованих плагінів, завантажувані через facade (`api.ts`, `runtime-api.ts`,
+`index.ts`, `setup-entry.ts` і подібні публічні entry-файли), тепер надають перевагу
+активному знімку конфігурації runtime, коли OpenClaw уже запущений. Якщо знімок runtime
+ще не існує, вони повертаються до визначеного файла конфігурації на диску.
-Плагіни провайдерів також можуть відкривати вузький локальний barrel-контракт плагіна, коли
-helper навмисно є специфічним для провайдера і поки що не належить до загального підшляху SDK.
-Поточний вбудований приклад: провайдер Anthropic зберігає свої helper-и потоку Claude
-у власному публічному seam `api.ts` / `contract-api.ts` замість того, щоб просувати логіку
-Anthropic beta-header і `service_tier` у загальний контракт
-`plugin-sdk/*`.
+Плагіни провайдерів також можуть експортувати вузький локальний для плагіна barrel-контракт, коли
+допоміжний засіб навмисно є специфічним для провайдера і ще не належить до загального підшляху SDK.
+Поточний вбудований приклад: провайдер Anthropic зберігає свої допоміжні засоби Claude
+stream у власному публічному seam `api.ts` / `contract-api.ts` замість
+просування логіки Anthropic beta-header і `service_tier` у загальний
+контракт `plugin-sdk/*`.
Інші поточні вбудовані приклади:
-- `@openclaw/openai-provider`: `api.ts` експортує builder-и провайдера,
- helper-и типових моделей і builder-и realtime-провайдерів
-- `@openclaw/openrouter-provider`: `api.ts` експортує builder провайдера та
- helper-и онбордингу/конфігурації
+- `@openclaw/openai-provider`: `api.ts` експортує конструктори провайдера,
+ допоміжні засоби моделі за замовчуванням і конструктори realtime-провайдера
+- `@openclaw/openrouter-provider`: `api.ts` експортує конструктор провайдера, а також
+ допоміжні засоби онбордингу/конфігурації
- Production-код розширень також повинен уникати імпортів `openclaw/plugin-sdk/`.
- Якщо helper справді є спільним, підніміть його до нейтрального підшляху SDK,
- такого як `openclaw/plugin-sdk/speech`, `.../provider-model-shared` або іншої
- surface, орієнтованої на можливості, замість того, щоб зв’язувати два плагіни між собою.
+ Production-код розширень також має уникати імпортів `openclaw/plugin-sdk/`.
+ Якщо допоміжний засіб справді є спільним, перенесіть його в нейтральний підшлях SDK,
+ такий як `openclaw/plugin-sdk/speech`, `.../provider-model-shared` або іншу
+ поверхню, орієнтовану на можливості, замість жорсткого зв’язування двох плагінів.
## Пов’язане
- [Entry Points](/uk/plugins/sdk-entrypoints) — параметри `definePluginEntry` і `defineChannelPluginEntry`
-- [Runtime Helpers](/uk/plugins/sdk-runtime) — повний довідник простору імен `api.runtime`
+- [Runtime Helpers](/uk/plugins/sdk-runtime) — повний довідник простору назв `api.runtime`
- [Setup and Config](/uk/plugins/sdk-setup) — пакування, маніфести, схеми конфігурації
-- [Testing](/uk/plugins/sdk-testing) — утиліти тестування та lint-правила
-- [SDK Migration](/uk/plugins/sdk-migration) — міграція із застарілих surface-інтерфейсів
-- [Plugin Internals](/uk/plugins/architecture) — поглиблена архітектура та модель можливостей плагінів
+- [Testing](/uk/plugins/sdk-testing) — утиліти тестування та правила lint
+- [SDK Migration](/uk/plugins/sdk-migration) — міграція із застарілих поверхонь
+- [Plugin Internals](/uk/plugins/architecture) — поглиблена архітектура та модель можливостей