opencode-webui 1.0.8 → 2.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -88,14 +88,27 @@ manually.
88
88
 
89
89
  ## Extensions
90
90
 
91
- Plain React, dropped in a folder, loaded at runtime — no rebuild, no restart:
91
+ One extension = one folder, dropped in — no rebuild, no restart:
92
92
 
93
- - `~/.config/opencode/webui-extensions/<name>/main.tsx` — per-user
94
- - `<project>/.opencode/webui-extensions/<name>/main.tsx` — per-project
93
+ - `~/.config/opencode/webui-extensions/<name>/` — per-user
94
+ - `<project>/.opencode/webui-extensions/<name>/` — per-project
95
95
 
96
- Toggle any extension in Settings › Extensions. The full authoring guide — the kind
97
- contract, hooks, region markers, the `window.__opencodeUI` bridge — is
98
- [ui-extensions/README.md](ui-extensions/README.md).
96
+ ```
97
+ my-extension/
98
+ manifest.json id, version, description, disabled?
99
+ index.tsx browser stratum (wrap / replace / contribute / hook / service)
100
+ dom.ts DOM stratum (portals, canvas, post-render tweaks)
101
+ server.ts proxy stratum (routes, middleware, event tap, pollers)
102
+ engine/ opencode plugin payload (model tools, prompt hints)
103
+ ```
104
+
105
+ Presence = installed, `disabled: true` = paused, delete = uninstalled; a
106
+ higher-precedence folder with the same id shadows the shipped one, so user
107
+ customizations survive core updates with no forks. Hot reload everywhere:
108
+ browser edits repaint live via the manifest SSE push, proxy edits reload
109
+ with no restart. The full authoring guide — the five kinds, hook catalog,
110
+ DOM kit, `server.ts` mounts, precedence, and the timestamp worked example —
111
+ is [webui-extensions/README.md](webui-extensions/README.md).
99
112
 
100
113
  The built-in `/report` command files a prefilled GitHub issue with a diagnostics
101
114
  bundle (build version, enabled extensions, error ring); `--agent` hands it to the
@@ -111,7 +124,7 @@ bun run typecheck
111
124
  bun run build && bun start # production: dist/ + API on 4097
112
125
  ```
113
126
 
114
- - Extension authoring guide: [ui-extensions/README.md](ui-extensions/README.md)
127
+ - Extension authoring guide: [webui-extensions/README.md](webui-extensions/README.md)
115
128
  - Extension contract check: `bun run scripts/uitest/extensions-check.ts`
116
129
  - Architecture, editing rules, roadmap: [AGENTS.md](AGENTS.md)
117
130