From e255eb628d9a34a28874e01f210d777c40d54253 Mon Sep 17 00:00:00 2001 From: "openclaw-docs-i18n[bot]" Date: Tue, 28 Apr 2026 03:12:56 +0000 Subject: [PATCH] chore(i18n): refresh uk translations --- docs/uk/cli/backup.md | 62 +-- docs/uk/plugins/sdk-migration.md | 724 +++++++++++++++---------------- docs/uk/plugins/sdk-subpaths.md | 438 +++++++++---------- 3 files changed, 614 insertions(+), 610 deletions(-) diff --git a/docs/uk/cli/backup.md b/docs/uk/cli/backup.md index 831a3fe35..861fa2a98 100644 --- a/docs/uk/cli/backup.md +++ b/docs/uk/cli/backup.md @@ -1,21 +1,21 @@ --- read_when: - - Вам потрібен повноцінний архів резервної копії для локального стану OpenClaw + - Ви хочете повноцінний резервний архів для локального стану OpenClaw - Ви хочете попередньо переглянути, які шляхи буде включено перед скиданням або видаленням -summary: Довідка CLI для `openclaw backup` (створення локальних архівів резервних копій) +summary: Довідка CLI для `openclaw backup` (створювати локальні резервні архіви) title: Резервне копіювання x-i18n: - generated_at: "2026-04-24T04:11:42Z" + generated_at: "2026-04-28T03:09:57Z" model: gpt-5.4 provider: openai - source_hash: 88d83cf04c163d76658575aa6d90be1dd7379934fa2822a07e13311c4324f8fd + source_hash: 5c16f953bb32a1613181448f0e4c6ba8777383bce95bddc856dc7e1c3afe8550 source_path: cli/backup.md workflow: 15 --- # `openclaw backup` -Створіть локальний архів резервної копії для стану OpenClaw, конфігурації, профілів автентифікації, облікових даних каналів/провайдерів, сесій і, за бажанням, робочих просторів. +Створіть локальний резервний архів для стану OpenClaw, конфігурації, профілів автентифікації, облікових даних каналів/провайдерів, сесій і, за бажання, робочих просторів. ```bash openclaw backup create @@ -30,61 +30,67 @@ openclaw backup verify ./2026-03-09T00-00-00.000Z-openclaw-backup.tar.gz ## Примітки - Архів містить файл `manifest.json` із визначеними вихідними шляхами та структурою архіву. -- Типовим виводом є архів `.tar.gz` із часовою позначкою в поточному робочому каталозі. -- Якщо поточний робочий каталог розташований усередині дерева вихідних даних, що резервуються, OpenClaw використовує ваш домашній каталог як резервне типове розташування архіву. +- Типовий вивід — це `.tar.gz`-архів із часовою позначкою в поточному робочому каталозі. +- Якщо поточний робочий каталог розташований усередині дерева джерел, що потрапляє до резервної копії, OpenClaw використовує ваш домашній каталог як типове розташування архіву. - Наявні файли архівів ніколи не перезаписуються. - Вихідні шляхи всередині дерев вихідного стану/робочого простору відхиляються, щоб уникнути самовключення. -- `openclaw backup verify ` перевіряє, що архів містить рівно один кореневий маніфест, відхиляє шляхи архіву у стилі traversal і перевіряє, що кожне оголошене в маніфесті корисне навантаження існує в tarball. +- `openclaw backup verify ` перевіряє, що архів містить рівно один кореневий маніфест, відхиляє архівні шляхи у стилі traversal і перевіряє, що кожен payload, оголошений у маніфесті, існує в tarball. - `openclaw backup create --verify` запускає цю перевірку одразу після запису архіву. -- `openclaw backup create --only-config` створює резервну копію лише активного файла конфігурації JSON. +- `openclaw backup create --only-config` створює резервну копію лише активного JSON-файлу конфігурації. ## Що потрапляє до резервної копії `openclaw backup create` планує джерела резервного копіювання з вашого локального встановлення OpenClaw: - Каталог стану, який повертає локальний resolver стану OpenClaw, зазвичай `~/.openclaw` -- Шлях до активного файла конфігурації +- Шлях до активного файлу конфігурації - Визначений каталог `credentials/`, якщо він існує поза каталогом стану -- Каталоги робочих просторів, виявлені з поточної конфігурації, якщо ви не передасте `--no-include-workspace` +- Каталоги робочих просторів, знайдені з поточної конфігурації, якщо ви не передасте `--no-include-workspace` Профілі автентифікації моделей уже є частиною каталогу стану в -`agents//agent/auth-profiles.json`, тому зазвичай вони охоплюються -записом резервної копії стану. +`agents//agent/auth-profiles.json`, тож зазвичай вони охоплюються +записом резервного копіювання стану. -Якщо ви використовуєте `--only-config`, OpenClaw пропускає виявлення стану, каталогу облікових даних і робочого простору та архівує лише шлях до активного файла конфігурації. +Якщо ви використовуєте `--only-config`, OpenClaw пропускає виявлення стану, каталогу облікових даних і робочих просторів та архівує лише шлях до активного файлу конфігурації. -OpenClaw канонізує шляхи перед побудовою архіву. Якщо конфігурація, каталог -облікових даних або робочий простір уже розташовані всередині каталогу стану, -вони не дублюються як окремі джерела резервного копіювання верхнього рівня. Відсутні шляхи -пропускаються. +OpenClaw канонізує шляхи перед побудовою архіву. Якщо конфігурація, +каталог облікових даних або робочий простір уже розташовані всередині каталогу стану, +вони не дублюються як окремі джерела резервного копіювання верхнього рівня. Відсутні шляхи пропускаються. -Корисне навантаження архіву зберігає вміст файлів із цих дерев джерел, а вбудований `manifest.json` фіксує визначені абсолютні вихідні шляхи та структуру архіву, використану для кожного ресурсу. +Payload архіву зберігає вміст файлів із цих дерев джерел, а вбудований `manifest.json` записує визначені абсолютні шляхи джерел разом зі структурою архіву, використаною для кожного ресурсу. -## Поведінка за невалідної конфігурації +Вихідні файли та файли маніфесту встановлених Plugin у дереві +`extensions/` каталогу стану включаються, але їхні вкладені дерева залежностей +`node_modules/` пропускаються. Ці залежності є відтворюваними артефактами встановлення; після +відновлення архіву використайте `openclaw plugins update ` або перевстановіть Plugin +за допомогою `openclaw plugins install --force`, якщо відновлений Plugin повідомляє +про відсутні залежності. -`openclaw backup` навмисно оминає звичайну попередню перевірку конфігурації, щоб усе ще допомагати під час відновлення. Оскільки виявлення робочого простору залежить від валідної конфігурації, `openclaw backup create` тепер негайно завершується з помилкою, якщо файл конфігурації існує, але невалідний, і резервне копіювання робочого простору все ще ввімкнене. +## Поведінка за недійсної конфігурації -Якщо в такій ситуації вам усе ж потрібна часткова резервна копія, повторно виконайте: +`openclaw backup` навмисно обходить звичайну попередню перевірку конфігурації, щоб і надалі допомагати під час відновлення. Оскільки виявлення робочих просторів залежить від дійсної конфігурації, `openclaw backup create` тепер негайно завершується з помилкою, якщо файл конфігурації існує, але є недійсним, а резервне копіювання робочих просторів усе ще ввімкнене. + +Якщо в такій ситуації ви все ж хочете часткову резервну копію, запустіть ще раз: ```bash openclaw backup create --no-include-workspace ``` -Так у межах резервного копіювання залишаться стан, конфігурація та зовнішній каталог облікових даних, а -виявлення робочого простору буде повністю пропущено. +Так стан, конфігурація та зовнішній каталог облікових даних залишаться в межах +резервного копіювання, а виявлення робочих просторів буде повністю пропущено. -Якщо вам потрібна лише копія самого файла конфігурації, `--only-config` також працює, коли конфігурація некоректна, оскільки не покладається на розбір конфігурації для виявлення робочого простору. +Якщо вам потрібна лише копія самого файлу конфігурації, `--only-config` також працює, коли конфігурація пошкоджена, оскільки він не покладається на розбір конфігурації для виявлення робочих просторів. ## Розмір і продуктивність -OpenClaw не застосовує вбудоване максимальне обмеження розміру резервної копії або обмеження розміру окремого файла. +OpenClaw не застосовує вбудованого максимального розміру резервної копії або обмеження розміру окремого файлу. Практичні обмеження залежать від локальної машини та цільової файлової системи: -- Доступний простір для тимчасового запису архіву плюс фінальний архів +- Доступний простір для тимчасового запису архіву та для кінцевого архіву - Час на обхід великих дерев робочих просторів і їх стиснення в `.tar.gz` - Час на повторне сканування архіву, якщо ви використовуєте `openclaw backup create --verify` або запускаєте `openclaw backup verify` -- Поведінка файлової системи за цільовим шляхом. OpenClaw надає перевагу кроку публікації через hard link без перезапису й повертається до ексклюзивного копіювання, якщо hard link не підтримуються +- Поведінка файлової системи в цільовому шляху. OpenClaw надає перевагу кроку публікації через hard link без перезапису та повертається до ексклюзивного копіювання, коли hard link не підтримуються Великі робочі простори зазвичай є головним чинником розміру архіву. Якщо вам потрібна менша або швидша резервна копія, використовуйте `--no-include-workspace`. diff --git a/docs/uk/plugins/sdk-migration.md b/docs/uk/plugins/sdk-migration.md index caabb5db6..c8cabf1b1 100644 --- a/docs/uk/plugins/sdk-migration.md +++ b/docs/uk/plugins/sdk-migration.md @@ -1,42 +1,42 @@ --- read_when: - - Ви бачите попередження OPENCLAW_PLUGIN_SDK_COMPAT_DEPRECATED - - Ви бачите попередження OPENCLAW_EXTENSION_API_DEPRECATED + - Ви бачите попередження `OPENCLAW_PLUGIN_SDK_COMPAT_DEPRECATED` + - Ви бачите попередження `OPENCLAW_EXTENSION_API_DEPRECATED` - Ви використовували `api.registerEmbeddedExtensionFactory` до OpenClaw 2026.4.25 - - Ви оновлюєте Plugin до сучасної архітектури плагінів + - Ви оновлюєте Plugin до сучасної архітектури Plugin - Ви підтримуєте зовнішній Plugin OpenClaw sidebarTitle: Migrate to SDK summary: Перейдіть із застарілого шару зворотної сумісності на сучасний Plugin SDK -title: Міграція на Plugin SDK +title: Міграція Plugin SDK x-i18n: - generated_at: "2026-04-28T01:47:21Z" + generated_at: "2026-04-28T03:09:59Z" model: gpt-5.4 provider: openai - source_hash: 3d7a656413c7829ba65c81c5d1a96ebea9835ec205b4a08ec0ea6d53ce15141c + source_hash: 330ae4446c56e1a596e6c1b8e198a98bb03b616104efd1b25b4285c2700166c3 source_path: plugins/sdk-migration.md workflow: 15 --- -OpenClaw перейшов від широкого шару зворотної сумісності до сучасної архітектури плагінів із цільовими, задокументованими імпортами. Якщо ваш Plugin було створено до появи нової архітектури, цей посібник допоможе вам виконати міграцію. +OpenClaw перейшов від широкого шару зворотної сумісності до сучасної архітектури Plugin із цілеспрямованими, документованими імпортами. Якщо ваш Plugin було створено до появи нової архітектури, цей посібник допоможе вам виконати міграцію. ## Що змінюється -Стара система плагінів надавала дві надто широкі поверхні, які дозволяли Plugin імпортувати все необхідне з однієї точки входу: +Стара система Plugin надавала дві широко відкриті поверхні, які дозволяли Plugin імпортувати все, що їм було потрібно, з єдиної точки входу: -- **`openclaw/plugin-sdk/compat`** — один імпорт, який повторно експортував десятки допоміжних засобів. Його було запроваджено, щоб старіші hook-орієнтовані Plugin продовжували працювати, поки створювалася нова архітектура плагінів. -- **`openclaw/plugin-sdk/infra-runtime`** — широкий barrel-файл допоміжних засобів runtime, який змішував системні події, стан Heartbeat, черги доставки, допоміжні засоби fetch/proxy, файлові допоміжні засоби, типи approvals та не пов’язані між собою утиліти. -- **`openclaw/plugin-sdk/config-runtime`** — широкий barrel-файл сумісності для конфігурації, який у період міграції все ще містить застарілі прямі допоміжні засоби load/write. -- **`openclaw/extension-api`** — міст, який надавав Plugin прямий доступ до допоміжних засобів на боці хоста, наприклад до вбудованого runner агента. -- **`api.registerEmbeddedExtensionFactory(...)`** — вилучений hook для вбудованих розширень лише для Pi, який міг спостерігати за подіями embedded runner, такими як `tool_result`. +- **`openclaw/plugin-sdk/compat`** — єдиний імпорт, який повторно експортував десятки допоміжних засобів. Його було запроваджено, щоб старіші Plugin на основі хуків продовжували працювати, поки розроблялася нова архітектура Plugin. +- **`openclaw/plugin-sdk/infra-runtime`** — широкий barrel допоміжних засобів runtime, який змішував системні події, стан Heartbeat, черги доставки, допоміжні засоби fetch/proxy, файлові допоміжні засоби, типи схвалення та не пов’язані між собою утиліти. +- **`openclaw/plugin-sdk/config-runtime`** — широкий barrel сумісності конфігурації, який під час вікна міграції все ще містить застарілі допоміжні засоби прямого load/write. +- **`openclaw/extension-api`** — міст, який надавав Plugin прямий доступ до допоміжних засобів на боці хоста, як-от вбудований runner агента. +- **`api.registerEmbeddedExtensionFactory(...)`** — вилучений хук комплектного розширення лише для Pi, який міг спостерігати за подіями embedded-runner, такими як `tool_result`. -Ці широкі поверхні імпорту тепер **застарілі**. Вони все ще працюють у runtime, але нові Plugin не повинні їх використовувати, а наявні Plugin слід перенести до того, як у наступному мажорному релізі їх буде видалено. API реєстрації фабрики вбудованих розширень лише для Pi вже видалено; натомість використовуйте middleware для результатів інструментів. +Широкі поверхні імпорту тепер **застарілі**. Вони все ще працюють під час виконання, але нові Plugin не повинні їх використовувати, а наявні Plugin мають перейти до міграції до того, як їх буде вилучено в наступному мажорному випуску. API реєстрації фабрики вбудованого розширення лише для Pi вилучено; натомість використовуйте middleware результатів інструментів. -OpenClaw не видаляє і не переосмислює задокументовану поведінку Plugin у тій самій зміні, у якій запроваджується заміна. Зміни контрактів із порушенням сумісності спочатку мають пройти через адаптер сумісності, діагностику, документацію та період застарівання. Це стосується імпортів SDK, полів маніфесту, API налаштування, hook-ів і поведінки реєстрації runtime. +OpenClaw не вилучає і не переосмислює документовану поведінку Plugin в тій самій зміні, яка запроваджує заміну. Зміни контракту, що ламають сумісність, спочатку мають пройти через адаптер сумісності, діагностику, документацію та вікно застарівання. Це стосується імпортів SDK, полів маніфесту, API налаштування, хуків і поведінки реєстрації runtime. - Шар зворотної сумісності буде вилучено в одному з майбутніх мажорних релізів. + Шар зворотної сумісності буде вилучено в одному з майбутніх мажорних випусків. Plugin, які все ще імпортують із цих поверхонь, перестануть працювати, коли це станеться. - Реєстрації фабрик вбудованих розширень лише для Pi уже більше не завантажуються. + Реєстрації фабрики вбудованого розширення лише для Pi уже більше не завантажуються. ## Чому це змінилося @@ -44,48 +44,48 @@ OpenClaw не видаляє і не переосмислює задокумен Старий підхід спричиняв проблеми: - **Повільний запуск** — імпорт одного допоміжного засобу завантажував десятки не пов’язаних модулів -- **Циклічні залежності** — широкі повторні експорти полегшували створення циклів імпорту -- **Неясна поверхня API** — не було способу зрозуміти, які експорти є стабільними, а які внутрішніми +- **Циклічні залежності** — широкі повторні експорти спрощували створення циклів імпорту +- **Неочевидна поверхня API** — не було способу зрозуміти, які експорти є стабільними, а які — внутрішніми -Сучасний Plugin SDK виправляє це: кожен шлях імпорту (`openclaw/plugin-sdk/\`) — це невеликий, самодостатній модуль із чітким призначенням і задокументованим контрактом. +Сучасний Plugin SDK виправляє це: кожен шлях імпорту (`openclaw/plugin-sdk/\`) є невеликим самодостатнім модулем із чітким призначенням і документованим контрактом. -Застарілі зручні seams постачальників для вбудованих каналів також зникли. -Допоміжні seams, прив’язані до бренду каналу, були приватними скороченнями монорепозиторію, а не стабільними контрактами Plugin. Натомість використовуйте вузькі загальні підшляхи SDK. Усередині робочого простору вбудованого Plugin зберігайте допоміжні засоби, що належать постачальнику, у власному `api.ts` або `runtime-api.ts` цього Plugin. +Застарілі seams зручності provider для комплектних каналів також зникли. +Допоміжні seams із брендуванням каналу були приватними скороченнями mono-repo, а не стабільними контрактами Plugin. Натомість використовуйте вузькі узагальнені subpath SDK. Усередині робочого простору комплектного Plugin зберігайте допоміжні засоби, що належать provider, у власному `api.ts` або `runtime-api.ts` цього Plugin. -Поточні приклади вбудованих постачальників: +Поточні приклади комплектних provider: -- Anthropic зберігає допоміжні засоби потоків, специфічні для Claude, у власному seam `api.ts` / `contract-api.ts` -- OpenAI зберігає конструктори постачальників, допоміжні засоби моделей за замовчуванням і конструктори realtime-постачальників у власному `api.ts` -- OpenRouter зберігає конструктор постачальника та допоміжні засоби онбордингу/конфігурації у власному `api.ts` +- Anthropic зберігає допоміжні засоби потоку, специфічні для Claude, у власному seam `api.ts` / `contract-api.ts` +- OpenAI зберігає builder-и provider, допоміжні засоби моделей за замовчуванням і builder-и realtime provider у власному `api.ts` +- OpenRouter зберігає builder provider і допоміжні засоби onboarding/config у власному `api.ts` ## Політика сумісності -Для зовнішніх Plugin робота із сумісністю відбувається в такому порядку: +Для зовнішніх Plugin робота із сумісністю виконується в такому порядку: 1. додати новий контракт -2. зберегти стару поведінку, підключивши її через адаптер сумісності -3. вивести діагностичне повідомлення або попередження, яке вказує старий шлях і заміну +2. зберегти стару поведінку, підключену через адаптер сумісності +3. вивести діагностику або попередження, яке вказує старий шлях і заміну 4. покрити обидва шляхи в тестах -5. задокументувати застарівання та шлях міграції -6. видаляти лише після оголошеного вікна міграції, зазвичай у мажорному релізі +5. задокументувати застарівання і шлях міграції +6. вилучати лише після оголошеного вікна міграції, зазвичай у мажорному випуску -Якщо поле маніфесту все ще приймається, автори Plugin можуть і далі його використовувати, доки документація й діагностика не скажуть інакше. Новий код має віддавати перевагу задокументованій заміні, але наявні Plugin не повинні ламатися під час звичайних мінорних релізів. +Якщо поле маніфесту все ще приймається, автори Plugin можуть і далі використовувати його, доки документація та діагностика не скажуть інакше. Новий код має надавати перевагу документованій заміні, але наявні Plugin не повинні ламатися під час звичайних мінорних випусків. ## Як виконати міграцію - - Вбудовані Plugin повинні припинити прямі виклики + + Комплектні Plugin мають припинити прямі виклики `api.runtime.config.loadConfig()` і `api.runtime.config.writeConfigFile(...)`. Надавайте перевагу конфігурації, яку - вже передано в активний шлях виклику. Довгоживучі обробники, яким потрібен - поточний snapshot процесу, можуть використовувати `api.runtime.config.current()`. Довгоживучі - інструменти агента повинні використовувати `ctx.getRuntimeConfig()` із контексту інструмента в + вже було передано в активний шлях виклику. Довгоживучі обробники, яким + потрібен поточний знімок процесу, можуть використовувати `api.runtime.config.current()`. Довгоживучі + інструменти агента мають використовувати `ctx.getRuntimeConfig()` із контексту інструмента в `execute`, щоб інструмент, створений до запису конфігурації, усе одно бачив оновлену конфігурацію runtime. - Запис конфігурації має проходити через транзакційні допоміжні засоби з вибором - політики після запису: + Записи конфігурації мають проходити через транзакційні допоміжні засоби й + обирати політику після запису: ```typescript await api.runtime.config.mutateConfigFile({ @@ -96,53 +96,52 @@ OpenClaw не видаляє і не переосмислює задокумен }); ``` - Використовуйте `afterWrite: { mode: "restart", reason: "..." }`, коли код, що викликає, - знає, що зміна потребує чистого перезапуску Gateway, і - `afterWrite: { mode: "none", reason: "..." }` лише тоді, коли код, що викликає, сам керує - подальшими діями та свідомо хоче придушити планувальник перезавантаження. - Результати мутації містять типізоване резюме `followUp` для тестів і логування; - Gateway і далі відповідає за застосування або планування перезапуску. - `loadConfig` і `writeConfigFile` залишаються як застарілі - допоміжні засоби сумісності для зовнішніх Plugin упродовж вікна міграції та один раз - попереджають із кодом сумісності `runtime-config-load-write`. Вбудовані Plugin і код runtime - репозиторію захищені guardrails сканера в + Використовуйте `afterWrite: { mode: "restart", reason: "..." }`, коли викликач знає, + що зміна потребує чистого перезапуску Gateway, і + `afterWrite: { mode: "none", reason: "..." }` лише тоді, коли викликач сам керує + подальшими діями й навмисно хоче придушити планувальник перезавантаження. + Результати мутації містять типізоване зведення `followUp` для тестів і логування; + Gateway як і раніше відповідає за застосування або планування перезапуску. + `loadConfig` і `writeConfigFile` залишаються як застарілі допоміжні + засоби сумісності для зовнішніх Plugin на час вікна міграції та один раз + попереджають із кодом сумісності `runtime-config-load-write`. Комплектні Plugin і код + runtime репозиторію захищені scanner guardrails у `pnpm check:deprecated-internal-config-api` і - `pnpm check:no-runtime-action-load-config`: нове використання Plugin у production - завершується помилкою одразу, прямі записи конфігурації завершуються помилкою, методи сервера Gateway повинні використовувати - snapshot runtime запиту, допоміжні засоби send/action/client каналу runtime - повинні отримувати конфігурацію зі своєї межі, а довгоживучі модулі runtime мають - нульову дозволену кількість ambient-викликів `loadConfig()`. + `pnpm check:no-runtime-action-load-config`: нове використання production Plugin + одразу завершується помилкою, прямий запис конфігурації завершується помилкою, методи сервера Gateway мають використовувати + знімок runtime запиту, допоміжні засоби send/action/client runtime-каналу + мають отримувати конфігурацію зі своєї межі, а довгоживучі модулі runtime мають + нуль дозволених ambient викликів `loadConfig()`. - Новий код Plugin також не повинен імпортувати широкий - barrel-файл сумісності `openclaw/plugin-sdk/config-runtime`. Використовуйте вузький - підшлях SDK, що відповідає конкретному завданню: + Новий код Plugin також має уникати імпорту широкого + barrel сумісності `openclaw/plugin-sdk/config-runtime`. Використовуйте вузький + subpath SDK, що відповідає завданню: | Потреба | Імпорт | | --- | --- | - | Типи конфігурації, як-от `OpenClawConfig` | `openclaw/plugin-sdk/config-types` | - | Перевірки вже завантаженої конфігурації та пошук конфігурації запису Plugin | `openclaw/plugin-sdk/plugin-config-runtime` | - | Читання поточного snapshot runtime | `openclaw/plugin-sdk/runtime-config-snapshot` | - | Запис конфігурації | `openclaw/plugin-sdk/config-mutation` | + | Типи конфігурації, такі як `OpenClawConfig` | `openclaw/plugin-sdk/config-types` | + | Already-loaded перевірки конфігурації та пошук конфігурації запису Plugin | `openclaw/plugin-sdk/plugin-config-runtime` | + | Читання поточного знімка runtime | `openclaw/plugin-sdk/runtime-config-snapshot` | + | Записи конфігурації | `openclaw/plugin-sdk/config-mutation` | | Допоміжні засоби сховища сесій | `openclaw/plugin-sdk/session-store-runtime` | - | Конфігурація Markdown-таблиць | `openclaw/plugin-sdk/markdown-table-runtime` | - | Допоміжні засоби runtime для політик груп | `openclaw/plugin-sdk/runtime-group-policy` | - | Визначення секретного вводу | `openclaw/plugin-sdk/secret-input-runtime` | - | Перевизначення моделі/сесії | `openclaw/plugin-sdk/model-session-runtime` | + | Конфігурація таблиць Markdown | `openclaw/plugin-sdk/markdown-table-runtime` | + | Допоміжні засоби runtime політики груп | `openclaw/plugin-sdk/runtime-group-policy` | + | Розв’язання secret input | `openclaw/plugin-sdk/secret-input-runtime` | + | Перевизначення model/session | `openclaw/plugin-sdk/model-session-runtime` | - Вбудовані Plugin та їхні тести захищені сканером від широкого - barrel-файлу, тому імпорти й mocks залишаються локальними до потрібної їм поведінки. Широкий - barrel-файл усе ще існує для зовнішньої сумісності, але новий код не повинен - від нього залежати. + Комплектні Plugin та їхні тести захищені scanner-обмеженнями від широкого + barrel, щоб імпорти та mocks залишалися локальними щодо потрібної їм поведінки. Широкий + barrel усе ще існує для зовнішньої сумісності, але новий код не повинен від нього залежати. - - Вбудовані Plugin повинні замінити обробники - `api.registerEmbeddedExtensionFactory(...)` для результатів інструментів лише для Pi на - runtime-нейтральне middleware. + + Комплектні Plugin мають замінити обробники результатів інструментів лише для Pi + `api.registerEmbeddedExtensionFactory(...)` на + middleware, нейтральне до runtime. ```typescript - // Динамічні інструменти runtime Pi і Codex + // Pi and Codex runtime dynamic tools api.registerAgentToolResultMiddleware(async (event) => { return compactToolResult(event); }, { @@ -160,61 +159,61 @@ OpenClaw не видаляє і не переосмислює задокумен } ``` - Зовнішні Plugin не можуть реєструвати middleware для результатів інструментів, оскільки воно може - переписувати високодовірений вивід інструмента до того, як модель його побачить. + Зовнішні Plugin не можуть реєструвати middleware результатів інструментів, тому що воно може + переписувати результат інструмента з високим рівнем довіри до того, як модель його побачить. - - Plugin каналів із підтримкою approvals тепер надають native-поведінку approvals через - `approvalCapability.nativeRuntime` разом зі спільним реєстром контексту runtime. + + Plugin каналів із підтримкою approval тепер розкривають нативну поведінку approval через + `approvalCapability.nativeRuntime` плюс спільний registry контексту runtime. - Основні зміни: + Ключові зміни: - Замініть `approvalCapability.handler.loadRuntime(...)` на `approvalCapability.nativeRuntime` - - Перенесіть auth/delivery, специфічні для approvals, зі старого підключення `plugin.auth` / + - Перенесіть специфічну для approval auth/delivery із застарілої прив’язки `plugin.auth` / `plugin.approvals` на `approvalCapability` - - `ChannelPlugin.approvals` видалено з публічного - контракту Plugin каналу; перенесіть поля delivery/native/render до `approvalCapability` - - `plugin.auth` залишається лише для потоків входу/виходу з каналу; approvals auth - hook-и там більше не зчитуються ядром - - Реєструйте об’єкти runtime, що належать каналу, як-от клієнти, токени або Bolt + - `ChannelPlugin.approvals` вилучено з публічного + контракту channel-plugin; перенесіть поля delivery/native/render до `approvalCapability` + - `plugin.auth` залишається лише для потоків channel login/logout; approval auth + hooks там більше не зчитуються core + - Реєструйте об’єкти runtime, що належать каналу, як-от clients, tokens або Bolt apps, через `openclaw/plugin-sdk/channel-runtime-context` - - Не надсилайте сповіщення про reroute, що належать Plugin, із native-обробників approvals; - тепер ядро відповідає за сповіщення routed-elsewhere на основі фактичних результатів доставки - - Коли передаєте `channelRuntime` у `createChannelManager(...)`, надавайте + - Не надсилайте повідомлення reroute notice, що належать Plugin, із нативних approval-обробників; + core тепер сам володіє повідомленнями routed-elsewhere notice на основі фактичних результатів доставки + - Під час передавання `channelRuntime` до `createChannelManager(...)` надавайте справжню поверхню `createPluginRuntime().channel`. Часткові stubs відхиляються. - Поточну структуру capability approvals дивіться в `/plugins/sdk-channel-plugins`. + Поточну структуру capability approval див. у `/plugins/sdk-channel-plugins`. - - Якщо ваш Plugin використовує `openclaw/plugin-sdk/windows-spawn`, невизначені Windows - wrapper-и `.cmd`/`.bat` тепер закриваються без fallback, якщо ви явно не передасте + + Якщо ваш Plugin використовує `openclaw/plugin-sdk/windows-spawn`, нерозв’язані wrappers Windows + `.cmd`/`.bat` тепер завершуються в закритий спосіб, якщо ви явно не передасте `allowShellFallback: true`. ```typescript - // До + // Before const program = applyWindowsSpawnProgramPolicy({ candidate }); - // Після + // After const program = applyWindowsSpawnProgramPolicy({ candidate, - // Встановлюйте це лише для довірених сумісних викликів, які навмисно - // допускають fallback через shell. + // Only set this for trusted compatibility callers that intentionally + // accept shell-mediated fallback. allowShellFallback: true, }); ``` - Якщо ваш код, що викликає, не покладається навмисно на fallback через shell, не встановлюйте - `allowShellFallback` і натомість обробіть згенеровану помилку. + Якщо ваш викликач навмисно не покладається на shell fallback, не встановлюйте + `allowShellFallback` і натомість обробляйте викинуту помилку. - Знайдіть у своєму Plugin імпорти з будь-якої застарілої поверхні: + Знайдіть у своєму Plugin імпорти з будь-якої із застарілих поверхонь: ```bash grep -r "plugin-sdk/compat" my-plugin/ @@ -225,35 +224,35 @@ OpenClaw не видаляє і не переосмислює задокумен - - Кожен експорт зі старої поверхні відповідає певному сучасному шляху імпорту: + + Кожен експорт зі старої поверхні зіставляється з конкретним сучасним шляхом імпорту: ```typescript - // До (застарілий шар зворотної сумісності) + // Before (deprecated backwards-compatibility layer) import { createChannelReplyPipeline, createPluginRuntimeStore, resolveControlCommandGate, } from "openclaw/plugin-sdk/compat"; - // Після (сучасні цільові імпорти) + // After (modern focused imports) import { createChannelReplyPipeline } from "openclaw/plugin-sdk/channel-reply-pipeline"; import { createPluginRuntimeStore } from "openclaw/plugin-sdk/runtime-store"; import { resolveControlCommandGate } from "openclaw/plugin-sdk/command-auth"; ``` - Для допоміжних засобів на боці хоста використовуйте впроваджений runtime Plugin замість прямого імпорту: + Для допоміжних засобів на боці хоста використовуйте injected runtime Plugin замість прямого імпорту: ```typescript - // До (застарілий міст extension-api) + // Before (deprecated extension-api bridge) import { runEmbeddedPiAgent } from "openclaw/extension-api"; const result = await runEmbeddedPiAgent({ sessionId, prompt }); - // Після (впроваджений runtime) + // After (injected runtime) const result = await api.runtime.agent.runEmbeddedPiAgent({ sessionId, prompt }); ``` - Такий самий шаблон застосовується й до інших застарілих допоміжних засобів мосту: + Той самий шаблон застосовується й до інших застарілих допоміжних засобів bridge: | Старий імпорт | Сучасний еквівалент | | --- | --- | @@ -269,7 +268,7 @@ OpenClaw не видаляє і не переосмислює задокумен `openclaw/plugin-sdk/infra-runtime` усе ще існує для зовнішньої - сумісності, але новий код повинен імпортувати ту цільову поверхню допоміжних засобів, + сумісності, але новий код має імпортувати цілеспрямовану поверхню допоміжних засобів, яка йому фактично потрібна: | Потреба | Імпорт | @@ -278,31 +277,31 @@ OpenClaw не видаляє і не переосмислює задокумен | Допоміжні засоби подій Heartbeat і видимості | `openclaw/plugin-sdk/heartbeat-runtime` | | Спорожнення черги відкладеної доставки | `openclaw/plugin-sdk/delivery-queue-runtime` | | Телеметрія активності каналу | `openclaw/plugin-sdk/channel-activity-runtime` | - | In-memory кеші дедуплікації | `openclaw/plugin-sdk/dedupe-runtime` | + | Кеші дедуплікації в пам’яті | `openclaw/plugin-sdk/dedupe-runtime` | | Безпечні допоміжні засоби шляхів до локальних файлів/медіа | `openclaw/plugin-sdk/file-access-runtime` | - | Fetch з урахуванням dispatcher | `openclaw/plugin-sdk/runtime-fetch` | - | Допоміжні засоби proxy і захищеного fetch | `openclaw/plugin-sdk/fetch-runtime` | - | Типи політик SSRF dispatcher | `openclaw/plugin-sdk/ssrf-dispatcher` | - | Типи запитів і розв’язання approvals | `openclaw/plugin-sdk/approval-runtime` | - | Допоміжні засоби payload відповіді approvals і команд | `openclaw/plugin-sdk/approval-reply-runtime` | + | `fetch` з урахуванням dispatcher | `openclaw/plugin-sdk/runtime-fetch` | + | Допоміжні засоби proxy і guarded fetch | `openclaw/plugin-sdk/fetch-runtime` | + | Типи політики dispatcher SSRF | `openclaw/plugin-sdk/ssrf-dispatcher` | + | Типи запиту/розв’язання approval | `openclaw/plugin-sdk/approval-runtime` | + | Допоміжні засоби payload відповіді approval і команд | `openclaw/plugin-sdk/approval-reply-runtime` | | Допоміжні засоби форматування помилок | `openclaw/plugin-sdk/error-runtime` | - | Очікування готовності transport | `openclaw/plugin-sdk/transport-ready-runtime` | + | Очікування готовності транспорту | `openclaw/plugin-sdk/transport-ready-runtime` | | Допоміжні засоби безпечних токенів | `openclaw/plugin-sdk/secure-random-runtime` | | Обмежена конкурентність асинхронних задач | `openclaw/plugin-sdk/concurrency-runtime` | | Числове приведення | `openclaw/plugin-sdk/number-runtime` | | Асинхронне блокування в межах процесу | `openclaw/plugin-sdk/async-lock-runtime` | | Блокування файлів | `openclaw/plugin-sdk/file-lock` | - Вбудовані Plugin захищені сканером від `infra-runtime`, тому код репозиторію - не може повернутися до широкого barrel-файлу. + Комплектні Plugin захищені scanner-обмеженнями від `infra-runtime`, тому код репозиторію + не може знову повернутися до широкого barrel. - - Новий код маршрутів каналів повинен використовувати `openclaw/plugin-sdk/channel-route`. - Старіші назви route-key і comparable-target залишаються як псевдоніми - сумісності протягом вікна міграції, але нові Plugin повинні використовувати назви - маршрутів, які безпосередньо описують поведінку: + + Новий код маршрутизації каналу має використовувати `openclaw/plugin-sdk/channel-route`. + Старіші назви route-key і comparable-target залишаються як псевдоніми сумісності + на час вікна міграції, але нові Plugin мають використовувати назви маршрутів, + які безпосередньо описують поведінку: | Старий допоміжний засіб | Сучасний допоміжний засіб | | --- | --- | @@ -314,11 +313,11 @@ OpenClaw не видаляє і не переосмислює задокумен | `comparableChannelTargetsMatch(...)` | `channelRouteTargetsMatchExact(...)` | | `comparableChannelTargetsShareRoute(...)` | `channelRouteTargetsShareConversation(...)` | - Сучасні допоміжні засоби маршрутів узгоджено нормалізують `{ channel, to, accountId, threadId }` - для native approvals, придушення відповідей, дедуплікації вхідних повідомлень, - доставки Cron і маршрутизації сесій. Якщо ваш Plugin має власну граматику - цільових адрес, використовуйте `resolveChannelRouteTargetWithParser(...)`, щоб адаптувати цей - parser до того самого контракту цільового маршруту. + Сучасні допоміжні засоби маршрутів послідовно нормалізують `{ channel, to, accountId, threadId }` + для нативних approval, придушення відповідей, дедуплікації вхідних повідомлень, + доставки Cron і маршрутизації сесій. Якщо ваш Plugin використовує власну граматику + цільових об’єктів, застосовуйте `resolveChannelRouteTargetWithParser(...)`, щоб адаптувати + цей parser до того самого контракту цільового маршруту. @@ -333,72 +332,72 @@ OpenClaw не видаляє і не переосмислює задокумен ## Довідник шляхів імпорту - | Import path | Призначення | Ключові експорти | + | Шлях імпорту | Призначення | Ключові експорти | | --- | --- | --- | - | `plugin-sdk/plugin-entry` | Канонічний допоміжний засіб для входу Plugin | `definePluginEntry` | - | `plugin-sdk/core` | Застарілий umbrella-реекспорт для визначень/конструкторів входу каналів | `defineChannelPluginEntry`, `createChatChannelPlugin` | + | `plugin-sdk/plugin-entry` | Канонічний допоміжний засіб входу Plugin | `definePluginEntry` | + | `plugin-sdk/core` | Застарілий umbrella повторний експорт для визначень/builder-ів входу каналу | `defineChannelPluginEntry`, `createChatChannelPlugin` | | `plugin-sdk/config-schema` | Експорт кореневої схеми конфігурації | `OpenClawSchema` | - | `plugin-sdk/provider-entry` | Допоміжний засіб входу для одного постачальника | `defineSingleProviderPluginEntry` | - | `plugin-sdk/channel-core` | Цільові визначення та конструктори входу каналів | `defineChannelPluginEntry`, `defineSetupPluginEntry`, `createChatChannelPlugin`, `createChannelPluginBase` | - | `plugin-sdk/setup` | Спільні допоміжні засоби майстра налаштування | Prompts allowlist, конструктори статусу налаштування | - | `plugin-sdk/setup-runtime` | Допоміжні засоби runtime на етапі налаштування | Безпечні для імпорту адаптери patch налаштування, допоміжні засоби нотаток lookup, `promptResolvedAllowFrom`, `splitSetupEntries`, делеговані проксі налаштування | + | `plugin-sdk/provider-entry` | Допоміжний засіб входу для одного provider | `defineSingleProviderPluginEntry` | + | `plugin-sdk/channel-core` | Цілеспрямовані визначення і builder-и входу каналу | `defineChannelPluginEntry`, `defineSetupPluginEntry`, `createChatChannelPlugin`, `createChannelPluginBase` | + | `plugin-sdk/setup` | Спільні допоміжні засоби майстра налаштування | Підказки allowlist, builder-и статусу налаштування | + | `plugin-sdk/setup-runtime` | Допоміжні засоби runtime під час налаштування | Безпечні для імпорту patch-адаптери налаштування, допоміжні засоби нотаток lookup, `promptResolvedAllowFrom`, `splitSetupEntries`, delegated setup proxies | | `plugin-sdk/setup-adapter-runtime` | Допоміжні засоби адаптера налаштування | `createEnvPatchedAccountSetupAdapter` | | `plugin-sdk/setup-tools` | Допоміжні засоби інструментів налаштування | `formatCliCommand`, `detectBinary`, `extractArchive`, `resolveBrewExecutable`, `formatDocsLink`, `CONFIG_DIR` | - | `plugin-sdk/account-core` | Допоміжні засоби для багатьох облікових записів | Допоміжні засоби списку облікових записів/конфігурації/action-gate | + | `plugin-sdk/account-core` | Допоміжні засоби для кількох облікових записів | Допоміжні засоби списку/конфігурації/action-gate облікових записів | | `plugin-sdk/account-id` | Допоміжні засоби account-id | `DEFAULT_ACCOUNT_ID`, нормалізація account-id | - | `plugin-sdk/account-resolution` | Допоміжні засоби пошуку облікових записів | Допоміжні засоби пошуку облікових записів + fallback до значення за замовчуванням | - | `plugin-sdk/account-helpers` | Вузькі допоміжні засоби облікових записів | Допоміжні засоби списку облікових записів/дій облікових записів | + | `plugin-sdk/account-resolution` | Допоміжні засоби lookup облікових записів | Допоміжні засоби lookup облікових записів + fallback до значення за замовчуванням | + | `plugin-sdk/account-helpers` | Вузькі допоміжні засоби облікових записів | Допоміжні засоби списку облікових записів/account-action | | `plugin-sdk/channel-setup` | Адаптери майстра налаштування | `createOptionalChannelSetupSurface`, `createOptionalChannelSetupAdapter`, `createOptionalChannelSetupWizard`, а також `DEFAULT_ACCOUNT_ID`, `createTopLevelChannelDmPolicy`, `setSetupChannelEnabled`, `splitSetupEntries` | | `plugin-sdk/channel-pairing` | Примітиви DM pairing | `createChannelPairingController` | - | `plugin-sdk/channel-reply-pipeline` | Логіка префікса відповіді + typing | `createChannelReplyPipeline` | + | `plugin-sdk/channel-reply-pipeline` | Прив’язка префікса відповіді + typing | `createChannelReplyPipeline` | | `plugin-sdk/channel-config-helpers` | Фабрики адаптерів конфігурації | `createHybridChannelConfigAdapter` | - | `plugin-sdk/channel-config-schema` | Конструктори схем конфігурації | Спільні примітиви схем конфігурації каналів і лише загальний конструктор | - | `plugin-sdk/bundled-channel-config-schema` | Вбудовані схеми конфігурації | Лише для вбудованих Plugin, які підтримує OpenClaw; нові Plugin повинні визначати локальні для Plugin схеми | - | `plugin-sdk/channel-config-schema-legacy` | Застарілі вбудовані схеми конфігурації | Лише псевдонім сумісності; для підтримуваних вбудованих Plugin використовуйте `plugin-sdk/bundled-channel-config-schema` | - | `plugin-sdk/telegram-command-config` | Допоміжні засоби конфігурації команд Telegram | Нормалізація імен команд, обрізання описів, перевірка дублікатів/конфліктів | - | `plugin-sdk/channel-policy` | Визначення політики груп/DM | `resolveChannelGroupRequireMention` | - | `plugin-sdk/channel-lifecycle` | Допоміжні засоби статусу облікового запису та життєвого циклу draft stream | `createAccountStatusSink`, допоміжні засоби фіналізації попереднього перегляду draft | - | `plugin-sdk/inbound-envelope` | Допоміжні засоби inbound envelope | Спільні допоміжні засоби побудови route + envelope | - | `plugin-sdk/inbound-reply-dispatch` | Допоміжні засоби inbound reply | Спільні допоміжні засоби record-and-dispatch | + | `plugin-sdk/channel-config-schema` | Builder-и схем конфігурації | Спільні примітиви схем конфігурації каналу і лише узагальнений builder | + | `plugin-sdk/bundled-channel-config-schema` | Комплектні схеми конфігурації | Лише для комплектних Plugin, які підтримує OpenClaw; нові Plugin мають визначати локальні схеми Plugin | + | `plugin-sdk/channel-config-schema-legacy` | Застарілі комплектні схеми конфігурації | Лише псевдонім сумісності; для підтримуваних комплектних Plugin використовуйте `plugin-sdk/bundled-channel-config-schema` | + | `plugin-sdk/telegram-command-config` | Допоміжні засоби конфігурації команд Telegram | Нормалізація назв команд, обрізання опису, валідація дублікатів/конфліктів | + | `plugin-sdk/channel-policy` | Розв’язання політик груп/DM | `resolveChannelGroupRequireMention` | + | `plugin-sdk/channel-lifecycle` | Допоміжні засоби статусу облікових записів і життєвого циклу потоку чернеток | `createAccountStatusSink`, допоміжні засоби фіналізації попереднього перегляду чернеток | + | `plugin-sdk/inbound-envelope` | Допоміжні засоби вхідного envelope | Спільні допоміжні засоби builder-ів route + envelope | + | `plugin-sdk/inbound-reply-dispatch` | Допоміжні засоби вхідних відповідей | Спільні допоміжні засоби record-and-dispatch | | `plugin-sdk/messaging-targets` | Розбір цілей повідомлень | Допоміжні засоби розбору/зіставлення цілей | - | `plugin-sdk/outbound-media` | Допоміжні засоби outbound media | Спільне завантаження outbound media | - | `plugin-sdk/outbound-send-deps` | Допоміжні засоби залежностей outbound send | Полегшений пошук `resolveOutboundSendDep` без імпорту повного outbound runtime | - | `plugin-sdk/outbound-runtime` | Допоміжні засоби outbound runtime | Допоміжні засоби outbound delivery, делегата identity/send, сесії, форматування та планування payload | - | `plugin-sdk/thread-bindings-runtime` | Допоміжні засоби thread-binding | Допоміжні засоби життєвого циклу та адаптера thread-binding | - | `plugin-sdk/agent-media-payload` | Застарілі допоміжні засоби media payload | Конструктор media payload агента для застарілих схем полів | + | `plugin-sdk/outbound-media` | Допоміжні засоби вихідних медіа | Спільне завантаження вихідних медіа | + | `plugin-sdk/outbound-send-deps` | Допоміжні засоби залежностей outbound send | Полегшений lookup `resolveOutboundSendDep` без імпорту повного outbound runtime | + | `plugin-sdk/outbound-runtime` | Допоміжні засоби outbound runtime | Допоміжні засоби outbound delivery, identity/send delegate, session, formatting і планування payload | + | `plugin-sdk/thread-bindings-runtime` | Допоміжні засоби thread-binding | Життєвий цикл thread-binding і допоміжні засоби адаптера | + | `plugin-sdk/agent-media-payload` | Застарілі допоміжні засоби payload медіа | Builder payload медіа агента для застарілих layouts полів | | `plugin-sdk/channel-runtime` | Застарілий shim сумісності | Лише застарілі утиліти channel runtime | - | `plugin-sdk/channel-send-result` | Типи результатів send | Типи результатів reply | + | `plugin-sdk/channel-send-result` | Типи результатів send | Типи результатів відповіді | | `plugin-sdk/runtime-store` | Постійне сховище Plugin | `createPluginRuntimeStore` | | `plugin-sdk/runtime` | Широкі допоміжні засоби runtime | Допоміжні засоби runtime/logging/backup/встановлення Plugin | - | `plugin-sdk/runtime-env` | Вузькі допоміжні засоби runtime env | Logger/runtime env, timeout, retry і допоміжні засоби backoff | - | `plugin-sdk/plugin-runtime` | Спільні допоміжні засоби runtime Plugin | Допоміжні засоби команд/hook-ів/http/interactive для Plugin | - | `plugin-sdk/hook-runtime` | Допоміжні засоби pipeline hook-ів | Спільні допоміжні засоби pipeline webhook/internal hook | + | `plugin-sdk/runtime-env` | Вузькі допоміжні засоби середовища runtime | Допоміжні засоби logger/runtime env, timeout, retry і backoff | + | `plugin-sdk/plugin-runtime` | Спільні допоміжні засоби runtime Plugin | Допоміжні засоби команд/хуків/http/interactive Plugin | + | `plugin-sdk/hook-runtime` | Допоміжні засоби pipeline хуків | Спільні допоміжні засоби pipeline Webhook/внутрішніх хуків | | `plugin-sdk/lazy-runtime` | Допоміжні засоби lazy runtime | `createLazyRuntimeModule`, `createLazyRuntimeMethod`, `createLazyRuntimeMethodBinder`, `createLazyRuntimeNamedExport`, `createLazyRuntimeSurface` | - | `plugin-sdk/process-runtime` | Допоміжні засоби процесів | Спільні допоміжні засоби exec | + | `plugin-sdk/process-runtime` | Допоміжні засоби процесу | Спільні допоміжні засоби exec | | `plugin-sdk/cli-runtime` | Допоміжні засоби CLI runtime | Форматування команд, очікування, допоміжні засоби версій | - | `plugin-sdk/gateway-runtime` | Допоміжні засоби Gateway | Допоміжні засоби клієнта Gateway та patch-ів статусу каналу | + | `plugin-sdk/gateway-runtime` | Допоміжні засоби Gateway | Допоміжні засоби клієнта Gateway і patch статусу каналу | | `plugin-sdk/config-runtime` | Застарілий shim сумісності конфігурації | Надавайте перевагу `config-types`, `plugin-config-runtime`, `runtime-config-snapshot` і `config-mutation` | - | `plugin-sdk/telegram-command-config` | Допоміжні засоби команд Telegram | Допоміжні засоби перевірки команд Telegram зі стабільним fallback, коли поверхня контракту вбудованого Telegram недоступна | - | `plugin-sdk/approval-runtime` | Допоміжні засоби prompts approvals | Payload approval для exec/Plugin, допоміжні засоби capability/profile approvals, native routing/runtime approvals і форматування структурованого шляху відображення approvals | - | `plugin-sdk/approval-auth-runtime` | Допоміжні засоби auth approvals | Визначення approver, auth дій у тому самому чаті | - | `plugin-sdk/approval-client-runtime` | Допоміжні засоби клієнта approvals | Допоміжні засоби profile/filter native exec approval | - | `plugin-sdk/approval-delivery-runtime` | Допоміжні засоби доставки approvals | Адаптери capability/delivery native approvals | - | `plugin-sdk/approval-gateway-runtime` | Допоміжні засоби Gateway approvals | Спільний допоміжний засіб визначення approval gateway | - | `plugin-sdk/approval-handler-adapter-runtime` | Допоміжні засоби адаптера approvals | Полегшені допоміжні засоби завантаження адаптера native approvals для гарячих точок входу каналів | - | `plugin-sdk/approval-handler-runtime` | Допоміжні засоби обробника approvals | Ширші допоміжні засоби runtime для обробника approvals; надавайте перевагу вужчим adapter/gateway seams, коли їх достатньо | - | `plugin-sdk/approval-native-runtime` | Допоміжні засоби цілей approvals | Допоміжні засоби прив’язки native-цілей/облікових записів approvals | - | `plugin-sdk/approval-reply-runtime` | Допоміжні засоби reply approvals | Допоміжні засоби payload reply approvals для exec/Plugin | - | `plugin-sdk/channel-runtime-context` | Допоміжні засоби channel runtime-context | Загальні допоміжні засоби register/get/watch для channel runtime-context | + | `plugin-sdk/telegram-command-config` | Допоміжні засоби команд Telegram | Стабільні fallback-допоміжні засоби валідації команд Telegram, коли поверхня контракту комплектного Telegram недоступна | + | `plugin-sdk/approval-runtime` | Допоміжні засоби prompt approval | Payload виконання/Plugin approval, допоміжні засоби capability/profile approval, нативні допоміжні засоби routing/runtime approval і форматування шляху структурованого відображення approval | + | `plugin-sdk/approval-auth-runtime` | Допоміжні засоби auth approval | Розв’язання approver, auth дій у тому самому чаті | + | `plugin-sdk/approval-client-runtime` | Допоміжні засоби клієнта approval | Допоміжні засоби profile/filter для нативного exec approval | + | `plugin-sdk/approval-delivery-runtime` | Допоміжні засоби доставки approval | Адаптери capability/delivery нативного approval | + | `plugin-sdk/approval-gateway-runtime` | Допоміжні засоби Gateway approval | Спільний допоміжний засіб gateway-resolution approval | + | `plugin-sdk/approval-handler-adapter-runtime` | Допоміжні засоби адаптера approval | Полегшені допоміжні засоби завантаження нативного адаптера approval для гарячих entrypoint-ів каналу | + | `plugin-sdk/approval-handler-runtime` | Допоміжні засоби обробника approval | Ширші допоміжні засоби runtime обробника approval; надавайте перевагу вужчим seams адаптера/Gateway, коли їх достатньо | + | `plugin-sdk/approval-native-runtime` | Допоміжні засоби цілей approval | Допоміжні засоби binding цілі/облікового запису нативного approval | + | `plugin-sdk/approval-reply-runtime` | Допоміжні засоби відповіді approval | Допоміжні засоби payload відповіді exec/Plugin approval | + | `plugin-sdk/channel-runtime-context` | Допоміжні засоби контексту runtime каналу | Узагальнені допоміжні засоби register/get/watch для контексту runtime каналу | | `plugin-sdk/security-runtime` | Допоміжні засоби безпеки | Спільні допоміжні засоби trust, DM gating, external-content і збирання секретів | - | `plugin-sdk/ssrf-policy` | Допоміжні засоби політик SSRF | Допоміжні засоби allowlist хостів і політик приватної мережі | - | `plugin-sdk/ssrf-runtime` | Допоміжні засоби SSRF runtime | Pinned-dispatcher, guarded fetch, допоміжні засоби політик SSRF | + | `plugin-sdk/ssrf-policy` | Допоміжні засоби політики SSRF | Допоміжні засоби allowlist хостів і політики приватної мережі | + | `plugin-sdk/ssrf-runtime` | Допоміжні засоби runtime SSRF | Pinned-dispatcher, guarded fetch, допоміжні засоби політики SSRF | | `plugin-sdk/system-event-runtime` | Допоміжні засоби системних подій | `enqueueSystemEvent`, `peekSystemEventEntries` | | `plugin-sdk/heartbeat-runtime` | Допоміжні засоби Heartbeat | Допоміжні засоби подій Heartbeat і видимості | | `plugin-sdk/delivery-queue-runtime` | Допоміжні засоби черги доставки | `drainPendingDeliveries` | | `plugin-sdk/channel-activity-runtime` | Допоміжні засоби активності каналу | `recordChannelActivity` | - | `plugin-sdk/dedupe-runtime` | Допоміжні засоби дедуплікації | In-memory кеші дедуплікації | + | `plugin-sdk/dedupe-runtime` | Допоміжні засоби дедуплікації | Кеші дедуплікації в пам’яті | | `plugin-sdk/file-access-runtime` | Допоміжні засоби доступу до файлів | Безпечні допоміжні засоби шляхів до локальних файлів/медіа | - | `plugin-sdk/transport-ready-runtime` | Допоміжні засоби готовності transport | `waitForTransportReady` | + | `plugin-sdk/transport-ready-runtime` | Допоміжні засоби готовності транспорту | `waitForTransportReady` | | `plugin-sdk/collection-runtime` | Допоміжні засоби обмеженого кешу | `pruneMapToMaxSize` | | `plugin-sdk/diagnostic-runtime` | Допоміжні засоби керування діагностикою | `isDiagnosticFlagEnabled`, `isDiagnosticsEnabled` | | `plugin-sdk/error-runtime` | Допоміжні засоби форматування помилок | `formatUncaughtError`, `isApprovalNotFoundError`, допоміжні засоби графа помилок | @@ -406,123 +405,123 @@ OpenClaw не видаляє і не переосмислює задокумен | `plugin-sdk/host-runtime` | Допоміжні засоби нормалізації хоста | `normalizeHostname`, `normalizeScpRemoteHost` | | `plugin-sdk/retry-runtime` | Допоміжні засоби retry | `RetryConfig`, `retryAsync`, виконавці політик | | `plugin-sdk/allow-from` | Форматування allowlist | `formatAllowFromLowercase` | - | `plugin-sdk/allowlist-resolution` | Відображення вводу allowlist | `mapAllowlistResolutionInputs` | - | `plugin-sdk/command-auth` | Керування командами та допоміжні засоби поверхні команд | `resolveControlCommandGate`, допоміжні засоби авторизації відправника, допоміжні засоби реєстру команд, зокрема форматування меню динамічних аргументів | + | `plugin-sdk/allowlist-resolution` | Відображення входів allowlist | `mapAllowlistResolutionInputs` | + | `plugin-sdk/command-auth` | Керування командами і допоміжні засоби поверхні команд | `resolveControlCommandGate`, допоміжні засоби авторизації відправника, допоміжні засоби registry команд, зокрема форматування меню динамічних аргументів | | `plugin-sdk/command-status` | Рендерери статусу/довідки команд | `buildCommandsMessage`, `buildCommandsMessagePaginated`, `buildHelpMessage` | | `plugin-sdk/secret-input` | Розбір secret input | Допоміжні засоби secret input | | `plugin-sdk/webhook-ingress` | Допоміжні засоби запитів Webhook | Утиліти цілей Webhook | - | `plugin-sdk/webhook-request-guards` | Допоміжні засоби guards тіла запиту Webhook | Допоміжні засоби читання/обмеження тіла запиту | - | `plugin-sdk/reply-runtime` | Спільний reply runtime | Inbound dispatch, Heartbeat, планувальник reply, розбиття на частини | - | `plugin-sdk/reply-dispatch-runtime` | Вузькі допоміжні засоби dispatch reply | Фіналізація, dispatch постачальника та допоміжні засоби міток розмов | - | `plugin-sdk/reply-history` | Допоміжні засоби reply-history | `buildHistoryContext`, `buildPendingHistoryContextFromMap`, `recordPendingHistoryEntry`, `clearHistoryEntriesIfEnabled` | - | `plugin-sdk/reply-reference` | Планування посилань reply | `createReplyReferencePlanner` | - | `plugin-sdk/reply-chunking` | Допоміжні засоби частин reply | Допоміжні засоби розбиття тексту/markdown на частини | + | `plugin-sdk/webhook-request-guards` | Допоміжні засоби guard для тіла запиту Webhook | Допоміжні засоби читання/обмеження тіла запиту | + | `plugin-sdk/reply-runtime` | Спільний runtime відповідей | Вхідний dispatch, Heartbeat, планувальник відповідей, chunking | + | `plugin-sdk/reply-dispatch-runtime` | Вузькі допоміжні засоби dispatch відповідей | Фіналізація, dispatch provider і допоміжні засоби міток розмов | + | `plugin-sdk/reply-history` | Допоміжні засоби історії відповідей | `buildHistoryContext`, `buildPendingHistoryContextFromMap`, `recordPendingHistoryEntry`, `clearHistoryEntriesIfEnabled` | + | `plugin-sdk/reply-reference` | Планування посилань відповіді | `createReplyReferencePlanner` | + | `plugin-sdk/reply-chunking` | Допоміжні засоби chunk відповіді | Допоміжні засоби chunking тексту/Markdown | | `plugin-sdk/session-store-runtime` | Допоміжні засоби сховища сесій | Допоміжні засоби шляху сховища + updated-at | - | `plugin-sdk/state-paths` | Допоміжні засоби шляхів стану | Допоміжні засоби каталогів state і OAuth | + | `plugin-sdk/state-paths` | Допоміжні засоби шляхів стану | Допоміжні засоби каталогів стану та OAuth | | `plugin-sdk/routing` | Допоміжні засоби routing/session-key | `resolveAgentRoute`, `buildAgentSessionKey`, `resolveDefaultAgentBoundAccountId`, допоміжні засоби нормалізації session-key | - | `plugin-sdk/status-helpers` | Допоміжні засоби статусу каналу | Конструктори зведення статусу каналу/облікового запису, значення за замовчуванням для runtime-state, допоміжні засоби метаданих issue | - | `plugin-sdk/target-resolver-runtime` | Допоміжні засоби визначення цілі | Спільні допоміжні засоби target resolver | + | `plugin-sdk/status-helpers` | Допоміжні засоби статусу каналу | Builder-и зведення статусу каналу/облікового запису, значення за замовчуванням стану runtime, допоміжні засоби метаданих проблем | + | `plugin-sdk/target-resolver-runtime` | Допоміжні засоби розв’язання цілей | Спільні допоміжні засоби розв’язання цілей | | `plugin-sdk/string-normalization-runtime` | Допоміжні засоби нормалізації рядків | Допоміжні засоби нормалізації slug/рядків | - | `plugin-sdk/request-url` | Допоміжні засоби URL запиту | Витягування рядкових URL з request-подібних вхідних даних | + | `plugin-sdk/request-url` | Допоміжні засоби URL запитів | Витягання рядкових URL із входів, подібних до request | | `plugin-sdk/run-command` | Допоміжні засоби timed command | Виконавець timed command із нормалізованими stdout/stderr | - | `plugin-sdk/param-readers` | Читачі параметрів | Загальні читачі параметрів tool/CLI | - | `plugin-sdk/tool-payload` | Витягування payload tool | Витягування нормалізованих payload із об’єктів результатів tool | - | `plugin-sdk/tool-send` | Витягування send tool | Витягування канонічних полів цілі send з аргументів tool | - | `plugin-sdk/temp-path` | Допоміжні засоби тимчасових шляхів | Спільні допоміжні засоби шляхів до тимчасових завантажень | - | `plugin-sdk/logging-core` | Допоміжні засоби Logging | Допоміжні засоби логера підсистеми та редагування | - | `plugin-sdk/markdown-table-runtime` | Допоміжні засоби Markdown-таблиць | Допоміжні засоби режимів Markdown-таблиць | - | `plugin-sdk/reply-payload` | Типи reply повідомлень | Типи payload reply | - | `plugin-sdk/provider-setup` | Кураторські допоміжні засоби налаштування локальних/self-hosted постачальників | Допоміжні засоби виявлення/конфігурації self-hosted постачальників | - | `plugin-sdk/self-hosted-provider-setup` | Цільові допоміжні засоби налаштування self-hosted постачальників, сумісних з OpenAI | Ті самі допоміжні засоби виявлення/конфігурації self-hosted постачальників | - | `plugin-sdk/provider-auth-runtime` | Допоміжні засоби auth постачальника в runtime | Допоміжні засоби визначення API-key у runtime | - | `plugin-sdk/provider-auth-api-key` | Допоміжні засоби налаштування API-key постачальника | Допоміжні засоби онбордингу/запису профілю API-key | - | `plugin-sdk/provider-auth-result` | Допоміжні засоби auth-result постачальника | Стандартний конструктор OAuth auth-result | - | `plugin-sdk/provider-auth-login` | Допоміжні засоби інтерактивного входу постачальника | Спільні допоміжні засоби інтерактивного входу | - | `plugin-sdk/provider-selection-runtime` | Допоміжні засоби вибору постачальника | Вибір постачальника configured-or-auto та об’єднання сирих конфігурацій постачальників | - | `plugin-sdk/provider-env-vars` | Допоміжні засоби env-var постачальника | Допоміжні засоби пошуку auth env-var постачальника | - | `plugin-sdk/provider-model-shared` | Спільні допоміжні засоби моделі/replay постачальника | `ProviderReplayFamily`, `buildProviderReplayFamilyHooks`, `normalizeModelCompat`, спільні конструктори політик replay, допоміжні засоби endpoint постачальника та допоміжні засоби нормалізації model-id | - | `plugin-sdk/provider-catalog-shared` | Спільні допоміжні засоби каталогу постачальників | `findCatalogTemplate`, `buildSingleProviderApiKeyCatalog`, `supportsNativeStreamingUsageCompat`, `applyProviderNativeStreamingUsageCompat` | - | `plugin-sdk/provider-onboard` | Патчі онбордингу постачальника | Допоміжні засоби конфігурації онбордингу | - | `plugin-sdk/provider-http` | Допоміжні засоби HTTP постачальника | Загальні допоміжні засоби HTTP/можливостей endpoint постачальника, зокрема допоміжні засоби multipart form для транскрибування аудіо | - | `plugin-sdk/provider-web-fetch` | Допоміжні засоби web-fetch постачальника | Допоміжні засоби реєстрації/кешування постачальників web-fetch | - | `plugin-sdk/provider-web-search-config-contract` | Допоміжні засоби конфігурації web-search постачальника | Вузькі допоміжні засоби конфігурації/облікових даних web-search для постачальників, яким не потрібне підключення enable Plugin | - | `plugin-sdk/provider-web-search-contract` | Допоміжні засоби контракту web-search постачальника | Вузькі допоміжні засоби контракту конфігурації/облікових даних web-search, як-от `createWebSearchProviderContractFields`, `enablePluginInConfig`, `resolveProviderWebSearchPluginConfig` і scoped setters/getters облікових даних | - | `plugin-sdk/provider-web-search` | Допоміжні засоби web-search постачальника | Допоміжні засоби реєстрації/кешування/runtime постачальника web-search | - | `plugin-sdk/provider-tools` | Допоміжні засоби compat для tool/schema постачальника | `ProviderToolCompatFamily`, `buildProviderToolCompatFamilyHooks`, очищення схеми Gemini + діагностика та допоміжні засоби compat xAI, як-от `resolveXaiModelCompatPatch` / `applyXaiModelCompat` | - | `plugin-sdk/provider-usage` | Допоміжні засоби usage постачальника | `fetchClaudeUsage`, `fetchGeminiUsage`, `fetchGithubCopilotUsage` та інші допоміжні засоби usage постачальника | - | `plugin-sdk/provider-stream` | Допоміжні засоби wrapper-ів stream постачальника | `ProviderStreamFamily`, `buildProviderStreamFamilyHooks`, `composeProviderStreamWrappers`, типи wrapper-ів stream і спільні допоміжні засоби wrapper-ів Anthropic/Bedrock/DeepSeek V4/Google/Kilocode/Moonshot/OpenAI/OpenRouter/Z.A.I/MiniMax/Copilot | - | `plugin-sdk/provider-transport-runtime` | Допоміжні засоби transport постачальника | Допоміжні засоби native transport постачальника, як-от guarded fetch, трансформації повідомлень transport і writable event streams transport | + | `plugin-sdk/param-readers` | Читачі параметрів | Поширені читачі параметрів інструментів/CLI | + | `plugin-sdk/tool-payload` | Витягання payload інструмента | Витягання нормалізованих payload із об’єктів результатів інструмента | + | `plugin-sdk/tool-send` | Витягання send інструмента | Витягання канонічних полів цілі send з аргументів інструмента | + | `plugin-sdk/temp-path` | Допоміжні засоби тимчасових шляхів | Спільні допоміжні засоби шляхів тимчасового завантаження | + | `plugin-sdk/logging-core` | Допоміжні засоби logging | Допоміжні засоби logger підсистеми та редагування | + | `plugin-sdk/markdown-table-runtime` | Допоміжні засоби Markdown-table | Допоміжні засоби режиму таблиць Markdown | + | `plugin-sdk/reply-payload` | Типи reply повідомлень | Типи payload відповіді | + | `plugin-sdk/provider-setup` | Кураторські допоміжні засоби налаштування локальних/self-hosted provider | Допоміжні засоби виявлення/конфігурації self-hosted provider | + | `plugin-sdk/self-hosted-provider-setup` | Цілеспрямовані допоміжні засоби налаштування self-hosted provider, сумісних з OpenAI | Ті самі допоміжні засоби виявлення/конфігурації self-hosted provider | + | `plugin-sdk/provider-auth-runtime` | Допоміжні засоби auth provider runtime | Допоміжні засоби розв’язання API-ключів runtime | + | `plugin-sdk/provider-auth-api-key` | Допоміжні засоби налаштування API-ключів provider | Допоміжні засоби onboarding/profile-write для API-ключів | + | `plugin-sdk/provider-auth-result` | Допоміжні засоби auth-result provider | Стандартний builder auth-result OAuth | + | `plugin-sdk/provider-auth-login` | Допоміжні засоби інтерактивного входу provider | Спільні допоміжні засоби інтерактивного входу | + | `plugin-sdk/provider-selection-runtime` | Допоміжні засоби вибору provider | Вибір provider configured-or-auto і злиття сирої конфігурації provider | + | `plugin-sdk/provider-env-vars` | Допоміжні засоби env-var provider | Допоміжні засоби lookup env-var auth provider | + | `plugin-sdk/provider-model-shared` | Спільні допоміжні засоби model/replay provider | `ProviderReplayFamily`, `buildProviderReplayFamilyHooks`, `normalizeModelCompat`, спільні builder-и replay-policy, допоміжні засоби endpoint provider і нормалізації model-id | + | `plugin-sdk/provider-catalog-shared` | Спільні допоміжні засоби каталогу provider | `findCatalogTemplate`, `buildSingleProviderApiKeyCatalog`, `supportsNativeStreamingUsageCompat`, `applyProviderNativeStreamingUsageCompat` | + | `plugin-sdk/provider-onboard` | Патчі onboarding provider | Допоміжні засоби конфігурації onboarding | + | `plugin-sdk/provider-http` | Допоміжні засоби HTTP provider | Узагальнені допоміжні засоби HTTP/можливостей endpoint provider, зокрема допоміжні засоби multipart form для транскрипції аудіо | + | `plugin-sdk/provider-web-fetch` | Допоміжні засоби web-fetch provider | Допоміжні засоби реєстрації/кешу provider web-fetch | + | `plugin-sdk/provider-web-search-config-contract` | Допоміжні засоби конфігурації web-search provider | Вузькі допоміжні засоби конфігурації/облікових даних web-search для provider, яким не потрібна прив’язка enable Plugin | + | `plugin-sdk/provider-web-search-contract` | Допоміжні засоби контракту web-search provider | Вузькі допоміжні засоби контракту конфігурації/облікових даних web-search, такі як `createWebSearchProviderContractFields`, `enablePluginInConfig`, `resolveProviderWebSearchPluginConfig` і scoped setters/getters облікових даних | + | `plugin-sdk/provider-web-search` | Допоміжні засоби web-search provider | Допоміжні засоби реєстрації/кешу/runtime provider web-search | + | `plugin-sdk/provider-tools` | Допоміжні засоби compat інструментів/схем provider | `ProviderToolCompatFamily`, `buildProviderToolCompatFamilyHooks`, очищення схем Gemini + діагностика, а також допоміжні засоби compat xAI, такі як `resolveXaiModelCompatPatch` / `applyXaiModelCompat` | + | `plugin-sdk/provider-usage` | Допоміжні засоби використання provider | `fetchClaudeUsage`, `fetchGeminiUsage`, `fetchGithubCopilotUsage` та інші допоміжні засоби використання provider | + | `plugin-sdk/provider-stream` | Допоміжні засоби wrapper потоку provider | `ProviderStreamFamily`, `buildProviderStreamFamilyHooks`, `composeProviderStreamWrappers`, типи wrapper-ів потоку і спільні допоміжні засоби wrapper-ів Anthropic/Bedrock/DeepSeek V4/Google/Kilocode/Moonshot/OpenAI/OpenRouter/Z.A.I/MiniMax/Copilot | + | `plugin-sdk/provider-transport-runtime` | Допоміжні засоби транспорту provider | Нативні допоміжні засоби транспорту provider, такі як guarded fetch, перетворення повідомлень транспорту і доступні для запису потоки подій транспорту | | `plugin-sdk/keyed-async-queue` | Упорядкована асинхронна черга | `KeyedAsyncQueue` | - | `plugin-sdk/media-runtime` | Спільні допоміжні засоби media | Допоміжні засоби fetch/transform/store media, а також конструктори payload media | - | `plugin-sdk/media-generation-runtime` | Спільні допоміжні засоби генерації media | Спільні допоміжні засоби failover, вибору кандидатів і повідомлень про відсутню модель для генерації зображень/відео/музики | - | `plugin-sdk/media-understanding` | Допоміжні засоби media-understanding | Типи постачальника media understanding, а також експорти допоміжних засобів зображень/аудіо для постачальників | - | `plugin-sdk/text-runtime` | Спільні допоміжні засоби text | Видалення тексту, видимого асистенту, допоміжні засоби рендерингу/розбиття/таблиць markdown, допоміжні засоби редагування, допоміжні засоби directive-tag, утиліти safe-text та пов’язані допоміжні засоби text/logging | - | `plugin-sdk/text-chunking` | Допоміжні засоби розбиття text | Допоміжний засіб розбиття outbound text | - | `plugin-sdk/speech` | Допоміжні засоби speech | Типи постачальника speech, а також допоміжні засоби directives, registry, validation для постачальників і конструктор TTS, сумісний з OpenAI | - | `plugin-sdk/speech-core` | Спільне ядро speech | Типи постачальника speech, registry, directives, нормалізація | - | `plugin-sdk/realtime-transcription` | Допоміжні засоби транскрибування в realtime | Типи постачальника, допоміжні засоби registry і спільний допоміжний засіб сесії WebSocket | - | `plugin-sdk/realtime-voice` | Допоміжні засоби голосу в realtime | Типи постачальника, допоміжні засоби registry/визначення та допоміжні засоби bridge session | - | `plugin-sdk/image-generation` | Допоміжні засоби генерації зображень | Типи постачальника генерації зображень, а також допоміжні засоби image asset/data URL | + | `plugin-sdk/media-runtime` | Спільні допоміжні засоби медіа | Допоміжні засоби отримання/перетворення/зберігання медіа плюс builder-и payload медіа | + | `plugin-sdk/media-generation-runtime` | Спільні допоміжні засоби генерації медіа | Спільні допоміжні засоби failover, вибір кандидатів і повідомлення про відсутню модель для генерації зображень/відео/музики | + | `plugin-sdk/media-understanding` | Допоміжні засоби media-understanding | Типи provider media understanding плюс експорти допоміжних засобів для роботи із зображенням/аудіо для provider | + | `plugin-sdk/text-runtime` | Спільні допоміжні засоби тексту | Видалення видимого для асистента тексту, допоміжні засоби render/chunking/table для Markdown, допоміжні засоби редагування, допоміжні засоби тегів директив, утиліти безпечного тексту та пов’язані допоміжні засоби тексту/logging | + | `plugin-sdk/text-chunking` | Допоміжні засоби chunking тексту | Допоміжний засіб chunking вихідного тексту | + | `plugin-sdk/speech` | Допоміжні засоби мовлення | Типи provider мовлення плюс допоміжні засоби директив, registry, валідації для provider і builder TTS, сумісний з OpenAI | + | `plugin-sdk/speech-core` | Спільне ядро мовлення | Типи provider мовлення, registry, директиви, нормалізація | + | `plugin-sdk/realtime-transcription` | Допоміжні засоби транскрипції realtime | Типи provider, допоміжні засоби registry і спільний допоміжний засіб сесії WebSocket | + | `plugin-sdk/realtime-voice` | Допоміжні засоби голосу realtime | Типи provider, допоміжні засоби registry/розв’язання і допоміжні засоби bridge session | + | `plugin-sdk/image-generation` | Допоміжні засоби генерації зображень | Типи provider генерації зображень плюс допоміжні засоби image asset/data URL і builder provider зображень, сумісний з OpenAI | | `plugin-sdk/image-generation-core` | Спільне ядро генерації зображень | Типи генерації зображень, допоміжні засоби failover, auth і registry | - | `plugin-sdk/music-generation` | Допоміжні засоби генерації музики | Типи постачальника/запиту/результату генерації музики | - | `plugin-sdk/music-generation-core` | Спільне ядро генерації музики | Типи генерації музики, допоміжні засоби failover, пошук постачальника та розбір model-ref | - | `plugin-sdk/video-generation` | Допоміжні засоби генерації відео | Типи постачальника/запиту/результату генерації відео | - | `plugin-sdk/video-generation-core` | Спільне ядро генерації відео | Типи генерації відео, допоміжні засоби failover, пошук постачальника та розбір model-ref | - | `plugin-sdk/interactive-runtime` | Допоміжні засоби інтерактивних reply | Нормалізація/скорочення payload інтерактивних reply | - | `plugin-sdk/channel-config-primitives` | Примітиви конфігурації каналів | Вузькі примітиви channel config-schema | - | `plugin-sdk/channel-config-writes` | Допоміжні засоби запису конфігурації каналів | Допоміжні засоби авторизації запису конфігурації каналів | - | `plugin-sdk/channel-plugin-common` | Спільний prelude каналу | Експорти спільного prelude Plugin каналу | + | `plugin-sdk/music-generation` | Допоміжні засоби генерації музики | Типи provider/request/result для генерації музики | + | `plugin-sdk/music-generation-core` | Спільне ядро генерації музики | Типи генерації музики, допоміжні засоби failover, lookup provider і розбір model-ref | + | `plugin-sdk/video-generation` | Допоміжні засоби генерації відео | Типи provider/request/result для генерації відео | + | `plugin-sdk/video-generation-core` | Спільне ядро генерації відео | Типи генерації відео, допоміжні засоби failover, lookup provider і розбір model-ref | + | `plugin-sdk/interactive-runtime` | Допоміжні засоби інтерактивних відповідей | Нормалізація/зведення payload інтерактивної відповіді | + | `plugin-sdk/channel-config-primitives` | Примітиви конфігурації каналу | Вузькі примітиви channel config-schema | + | `plugin-sdk/channel-config-writes` | Допоміжні засоби config-write каналу | Допоміжні засоби авторизації запису конфігурації каналу | + | `plugin-sdk/channel-plugin-common` | Спільна преамбула каналу | Спільні експорти преамбули channel Plugin | | `plugin-sdk/channel-status` | Допоміжні засоби статусу каналу | Спільні допоміжні засоби snapshot/summary статусу каналу | | `plugin-sdk/allowlist-config-edit` | Допоміжні засоби конфігурації allowlist | Допоміжні засоби редагування/читання конфігурації allowlist | - | `plugin-sdk/group-access` | Допоміжні засоби доступу до груп | Спільні допоміжні засоби рішень щодо group-access | - | `plugin-sdk/direct-dm` | Допоміжні засоби direct-DM | Спільні допоміжні засоби auth/guard для direct-DM | - | `plugin-sdk/extension-shared` | Спільні допоміжні засоби extension | Примітиви пасивного каналу/статусу та ambient proxy helper | - | `plugin-sdk/webhook-targets` | Допоміжні засоби цілей Webhook | Реєстр цілей Webhook і допоміжні засоби встановлення route | + | `plugin-sdk/group-access` | Допоміжні засоби доступу груп | Спільні допоміжні засоби ухвалення рішень group-access | + | `plugin-sdk/direct-dm` | Допоміжні засоби direct-DM | Спільні допоміжні засоби auth/guard direct-DM | + | `plugin-sdk/extension-shared` | Спільні допоміжні засоби розширень | Примітиви passive-channel/status і ambient proxy helper | + | `plugin-sdk/webhook-targets` | Допоміжні засоби цілей Webhook | Registry цілей Webhook і допоміжні засоби встановлення route | | `plugin-sdk/webhook-path` | Допоміжні засоби шляхів Webhook | Допоміжні засоби нормалізації шляхів Webhook | - | `plugin-sdk/web-media` | Спільні допоміжні засоби web media | Допоміжні засоби завантаження віддалених/локальних media | - | `plugin-sdk/zod` | Реекспорт Zod | Повторно експортований `zod` для споживачів Plugin SDK | - | `plugin-sdk/memory-core` | Вбудовані допоміжні засоби memory-core | Поверхня допоміжних засобів менеджера memory/config/file/CLI | - | `plugin-sdk/memory-core-engine-runtime` | Runtime facade рушія memory | Runtime facade індексування/пошуку memory | - | `plugin-sdk/memory-core-host-engine-foundation` | Базовий рушій memory host | Експорти базового рушія memory host | - | `plugin-sdk/memory-core-host-engine-embeddings` | Рушій embeddings для memory host | Контракти embeddings для memory, доступ до registry, локальний постачальник і загальні batch/remote helper-и; конкретні remote-постачальники живуть у власних Plugin | - | `plugin-sdk/memory-core-host-engine-qmd` | Рушій QMD для memory host | Експорти рушія QMD для memory host | - | `plugin-sdk/memory-core-host-engine-storage` | Рушій сховища memory host | Експорти рушія сховища memory host | - | `plugin-sdk/memory-core-host-multimodal` | Допоміжні засоби multimodal для memory host | Допоміжні засоби multimodal для memory host | - | `plugin-sdk/memory-core-host-query` | Допоміжні засоби query для memory host | Допоміжні засоби query для memory host | - | `plugin-sdk/memory-core-host-secret` | Допоміжні засоби secret для memory host | Допоміжні засоби secret для memory host | - | `plugin-sdk/memory-core-host-events` | Допоміжні засоби журналу подій memory host | Допоміжні засоби журналу подій memory host | - | `plugin-sdk/memory-core-host-status` | Допоміжні засоби статусу memory host | Допоміжні засоби статусу memory host | - | `plugin-sdk/memory-core-host-runtime-cli` | CLI runtime memory host | Допоміжні засоби CLI runtime memory host | - | `plugin-sdk/memory-core-host-runtime-core` | Core runtime memory host | Допоміжні засоби core runtime memory host | - | `plugin-sdk/memory-core-host-runtime-files` | Допоміжні засоби файлів/runtime memory host | Допоміжні засоби файлів/runtime memory host | - | `plugin-sdk/memory-host-core` | Псевдонім core runtime memory host | Нейтральний до вендора псевдонім для допоміжних засобів core runtime memory host | - | `plugin-sdk/memory-host-events` | Псевдонім журналу подій memory host | Нейтральний до вендора псевдонім для допоміжних засобів журналу подій memory host | - | `plugin-sdk/memory-host-files` | Псевдонім файлів/runtime memory host | Нейтральний до вендора псевдонім для допоміжних засобів файлів/runtime memory host | - | `plugin-sdk/memory-host-markdown` | Допоміжні засоби керованого markdown | Спільні допоміжні засоби керованого markdown для Plugin, суміжних із memory | - | `plugin-sdk/memory-host-search` | Фасад пошуку Active Memory | Лінивий runtime facade менеджера пошуку active-memory | - | `plugin-sdk/memory-host-status` | Псевдонім статусу memory host | Нейтральний до вендора псевдонім для допоміжних засобів статусу memory host | - | `plugin-sdk/memory-lancedb` | Вбудовані допоміжні засоби memory-lancedb | Поверхня допоміжних засобів memory-lancedb | - | `plugin-sdk/testing` | Утиліти тестування | Застарілий широкий barrel сумісності; надавайте перевагу цільовим підшляхам тестування, таким як `plugin-sdk/plugin-test-runtime`, `plugin-sdk/channel-test-helpers`, `plugin-sdk/channel-target-testing`, `plugin-sdk/test-env` і `plugin-sdk/test-fixtures` | + | `plugin-sdk/web-media` | Спільні допоміжні засоби вебмедіа | Допоміжні засоби завантаження віддалених/локальних медіа | + | `plugin-sdk/zod` | Повторний експорт Zod | Повторно експортований `zod` для користувачів Plugin SDK | + | `plugin-sdk/memory-core` | Комплектні допоміжні засоби memory-core | Поверхня допоміжних засобів memory manager/config/file/CLI | + | `plugin-sdk/memory-core-engine-runtime` | Фасад runtime рушія пам’яті | Фасад runtime індексу/пошуку пам’яті | + | `plugin-sdk/memory-core-host-engine-foundation` | Базовий рушій хоста пам’яті | Експорти базового рушія хоста пам’яті | + | `plugin-sdk/memory-core-host-engine-embeddings` | Рушій embeddings хоста пам’яті | Контракти embeddings пам’яті, доступ до registry, локальний provider і узагальнені batch/remote допоміжні засоби; конкретні remote provider живуть у своїх Plugin-власниках | + | `plugin-sdk/memory-core-host-engine-qmd` | Рушій QMD хоста пам’яті | Експорти рушія QMD хоста пам’яті | + | `plugin-sdk/memory-core-host-engine-storage` | Рушій сховища хоста пам’яті | Експорти рушія сховища хоста пам’яті | + | `plugin-sdk/memory-core-host-multimodal` | Допоміжні засоби multimodal хоста пам’яті | Допоміжні засоби multimodal хоста пам’яті | + | `plugin-sdk/memory-core-host-query` | Допоміжні засоби запитів хоста пам’яті | Допоміжні засоби запитів хоста пам’яті | + | `plugin-sdk/memory-core-host-secret` | Допоміжні засоби secret хоста пам’яті | Допоміжні засоби secret хоста пам’яті | + | `plugin-sdk/memory-core-host-events` | Допоміжні засоби журналу подій хоста пам’яті | Допоміжні засоби журналу подій хоста пам’яті | + | `plugin-sdk/memory-core-host-status` | Допоміжні засоби статусу хоста пам’яті | Допоміжні засоби статусу хоста пам’яті | + | `plugin-sdk/memory-core-host-runtime-cli` | CLI runtime хоста пам’яті | Допоміжні засоби CLI runtime хоста пам’яті | + | `plugin-sdk/memory-core-host-runtime-core` | Core runtime хоста пам’яті | Допоміжні засоби core runtime хоста пам’яті | + | `plugin-sdk/memory-core-host-runtime-files` | Допоміжні засоби файлів/runtime хоста пам’яті | Допоміжні засоби файлів/runtime хоста пам’яті | + | `plugin-sdk/memory-host-core` | Псевдонім core runtime хоста пам’яті | Нейтральний до vendor псевдонім для допоміжних засобів core runtime хоста пам’яті | + | `plugin-sdk/memory-host-events` | Псевдонім журналу подій хоста пам’яті | Нейтральний до vendor псевдонім для допоміжних засобів журналу подій хоста пам’яті | + | `plugin-sdk/memory-host-files` | Псевдонім файлів/runtime хоста пам’яті | Нейтральний до vendor псевдонім для допоміжних засобів файлів/runtime хоста пам’яті | + | `plugin-sdk/memory-host-markdown` | Допоміжні засоби керованого Markdown | Спільні допоміжні засоби керованого Markdown для суміжних із пам’яттю Plugin | + | `plugin-sdk/memory-host-search` | Фасад пошуку Active Memory | Лінивий фасад runtime менеджера пошуку active-memory | + | `plugin-sdk/memory-host-status` | Псевдонім статусу хоста пам’яті | Нейтральний до vendor псевдонім для допоміжних засобів статусу хоста пам’яті | + | `plugin-sdk/memory-lancedb` | Комплектні допоміжні засоби memory-lancedb | Поверхня допоміжних засобів memory-lancedb | + | `plugin-sdk/testing` | Утиліти тестування | Застарілий широкий barrel сумісності; надавайте перевагу цілеспрямованим test subpath, таким як `plugin-sdk/plugin-test-runtime`, `plugin-sdk/channel-test-helpers`, `plugin-sdk/channel-target-testing`, `plugin-sdk/test-env` і `plugin-sdk/test-fixtures` | -Ця таблиця навмисно містить поширену підмножину для міграції, а не всю -поверхню SDK. Повний список із понад 200 точок входу наведено в +Ця таблиця навмисно охоплює поширену підмножину для міграції, а не всю +поверхню SDK. Повний список із понад 200 entrypoint-ів міститься в `scripts/lib/plugin-sdk-entrypoints.json`. -Цей список усе ще містить деякі допоміжні seams для вбудованих Plugin, наприклад +Цей список усе ще містить деякі seams допоміжних засобів комплектних Plugin, такі як `plugin-sdk/feishu`, `plugin-sdk/feishu-setup`, `plugin-sdk/zalo`, `plugin-sdk/zalo-setup` і `plugin-sdk/matrix*`. Вони й надалі експортуються для -підтримки вбудованих Plugin і сумісності, але навмисно -не включені до загальної таблиці міграції та не є рекомендованою ціллю для +підтримки комплектних Plugin і сумісності, але навмисно +опущені з таблиці поширеної міграції та не є рекомендованою ціллю для нового коду Plugin. -Те саме правило застосовується до інших сімейств вбудованих helper-ів, наприклад: +Те саме правило застосовується і до інших сімейств комплектних допоміжних засобів, зокрема: -- helper-и підтримки браузера: `plugin-sdk/browser-cdp`, `plugin-sdk/browser-config-runtime`, `plugin-sdk/browser-config-support`, `plugin-sdk/browser-control-auth`, `plugin-sdk/browser-node-runtime`, `plugin-sdk/browser-profiles`, `plugin-sdk/browser-security-runtime`, `plugin-sdk/browser-setup-tools`, `plugin-sdk/browser-support` +- допоміжні засоби підтримки браузера: `plugin-sdk/browser-cdp`, `plugin-sdk/browser-config-runtime`, `plugin-sdk/browser-config-support`, `plugin-sdk/browser-control-auth`, `plugin-sdk/browser-node-runtime`, `plugin-sdk/browser-profiles`, `plugin-sdk/browser-security-runtime`, `plugin-sdk/browser-setup-tools`, `plugin-sdk/browser-support` - Matrix: `plugin-sdk/matrix*` - LINE: `plugin-sdk/line*` - IRC: `plugin-sdk/irc*` -- поверхні вбудованих helper-ів/Plugin, як-от `plugin-sdk/googlechat`, +- поверхні комплектних допоміжних засобів/Plugin, такі як `plugin-sdk/googlechat`, `plugin-sdk/zalouser`, `plugin-sdk/bluebubbles*`, `plugin-sdk/mattermost*`, `plugin-sdk/msteams`, `plugin-sdk/nextcloud-talk`, `plugin-sdk/nostr`, `plugin-sdk/tlon`, @@ -532,40 +531,40 @@ OpenClaw не видаляє і не переосмислює задокумен `plugin-sdk/diffs`, `plugin-sdk/llm-task`, `plugin-sdk/thread-ownership`, і `plugin-sdk/voice-call` -`plugin-sdk/github-copilot-token` наразі надає вузьку поверхню helper-ів для токенів: -`DEFAULT_COPILOT_API_BASE_URL`, +`plugin-sdk/github-copilot-token` наразі надає вузьку поверхню +допоміжних засобів токенів: `DEFAULT_COPILOT_API_BASE_URL`, `deriveCopilotApiBaseUrlFromToken` і `resolveCopilotApiToken`. -Використовуйте найвужчий імпорт, який відповідає конкретному завданню. Якщо ви не можете знайти експорт, -перевірте джерело в `src/plugin-sdk/` або запитайте в Discord. +Використовуйте найвужчий імпорт, який відповідає завданню. Якщо ви не можете знайти експорт, +перевірте вихідний код у `src/plugin-sdk/` або запитайте в Discord. ## Активні застарівання -Вужчі застарівання, що застосовуються в усьому Plugin SDK, контракті постачальника, -поверхні runtime і маніфесті. Кожен із них досі працює сьогодні, але буде видалений -у майбутньому мажорному релізі. Запис під кожним пунктом зіставляє старий API з його -канонічною заміною. +Вужчі застарівання, які застосовуються в усьому Plugin SDK, контракті provider, +поверхні runtime і маніфесті. Кожен із них іще працює сьогодні, але буде вилучений +у майбутньому мажорному випуску. Запис під кожним елементом зіставляє старий API +з його канонічною заміною. - + **Старе (`openclaw/plugin-sdk/command-auth`)**: `buildCommandsMessage`, `buildCommandsMessagePaginated`, `buildHelpMessage`. **Нове (`openclaw/plugin-sdk/command-status`)**: ті самі сигнатури, ті самі - експорти — лише імпортуються з вужчого підшляху. `command-auth` + експорти — лише імпортуються з вужчого subpath. `command-auth` повторно експортує їх як compat stubs. ```typescript - // До + // Before import { buildHelpMessage } from "openclaw/plugin-sdk/command-auth"; - // Після + // After import { buildHelpMessage } from "openclaw/plugin-sdk/command-status"; ``` - + **Старе**: `resolveInboundMentionRequirement({ facts, policy })` і `shouldDropInboundForMention(...)` з `openclaw/plugin-sdk/channel-inbound` або @@ -574,89 +573,88 @@ OpenClaw не видаляє і не переосмислює задокумен **Нове**: `resolveInboundMentionDecision({ facts, policy })` — повертає єдиний об’єкт рішення замість двох окремих викликів. - Downstream Plugin каналів (Slack, Discord, Matrix, Microsoft Teams) уже - перейшли на це. + Залежні Plugin каналів (Slack, Discord, Matrix, MS Teams) уже + перейшли. - + `openclaw/plugin-sdk/channel-runtime` — це shim сумісності для старіших Plugin каналів. Не імпортуйте його в новому коді; використовуйте `openclaw/plugin-sdk/channel-runtime-context` для реєстрації об’єктів runtime. - Helper-и `channelActions*` у `openclaw/plugin-sdk/channel-actions` є - застарілими разом із сирими експортами каналів "actions". Натомість відкривайте можливості - через семантичну поверхню `presentation` — Plugin каналів - оголошують, що саме вони рендерять (картки, кнопки, select-и), а не які сирі + Допоміжні засоби `channelActions*` у `openclaw/plugin-sdk/channel-actions` є + застарілими разом із сирими експортами каналу типу "actions". Натомість розкривайте + можливості через семантичну поверхню `presentation` — Plugin каналів + декларують, що саме вони рендерять (картки, кнопки, selects), а не які сирі назви дій вони приймають. - + **Старе**: фабрика `tool()` з `openclaw/plugin-sdk/provider-web-search`. - **Нове**: реалізуйте `createTool(...)` безпосередньо в Plugin постачальника. - OpenClaw більше не потребує helper-а SDK для реєстрації wrapper-а tool. + **Нове**: реалізуйте `createTool(...)` безпосередньо в Plugin provider. + OpenClaw більше не потребує допоміжного засобу SDK для реєстрації wrapper-а інструмента. - + **Старе**: `formatInboundEnvelope(...)` (і - `ChannelMessageForAgent.channelEnvelope`) для побудови плаского plaintext prompt + `ChannelMessageForAgent.channelEnvelope`) для побудови плоского текстового prompt envelope із вхідних повідомлень каналу. - **Нове**: `BodyForAgent` плюс структуровані блоки контексту користувача. Plugin - каналів додають метадані маршрутизації (thread, topic, reply-to, reactions) як - типізовані поля замість конкатенації їх у рядок prompt. Helper - `formatAgentEnvelope(...)` усе ще підтримується для синтезованих - envelope-ів, видимих асистенту, але plaintext envelope-и для вхідних повідомлень - поступово вилучаються. + **Нове**: `BodyForAgent` плюс структуровані блоки контексту користувача. + Plugin каналів додають метадані маршрутизації (thread, topic, reply-to, reactions) як + типізовані поля замість конкатенації їх у рядок prompt. Допоміжний засіб + `formatAgentEnvelope(...)` іще підтримується для синтезованих envelopes, + орієнтованих на асистента, але від вхідних текстових envelopes поступово відмовляються. - Зони впливу: `inbound_claim`, `message_received` і будь-який кастомний - Plugin каналу, який виконував постобробку тексту `channelEnvelope`. + Затронуті області: `inbound_claim`, `message_received` і будь-який власний + Plugin каналу, який постобробляв текст `channelEnvelope`. - - Чотири псевдоніми типів виявлення тепер є тонкими wrapper-ами над - типами епохи каталогу: + + Чотири псевдоніми типів discovery тепер є тонкими обгортками над + типами епохи catalog: - | Старий псевдонім | Новий тип | - | ------------------------- | ------------------------- | - | `ProviderDiscoveryOrder` | `ProviderCatalogOrder` | - | `ProviderDiscoveryContext`| `ProviderCatalogContext` | - | `ProviderDiscoveryResult` | `ProviderCatalogResult` | - | `ProviderPluginDiscovery` | `ProviderPluginCatalog` | + | Старий псевдонім | Новий тип | + | ------------------------- | ------------------------ | + | `ProviderDiscoveryOrder` | `ProviderCatalogOrder` | + | `ProviderDiscoveryContext`| `ProviderCatalogContext` | + | `ProviderDiscoveryResult` | `ProviderCatalogResult` | + | `ProviderPluginDiscovery` | `ProviderPluginCatalog` | - Плюс застарілий статичний пакет `ProviderCapabilities` — Plugin постачальників - повинні додавати факти можливостей через контракт runtime постачальника, + Плюс застарілий статичний набір `ProviderCapabilities` — Plugin provider + мають приєднувати факти capability через контракт runtime provider, а не через статичний об’єкт. - - **Старе** (три окремі hook-и в `ProviderThinkingPolicy`): + + **Старе** (три окремі хуки в `ProviderThinkingPolicy`): `isBinaryThinking(ctx)`, `supportsXHighThinking(ctx)` і `resolveDefaultThinkingLevel(ctx)`. **Нове**: єдиний `resolveThinkingProfile(ctx)`, який повертає `ProviderThinkingProfile` із канонічним `id`, необов’язковим `label` і - ранжованим списком рівнів. OpenClaw автоматично знижує застарілі збережені - значення за рангом профілю. + ранжованим списком рівнів. OpenClaw автоматично знижує застарілі збережені значення + за рангом профілю. - Реалізуйте один hook замість трьох. Застарілі hook-и продовжують працювати протягом - вікна застарівання, але не композиціонуються з результатом профілю. + Реалізуйте один хук замість трьох. Застарілі хуки й надалі працюють під час + вікна застарівання, але не композуються з результатом профілю. - + **Старе**: реалізація `resolveExternalOAuthProfiles(...)` без - оголошення постачальника в маніфесті Plugin. + оголошення provider у маніфесті Plugin. **Нове**: оголосіть `contracts.externalAuthProviders` у маніфесті Plugin **і** реалізуйте `resolveExternalAuthProfiles(...)`. Старий шлях - "auth fallback" виводить попередження в runtime і буде вилучений. + "auth fallback" виводить попередження під час runtime і буде вилучений. ```json { @@ -668,41 +666,41 @@ OpenClaw не видаляє і не переосмислює задокумен - + **Старе** поле маніфесту: `providerAuthEnvVars: { anthropic: ["ANTHROPIC_API_KEY"] }`. - **Нове**: віддзеркальте той самий пошук env-var у `setup.providers[].envVars` - у маніфесті. Це об’єднує метадані env для setup/status в одному - місці й дає змогу не запускати runtime Plugin лише для відповіді на - пошук env-var. + **Нове**: віддзеркальте той самий lookup env-var у `setup.providers[].envVars` + у маніфесті. Це об’єднує метадані env налаштування/статусу в одному + місці й дає змогу уникнути запуску runtime Plugin лише для відповіді на + lookup env-var. - `providerAuthEnvVars` залишається підтримуваним через адаптер сумісності + `providerAuthEnvVars` і надалі підтримується через адаптер сумісності до завершення вікна застарівання. - + **Старе**: три окремі виклики — `api.registerMemoryPromptSection(...)`, `api.registerMemoryFlushPlan(...)`, `api.registerMemoryRuntime(...)`. - **Нове**: один виклик API memory-state — + **Нове**: один виклик на API memory-state — `registerMemoryCapability(pluginId, { promptBuilder, flushPlanResolver, runtime })`. - Ті самі слоти, один виклик реєстрації. Додаткові helper-и memory + Ті самі слоти, єдиний виклик реєстрації. Адитивні допоміжні засоби пам’яті (`registerMemoryPromptSupplement`, `registerMemoryCorpusSupplement`, - `registerMemoryEmbeddingProvider`) не зачіпаються. + `registerMemoryEmbeddingProvider`) не зачеплено. - Два застарілі псевдоніми типів досі експортуються з `src/plugins/runtime/types.ts`: + Два застарілі псевдоніми типів іще експортуються з `src/plugins/runtime/types.ts`: - | Старе | Нове | - | ----------------------------- | ------------------------------- | - | `SubagentReadSessionParams` | `SubagentGetSessionMessagesParams` | - | `SubagentReadSessionResult` | `SubagentGetSessionMessagesResult` | + | Старе | Нове | + | ---------------------------- | ------------------------------ | + | `SubagentReadSessionParams` | `SubagentGetSessionMessagesParams` | + | `SubagentReadSessionResult` | `SubagentGetSessionMessagesResult` | Метод runtime `readSession` є застарілим на користь `getSessionMessages`. Та сама сигнатура; старий метод викликає @@ -711,26 +709,26 @@ OpenClaw не видаляє і не переосмислює задокумен - **Старе**: `runtime.tasks.flow` (однина) повертав живий accessor TaskFlow. + **Старе**: `runtime.tasks.flow` (в однині) повертав accessor live task-flow. - **Нове**: `runtime.tasks.flows` (множина) повертає DTO-орієнтований доступ до TaskFlow, - який безпечний для імпорту й не вимагає завантаження всього task runtime. + **Нове**: `runtime.tasks.flows` (у множині) повертає DTO-базований доступ до TaskFlow, + який є безпечним для імпорту й не потребує завантаження повного runtime задач. ```typescript - // До + // Before const flow = api.runtime.tasks.flow(ctx); - // Після + // After const flows = api.runtime.tasks.flows(ctx); ``` - Розглянуто вище в розділі "Як виконати міграцію → Мігруйте розширення Pi для результатів інструментів на - middleware". Тут наведено для повноти: вилучений шлях - `api.registerEmbeddedExtensionFactory(...)` лише для Pi замінено на - `api.registerAgentToolResultMiddleware(...)` із явним списком runtime - у `contracts.agentToolResultMiddleware`. + Розглянуто вище в розділі "Як виконати міграцію → Перенесіть розширення результатів інструментів Pi на + middleware". Для повноти тут також зазначено: вилучений шлях лише для Pi + `api.registerEmbeddedExtensionFactory(...)` замінено на + `api.registerAgentToolResultMiddleware(...)` з явним + списком runtime у `contracts.agentToolResultMiddleware`. @@ -738,9 +736,9 @@ OpenClaw не видаляє і не переосмислює задокумен однорядковим псевдонімом для `OpenClawConfig`. Надавайте перевагу канонічній назві. ```typescript - // До + // Before import type { OpenClawSchemaType } from "openclaw/plugin-sdk"; - // Після + // After import type { OpenClawConfig } from "openclaw/plugin-sdk/config-schema"; ``` @@ -748,26 +746,26 @@ OpenClaw не видаляє і не переосмислює задокумен -Застарівання на рівні extension (усередині вбудованих Plugin каналів/постачальників у -`extensions/`) відстежуються у власних barrel-файлах `api.ts` і `runtime-api.ts`. -Вони не впливають на сторонні контракти Plugin і тут не перелічені. -Якщо ви безпосередньо споживаєте локальний barrel вбудованого Plugin, перед оновленням -прочитайте коментарі про застарівання в цьому barrel-файлі. +Застарівання на рівні extension (усередині комплектних Plugin каналів/provider у +`extensions/`) відстежуються у власних barrels `api.ts` і `runtime-api.ts`. +Вони не впливають на контракти сторонніх Plugin і тут не перелічені. +Якщо ви напряму використовуєте локальний barrel комплектного Plugin, перед +оновленням прочитайте коментарі про застарівання в цьому barrel. ## Часова шкала вилучення -| Коли | Що відбувається | -| ---------------------- | ----------------------------------------------------------------------- | -| **Зараз** | Застарілі поверхні виводять попередження в runtime | -| **Наступний мажорний реліз** | Застарілі поверхні буде вилучено; Plugin, які все ще їх використовують, завершаться помилкою | +| Коли | Що відбувається | +| --------------------- | ----------------------------------------------------------------------- | +| **Зараз** | Застарілі поверхні виводять попередження runtime | +| **Наступний мажорний випуск** | Застарілі поверхні буде вилучено; Plugin, які все ще їх використовують, завершаться помилкою | -Усі основні Plugin уже мігровано. Зовнішні Plugin повинні виконати міграцію -до наступного мажорного релізу. +Усі core Plugin уже мігровано. Зовнішнім Plugin слід виконати міграцію +до наступного мажорного випуску. -## Тимчасове придушення попереджень +## Тимчасове приглушення попереджень -Під час роботи над міграцією встановіть ці змінні середовища: +Установіть ці змінні середовища, поки працюєте над міграцією: ```bash OPENCLAW_SUPPRESS_PLUGIN_SDK_COMPAT_WARNING=1 openclaw gateway run @@ -778,9 +776,9 @@ OPENCLAW_SUPPRESS_EXTENSION_API_WARNING=1 openclaw gateway run ## Пов’язане -- [Початок роботи](/uk/plugins/building-plugins) — створіть свій перший Plugin -- [Огляд SDK](/uk/plugins/sdk-overview) — повний довідник імпортів підшляхів +- [Початок роботи](/uk/plugins/building-plugins) — створення вашого першого Plugin +- [Огляд SDK](/uk/plugins/sdk-overview) — повний довідник імпортів subpath - [Plugin каналів](/uk/plugins/sdk-channel-plugins) — створення Plugin каналів -- [Plugin постачальників](/uk/plugins/sdk-provider-plugins) — створення Plugin постачальників -- [Внутрішня будова Plugin](/uk/plugins/architecture) — глибокий розбір архітектури +- [Plugin provider](/uk/plugins/sdk-provider-plugins) — створення Plugin provider +- [Внутрішня будова Plugin](/uk/plugins/architecture) — глибоке занурення в архітектуру - [Маніфест Plugin](/uk/plugins/manifest) — довідник схеми маніфесту diff --git a/docs/uk/plugins/sdk-subpaths.md b/docs/uk/plugins/sdk-subpaths.md index 272fc32b2..74cde113c 100644 --- a/docs/uk/plugins/sdk-subpaths.md +++ b/docs/uk/plugins/sdk-subpaths.md @@ -2,330 +2,330 @@ read_when: - Вибір правильного підшляху plugin-sdk для імпорту Plugin - Аудит підшляхів bundled-plugin і допоміжних поверхонь -summary: 'Каталог підшляхів Plugin SDK: які імпорти де розміщені, згруповані за областями' +summary: 'Каталог підшляхів Plugin SDK: які імпорти де розміщені, згруповано за областями' title: Підшляхи Plugin SDK x-i18n: - generated_at: "2026-04-28T02:44:53Z" + generated_at: "2026-04-28T03:09:57Z" model: gpt-5.4 provider: openai - source_hash: 0c4eab29c94c207a616599216655448dd33ab9e07be1a5391cd5fec63c07d93d + source_hash: 466bde9b1ba40a916e5d352497ff3c5c39758f075d6975d559c4207598ad659f source_path: plugins/sdk-subpaths.md workflow: 15 --- - Plugin SDK надається як набір вузьких підшляхів у `openclaw/plugin-sdk/`. - На цій сторінці зібрано найуживаніші підшляхи, згруповані за призначенням. Згенерований - повний список із понад 200 підшляхів розміщено в `scripts/lib/plugin-sdk-entrypoints.json`; - зарезервовані допоміжні підшляхи bundled-plugin також там наведені, але є деталлю + Plugin SDK доступний як набір вузьких підшляхів у `openclaw/plugin-sdk/`. + На цій сторінці наведено каталог найуживаніших підшляхів, згрупованих за призначенням. Згенерований + повний список із понад 200 підшляхів міститься в `scripts/lib/plugin-sdk-entrypoints.json`; + зарезервовані допоміжні підшляхи bundled-plugin також наведено там, але вони є деталлю реалізації, якщо лише сторінка документації явно не просуває їх. - Посібник з авторства Plugin див. у [Огляд Plugin SDK](/uk/plugins/sdk-overview). + Посібник з розробки Plugin див. у [Огляд Plugin SDK](/uk/plugins/sdk-overview). ## Точка входу Plugin - | Subpath | Ключові експорти | - | ----------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | - | `plugin-sdk/plugin-entry` | `definePluginEntry` | - | `plugin-sdk/core` | `defineChannelPluginEntry`, `createChatChannelPlugin`, `createChannelPluginBase`, `defineSetupPluginEntry`, `buildChannelConfigSchema` | - | `plugin-sdk/config-schema` | `OpenClawSchema` | - | `plugin-sdk/provider-entry` | `defineSingleProviderPluginEntry` | - | `plugin-sdk/testing` | Широкий сумісний barrel для застарілих тестів Plugin; для нових тестів extension віддавайте перевагу цільовим тестовим підшляхам | - | `plugin-sdk/plugin-test-api` | Мінімальний конструктор мока `OpenClawPluginApi` для прямих модульних тестів реєстрації Plugin | - | `plugin-sdk/agent-runtime-test-contracts` | Фікстури контрактів нативного адаптера agent-runtime для профілів автентифікації, пригнічення доставки, класифікації fallback, хуків інструментів, накладок prompt, схем і відновлення транскрипту | - | `plugin-sdk/channel-test-helpers` | Допоміжні засоби для життєвого циклу облікового запису каналу, каталогу, send-config, мока runtime, hook, bundled channel entry, часової мітки envelope, відповіді pairing і тестів загального контракту каналу | - | `plugin-sdk/channel-target-testing` | Спільний набір тестів випадків помилок розв’язання цілей каналу | - | `plugin-sdk/plugin-test-contracts` | Допоміжні засоби контрактів реєстрації Plugin, маніфесту пакета, публічного артефакту, runtime API, побічних ефектів імпорту та прямого імпорту | - | `plugin-sdk/plugin-test-runtime` | Фікстури runtime Plugin, реєстру, реєстрації provider, майстра налаштування та runtime TaskFlow для тестів | - | `plugin-sdk/provider-test-contracts` | Допоміжні засоби контрактів runtime provider, автентифікації, виявлення, onboard, каталогу, медіаможливостей, політики replay, realtime STT live-audio, web-search/fetch і майстра | - | `plugin-sdk/provider-http-test-mocks` | Opt-in моки HTTP/auth для Vitest для тестів provider, які перевіряють `plugin-sdk/provider-http` | - | `plugin-sdk/test-env` | Фікстури тестового середовища, fetch/network, disposable HTTP server, вхідного запиту, live-test, тимчасової файлової системи та керування часом | - | `plugin-sdk/test-fixtures` | Загальні тестові фікстури для CLI, sandbox, skill, agent-message, system-event, перезавантаження модуля, шляху bundled plugin, terminal, chunking, auth-token і typed-case | - | `plugin-sdk/test-node-mocks` | Цільові допоміжні засоби моків вбудованих модулів Node для використання всередині фабрик Vitest `vi.mock("node:*")` | - | `plugin-sdk/migration` | Допоміжні засоби елементів provider міграції, як-от `createMigrationItem`, константи причин, маркери статусу елемента, допоміжні засоби редагування та `summarizeMigrationItems` | - | `plugin-sdk/migration-runtime` | Допоміжні засоби runtime міграції, як-от `copyMigrationFileItem` і `writeMigrationReport` | + | Підшлях | Ключові експорти | + | ---------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | + | `plugin-sdk/plugin-entry` | `definePluginEntry` | + | `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` | Мінімальний збирач моків `OpenClawPluginApi` для прямих модульних тестів реєстрації Plugin | + | `plugin-sdk/agent-runtime-test-contracts` | Фікстури контрактів нативного адаптера agent-runtime для профілів автентифікації, пригнічення доставки, класифікації резервних сценаріїв, хуків інструментів, накладок промптів, схем і відновлення транскриптів | + | `plugin-sdk/channel-test-helpers` | Допоміжні засоби для тестування життєвого циклу облікового запису каналу, каталогу, send-config, мока runtime, хука, bundled channel entry, часової мітки envelope, відповіді на pairing і загальних контрактів каналу | + | `plugin-sdk/channel-target-testing` | Спільний набір тестів для випадків помилок під час визначення цілі каналу | + | `plugin-sdk/plugin-test-contracts` | Допоміжні засоби для контрактів реєстрації Plugin, маніфесту пакета, публічного артефакту, runtime API, побічних ефектів імпорту та прямого імпорту | + | `plugin-sdk/plugin-test-runtime` | Фікстури runtime Plugin, реєстру, реєстрації провайдера, майстра налаштування та TaskFlow runtime для тестів | + | `plugin-sdk/provider-test-contracts` | Допоміжні засоби для контрактів runtime провайдера, автентифікації, виявлення, онбордингу, каталогу, медіаможливостей, політики повтору, realtime STT live-audio, web-search/fetch і майстра | + | `plugin-sdk/provider-http-test-mocks` | Opt-in моки HTTP/автентифікації для Vitest у тестах провайдерів, які використовують `plugin-sdk/provider-http` | + | `plugin-sdk/test-env` | Фікстури тестового середовища, fetch/мережі, disposable HTTP server, вхідного запиту, live-тесту, тимчасової файлової системи та керування часом | + | `plugin-sdk/test-fixtures` | Загальні тестові фікстури для CLI, sandbox, skill, повідомлення агента, системної події, перезавантаження модуля, шляху bundled plugin, термінала, chunking, токена автентифікації та типізованого кейсу | + | `plugin-sdk/test-node-mocks` | Спеціалізовані допоміжні засоби для моків вбудованих модулів Node для використання у фабриках Vitest `vi.mock("node:*")` | + | `plugin-sdk/migration` | Допоміжні засоби елементів провайдера міграції, як-от `createMigrationItem`, константи причин, маркери статусу елементів, допоміжні засоби редагування та `summarizeMigrationItems` | + | `plugin-sdk/migration-runtime` | Допоміжні засоби runtime міграції, як-от `copyMigrationFileItem` і `writeMigrationReport` | - - | Subpath | Ключові експорти | + + | Підшлях | Ключові експорти | | --- | --- | | `plugin-sdk/channel-core` | `defineChannelPluginEntry`, `defineSetupPluginEntry`, `createChatChannelPlugin`, `createChannelPluginBase` | | `plugin-sdk/config-schema` | Експорт кореневої Zod-схеми `openclaw.json` (`OpenClawSchema`) | | `plugin-sdk/channel-setup` | `createOptionalChannelSetupSurface`, `createOptionalChannelSetupAdapter`, `createOptionalChannelSetupWizard`, а також `DEFAULT_ACCOUNT_ID`, `createTopLevelChannelDmPolicy`, `setSetupChannelEnabled`, `splitSetupEntries` | - | `plugin-sdk/setup` | Спільні допоміжні засоби майстра налаштування, запити allowlist, конструктори статусу налаштування | + | `plugin-sdk/setup` | Спільні допоміжні засоби майстра налаштування, allowlist-промптів і побудови статусу налаштування | | `plugin-sdk/setup-runtime` | `createPatchedAccountSetupAdapter`, `createEnvPatchedAccountSetupAdapter`, `createSetupInputPresenceValidator`, `noteChannelLookupFailure`, `noteChannelLookupSummary`, `promptResolvedAllowFrom`, `splitSetupEntries`, `createAllowlistSetupWizardProxy`, `createDelegatedSetupWizardProxy` | | `plugin-sdk/setup-adapter-runtime` | `createEnvPatchedAccountSetupAdapter` | | `plugin-sdk/setup-tools` | `formatCliCommand`, `detectBinary`, `extractArchive`, `resolveBrewExecutable`, `formatDocsLink`, `CONFIG_DIR` | - | `plugin-sdk/account-core` | Допоміжні засоби конфігурації/шлюзу дій для кількох облікових записів, допоміжні засоби fallback облікового запису за замовчуванням | - | `plugin-sdk/account-id` | `DEFAULT_ACCOUNT_ID`, допоміжні засоби нормалізації account-id | - | `plugin-sdk/account-resolution` | Допоміжні засоби пошуку облікового запису + fallback за замовчуванням | - | `plugin-sdk/account-helpers` | Вузькі допоміжні засоби списку облікових записів/дій з обліковими записами | + | `plugin-sdk/account-core` | Допоміжні засоби конфігурації/контролю дій для кількох облікових записів, а також fallback-засоби облікового запису за замовчуванням | + | `plugin-sdk/account-id` | `DEFAULT_ACCOUNT_ID`, допоміжні засоби нормалізації id облікового запису | + | `plugin-sdk/account-resolution` | Допоміжні засоби пошуку облікового запису + fallback до облікового запису за замовчуванням | + | `plugin-sdk/account-helpers` | Вузькі допоміжні засоби для списку облікових записів/дій облікового запису | | `plugin-sdk/channel-pairing` | `createChannelPairingController` | | `plugin-sdk/channel-reply-pipeline` | `createChannelReplyPipeline` | | `plugin-sdk/channel-config-helpers` | `createHybridChannelConfigAdapter` | - | `plugin-sdk/channel-config-schema` | Спільні примітиви схеми конфігурації каналу та загальний конструктор | + | `plugin-sdk/channel-config-schema` | Спільні примітиви схеми конфігурації каналу та універсальний збирач | | `plugin-sdk/bundled-channel-config-schema` | Схеми конфігурації bundled OpenClaw channel лише для підтримуваних bundled Plugin | - | `plugin-sdk/channel-config-schema-legacy` | Застарілий псевдонім сумісності для bundled-channel config schemas | - | `plugin-sdk/telegram-command-config` | Допоміжні засоби нормалізації/валідації користувацьких команд Telegram із fallback bundled-contract | - | `plugin-sdk/command-gating` | Вузькі допоміжні засоби шлюзу авторизації команд | + | `plugin-sdk/channel-config-schema-legacy` | Застарілий сумісний псевдонім для bundled-channel config schemas | + | `plugin-sdk/telegram-command-config` | Допоміжні засоби нормалізації/валідації користувацьких команд Telegram із fallback на bundled-contract | + | `plugin-sdk/command-gating` | Вузькі допоміжні засоби контролю авторизації команд | | `plugin-sdk/channel-policy` | `resolveChannelGroupRequireMention` | - | `plugin-sdk/channel-lifecycle` | `createAccountStatusSink`, допоміжні засоби життєвого циклу/фіналізації потоку чернеток | - | `plugin-sdk/inbound-envelope` | Спільні допоміжні засоби вхідного маршруту + конструктора envelope | - | `plugin-sdk/inbound-reply-dispatch` | Спільні допоміжні засоби запису й диспетчеризації вхідних відповідей | + | `plugin-sdk/channel-lifecycle` | `createAccountStatusSink`, допоміжні засоби життєвого циклу/завершення потоку чернеток | + | `plugin-sdk/inbound-envelope` | Спільні допоміжні засоби для вхідного маршруту + побудови envelope | + | `plugin-sdk/inbound-reply-dispatch` | Спільні допоміжні засоби запису та диспетчеризації вхідних даних | | `plugin-sdk/messaging-targets` | Допоміжні засоби розбору/зіставлення цілей | | `plugin-sdk/outbound-media` | Спільні допоміжні засоби завантаження вихідних медіа | - | `plugin-sdk/outbound-send-deps` | Полегшений пошук залежностей вихідного надсилання для адаптерів каналу | - | `plugin-sdk/outbound-runtime` | Допоміжні засоби вихідної доставки, ідентичності, делегата надсилання, сесії, форматування та планування payload | + | `plugin-sdk/outbound-send-deps` | Легковаговий пошук залежностей надсилання вихідних даних для адаптерів каналів | + | `plugin-sdk/outbound-runtime` | Допоміжні засоби runtime для вихідної доставки, ідентичності, делегата надсилання, сесії, форматування та планування payload | | `plugin-sdk/poll-runtime` | Вузькі допоміжні засоби нормалізації poll | - | `plugin-sdk/thread-bindings-runtime` | Допоміжні засоби життєвого циклу thread-binding та адаптера | - | `plugin-sdk/agent-media-payload` | Застарілий конструктор payload медіа агента | - | `plugin-sdk/conversation-runtime` | Допоміжні засоби прив’язки conversation/thread, pairing і configured-binding | - | `plugin-sdk/runtime-config-snapshot` | Допоміжний засіб знімка конфігурації runtime | - | `plugin-sdk/runtime-group-policy` | Допоміжні засоби розв’язання group-policy у runtime | - | `plugin-sdk/channel-status` | Спільні допоміжні засоби знімка/зведення стану каналу | - | `plugin-sdk/channel-config-primitives` | Вузькі примітиви channel config-schema | + | `plugin-sdk/thread-bindings-runtime` | Допоміжні засоби життєвого циклу thread-binding і адаптера | + | `plugin-sdk/agent-media-payload` | Застарілий збирач 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` | Допоміжні засоби визначення group-policy у runtime | + | `plugin-sdk/channel-status` | Спільні допоміжні засоби snapshot/summary статусу каналу | + | `plugin-sdk/channel-config-primitives` | Вузькі примітиви схеми конфігурації каналу | | `plugin-sdk/channel-config-writes` | Допоміжні засоби авторизації запису конфігурації каналу | - | `plugin-sdk/channel-plugin-common` | Спільні prelude-експорти Plugin каналу | + | `plugin-sdk/channel-plugin-common` | Спільні prelude-експорти для channel plugin | | `plugin-sdk/allowlist-config-edit` | Допоміжні засоби редагування/читання конфігурації allowlist | - | `plugin-sdk/group-access` | Спільні допоміжні засоби визначення group-access | - | `plugin-sdk/direct-dm` | Спільні допоміжні засоби автентифікації/захисту direct-DM | + | `plugin-sdk/group-access` | Спільні допоміжні засоби для рішень щодо group-access | + | `plugin-sdk/direct-dm` | Спільні допоміжні засоби авторизації/захисту direct-DM | | `plugin-sdk/interactive-runtime` | Семантичне представлення повідомлень, доставка та застарілі допоміжні засоби інтерактивних відповідей. Див. [Представлення повідомлень](/uk/plugins/message-presentation) | - | `plugin-sdk/channel-inbound` | Barrel сумісності для вхідного debounce, зіставлення mention, допоміжних засобів mention-policy та envelope helpers | + | `plugin-sdk/channel-inbound` | Сумісний barrel для вхідного debounce, зіставлення згадок, допоміжних засобів mention-policy та envelope | | `plugin-sdk/channel-inbound-debounce` | Вузькі допоміжні засоби вхідного debounce | - | `plugin-sdk/channel-mention-gating` | Вузькі допоміжні засоби mention-policy, маркерів mention і тексту mention без ширшої поверхні inbound runtime | + | `plugin-sdk/channel-mention-gating` | Вузькі допоміжні засоби mention-policy, маркерів згадок і тексту згадок без ширшої поверхні inbound runtime | | `plugin-sdk/channel-envelope` | Вузькі допоміжні засоби форматування вхідного envelope | | `plugin-sdk/channel-location` | Допоміжні засоби контексту та форматування розташування каналу | - | `plugin-sdk/channel-logging` | Допоміжні засоби логування каналу для скидання вхідних повідомлень і збоїв typing/ack | - | `plugin-sdk/channel-send-result` | Типи результату відповіді | + | `plugin-sdk/channel-logging` | Допоміжні засоби логування каналу для відкинутих вхідних даних і збоїв typing/ack | + | `plugin-sdk/channel-send-result` | Типи результатів відповіді | | `plugin-sdk/channel-actions` | Допоміжні засоби дій із повідомленнями каналу, а також застарілі допоміжні засоби нативної схеми, збережені для сумісності Plugin | - | `plugin-sdk/channel-route` | Спільні допоміжні засоби нормалізації маршруту, розв’язання цілей на основі parser, перетворення thread-id на рядок, dedupe/compact ключів маршруту, типів parsed-target і порівняння route/target | - | `plugin-sdk/channel-targets` | Допоміжні засоби розбору цілей; викликачам порівняння маршрутів слід використовувати `plugin-sdk/channel-route` | - | `plugin-sdk/channel-contract` | Типи контракту каналу | + | `plugin-sdk/channel-route` | Спільні допоміжні засоби нормалізації маршрутів, визначення цілей на основі парсера, перетворення thread-id на рядок, dedupe/compact ключів маршруту, типів parsed-target, а також порівняння маршрутів/цілей | + | `plugin-sdk/channel-targets` | Допоміжні засоби розбору цілей; виклики порівняння маршрутів мають використовувати `plugin-sdk/channel-route` | + | `plugin-sdk/channel-contract` | Типи контрактів каналу | | `plugin-sdk/channel-feedback` | Підключення feedback/reaction | - | `plugin-sdk/channel-secret-runtime` | Вузькі допоміжні засоби secret-contract, як-от `collectSimpleChannelFieldAssignments`, `getChannelSurface`, `pushAssignment`, і типи цілей secret | + | `plugin-sdk/channel-secret-runtime` | Вузькі допоміжні засоби secret-contract, як-от `collectSimpleChannelFieldAssignments`, `getChannelSurface`, `pushAssignment`, а також типи цілей секретів | - - | Subpath | Ключові експорти | + + | Підшлях | Ключові експорти | | --- | --- | | `plugin-sdk/provider-entry` | `defineSingleProviderPluginEntry` | - | `plugin-sdk/lmstudio` | Підтримуваний фасад provider LM Studio для налаштування, виявлення каталогу та підготовки моделі в runtime | - | `plugin-sdk/lmstudio-runtime` | Підтримуваний фасад runtime LM Studio для локальних стандартів сервера, виявлення моделей, заголовків запитів і допоміжних засобів loaded-model | - | `plugin-sdk/provider-setup` | Кураторські допоміжні засоби налаштування локального/self-hosted provider | - | `plugin-sdk/self-hosted-provider-setup` | Цільові допоміжні засоби налаштування self-hosted provider, сумісного з OpenAI | - | `plugin-sdk/cli-backend` | Стандартні значення бекенда CLI + константи watchdog | - | `plugin-sdk/provider-auth-runtime` | Допоміжні засоби розв’язання API-key у runtime для plugin provider | - | `plugin-sdk/provider-auth-api-key` | Допоміжні засоби onboard/profile-write для API-key, як-от `upsertApiKeyProfile` | - | `plugin-sdk/provider-auth-result` | Стандартний конструктор auth-result для OAuth | - | `plugin-sdk/provider-auth-login` | Спільні допоміжні засоби інтерактивного входу для plugin provider | - | `plugin-sdk/provider-env-vars` | Допоміжні засоби пошуку auth env-var provider | + | `plugin-sdk/lmstudio` | Підтримуваний фасад провайдера LM Studio для налаштування, виявлення каталогу та підготовки моделей у runtime | + | `plugin-sdk/lmstudio-runtime` | Підтримуваний фасад runtime LM Studio для стандартних параметрів локального сервера, виявлення моделей, заголовків запитів і допоміжних засобів для завантажених моделей | + | `plugin-sdk/provider-setup` | Кураторські допоміжні засоби налаштування локальних/self-hosted провайдерів | + | `plugin-sdk/self-hosted-provider-setup` | Спеціалізовані допоміжні засоби налаштування self-hosted провайдерів, сумісних з OpenAI | + | `plugin-sdk/cli-backend` | Стандартні параметри бекенда CLI + константи watchdog | + | `plugin-sdk/provider-auth-runtime` | Допоміжні засоби визначення API-ключів у runtime для Plugin провайдерів | + | `plugin-sdk/provider-auth-api-key` | Допоміжні засоби онбордингу/запису профілю API-ключа, як-от `upsertApiKeyProfile` | + | `plugin-sdk/provider-auth-result` | Стандартний збирач auth-result для OAuth | + | `plugin-sdk/provider-auth-login` | Спільні допоміжні засоби інтерактивного входу для Plugin провайдерів | + | `plugin-sdk/provider-env-vars` | Допоміжні засоби пошуку env vars для автентифікації провайдера | | `plugin-sdk/provider-auth` | `createProviderApiKeyAuthMethod`, `ensureApiKeyFromOptionEnvOrPrompt`, `upsertAuthProfile`, `upsertApiKeyProfile`, `writeOAuthCredentials` | - | `plugin-sdk/provider-model-shared` | `ProviderReplayFamily`, `buildProviderReplayFamilyHooks`, `normalizeModelCompat`, спільні конструктори replay-policy, допоміжні засоби endpoint provider і допоміжні засоби нормалізації model-id, як-от `normalizeNativeXaiModelId` | - | `plugin-sdk/provider-catalog-runtime` | Хук runtime для розширення каталогу provider і шви реєстру plugin-provider для контрактних тестів | + | `plugin-sdk/provider-model-shared` | `ProviderReplayFamily`, `buildProviderReplayFamilyHooks`, `normalizeModelCompat`, спільні збирачі replay-policy, допоміжні засоби endpoint провайдера та нормалізації model-id, як-от `normalizeNativeXaiModelId` | + | `plugin-sdk/provider-catalog-runtime` | Хук runtime для розширення каталогу провайдера та стики реєстру plugin-provider для контрактних тестів | | `plugin-sdk/provider-catalog-shared` | `findCatalogTemplate`, `buildSingleProviderApiKeyCatalog`, `supportsNativeStreamingUsageCompat`, `applyProviderNativeStreamingUsageCompat` | - | `plugin-sdk/provider-http` | Загальні допоміжні засоби HTTP/endpoint capability provider, помилки HTTP provider і допоміжні засоби multipart form для аудіотранскрипції | + | `plugin-sdk/provider-http` | Загальні допоміжні засоби для HTTP/можливостей endpoint провайдера, HTTP-помилки провайдера та допоміжні засоби multipart form для транскрипції аудіо | | `plugin-sdk/provider-web-fetch-contract` | Вузькі допоміжні засоби контракту config/selection для web-fetch, як-от `enablePluginInConfig` і `WebFetchProviderPlugin` | - | `plugin-sdk/provider-web-fetch` | Допоміжні засоби реєстрації/кешування provider web-fetch | - | `plugin-sdk/provider-web-search-config-contract` | Вузькі допоміжні засоби config/credential для web-search для provider, яким не потрібне підключення enable plugin | - | `plugin-sdk/provider-web-search-contract` | Вузькі допоміжні засоби контракту config/credential для web-search, як-от `createWebSearchProviderContractFields`, `enablePluginInConfig`, `resolveProviderWebSearchPluginConfig` і setter/getter облікових даних з обмеженою областю дії | - | `plugin-sdk/provider-web-search` | Допоміжні засоби реєстрації/кешування/runtime provider web-search | - | `plugin-sdk/provider-tools` | `ProviderToolCompatFamily`, `buildProviderToolCompatFamilyHooks`, очищення схеми Gemini + діагностика, а також допоміжні засоби сумісності xAI, як-от `resolveXaiModelCompatPatch` / `applyXaiModelCompat` | + | `plugin-sdk/provider-web-fetch` | Допоміжні засоби реєстрації/кешування провайдера web-fetch | + | `plugin-sdk/provider-web-search-config-contract` | Вузькі допоміжні засоби config/credential для web-search для провайдерів, яким не потрібне підключення enable Plugin | + | `plugin-sdk/provider-web-search-contract` | Вузькі допоміжні засоби контракту config/credential для web-search, як-от `createWebSearchProviderContractFields`, `enablePluginInConfig`, `resolveProviderWebSearchPluginConfig` і setter/getter облікових даних в обмеженій області | + | `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`, типи обгорток stream і спільні допоміжні засоби обгорток Anthropic/Bedrock/DeepSeek V4/Google/Kilocode/Moonshot/OpenAI/OpenRouter/Z.A.I/MiniMax/Copilot | - | `plugin-sdk/provider-transport-runtime` | Нативні допоміжні засоби транспорту provider, як-от guarded fetch, перетворення transport message і потоки подій writable transport | - | `plugin-sdk/provider-onboard` | Допоміжні засоби виправлення конфігурації onboarding | + | `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` | Нативні допоміжні засоби транспорту провайдера, як-от guarded fetch, перетворення транспортних повідомлень і потоки подій транспорту з можливістю запису | + | `plugin-sdk/provider-onboard` | Допоміжні засоби patch конфігурації онбордингу | | `plugin-sdk/global-singleton` | Допоміжні засоби process-local singleton/map/cache | | `plugin-sdk/group-activation` | Вузькі допоміжні засоби режиму активації групи та розбору команд | - | Subpath | Ключові експорти | + | Підшлях | Ключові експорти | | --- | --- | - | `plugin-sdk/command-auth` | `resolveControlCommandGate`, допоміжні засоби реєстру команд, включно з форматуванням меню динамічних аргументів, допоміжні засоби авторизації відправника | - | `plugin-sdk/command-status` | Конструктори повідомлень команд/довідки, як-от `buildCommandsMessagePaginated` і `buildHelpMessage` | - | `plugin-sdk/approval-auth-runtime` | Допоміжні засоби розв’язання approver і авторизації дій у тому самому чаті | - | `plugin-sdk/approval-client-runtime` | Нативні допоміжні засоби профілю/фільтра approval exec | - | `plugin-sdk/approval-delivery-runtime` | Нативні адаптери можливостей/доставки approval | - | `plugin-sdk/approval-gateway-runtime` | Спільний допоміжний засіб розв’язання Gateway approval | - | `plugin-sdk/approval-handler-adapter-runtime` | Полегшені нативні допоміжні засоби завантаження адаптера approval для гарячих точок входу каналу | - | `plugin-sdk/approval-handler-runtime` | Ширші допоміжні засоби runtime обробника approval; віддавайте перевагу вужчим швам adapter/gateway, коли їх достатньо | - | `plugin-sdk/approval-native-runtime` | Нативні допоміжні засоби цілі approval + прив’язки облікового запису | - | `plugin-sdk/approval-reply-runtime` | Допоміжні засоби payload відповіді approval для exec/plugin | - | `plugin-sdk/approval-runtime` | Допоміжні засоби payload approval для exec/plugin, нативні допоміжні засоби маршрутизації/runtime approval і структуровані допоміжні засоби відображення approval, як-от `formatApprovalDisplayPath` | - | `plugin-sdk/reply-dedupe` | Вузькі допоміжні засоби скидання dedupe вхідних відповідей | - | `plugin-sdk/channel-contract-testing` | Вузькі допоміжні засоби тестування контракту каналу без широкого testing barrel | - | `plugin-sdk/command-auth-native` | Нативна автентифікація команд, форматування меню динамічних аргументів і нативні допоміжні засоби session-target | + | `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` | Ширші допоміжні засоби 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` | Вузькі допоміжні засоби тестування контрактів каналу без широкого testing barrel | + | `plugin-sdk/command-auth-native` | Нативні допоміжні засоби автентифікації команд, форматування меню динамічних аргументів і нативних session-target | | `plugin-sdk/command-detection` | Спільні допоміжні засоби виявлення команд | - | `plugin-sdk/command-primitives-runtime` | Полегшені предикати тексту команд для гарячих шляхів каналу | - | `plugin-sdk/command-surface` | Допоміжні засоби нормалізації command-body і command-surface | + | `plugin-sdk/command-primitives-runtime` | Легковагові предикати тексту команд для гарячих шляхів каналів | + | `plugin-sdk/command-surface` | Допоміжні засоби нормалізації тіла команди та command-surface | | `plugin-sdk/allow-from` | `formatAllowFromLowercase` | - | `plugin-sdk/channel-secret-runtime` | Вузькі допоміжні засоби збирання secret-contract для поверхонь secret каналу/plugin | - | `plugin-sdk/secret-ref-runtime` | Вузькі допоміжні засоби типізації `coerceSecretRef` і SecretRef для розбору secret-contract/config | - | `plugin-sdk/security-runtime` | Спільні допоміжні засоби довіри, DM gating, зовнішнього вмісту, редагування чутливого тексту, порівняння secret за константний час і збирання secret | - | `plugin-sdk/ssrf-policy` | Допоміжні засоби host allowlist і політики SSRF для приватної мережі | - | `plugin-sdk/ssrf-dispatcher` | Вузькі допоміжні засоби pinned-dispatcher без широкої поверхні runtime інфраструктури | - | `plugin-sdk/ssrf-runtime` | Допоміжні засоби pinned-dispatcher, fetch із захистом SSRF, помилки SSRF і політики SSRF | + | `plugin-sdk/channel-secret-runtime` | Вузькі допоміжні засоби збирання secret-contract для поверхонь секретів channel/plugin | + | `plugin-sdk/secret-ref-runtime` | Вузькі допоміжні засоби `coerceSecretRef` і типізації SecretRef для розбору secret-contract/config | + | `plugin-sdk/security-runtime` | Спільні допоміжні засоби для довіри, DM gating, зовнішнього вмісту, редагування чутливого тексту, порівняння секретів за сталий час і збирання секретів | + | `plugin-sdk/ssrf-policy` | Допоміжні засоби політики SSRF для allowlist хостів і приватних мереж | + | `plugin-sdk/ssrf-dispatcher` | Вузькі допоміжні засоби pinned-dispatcher без широкої поверхні infra runtime | + | `plugin-sdk/ssrf-runtime` | Допоміжні засоби pinned-dispatcher, fetch із захистом SSRF, помилок SSRF і політики SSRF | | `plugin-sdk/secret-input` | Допоміжні засоби розбору secret input | - | `plugin-sdk/webhook-ingress` | Допоміжні засоби запитів/цілей Webhook і приведення raw websocket/body | - | `plugin-sdk/webhook-request-guards` | Допоміжні засоби розміру body/timeout запиту | + | `plugin-sdk/webhook-ingress` | Допоміжні засоби запиту/цілі Webhook і приведення raw websocket/body | + | `plugin-sdk/webhook-request-guards` | Допоміжні засоби обмеження розміру body/timeout запиту | - | Subpath | Ключові експорти | + | Підшлях | Ключові експорти | | --- | --- | - | `plugin-sdk/runtime` | Широкі допоміжні засоби runtime/logging/backup/встановлення Plugin | - | `plugin-sdk/runtime-env` | Вузькі допоміжні засоби runtime env, logger, timeout, retry і backoff | - | `plugin-sdk/browser-config` | Підтримуваний фасад конфігурації браузера для нормалізованого профілю/стандартних значень, розбору URL CDP і допоміжних засобів автентифікації browser-control | + | `plugin-sdk/runtime` | Широкі допоміжні засоби для runtime/логування/резервного копіювання/встановлення Plugin | + | `plugin-sdk/runtime-env` | Вузькі допоміжні засоби для env runtime, logger, timeout, retry і backoff | + | `plugin-sdk/browser-config` | Підтримуваний фасад конфігурації браузера для нормалізованого профілю/параметрів за замовчуванням, розбору URL CDP і допоміжних засобів автентифікації browser-control | | `plugin-sdk/channel-runtime-context` | Загальні допоміжні засоби реєстрації та пошуку channel runtime-context | | `plugin-sdk/runtime-store` | `createPluginRuntimeStore` | - | `plugin-sdk/plugin-runtime` | Спільні допоміжні засоби команд/hook/http/interactive для Plugin | - | `plugin-sdk/hook-runtime` | Спільні допоміжні засоби pipeline для webhook/internal hook | - | `plugin-sdk/lazy-runtime` | Допоміжні засоби lazy імпорту/прив’язки runtime, як-от `createLazyRuntimeModule`, `createLazyRuntimeMethod` і `createLazyRuntimeSurface` | - | `plugin-sdk/process-runtime` | Допоміжні засоби виконання process | + | `plugin-sdk/plugin-runtime` | Спільні допоміжні засоби для команд/хуків/http/інтерактивних функцій Plugin | + | `plugin-sdk/hook-runtime` | Спільні допоміжні засоби конвеєра Webhook/внутрішніх хуків | + | `plugin-sdk/lazy-runtime` | Допоміжні засоби lazy-імпорту/прив’язки runtime, як-от `createLazyRuntimeModule`, `createLazyRuntimeMethod` і `createLazyRuntimeSurface` | + | `plugin-sdk/process-runtime` | Допоміжні засоби виконання процесів | | `plugin-sdk/cli-runtime` | Допоміжні засоби форматування CLI, очікування, версії, виклику аргументів і lazy command-group | - | `plugin-sdk/gateway-runtime` | Допоміжні засоби клієнта Gateway, Gateway CLI RPC, помилок протоколу Gateway і виправлення channel-status | - | `plugin-sdk/config-types` | Поверхня конфігурації лише для типів для форм конфігурації Plugin, як-от `OpenClawConfig` і типів конфігурації channel/provider | + | `plugin-sdk/gateway-runtime` | Допоміжні засоби клієнта Gateway, CLI RPC Gateway, помилок протоколу Gateway і patch статусу каналу | + | `plugin-sdk/config-types` | Поверхня конфігурації лише для типів для форм конфігурації Plugin, як-от `OpenClawConfig` і типів конфігурації каналів/провайдерів | | `plugin-sdk/plugin-config-runtime` | Допоміжні засоби пошуку plugin-config у runtime, як-от `requireRuntimeConfig`, `resolvePluginConfigObject` і `resolveLivePluginConfigObject` | | `plugin-sdk/config-mutation` | Допоміжні засоби транзакційної мутації конфігурації, як-от `mutateConfigFile`, `replaceConfigFile` і `logConfigUpdated` | - | `plugin-sdk/runtime-config-snapshot` | Допоміжні засоби знімка конфігурації поточного процесу, як-от `getRuntimeConfig`, `getRuntimeConfigSnapshot` і setter-и тестових знімків | - | `plugin-sdk/telegram-command-config` | Допоміжні засоби нормалізації назви/опису команди Telegram і перевірки дублікатів/конфліктів, навіть коли поверхня bundled-контракту Telegram недоступна | - | `plugin-sdk/text-autolink-runtime` | Виявлення autolink посилань на файли без широкого barrel text-runtime | - | `plugin-sdk/approval-runtime` | Допоміжні засоби approval для exec/plugin, конструктори approval-capability, допоміжні засоби auth/profile, нативні допоміжні засоби маршрутизації/runtime і форматування шляху структурованого відображення approval | - | `plugin-sdk/reply-runtime` | Спільні допоміжні засоби runtime для inbound/reply, chunking, dispatch, Heartbeat, планувальник reply | - | `plugin-sdk/reply-dispatch-runtime` | Вузькі допоміжні засоби dispatch/finalize reply і допоміжні засоби conversation-label | - | `plugin-sdk/reply-history` | Спільні допоміжні засоби коротковіконної history reply і маркери, як-от `buildHistoryContext`, `HISTORY_CONTEXT_MARKER`, `recordPendingHistoryEntry` і `clearHistoryEntriesIfEnabled` | + | `plugin-sdk/runtime-config-snapshot` | Допоміжні засоби snapshot конфігурації поточного процесу, як-от `getRuntimeConfig`, `getRuntimeConfigSnapshot` і setter-и test snapshot | + | `plugin-sdk/telegram-command-config` | Допоміжні засоби нормалізації назв/описів команд Telegram і перевірок дублікатів/конфліктів, навіть коли поверхня контракту bundled Telegram недоступна | + | `plugin-sdk/text-autolink-runtime` | Виявлення автопосилань на файлові посилання без широкого text-runtime barrel | + | `plugin-sdk/approval-runtime` | Допоміжні засоби схвалення exec/plugin, збирачі approval-capability, допоміжні засоби auth/profile, нативні допоміжні засоби routing/runtime і форматування структурованого шляху відображення схвалення | + | `plugin-sdk/reply-runtime` | Спільні допоміжні засоби runtime для inbound/reply, chunking, dispatch, Heartbeat, planner відповіді | + | `plugin-sdk/reply-dispatch-runtime` | Вузькі допоміжні засоби dispatch/finalize відповіді та ярликів conversation | + | `plugin-sdk/reply-history` | Спільні допоміжні засоби history відповідей для короткого вікна та маркери, як-от `buildHistoryContext`, `HISTORY_CONTEXT_MARKER`, `recordPendingHistoryEntry` і `clearHistoryEntriesIfEnabled` | | `plugin-sdk/reply-reference` | `createReplyReferencePlanner` | - | `plugin-sdk/reply-chunking` | Вузькі допоміжні засоби chunking text/markdown | + | `plugin-sdk/reply-chunking` | Вузькі допоміжні засоби chunking тексту/markdown | | `plugin-sdk/session-store-runtime` | Допоміжні засоби шляху сховища сесій, session-key, updated-at і мутації сховища | - | `plugin-sdk/cron-store-runtime` | Допоміжні засоби шляху/load/save для сховища Cron | - | `plugin-sdk/state-paths` | Допоміжні засоби шляхів каталогів state/OAuth | - | `plugin-sdk/routing` | Допоміжні засоби прив’язки route/session-key/account, як-от `resolveAgentRoute`, `buildAgentSessionKey` і `resolveDefaultAgentBoundAccountId` | - | `plugin-sdk/status-helpers` | Спільні допоміжні засоби зведення статусу каналу/облікового запису, стандартні значення runtime-state і допоміжні засоби метаданих issue | - | `plugin-sdk/target-resolver-runtime` | Спільні допоміжні засоби розв’язання цілей | + | `plugin-sdk/cron-store-runtime` | Допоміжні засоби шляху/load/save сховища Cron | + | `plugin-sdk/state-paths` | Допоміжні засоби шляхів каталогів State/OAuth | + | `plugin-sdk/routing` | Допоміжні засоби маршруту/ключа сесії/прив’язки облікового запису, як-от `resolveAgentRoute`, `buildAgentSessionKey` і `resolveDefaultAgentBoundAccountId` | + | `plugin-sdk/status-helpers` | Спільні допоміжні засоби summary статусу каналу/облікового запису, стандартні параметри runtime-state і допоміжні засоби метаданих проблем | + | `plugin-sdk/target-resolver-runtime` | Спільні допоміжні засоби target resolver | | `plugin-sdk/string-normalization-runtime` | Допоміжні засоби нормалізації slug/рядків | - | `plugin-sdk/request-url` | Видобування рядкових URL із входів, подібних до fetch/request | - | `plugin-sdk/run-command` | Виконавець команд із таймером і нормалізованими результатами stdout/stderr | - | `plugin-sdk/param-readers` | Загальні читачі параметрів tool/CLI | - | `plugin-sdk/tool-payload` | Видобування нормалізованих payload з об’єктів результатів tool | - | `plugin-sdk/tool-send` | Видобування канонічних полів цілі надсилання з аргументів tool | - | `plugin-sdk/temp-path` | Спільні допоміжні засоби шляхів тимчасового завантаження | - | `plugin-sdk/logging-core` | Допоміжні засоби logger підсистеми та редагування | + | `plugin-sdk/request-url` | Витягування рядкових URL з вхідних даних типу fetch/request | + | `plugin-sdk/run-command` | Запускач команд із таймером і нормалізованими результатами stdout/stderr | + | `plugin-sdk/param-readers` | Поширені читачі параметрів tool/CLI | + | `plugin-sdk/tool-payload` | Витягування нормалізованих payload з об’єктів результатів tool | + | `plugin-sdk/tool-send` | Витягування канонічних полів цілі надсилання з аргументів tool | + | `plugin-sdk/temp-path` | Спільні допоміжні засоби шляху тимчасового завантаження | + | `plugin-sdk/logging-core` | Допоміжні засоби логера підсистеми та редагування | | `plugin-sdk/markdown-table-runtime` | Допоміжні засоби режиму та перетворення таблиць Markdown | - | `plugin-sdk/model-session-runtime` | Допоміжні засоби перевизначення model/session, як-от `applyModelOverrideToSessionEntry` і `resolveAgentMaxConcurrent` | - | `plugin-sdk/talk-config-runtime` | Допоміжні засоби розв’язання конфігурації talk provider | - | `plugin-sdk/json-store` | Невеликі допоміжні засоби читання/запису стану JSON | + | `plugin-sdk/model-session-runtime` | Допоміжні засоби перевизначення моделі/сесії, як-от `applyModelOverrideToSessionEntry` і `resolveAgentMaxConcurrent` | + | `plugin-sdk/talk-config-runtime` | Допоміжні засоби визначення конфігурації talk provider | + | `plugin-sdk/json-store` | Невеликі допоміжні засоби читання/запису JSON state | | `plugin-sdk/file-lock` | Реентерабельні допоміжні засоби file-lock | - | `plugin-sdk/persistent-dedupe` | Допоміжні засоби кешу dedupe з дисковою підтримкою | - | `plugin-sdk/acp-runtime` | Допоміжні засоби runtime/session і reply-dispatch для ACP | - | `plugin-sdk/acp-binding-resolve-runtime` | Розв’язання прив’язок ACP лише для читання без імпортів запуску життєвого циклу | - | `plugin-sdk/agent-config-primitives` | Вузькі примітиви config-schema runtime агента | + | `plugin-sdk/persistent-dedupe` | Допоміжні засоби кешу дедуплікації з дисковим backing | + | `plugin-sdk/acp-runtime` | Допоміжні засоби runtime/сесії ACP і reply-dispatch | + | `plugin-sdk/acp-binding-resolve-runtime` | Визначення прив’язки ACP лише для читання без імпортів запуску життєвого циклу | + | `plugin-sdk/agent-config-primitives` | Вузькі примітиви schema конфігурації agent runtime | | `plugin-sdk/boolean-param` | Гнучкий читач булевих параметрів | - | `plugin-sdk/dangerous-name-runtime` | Допоміжні засоби розв’язання зіставлення dangerous-name | - | `plugin-sdk/device-bootstrap` | Допоміжні засоби початкового налаштування пристрою та токенів pairing | + | `plugin-sdk/dangerous-name-runtime` | Допоміжні засоби визначення збігів небезпечних назв | + | `plugin-sdk/device-bootstrap` | Допоміжні засоби bootstrap пристрою та токена pairing | | `plugin-sdk/extension-shared` | Спільні примітиви допоміжних засобів passive-channel, status і ambient proxy | - | `plugin-sdk/models-provider-runtime` | Допоміжні засоби відповіді `/models` command/provider | - | `plugin-sdk/skill-commands-runtime` | Допоміжні засоби переліку команд skill | + | `plugin-sdk/models-provider-runtime` | Допоміжні засоби відповіді команди `/models`/провайдера | + | `plugin-sdk/skill-commands-runtime` | Допоміжні засоби списку команд Skill | | `plugin-sdk/native-command-registry` | Допоміжні засоби реєстру/build/serialize нативних команд | - | `plugin-sdk/agent-harness` | Експериментальна поверхня trusted-plugin для низькорівневих harness агента: типи harness, допоміжні засоби steer/abort активного запуску, допоміжні засоби мосту OpenClaw tool, допоміжні засоби політики tool у runtime-plan, класифікація результатів terminal і допоміжні засоби форматування/деталізації прогресу tool та утиліти результатів спроб | + | `plugin-sdk/agent-harness` | Експериментальна поверхня trusted-plugin для низькорівневих agent harnesses: типи harness, допоміжні засоби керування/переривання active-run, допоміжні засоби мосту tool OpenClaw, допоміжні засоби політики tool runtime-plan, класифікація результатів terminal, допоміжні засоби форматування/деталізації прогресу tool і утиліти результатів спроб | | `plugin-sdk/provider-zai-endpoint` | Допоміжні засоби виявлення endpoint Z.A.I | - | `plugin-sdk/async-lock-runtime` | Допоміжний засіб process-local async lock для невеликих файлів стану runtime | - | `plugin-sdk/channel-activity-runtime` | Допоміжний засіб telemetry активності каналу | - | `plugin-sdk/concurrency-runtime` | Допоміжний засіб обмеженої concurrency асинхронних завдань | - | `plugin-sdk/dedupe-runtime` | Допоміжні засоби кешу dedupe в пам’яті | - | `plugin-sdk/delivery-queue-runtime` | Допоміжний засіб спорожнення черги очікуваної вихідної доставки | - | `plugin-sdk/file-access-runtime` | Допоміжні засоби безпечних шляхів локальних файлів і джерел медіа | + | `plugin-sdk/async-lock-runtime` | Допоміжний засіб process-local async lock для невеликих файлів runtime state | + | `plugin-sdk/channel-activity-runtime` | Допоміжний засіб телеметрії активності каналу | + | `plugin-sdk/concurrency-runtime` | Допоміжний засіб обмеженої конкурентності async-задач | + | `plugin-sdk/dedupe-runtime` | Допоміжні засоби кешу дедуплікації в пам’яті | + | `plugin-sdk/delivery-queue-runtime` | Допоміжний засіб drain для вихідних pending-delivery | + | `plugin-sdk/file-access-runtime` | Допоміжні засоби безпечного шляху до локального файлу та media-source | | `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` | Застарілий shim сумісності; використовуйте наведені вище цільові підшляхи runtime | + | `plugin-sdk/infra-runtime` | Застарілий shim сумісності; використовуйте спеціалізовані підшляхи runtime вище | | `plugin-sdk/collection-runtime` | Невеликі допоміжні засоби обмеженого кешу | - | `plugin-sdk/diagnostic-runtime` | Допоміжні засоби діагностичних прапорців, подій і trace-context | + | `plugin-sdk/diagnostic-runtime` | Допоміжні засоби прапорців, подій і trace-context діагностики | | `plugin-sdk/error-runtime` | Допоміжні засоби графа помилок, форматування, спільної класифікації помилок, `isApprovalNotFoundError` | - | `plugin-sdk/fetch-runtime` | Допоміжні засоби обгорнутого fetch, proxy і pinned lookup | + | `plugin-sdk/fetch-runtime` | Допоміжні засоби wrapped fetch, proxy і pinned lookup | | `plugin-sdk/runtime-fetch` | Runtime fetch з урахуванням dispatcher без імпортів proxy/guarded-fetch | - | `plugin-sdk/response-limit-runtime` | Читач body відповіді з обмеженням без широкої поверхні media runtime | + | `plugin-sdk/response-limit-runtime` | Читач обмеженого response-body без широкої media runtime surface | | `plugin-sdk/session-binding-runtime` | Поточний стан прив’язки conversation без маршрутизації configured binding або сховищ pairing | | `plugin-sdk/session-store-runtime` | Допоміжні засоби session-store без широких імпортів запису/обслуговування конфігурації | - | `plugin-sdk/context-visibility-runtime` | Допоміжні засоби розв’язання видимості контексту та фільтрації додаткового контексту без широких імпортів config/security | - | `plugin-sdk/string-coerce-runtime` | Вузькі допоміжні засоби приведення й нормалізації primitive record/string без імпортів markdown/logging | + | `plugin-sdk/context-visibility-runtime` | Визначення видимості контексту та фільтрація додаткового контексту без широких імпортів config/security | + | `plugin-sdk/string-coerce-runtime` | Вузькі допоміжні засоби приведення та нормалізації primitive record/string без імпортів markdown/logging | | `plugin-sdk/host-runtime` | Допоміжні засоби нормалізації hostname і SCP host | - | `plugin-sdk/retry-runtime` | Допоміжні засоби конфігурації retry і виконання retry | + | `plugin-sdk/retry-runtime` | Допоміжні засоби конфігурації retry і запуску retry | | `plugin-sdk/agent-runtime` | Допоміжні засоби каталогу/ідентичності/робочого простору агента | - | `plugin-sdk/directory-runtime` | Запит/dedupe каталогу з підтримкою конфігурації | + | `plugin-sdk/directory-runtime` | Запит/dedup каталогу на основі конфігурації | | `plugin-sdk/keyed-async-queue` | `KeyedAsyncQueue` | - | Subpath | Ключові експорти | + | Підшлях | Ключові експорти | | --- | --- | - | `plugin-sdk/media-runtime` | Спільні допоміжні засоби fetch/transform/store для медіа, а також конструктори media payload | - | `plugin-sdk/media-store` | Вузькі допоміжні засоби сховища медіа, як-от `saveMediaBuffer` | - | `plugin-sdk/media-generation-runtime` | Спільні допоміжні засоби failover для генерації медіа, вибір кандидатів і повідомлення про відсутню модель | - | `plugin-sdk/media-understanding` | Типи provider для розуміння медіа, а також експорти допоміжних засобів для зображень/аудіо, орієнтовані на provider | - | `plugin-sdk/text-runtime` | Спільні допоміжні засоби text/markdown/logging, як-от вилучення тексту, видимого помічнику, допоміжні засоби рендерингу/chunking/таблиць Markdown, допоміжні засоби редагування, допоміжні засоби directive-tag і утиліти safe-text | + | `plugin-sdk/media-runtime` | Спільні допоміжні засоби fetch/transform/store для медіа, а також збирачі media payload | + | `plugin-sdk/media-store` | Вузькі допоміжні засоби media store, як-от `saveMediaBuffer` | + | `plugin-sdk/media-generation-runtime` | Спільні допоміжні засоби failover для генерації медіа, вибору кандидатів і повідомлень про відсутню модель | + | `plugin-sdk/media-understanding` | Типи провайдера для розуміння медіа, а також орієнтовані на провайдера експорти допоміжних засобів для зображень/аудіо | + | `plugin-sdk/text-runtime` | Спільні допоміжні засоби для тексту/markdown/логування, як-от видалення видимого для помічника тексту, допоміжні засоби render/chunking/table для markdown, допоміжні засоби редагування, допоміжні засоби directive-tag і утиліти safe-text | | `plugin-sdk/text-chunking` | Допоміжний засіб chunking вихідного тексту | - | `plugin-sdk/speech` | Типи speech provider, а також експорти допоміжних засобів directive, registry, validation, конструктора TTS, сумісного з OpenAI, і speech helper | - | `plugin-sdk/speech-core` | Спільні типи speech provider, а також експорти допоміжних засобів registry, directive, normalization і speech helper | - | `plugin-sdk/realtime-transcription` | Типи provider для realtime transcription, допоміжні засоби registry і спільний допоміжний засіб сесії WebSocket | - | `plugin-sdk/realtime-voice` | Типи provider для realtime voice і допоміжні засоби registry | - | `plugin-sdk/image-generation` | Типи provider для генерації зображень, а також допоміжні засоби image asset/data URL | - | `plugin-sdk/image-generation-core` | Спільні типи image-generation, допоміжні засоби failover, auth і registry | - | `plugin-sdk/music-generation` | Типи provider/request/result для генерації музики | - | `plugin-sdk/music-generation-core` | Спільні типи music-generation, допоміжні засоби failover, пошук provider і розбір model-ref | - | `plugin-sdk/video-generation` | Типи provider/request/result для генерації відео | - | `plugin-sdk/video-generation-core` | Спільні типи video-generation, допоміжні засоби failover, пошук provider і розбір model-ref | - | `plugin-sdk/webhook-targets` | Допоміжні засоби registry цілей Webhook і встановлення route | + | `plugin-sdk/speech` | Типи провайдера мовлення, а також орієнтовані на провайдера експорти директив, реєстру, валідації, сумісного з OpenAI збирача TTS і допоміжних засобів мовлення | + | `plugin-sdk/speech-core` | Спільні експорти типів провайдера мовлення, реєстру, директив, нормалізації та допоміжних засобів мовлення | + | `plugin-sdk/realtime-transcription` | Типи провайдера realtime transcription, допоміжні засоби реєстру та спільний допоміжний засіб сесії WebSocket | + | `plugin-sdk/realtime-voice` | Типи провайдера realtime voice і допоміжні засоби реєстру | + | `plugin-sdk/image-generation` | Типи провайдера генерації зображень, а також допоміжні засоби image asset/data URL і сумісний з OpenAI збирач провайдера зображень | + | `plugin-sdk/image-generation-core` | Спільні допоміжні засоби типів, failover, auth і реєстру для генерації зображень | + | `plugin-sdk/music-generation` | Типи провайдера/запиту/результату генерації музики | + | `plugin-sdk/music-generation-core` | Спільні типи генерації музики, допоміжні засоби failover, пошуку провайдера та розбору model-ref | + | `plugin-sdk/video-generation` | Типи провайдера/запиту/результату генерації відео | + | `plugin-sdk/video-generation-core` | Спільні типи генерації відео, допоміжні засоби failover, пошуку провайдера та розбору model-ref | + | `plugin-sdk/webhook-targets` | Допоміжні засоби реєстру цілей Webhook і встановлення маршрутів | | `plugin-sdk/webhook-path` | Допоміжні засоби нормалізації шляху Webhook | | `plugin-sdk/web-media` | Спільні допоміжні засоби завантаження віддалених/локальних медіа | | `plugin-sdk/zod` | Повторно експортований `zod` для споживачів Plugin SDK | - | `plugin-sdk/testing` | Широкий сумісний barrel для застарілих тестів Plugin. Нові тести extension мають імпортувати натомість цільові підшляхи 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 без імпорту мостів допоміжних засобів тестування репозиторію | - | `plugin-sdk/agent-runtime-test-contracts` | Фікстури контрактів нативного адаптера agent-runtime для тестів auth, delivery, fallback, tool-hook, prompt-overlay, schema і проєкції transcript | - | `plugin-sdk/channel-test-helpers` | Допоміжні засоби тестування, орієнтовані на канал, для загальних контрактів actions/setup/status, перевірок каталогу, життєвого циклу запуску облікового запису, threading send-config, моків runtime, проблем статусу, вихідної доставки та реєстрації hook | - | `plugin-sdk/channel-target-testing` | Спільний набір випадків помилок розв’язання цілей для тестів каналу | + | `plugin-sdk/testing` | Широкий сумісний 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` для прямих модульних тестів реєстрації Plugin без імпорту мостів допоміжних тестових засобів репозиторію | + | `plugin-sdk/agent-runtime-test-contracts` | Фікстури контрактів нативного адаптера agent-runtime для тестів auth, delivery, fallback, tool-hook, prompt-overlay, schema і проєкції транскриптів | + | `plugin-sdk/channel-test-helpers` | Орієнтовані на канали допоміжні засоби тестування для загальних контрактів actions/setup/status, перевірок каталогу, життєвого циклу запуску облікового запису, потоків send-config, моків runtime, проблем статусу, вихідної доставки та реєстрації хуків | + | `plugin-sdk/channel-target-testing` | Спільний набір випадків помилок визначення цілі для тестів каналів | | `plugin-sdk/plugin-test-contracts` | Допоміжні засоби контрактів пакета Plugin, реєстрації, публічного артефакту, прямого імпорту, runtime API і побічних ефектів імпорту | - | `plugin-sdk/provider-test-contracts` | Допоміжні засоби контрактів runtime, auth, discovery, onboard, catalog, wizard, media capability, replay policy, realtime STT live-audio, web-search/fetch і stream для provider | - | `plugin-sdk/provider-http-test-mocks` | Opt-in моки HTTP/auth для Vitest для тестів provider, які перевіряють `plugin-sdk/provider-http` | - | `plugin-sdk/test-fixtures` | Загальні фікстури захоплення runtime CLI, контексту sandbox, writer skill, agent-message, system-event, перезавантаження модуля, шляху bundled plugin, terminal-text, chunking, auth-token і typed-case | - | `plugin-sdk/test-node-mocks` | Цільові допоміжні засоби моків вбудованих модулів Node для використання всередині фабрик Vitest `vi.mock("node:*")` | + | `plugin-sdk/provider-test-contracts` | Допоміжні засоби контрактів runtime, auth, discovery, onboard, catalog, wizard, media capability, replay policy, realtime STT live-audio, web-search/fetch і stream для провайдерів | + | `plugin-sdk/provider-http-test-mocks` | Opt-in моки HTTP/auth для Vitest у тестах провайдерів, які використовують `plugin-sdk/provider-http` | + | `plugin-sdk/test-fixtures` | Загальні фікстури захоплення runtime CLI, контексту sandbox, записувача skill, повідомлення агента, системної події, перезавантаження модуля, шляху bundled plugin, terminal-text, chunking, auth-token і типізованого кейсу | + | `plugin-sdk/test-node-mocks` | Спеціалізовані допоміжні засоби моків вбудованих модулів Node для використання у фабриках Vitest `vi.mock("node:*")` | - | Subpath | Ключові експорти | + | Підшлях | Ключові експорти | | --- | --- | - | `plugin-sdk/memory-core` | Поверхня допоміжних засобів bundled memory-core для manager/config/file/CLI helper | - | `plugin-sdk/memory-core-engine-runtime` | Фасад runtime індексу/пошуку пам’яті | + | `plugin-sdk/memory-core` | Поверхня допоміжних засобів bundled memory-core для manager/config/file/CLI helperів | + | `plugin-sdk/memory-core-engine-runtime` | Фасад runtime індексації/пошуку пам’яті | | `plugin-sdk/memory-core-host-engine-foundation` | Експорти foundation engine хоста пам’яті | - | `plugin-sdk/memory-core-host-engine-embeddings` | Контракти embedding хоста пам’яті, доступ до registry, локальний provider і загальні допоміжні засоби batch/remote | - | `plugin-sdk/memory-core-host-engine-qmd` | Експорти engine QMD хоста пам’яті | - | `plugin-sdk/memory-core-host-engine-storage` | Експорти engine сховища хоста пам’яті | - | `plugin-sdk/memory-core-host-multimodal` | Допоміжні засоби multimodal хоста пам’яті | - | `plugin-sdk/memory-core-host-query` | Допоміжні засоби запитів хоста пам’яті | - | `plugin-sdk/memory-core-host-secret` | Допоміжні засоби secret хоста пам’яті | - | `plugin-sdk/memory-core-host-events` | Допоміжні засоби журналу подій хоста пам’яті | - | `plugin-sdk/memory-core-host-status` | Допоміжні засоби статусу хоста пам’яті | - | `plugin-sdk/memory-core-host-runtime-cli` | Допоміжні засоби runtime CLI хоста пам’яті | - | `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 для plugin, суміжних із пам’яттю | - | `plugin-sdk/memory-host-search` | Фасад runtime Active Memory для доступу до менеджера пошуку | - | `plugin-sdk/memory-host-status` | Нейтральний до постачальника псевдонім для допоміжних засобів статусу хоста пам’яті | + | `plugin-sdk/memory-core-host-engine-embeddings` | Контракти embedding хоста пам’яті, доступ до реєстру, локальний провайдер і загальні batch/remote helperи | + | `plugin-sdk/memory-core-host-engine-qmd` | Експорти QMD engine хоста пам’яті | + | `plugin-sdk/memory-core-host-engine-storage` | Експорти storage engine хоста пам’яті | + | `plugin-sdk/memory-core-host-multimodal` | Мультимодальні helperи хоста пам’яті | + | `plugin-sdk/memory-core-host-query` | Helperи запитів хоста пам’яті | + | `plugin-sdk/memory-core-host-secret` | Helperи секретів хоста пам’яті | + | `plugin-sdk/memory-core-host-events` | Helperи журналу подій хоста пам’яті | + | `plugin-sdk/memory-core-host-status` | Helperи статусу хоста пам’яті | + | `plugin-sdk/memory-core-host-runtime-cli` | Helperи runtime CLI хоста пам’яті | + | `plugin-sdk/memory-core-host-runtime-core` | Helperи основного runtime хоста пам’яті | + | `plugin-sdk/memory-core-host-runtime-files` | Helperи файлів/runtime хоста пам’яті | + | `plugin-sdk/memory-host-core` | Vendor-neutral псевдонім для helperів основного runtime хоста пам’яті | + | `plugin-sdk/memory-host-events` | Vendor-neutral псевдонім для helperів журналу подій хоста пам’яті | + | `plugin-sdk/memory-host-files` | Vendor-neutral псевдонім для helperів файлів/runtime хоста пам’яті | + | `plugin-sdk/memory-host-markdown` | Спільні helperи managed-markdown для Plugin, суміжних із пам’яттю | + | `plugin-sdk/memory-host-search` | Фасад runtime Active Memory для доступу до search-manager | + | `plugin-sdk/memory-host-status` | Vendor-neutral псевдонім для helperів статусу хоста пам’яті | | `plugin-sdk/memory-lancedb` | Поверхня допоміжних засобів bundled memory-lancedb | - | Family | Поточні підшляхи | Призначення | + | Сімейство | Поточні підшляхи | Призначення | | --- | --- | --- | - | Browser | `plugin-sdk/browser-cdp`, `plugin-sdk/browser-config-runtime`, `plugin-sdk/browser-config-support`, `plugin-sdk/browser-control-auth`, `plugin-sdk/browser-node-runtime`, `plugin-sdk/browser-profiles`, `plugin-sdk/browser-security-runtime`, `plugin-sdk/browser-setup-tools`, `plugin-sdk/browser-support` | Допоміжні засоби підтримки bundled browser plugin. `browser-profiles` експортує `resolveBrowserConfig`, `resolveProfile`, `ResolvedBrowserConfig`, `ResolvedBrowserProfile` і `ResolvedBrowserTabCleanupConfig` для нормалізованої форми `browser.tabCleanup`. `browser-support` залишається barrel сумісності. | - | Matrix | `plugin-sdk/matrix`, `plugin-sdk/matrix-helper`, `plugin-sdk/matrix-runtime-heavy`, `plugin-sdk/matrix-runtime-shared`, `plugin-sdk/matrix-runtime-surface`, `plugin-sdk/matrix-surface`, `plugin-sdk/matrix-thread-bindings` | Поверхня bundled Matrix helper/runtime | - | Line | `plugin-sdk/line`, `plugin-sdk/line-core`, `plugin-sdk/line-runtime`, `plugin-sdk/line-surface` | Поверхня bundled LINE helper/runtime | - | IRC | `plugin-sdk/irc`, `plugin-sdk/irc-surface` | Поверхня bundled IRC helper | - | Допоміжні засоби, специфічні для каналу | `plugin-sdk/googlechat`, `plugin-sdk/googlechat-runtime-shared`, `plugin-sdk/zalouser`, `plugin-sdk/bluebubbles`, `plugin-sdk/bluebubbles-policy`, `plugin-sdk/mattermost`, `plugin-sdk/mattermost-policy`, `plugin-sdk/feishu`, `plugin-sdk/feishu-conversation`, `plugin-sdk/feishu-setup`, `plugin-sdk/msteams`, `plugin-sdk/nextcloud-talk`, `plugin-sdk/nostr`, `plugin-sdk/telegram-command-ui`, `plugin-sdk/tlon`, `plugin-sdk/twitch`, `plugin-sdk/zalo`, `plugin-sdk/zalo-setup` | Застарілі шви сумісності/допоміжних засобів bundled channel. Нові Plugin мають імпортувати загальні підшляхи SDK або локальні barrel-файли Plugin. | - | Допоміжні засоби, специфічні для auth/plugin | `plugin-sdk/github-copilot-login`, `plugin-sdk/github-copilot-token`, `plugin-sdk/diagnostics-otel`, `plugin-sdk/diagnostics-prometheus`, `plugin-sdk/diffs`, `plugin-sdk/llm-task`, `plugin-sdk/memory-core`, `plugin-sdk/memory-lancedb`, `plugin-sdk/opencode`, `plugin-sdk/thread-ownership`, `plugin-sdk/voice-call` | Шви допоміжних засобів bundled feature/plugin; `plugin-sdk/github-copilot-token` наразі експортує `DEFAULT_COPILOT_API_BASE_URL`, `deriveCopilotApiBaseUrlFromToken` і `resolveCopilotApiToken` | + | Браузер | `plugin-sdk/browser-cdp`, `plugin-sdk/browser-config-runtime`, `plugin-sdk/browser-config-support`, `plugin-sdk/browser-control-auth`, `plugin-sdk/browser-node-runtime`, `plugin-sdk/browser-profiles`, `plugin-sdk/browser-security-runtime`, `plugin-sdk/browser-setup-tools`, `plugin-sdk/browser-support` | Допоміжні засоби підтримки bundled browser plugin. `browser-profiles` експортує `resolveBrowserConfig`, `resolveProfile`, `ResolvedBrowserConfig`, `ResolvedBrowserProfile` і `ResolvedBrowserTabCleanupConfig` для нормалізованої форми `browser.tabCleanup`. `browser-support` лишається barrel сумісності. | + | Matrix | `plugin-sdk/matrix`, `plugin-sdk/matrix-helper`, `plugin-sdk/matrix-runtime-heavy`, `plugin-sdk/matrix-runtime-shared`, `plugin-sdk/matrix-runtime-surface`, `plugin-sdk/matrix-surface`, `plugin-sdk/matrix-thread-bindings` | Поверхня helperів/runtime bundled Matrix | + | Line | `plugin-sdk/line`, `plugin-sdk/line-core`, `plugin-sdk/line-runtime`, `plugin-sdk/line-surface` | Поверхня helperів/runtime bundled LINE | + | IRC | `plugin-sdk/irc`, `plugin-sdk/irc-surface` | Поверхня helperів bundled IRC | + | Допоміжні засоби, специфічні для каналів | `plugin-sdk/googlechat`, `plugin-sdk/googlechat-runtime-shared`, `plugin-sdk/zalouser`, `plugin-sdk/bluebubbles`, `plugin-sdk/bluebubbles-policy`, `plugin-sdk/mattermost`, `plugin-sdk/mattermost-policy`, `plugin-sdk/feishu`, `plugin-sdk/feishu-conversation`, `plugin-sdk/feishu-setup`, `plugin-sdk/msteams`, `plugin-sdk/nextcloud-talk`, `plugin-sdk/nostr`, `plugin-sdk/telegram-command-ui`, `plugin-sdk/tlon`, `plugin-sdk/twitch`, `plugin-sdk/zalo`, `plugin-sdk/zalo-setup` | Застарілі стики сумісності/helperи bundled channel. Нові Plugin мають імпортувати загальні підшляхи SDK або локальні barrel-и Plugin. | + | Допоміжні засоби, специфічні для auth/plugin | `plugin-sdk/github-copilot-login`, `plugin-sdk/github-copilot-token`, `plugin-sdk/diagnostics-otel`, `plugin-sdk/diagnostics-prometheus`, `plugin-sdk/diffs`, `plugin-sdk/llm-task`, `plugin-sdk/memory-core`, `plugin-sdk/memory-lancedb`, `plugin-sdk/opencode`, `plugin-sdk/thread-ownership`, `plugin-sdk/voice-call` | Стики helperів bundled feature/plugin; `plugin-sdk/github-copilot-token` наразі експортує `DEFAULT_COPILOT_API_BASE_URL`, `deriveCopilotApiBaseUrlFromToken` і `resolveCopilotApiToken` |