Repository navigation
docs(extensions v0.2.3): cover full-stack plugins and request-scoped run evidence - #5775
Merged
WillemJiang merged 8 commits intoSep 23, 2026
Merged
Conversation
Add a harness/extensions/ section in English and Chinese documenting the
deerflow-extension-api 0.2.3 contract:
index when to write an extension vs a tool, MCP server or
skill; contribution kinds; loading; failure and
trust model; versioning
quick-start build, test, install and remove a working extension
runtime load sequence, API version rules, scopes and
ExtensionData, fail-open and cancellation, diagnostics
middleware placements and where each lands, scope, ordering,
observe-only wrap hooks, failure isolation
observers task lifecycle, system model calls, agent assembly
and fingerprint, context compaction
services-and-routes service lifecycle, router rejection rules, auth,
principals
run-evidence service and request-scoped readers (bytedance#5727), cursor
semantics, deletions, redaction, store differences
plugins experimental full-stack plugins, inline modules and
manifest-based browser assets (bytedance#5685)
operations extension manager CLI, sources, upgrade, rollback,
Docker, Helm, recovery
troubleshooting indexed by the exact log and error strings
reference every public name and the contract version history
Also fix stale descriptions: the contribution kinds listed in AGENTS.md
and deerflow/extensions/AGENTS.md (now eight, including plugins), the
run-evidence redaction claim (only auth_token is removed), and the plugin
mount return value in docs/full-stack-plugins.md ({ dispose }, not a
function). Changelog entries added in both languages.
Plugins and request-scoped run evidence are not in 2.1.x-dev yet; they move to a stacked follow-up so this change can be cherry-picked.
…dence Brings the extension manual up to deerflow-extension-api 0.2.3. Stacked on the 0.2.1 manual so that part can be cherry-picked to 2.1.x-dev alone.
github-actions
Bot
added
area:docs
ggnnggez
changed the title
Collaborator
|
@ggnnggez, please resolve the conflict with the main branch. |
…docs-plugins # Conflicts: # AGENTS.md # CHANGELOG.md # CHANGELOG_zh.md # frontend/src/content/en/harness/extensions/_meta.ts # frontend/src/content/en/harness/extensions/index.mdx # frontend/src/content/en/harness/extensions/operations.mdx # frontend/src/content/en/harness/extensions/reference.mdx # frontend/src/content/en/harness/extensions/run-evidence.mdx # frontend/src/content/en/harness/extensions/services-and-routes.mdx # frontend/src/content/en/harness/extensions/troubleshooting.mdx # frontend/src/content/zh/harness/extensions/_meta.ts # frontend/src/content/zh/harness/extensions/index.mdx # frontend/src/content/zh/harness/extensions/operations.mdx # frontend/src/content/zh/harness/extensions/reference.mdx # frontend/src/content/zh/harness/extensions/run-evidence.mdx # frontend/src/content/zh/harness/extensions/services-and-routes.mdx # frontend/src/content/zh/harness/extensions/troubleshooting.mdx
WillemJiang
approved these changes
Sep 23, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Follow-up to #5769 (merged). #5769 limits the extension manual to the
deerflow-extension-api0.2.1 contract so it can be cherry-picked to2.1.x-dev. This PR adds the parts that exist only onmainand brings the manual up to 0.2.3:registry.plugin(),BrowserModule/BrowserAssets, backend actions, model tools, and settings (feat(plugins): full-stack plugin APIs and bookmarks #5647, feat(plugins): support manifests and static asset directories #5685)resolve_run_evidence_reader/require_run_evidence_reader, plus a per-user route example (feat(extensions): add request-scoped run evidence access #5727)extensions/AGENTS.md, and a fix for the description of the pluginmountreturn value indocs/full-stack-plugins.mdWhen #5647, #5685, and #5727 are backported to 2.1, cherry-pick this PR along with them.
Validation
python scripts/check_agent_guidance.py --base-ref 2a9beb34 --head-ref HEAD: 0 errorsfrontend/src/content/{en,zh}/harness/extensions/compiles with@mdx-js/mdxNotes for reviewers
Plugin-specific code issues surfaced while writing these pages. The pages describe them as-is; happy to file them as separate issues:
ValueErrorbecomes 502 (routers/plugins.py).user_id(plugin_tools.py), sois_adminis always false, unlike actions.FileNotFoundErrorwith an absolute host path instead of a named validation error.PluginContribution.enableddefaults toFalse, and the resulting error says "disabled by administrator".