From a91f9b03eb123780fb338d18c5783103a727d4c5 Mon Sep 17 00:00:00 2001 From: "openclaw-docs-sync[bot]" Date: Tue, 28 Apr 2026 04:24:29 +0000 Subject: [PATCH] chore(sync): mirror docs from openclaw/openclaw@1a2f60c0a16b9b5400fcae9aacb528a62a824dd4 --- .openclaw-sync/source.json | 4 ++-- docs/plugins/architecture.md | 2 +- docs/plugins/sdk-migration.md | 22 +++++++--------------- docs/plugins/sdk-subpaths.md | 9 ++++----- 4 files changed, 14 insertions(+), 23 deletions(-) diff --git a/.openclaw-sync/source.json b/.openclaw-sync/source.json index 5989f85b4..8176d13df 100644 --- a/.openclaw-sync/source.json +++ b/.openclaw-sync/source.json @@ -1,5 +1,5 @@ { "repository": "openclaw/openclaw", - "sha": "870d993eb85c02bdcaba5e13e53167b3a641b296", - "syncedAt": "2026-04-28T04:22:51.393Z" + "sha": "1a2f60c0a16b9b5400fcae9aacb528a62a824dd4", + "syncedAt": "2026-04-28T04:23:06.529Z" } diff --git a/docs/plugins/architecture.md b/docs/plugins/architecture.md index 5e771b0b7..9fba7fe34 100644 --- a/docs/plugins/architecture.md +++ b/docs/plugins/architecture.md @@ -473,7 +473,7 @@ Keep capability registration public. Trim non-contract helper exports: - vendor-specific convenience helpers - setup/onboarding helpers that are implementation details -Some bundled-plugin helper subpaths still remain in the generated SDK export map for bundled-plugin maintenance when they have tracked owner usage. Current examples include `plugin-sdk/browser-config-runtime`, `plugin-sdk/browser-config-support`, `plugin-sdk/browser-node-runtime`, `plugin-sdk/browser-security-runtime`, `plugin-sdk/browser-setup-tools`, `plugin-sdk/matrix-runtime-shared`, `plugin-sdk/github-copilot-token`, `plugin-sdk/memory-core`, `plugin-sdk/bundled-channel-config-schema`, and `plugin-sdk/channel-config-schema-legacy`. Treat those as reserved exports, not as the recommended SDK pattern for new third-party plugins. +Reserved bundled-plugin helper subpaths have been retired from the generated SDK export map. Keep owner-specific helpers inside the owning plugin package; promote only reusable host behavior to generic SDK contracts such as `plugin-sdk/gateway-runtime`, `plugin-sdk/security-runtime`, and `plugin-sdk/plugin-config-runtime`. ## Internals and reference diff --git a/docs/plugins/sdk-migration.md b/docs/plugins/sdk-migration.md index 91551a1a7..6c0d18933 100644 --- a/docs/plugins/sdk-migration.md +++ b/docs/plugins/sdk-migration.md @@ -544,23 +544,15 @@ This table is intentionally the common migration subset, not the full SDK surface. The full list of 200+ entrypoints lives in `scripts/lib/plugin-sdk-entrypoints.json`. -That list still includes a few bundled-plugin helper seams that have tracked -owner usage. They remain exported for bundled-plugin maintenance, but they are -intentionally omitted from the common migration table and are not the -recommended target for new plugin code. - -The same rule applies to other bundled-helper families such as: - -- browser support helpers: `plugin-sdk/browser-config-runtime`, `plugin-sdk/browser-config-support`, `plugin-sdk/browser-node-runtime`, `plugin-sdk/browser-security-runtime`, `plugin-sdk/browser-setup-tools` -- Matrix: `plugin-sdk/matrix-runtime-shared` -- bundled helper/plugin surfaces like `plugin-sdk/github-copilot-token` and `plugin-sdk/memory-core` - -`plugin-sdk/github-copilot-token` currently exposes the narrow token-helper -surface `DEFAULT_COPILOT_API_BASE_URL`, -`deriveCopilotApiBaseUrlFromToken`, and `resolveCopilotApiToken`. +Reserved bundled-plugin helper seams have been retired from the public SDK +export map. Owner-specific helpers live inside the owning plugin package; shared +host behavior should move through generic SDK contracts such as +`plugin-sdk/gateway-runtime`, `plugin-sdk/security-runtime`, and +`plugin-sdk/plugin-config-runtime`. Use the narrowest import that matches the job. If you cannot find an export, -check the source at `src/plugin-sdk/` or ask in Discord. +check the source at `src/plugin-sdk/` or ask maintainers which generic contract +should own it. ## Active deprecations diff --git a/docs/plugins/sdk-subpaths.md b/docs/plugins/sdk-subpaths.md index 3bcf51c28..73710a129 100644 --- a/docs/plugins/sdk-subpaths.md +++ b/docs/plugins/sdk-subpaths.md @@ -313,11 +313,10 @@ For the plugin authoring guide, see [Plugin SDK overview](/plugins/sdk-overview) - | Family | Current subpaths | Intended use | - | --- | --- | --- | - | Browser | `plugin-sdk/browser-config-runtime`, `plugin-sdk/browser-config-support`, `plugin-sdk/browser-node-runtime`, `plugin-sdk/browser-security-runtime`, `plugin-sdk/browser-setup-tools` | Bundled browser plugin support helpers still consumed by the owner package. | - | Matrix | `plugin-sdk/matrix-runtime-shared` | Bundled Matrix runtime surface still consumed by the owner package. | - | Auth/plugin-specific helpers | `plugin-sdk/github-copilot-token`, `plugin-sdk/memory-core` | Bundled feature/plugin helper seams still consumed by their owners; `plugin-sdk/github-copilot-token` currently exports `DEFAULT_COPILOT_API_BASE_URL`, `deriveCopilotApiBaseUrlFromToken`, and `resolveCopilotApiToken`. | + There are currently no reserved bundled-helper SDK subpaths. Owner-specific + helpers live inside the owning plugin package, while reusable host contracts + use generic SDK subpaths such as `plugin-sdk/gateway-runtime`, + `plugin-sdk/security-runtime`, and `plugin-sdk/plugin-config-runtime`.