vultr/openclaw
1
0
Fork 0
mirror of https://github.com/openclaw/openclaw.git synced 2026-05-06 15:40:44 +00:00
Code Issues Packages Projects Releases Wiki Activity

refactor(plugins): track activation compat hints

Browse Source
This commit is contained in:
Vincent Koc
2026-04-23 20:59:07 -07:00
parent 76a4c167f7
commit b1d0c14d38
8 changed files with 374 additions and 106 deletions
Download Patch File Download Diff File Expand all files Collapse all files

24
docs/plugins/sdk-migration.md
View File

@@ -25,12 +25,14 @@ anything they needed from a single entry point:
host-side helpers like the embedded agent runner.
Both surfaces are now **deprecated**. They still work at runtime, but new
plugins must not use them, and existing plugins should migrate before the next
major release removes them.
plugins must not use them, and existing plugins should migrate before an
approved breaking release removes them.
<Warning>
The backwards-compatibility layer will be removed in a future major release.
Plugins that still import from these surfaces will break when that happens.
The backwards-compatibility layer remains supported during the migration
window. Any removal must go through a documented deprecation path first:
replacement contract, compatibility adapter, diagnostics, tests, docs, and an
explicitly approved breaking release.
</Warning>
## Why this changed
@@ -374,13 +376,15 @@ check the source at `src/plugin-sdk/` or ask in Discord.
## Removal timeline
| When | What happens |
| ---------------------- | ----------------------------------------------------------------------- |
| **Now** | Deprecated surfaces emit runtime warnings |
| **Next major release** | Deprecated surfaces will be removed; plugins still using them will fail |
| When | What happens |
| ---------------------------------- | ---------------------------------------------------------------------------- |
| **Now** | Deprecated surfaces emit runtime warnings and keep working through adapters. |
| **Migration window** | Replacement contracts, diagnostics, tests, and docs stay available together. |
| **Approved breaking release only** | Deprecated surfaces may be removed after the migration window. |
All core plugins have already been migrated. External plugins should migrate
before the next major release.
All core plugins have already been migrated. External plugins should migrate,
but documented external plugins should not break without the compatibility path
above.
## Suppressing the warnings temporarily