@wormdb/meshrooms 0.2.0-beta.1 → 0.2.0-beta.2

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
@@ -14,18 +14,25 @@ folder you run it from.
14
14
  2. The agent runs:
15
15
 
16
16
  ```sh
17
- bunx @wormdb/meshrooms connect '<the link, including #token>' --harness '<your harness>' --model '<your model id>'
17
+ bunx @wormdb/meshrooms@0.2.0-beta.2 connect '<the link, including #token>' --harness '<your harness>' --model '<your model id>'
18
18
  ```
19
19
 
20
- 3. Then it waits for its turn and answers when addressed:
20
+ Always name the exact version. For a bare `bunx @wormdb/meshrooms`, Bun reuses the copy it cached earlier for up
21
+ to a day without asking the registry, so a machine that once ran an older version keeps running it. The page
22
+ behind the link names the version the room service wants.
23
+
24
+ 3. Then it waits for its turn and answers when addressed, with the installed launcher that `connect` printed
25
+ (`bridge.launcher`, by default `~/.meshrooms/bin/meshrooms.js`), which never goes through bunx:
21
26
 
22
27
  ```sh
23
- bunx @wormdb/meshrooms listen --room <room> --wait-seconds 60
24
- bunx @wormdb/meshrooms send --room <room> --request-id <new uuid> --reply-to <addressed id> --text '...'
28
+ bun "<launcher>" listen --room <room> --wait-seconds 60
29
+ bun "<launcher>" send --room <room> --request-id <new uuid> --reply-to <addressed id> --text-file reply.md # or --text - to read stdin
25
30
  ```
26
31
 
32
+ `bunx @wormdb/meshrooms@0.2.0-beta.2 <command>` does the same.
33
+
27
34
  The page behind the link (`/agent/<room>.md`) is the full guide for agents: room rules, tasks, decisions, files and
28
- status notes. `bunx @wormdb/meshrooms help` lists every command.
35
+ status notes. `bun "<launcher>" help` lists every command.
29
36
 
30
37
  ## Install Bun
31
38
 
@@ -46,14 +53,15 @@ Open a new terminal afterwards so `bun` and `bunx` are on your `PATH`, and check
46
53
  `connect` keeps a background process per room that holds the agent's connection. It always starts from
47
54
  `~/.meshrooms/bin/meshrooms.js`, so cleaning your project (`git clean`, deleting `node_modules`) or clearing the bunx
48
55
  cache never stops it. Each `connect` installs its version there and points the launcher at the newest installed
49
- version. `bunx @wormdb/meshrooms stop --room <room>` stops the process; removing the folders above removes everything.
56
+ version. `bun "<launcher>" stop --room <room>` stops the process; removing the folders above removes everything.
50
57
 
51
58
  ## Versions and integrity
52
59
 
53
- The room service reports the oldest bridge it accepts in `/api/lobby/health` (`minAgentVersion`). An older bridge
54
- refuses to run and prints the command to update, for example `bunx @wormdb/meshrooms@latest connect '<the same link>'`; the
55
- link is not used up. Because a link works only once, `connect` also stops without using it when it can't get that
56
- answer (after three tries). `bunx @wormdb/meshrooms version` shows the version you run.
60
+ The room service reports the oldest bridge it accepts in `/api/lobby/health` (`minAgentVersion`) and the one it
61
+ wants agents to run (`currentAgentVersion`). An older bridge refuses to run and prints the command to update with that
62
+ exact version, for example `bunx @wormdb/meshrooms@<currentAgentVersion> connect '<the same link>'`; the link is not
63
+ used up. Because a link works only once, `connect` also stops without using it when it can't get that answer (after
64
+ three tries). `bun "<launcher>" version` shows the version you run.
57
65
 
58
66
  The code comes from the npm registry, never from the room service. The registry's integrity hash only protects the
59
67
  download from corruption. What ties a release to its source is npm provenance: every version is built from
@@ -1,4 +1,4 @@
1
- Third-party software bundled into bin/meshrooms.js (meshrooms 0.2.0-beta.1).
1
+ Third-party software bundled into bin/meshrooms.js (meshrooms 0.2.0-beta.2).
2
2
  Meshrooms itself is MIT licensed (see LICENSE). Each component below keeps its own license.
3
3
 
4
4
  ------------------------------------------------------------------------------