rovloom 0.4.0 → 0.5.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.
Files changed (29) hide show
  1. package/README.md +13 -41
  2. package/dist/src/admin/index.js +1 -1
  3. package/dist/src/{chunk-1fyfrgte.js → chunk-0ake7e4r.js} +4 -4
  4. package/dist/src/{chunk-qfyefed3.js → chunk-1bf0wmgk.js} +1 -1
  5. package/dist/src/chunk-5j0gj6w2.js +7 -0
  6. package/dist/src/{chunk-dtj9y82v.js → chunk-5n8csngz.js} +119 -34
  7. package/dist/src/{chunk-v1httsp6.js → chunk-64ftwe9b.js} +2 -2
  8. package/dist/src/{chunk-76wgt2g5.js → chunk-9y36gntb.js} +6 -5
  9. package/dist/src/{chunk-ydmabg5t.js → chunk-9yg6x3gt.js} +5 -5
  10. package/dist/src/{chunk-keg92d31.js → chunk-abd4envz.js} +13 -11
  11. package/dist/src/{chunk-6hxy1fcg.js → chunk-bspzg8er.js} +2 -2
  12. package/dist/src/{chunk-t3pn1435.js → chunk-e7x51y0t.js} +2 -2
  13. package/dist/src/{chunk-qab3m6nh.js → chunk-ebm3kvnq.js} +18 -5
  14. package/dist/src/{chunk-ymsx7hhd.js → chunk-erdq0rn8.js} +8 -8
  15. package/dist/src/{chunk-wdr3sdsm.js → chunk-fnakrk0a.js} +42 -11
  16. package/dist/src/{chunk-bjdqj43d.js → chunk-hpzr94hm.js} +23 -6
  17. package/dist/src/{chunk-fd9n51mc.js → chunk-n073xnr1.js} +51 -22
  18. package/dist/src/{chunk-xmkgq3nh.js → chunk-r0nfthsf.js} +2 -2
  19. package/dist/src/{chunk-z1vhdr3c.js → chunk-rwpynx2j.js} +10 -10
  20. package/dist/src/{chunk-8x6ygvhh.js → chunk-sj24fpz3.js} +4 -4
  21. package/dist/src/{chunk-5vx1b9z8.js → chunk-xhq21g24.js} +3 -3
  22. package/dist/src/{chunk-4af38z2b.js → chunk-ybte82d3.js} +1 -1
  23. package/dist/src/{chunk-khmgp03q.js → chunk-ympzv86c.js} +65 -13
  24. package/dist/src/{chunk-se5daacy.js → chunk-z7kkfrgz.js} +1 -1
  25. package/dist/src/cli/index.js +12 -12
  26. package/dist/src/cli/main.js +9 -9
  27. package/dist/src/mcp/index.js +2 -2
  28. package/dist/src/webui/index.js +13 -3
  29. package/package.json +1 -1
package/README.md CHANGED
@@ -27,47 +27,16 @@ port is opened on the machines that run them.
27
27
  ## How it works
28
28
 
29
29
  AI Agents and CLIs talk to the Gateway over MCP. Each device runs one Connector with local provider
30
- adapters, which can manage several runtime instances.
31
-
32
- ```mermaid
33
- flowchart TB
34
- subgraph ACCESS["Access layer"]
35
- direction LR
36
- AI["AI Agent / AI Bot"]
37
- CLI["CLI"]
38
- end
39
-
40
- GW["Gateway<br/>MCP facade · registry · routing · policy<br/>call ledger · result storage · management UI"]
41
-
42
- subgraph DEVICE_A["Device A"]
43
- direction TB
44
- CA["One Connector<br/>one device identity · local policy"]
45
- PA["Provider adapters<br/>trusted binding per instance"]
46
- LA["Local Luvus<br/>Host / session"]
47
- HA["Local Herdr<br/>session runtime"]
48
- CA <--> PA
49
- PA <--> LA
50
- PA <--> HA
51
- end
52
-
53
- subgraph DEVICE_B["Device B"]
54
- direction TB
55
- CB["One Connector<br/>one device identity · local policy"]
56
- PB["Provider adapters<br/>trusted binding per instance"]
57
- LB["Local Luvus<br/>Host / session"]
58
- HB["Local Herdr<br/>session runtime"]
59
- CB <--> PB
60
- PB <--> LB
61
- PB <--> HB
62
- end
63
-
64
- AI <-->|"MCP requests / results"| GW
65
- CLI <-->|"commands / results"| GW
66
- GW <-->|"requests ↓ · results / events ↑"| CA
67
- GW <-->|"requests ↓ · results / events ↑"| CB
68
- CA -.->|"initiates outbound WSS"| GW
69
- CB -.->|"initiates outbound WSS"| GW
70
- ```
30
+ adapters, which can manage several runtime instances. Sessions in those runtimes run local Agents
31
+ such as Claude Code, Codex, Pi, OpenCode and Fx; the Agent software and logins stay on that device.
32
+
33
+ <p align="center">
34
+ <a href="docs/assets/architecture/architecture.en.svg">
35
+ <img src="docs/assets/architecture/architecture.en.png" alt="Rovloom architecture: MCP clients access a Gateway; one outbound Connector per device routes calls through provider adapters to local Luvus and Herdr runtimes and their session Agents, such as Claude Code, Codex, Pi, OpenCode and Fx." width="1200">
36
+ </a>
37
+ </p>
38
+
39
+ Solid arrows show requests and returned results/events; dashed arrows show Connector-initiated outbound WSS. Click the image for the scalable SVG.
71
40
 
72
41
  ## Typical setup: two machines, one Agent
73
42
 
@@ -85,6 +54,9 @@ workstation's real sessions.
85
54
  curl --fail --silent --show-error --location https://raw.githubusercontent.com/ArnoChenFx/rovloom/main/scripts/install.sh | sh
86
55
  ```
87
56
 
57
+ Already have Bun (1.4.3 or newer)? `bun add -g rovloom` installs the npm package instead — no
58
+ bundled runtime to download — and `bunx rovloom` runs it without installing.
59
+
88
60
  Windows PowerShell and the Docker Gateway are covered in the [Quick Start](docs/QUICK-START.md).
89
61
 
90
62
  | | Linux | macOS | Windows |
@@ -8,7 +8,7 @@ import {
8
8
  StoreManagementWriteService2,
9
9
  createManagementHandler2,
10
10
  createManagementSessionAdapter2
11
- } from "../chunk-khmgp03q.js";
11
+ } from "../chunk-ympzv86c.js";
12
12
  import {
13
13
  sampleManagementTransport2,
14
14
  createManagementTransportProjection2
@@ -18,18 +18,18 @@ import {
18
18
  import"./chunk-09f9q26d.js";
19
19
  import {
20
20
  readRuntimeConfig2
21
- } from "./chunk-6hxy1fcg.js";
21
+ } from "./chunk-bspzg8er.js";
22
22
  import {
23
23
  resolveRoleConfigPath2
24
- } from "./chunk-qfyefed3.js";
24
+ } from "./chunk-1bf0wmgk.js";
25
25
  import {
26
26
  runtimeReference
27
- } from "./chunk-se5daacy.js";
27
+ } from "./chunk-z7kkfrgz.js";
28
28
  import {
29
29
  CLI_ERROR_CODES,
30
30
  CliError2,
31
31
  readConfig2
32
- } from "./chunk-bjdqj43d.js";
32
+ } from "./chunk-hpzr94hm.js";
33
33
  import"./chunk-3nnahj0j.js";
34
34
  import {
35
35
  lockContent
@@ -1,7 +1,7 @@
1
1
  // @bun
2
2
  import {
3
3
  CliError2
4
- } from "./chunk-bjdqj43d.js";
4
+ } from "./chunk-hpzr94hm.js";
5
5
 
6
6
  // src/cli/config-path.ts
7
7
  import { homedir } from "os";
@@ -0,0 +1,7 @@
1
+ // @bun
2
+ // src/pairing-policy.ts
3
+ var DEFAULT_PAIRING_POLICY_REF = "rovloom_setup_v1";
4
+
5
+ export { DEFAULT_PAIRING_POLICY_REF };
6
+
7
+ //# debugId=C4F08DA3B385473E64756E2164756E21