@cecwxf/dsh-room 0.3.2 → 0.3.4

package/README.md

@@ -2,6 +2,27 @@
 
 DeepSeek Harness plugin **dsh room** (sidebar label **DSH Room**) for Collab rooms: accountless, end-to-end encrypted, one-to-many agent collaboration over the default VPS Node relay (optional Cloudflare).
 
+
+## Confirm / upgrade to 0.3.3
+
+User hangs on **Creating…** for Local-only were caused by older builds (≤0.3.1) awaiting joins with no timeout, and by `bridge.start()` blocking every API call while rejoining rooms. **0.3.3** returns create immediately.
+
+```bash
+# in the dsh profile that has dsh-room (e.g. ~/.dsh/profiles/web)
+pnpm add @cecwxf/dsh-room@0.3.3
+# or: dsh plugin add @cecwxf/dsh-room@0.3.3
+```
+
+Then **fully restart dsh** (not only live-reload), hard-refresh the web UI (Ctrl+Shift+R), and confirm:
+
+```bash
+# dump-config / logs should show dsh-room 0.3.3
+curl -s http://127.0.0.1:<dsh-port>/api/collab/version
+# → {"name":"@cecwxf/dsh-room","version":"0.3.3"}
+```
+
+The Create dialog subtitle also shows `dsh-room 0.3.3`. If it still says `?` or an older version, the UI is serving a cached client — hard refresh again after restart.
+
 ## Install (one-liner)
 
 ```sh
@@ -107,3 +128,13 @@ Create room → defaults to **LAN / VPS** with `62.234.113.56:80` (public direct
 **MCP tools**: `workspace_list`, `workspace_read`, `workspace_stat`, `workspace_search`, `workspace_write`, `workspace_mkdir`, `workspace_delete`, `workspace_exec`.
 
 API: `GET/POST /api/collab/rooms/:id/config`, `POST /api/collab/rooms/:id/mcp`, `GET /api/collab/lan/browse`, `POST /api/collab/approvals/decide`.
+
+## Models and validation (0.3.4)
+
+Model selectors load the active dsh provider catalog and show its versioned names (for example `DeepSeek-V41-Flash`), while passing the catalog's exact provider/model IDs to sessions. Agents inherit the room model; rooms inherit the dsh selection. Changing a model resets the affected idle sessions. Stop running agents before changing their model or scope. Missing real agent services now produce a failed run; mock execution requires explicit `localAgentRunner: mock`.
+
+Short `collab://join/...` invitations use the host's configured `relayUrl`; invitations specifying a LAN or relay host use that explicit address.
+
+From the repository, run `npm test`, `npm run smoke`, and `npm run e2e:dsh:local` for offline/mock regression coverage. `DEEPSEEK_API_KEY=... npm run e2e:dsh:real` exercises real dsh sessions: agent create/edit/remove, coding task claim/completion, worktree diff/merge, executable code, review, and moderator delegation/summary. It uses an isolated dsh home and workspace, and makes paid model requests. Optional `DSH_PLUGIN_SOURCE` selects a packed npm tarball; `DSH_REAL_RELAY=1` uses a relay, with `DSH_TEST_RELAY` overriding the default URL. Credentials are inherited only through the child process environment.
+
+For two running isolated real dsh hosts, `DSH_MAC_CONTROL=/path/mac.json DSH_VPS_CONTROL=/path/vps.json node scripts/e2e-dsh-cross-real.mjs` verifies Mac → VPS → Mac model cooperation. Each control file contains the authenticated API `base` and `cookie`; the Mac file also contains `roomId` and `invite`. Keep these files private and remove them after testing.