* feat(webserver): add resource routes and in-process readResource
A webserver route or the fallback seat may now answer through a resource,
a function from a Fetch Request to a Response, besides the existing
node:http handler. register accepts either route form and registerFallback
accepts a handler or { resource }; existing handler callers are unchanged.
HTTP GET and HEAD requests reach a resource; webServer.readResource(request,
peer) follows the same match order and reaches only resources, so handler
routes stay unreachable to in-process readers.
client-modules registers /plugins as the fetchBundle resource, and
frontend-static claims the fallback seat with a resource that renders the
index for a supplied Peer, or runs Connection's existing authorizeIndex for
an HTTP request and renders for the browser Peer.
* fix(webserver): flush resource headers and keep one drain listener per response
Resource responses send their status and headers before the first body
chunk, register one drain/close listener pair per response so the gzip
middleware's zlib stream does not accumulate listeners across backpressure
waits, and readResource drops the body of a HEAD read as HTTP does. HTTP
requests and readResource share one responder lookup.
* chore(scripts): prune the retired client-modules unknown-cast baseline entry
* feat(frontend-static): let browsers revalidate dist files except the index
Every dist file other than the rendered index now carries
cache-control: no-cache and a weak ETag from a SHA-1 of its bytes; a
request whose If-None-Match equals that ETag receives an empty 304. The
index keeps sending no cache headers. In-process reads through
webServer.readResource revalidate the same way.
* fix(webserver): stop reading Host for resource URLs and copy no held body
A resource request's URL is the request target resolved against the same
placeholder origin the route match uses, so a missing or unparsable Host no
longer turns a dist or /plugins request into 400. The webserver ends a
resource response itself and treats any earlier close as an abort, which
also covers the Web Worker tunnel marking an aborted response ended first.
client-modules bundle bodies and frontend-static file bodies are the held
bytes themselves instead of copies, and frontend-static no longer exports
its internal serveStatic helper.
* docs(webserver): document resource route types and the handler-or-resource fallback
Paste WebResource and WebResourceRoute beside WebRoute on the web-server
subsystem page and link the catalog signatures to it, replace the remaining
'fallback handler' wording now that the seat takes a handler or a resource,
and note why the drain listener removal is a no-op under gzip.
description, kind
| description | kind |
|---|---|
| The experimental group map: publicly installable pre-stable prototypes. | package-group |
packages/experimental
English | 中文
Summary
Install and compose experimental capabilities explicitly, without a product-support commitment. Package naming and publication follow the experimental package policy. The optional-bundle rule determines which capabilities ship switched off with the installation for explicit selection. The plugin manager page owns which bundles appear by default and how to enable hidden ones.
Table of Contents
Experimental, optional, and Official
Experimental means the complete public capability remains under evaluation and is not a product-support commitment. Its behavior or API may change, and the capability may be withdrawn; engineering, security, documentation, testing, and released-data obligations still apply. A package belongs here only when its entire public contract is experimental or internal-only; an experimental option inside a product package stays with that product role.
Optional means a user explicitly selects the capability. Official means the project maintains and lists the package in the Plugins page. Neither describes maturity; publication, default installation, and GUI visibility do not determine maturity either. Product packages outside this group have maintained product roles, while their public APIs still follow the repository's pre-stable policy.
Promotion requires a named product role, documented public behavior and limitations, current consumers, release contents, and test evidence. Move the package to its product group, apply that group's naming rules, and update affected consumers together. The subtree rules govern dependency isolation and publication.
Packages
| Package | Role | ctx key |
|---|---|---|
tool-session-query |
Workspace-authorized model session search, trace, and event reads | — |
session-search |
Optional experimental global session search tools | — |
ralph-bundle |
Optional repeated delegation with an isolated workflow engine | — |
terminal-bundle |
Optional global persistent terminal tools | — |
badge-skill-bundle |
Optional powered-by-dsh badge skill | — |
session-titles-bundle |
Optional titles following human prompts in a conversation | — |
hook-protocol |
Hook bridge wire types and durable events | — |
hooks-claude-code |
Claude Code hook bridge | — |
hooks-codex |
Codex hook bridge | — |
webhook |
Authenticated delivery dispatch and Workspace Session creation | ctx.webhookRuntime |
webhook-github |
Signed GitHub webhook ingress | — |
session-title-all-prompts-llm |
Session titles from all human prompts | — |
tool-terminal |
Persistent terminal tools | — |
tool-ralph |
Bounded repeated delegated tasks | — |
skill-badge |
The powered-by-dsh badge skill | — |
translator |
Anonymous Google and Bing text translation | ctx.translator |
client-ui-cot-translation |
Expanded reasoning translation and original-text controls | ctx.cotTranslation |
cot-translation-bundle |
Default-disabled reasoning translation composition | — |
speech-to-text |
Named speech recognition providers | ctx.speechToText |
speech-to-text-sensevoice |
Managed local SenseVoice inference | — |
api-speech-to-text |
Authenticated transient transcription Remote | ctx.speechController |
client-ui-voice-input |
Microphone capture and guarded draft insertion | — |
plugin-market-bundle |
Default-disabled optional custom plugin markets: the market service and the Discover tab | — |
voice-input-bundle |
Default-disabled optional voice input composition | — |
agent-team-profile |
Agent Teams collaboration, tools, and Web UI bundle | — |
agent-team |
Named teammates with direct messages and a durable shared task board | ctx.agentTeams |
client-ui-agent-team |
Team roster, task board, and teammate navigation for Web | — |
auto-review |
Explicit Web layer for same-model review before each native or PTC inner tool call | — |
subagent-oar |
Run standalone external coding-agent tasks through OAR | ctx.subagents |
tool-subagent-oar |
Select a configured external agent for each delegated task | ctx.tools |
claude-code-mods |
Run Claude Code mods as plugins: their hook chains on harness extension points and a band above the prompt | ctx.claudeCodeMods |
client-ui-claude-code-mods |
The Web band that draws a mod's tree above the prompt and sends button clicks back | — |
ptc-runtime-python |
CPython subprocess backend for the PTC execution seam | ctx.ptcRuntime |
| CUA | Application/window objects, authorized execution, and permission controls. | ctx.cuaAccess |
| macOS CUA | Swift native execution and platform preparation. | ctx.computerUse |
cua-bundle |
Optional Computer Use switch for PTC sessions | — |
computer-use-cua-driver-mcp |
Use an installed Cua Driver through MCP | ctx.computerUse |
computer-use-cua-driver-native |
Embed the Cua Driver native npm runtime | ctx.computerUse |
browser-use-playwright-mcp |
Playwright browser tools over MCP | ctx.browserUse |
browser-use-chrome-devtools-mcp |
Chrome DevTools inspection and browser control over MCP | ctx.browserUse |
browser-use-stagehand-native |
Stagehand browser operations with explicitly configured native models | ctx.browserUse |
browser-use-runtime |
Session-owned browser resources shared by experimental providers | — |
inspector |
Cross-realm CDP hub for Host debugging, Client Runtime inspection, network capture, and Cordis trees | ctx.inspector |
session-inspector |
Sidebar tables for raw Session logs and Chat nodes | — |
inspector-profile |
Optional Web bundle for Session log and Chat node inspection | — |
tool-agent-team |
Nine tools that let the model create, message, and coordinate teammates | registers scoped tools on ctx.tools |
tool-worktree |
Optional bundle and model tool for creating and entering worktrees | ctx.tools |
webworker-packer |
Builds the gzip-compressed VFS image consumed by the browser worker preview | library and CLI — no ctx key |
webworker-runtime |
Runs the harness plugin tree inside a dedicated browser worker | library and worker entry — no ctx key |
worktree |
Creates a named Git worktree and changes the calling Session directory | ctx.worktrees |
Related documentation
- Experimental publication reference — public defaults and private exceptions.
- Worktrees — explicit branch and checkout creation.
- Computer use — desktop provider choices.
- Browser use — browser provider choices and Session ownership.
- Agent Teams subsystem — durable Team types and the
ctx.agentTeamsservice API. - Experimental subtree rules — what experimental status does and does not relax.
Dev Note
Working context for maintainers — click to expand
None.