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