@xemahq/opencode-xema-plugin
v0.5.14
Published
OpenCode V2 plugin `xema-runtime-bridge`: the Xema system overlay, compaction continuation invariants, root-session auto-commit, the sub-agent fan-out ceiling, tool-surface observation and shell env hygiene. Contributes no tools.
Readme
@xemahq/opencode-xema-plugin
OpenCode V2 plugin that adds Xema runtime hooks, with no tools
Overview
The xema-runtime-bridge OpenCode V2 plugin. It adds no model-facing tools; it works through hooks only:
- Appends the platform overlay and a live workspace listing to every model request.
- Tells the summarizer which invocation identifiers and deliverable constraints must survive compaction.
- Notifies the workspace service when a root session's execution succeeds.
- Caps how many sub-agent children run at once in one worker (further spawns wait).
- Records the tools OpenCode advertises, and removes the server password from agent shells.
When to use it
- In an OpenCode V2 agent runtime that serves Xema invocations.
Installation
The artifact is the directory plugin/xema-runtime-bridge/ inside the published tarball. Copy it into the worker image and enable it by path:
{
"plugins": [{ "package": "file:///opt/xema/opencode-plugins/xema-runtime-bridge" }]
}Configuration
| Variable | Default | Meaning |
| --- | --- | --- |
| XEMA_SUBAGENT_FANOUT_LIMIT | 8 | Concurrent sub-agent children per worker (1..8). Unset or empty uses the default; a larger value is refused at boot. |
Peer requirements
@opencode/plugin2.0.20 (types only)
License
Apache-2.0 © Xema — xema.dev