@rho-workspace/rho 0.5.3 → 0.5.4

package/dist/web/composition.json

@@ -1,7 +1,7 @@
 {
   "format": "rho.web-build/1",
   "uiProtocol": "0.1-draft",
-  "rendererBuild": "0f756895a02299d87adeef11395d33392605448723c95db1c0ff3abbdbc736b6",
+  "rendererBuild": "485f1b19e789f432be41a9566199b3dddf2ff479e48ab4e3c1cd4ea75fe16033",
   "ownerEntries": [
     {
       "plugin": "documents",
@@ -10,7 +10,7 @@
       "component": "rho.editor",
       "version": "0.2.0",
       "source": "web/entries/documents.tsx",
-      "packageVersion": "0.4.10",
+      "packageVersion": "0.4.11",
       "entrySha256": "076b4b63643813eb32f8c81caa35abdcf0e1a7b88420d49e7b984ec9acd53d23"
     },
     {
@@ -60,7 +60,7 @@
       "component": "rho.agent-note",
       "version": "0.2.0",
       "source": "web/entries/agent.tsx",
-      "packageVersion": "0.4.27",
+      "packageVersion": "0.4.28",
       "entrySha256": "0e18d175dfc25fd8e237ec0341422e0d1311d2d8882e487962e8c7c25794d69e"
     },
     {
@@ -71,8 +71,8 @@
       "version": "1",
       "source": "web/entries/kernel.tsx",
       "export": "notebook",
-      "packageVersion": "0.5.2",
-      "entrySha256": "b90ad1273ee9a9be8b3c9bd5799ec31ae22d47b643b6ec6101dd1ffc11a00cb6"
+      "packageVersion": "0.5.5",
+      "entrySha256": "b5a012c8cd766e04cafb550e62eeec1c3b85eae07ac2fa69175f472268ddfbb2"
     },
     {
       "plugin": "kernel",
@@ -82,8 +82,8 @@
       "version": "1",
       "source": "web/entries/kernel.tsx",
       "export": "variables",
-      "packageVersion": "0.5.2",
-      "entrySha256": "b90ad1273ee9a9be8b3c9bd5799ec31ae22d47b643b6ec6101dd1ffc11a00cb6"
+      "packageVersion": "0.5.5",
+      "entrySha256": "b5a012c8cd766e04cafb550e62eeec1c3b85eae07ac2fa69175f472268ddfbb2"
     },
     {
       "plugin": "kernel",
@@ -93,8 +93,8 @@
       "version": "1",
       "source": "web/entries/kernel.tsx",
       "export": "plots",
-      "packageVersion": "0.5.2",
-      "entrySha256": "b90ad1273ee9a9be8b3c9bd5799ec31ae22d47b643b6ec6101dd1ffc11a00cb6"
+      "packageVersion": "0.5.5",
+      "entrySha256": "b5a012c8cd766e04cafb550e62eeec1c3b85eae07ac2fa69175f472268ddfbb2"
     },
     {
       "plugin": "kernel",
@@ -104,8 +104,8 @@
       "version": "1",
       "source": "web/entries/kernel.tsx",
       "export": "flow",
-      "packageVersion": "0.5.2",
-      "entrySha256": "b90ad1273ee9a9be8b3c9bd5799ec31ae22d47b643b6ec6101dd1ffc11a00cb6"
+      "packageVersion": "0.5.5",
+      "entrySha256": "b5a012c8cd766e04cafb550e62eeec1c3b85eae07ac2fa69175f472268ddfbb2"
     },
     {
       "plugin": "kernel",
@@ -115,8 +115,8 @@
       "version": "1",
       "source": "web/entries/kernel.tsx",
       "export": "servers",
-      "packageVersion": "0.5.2",
-      "entrySha256": "b90ad1273ee9a9be8b3c9bd5799ec31ae22d47b643b6ec6101dd1ffc11a00cb6"
+      "packageVersion": "0.5.5",
+      "entrySha256": "b5a012c8cd766e04cafb550e62eeec1c3b85eae07ac2fa69175f472268ddfbb2"
     },
     {
       "plugin": "kernel",
@@ -126,8 +126,8 @@
       "version": "1",
       "source": "web/entries/kernel.tsx",
       "export": "object",
-      "packageVersion": "0.5.2",
-      "entrySha256": "b90ad1273ee9a9be8b3c9bd5799ec31ae22d47b643b6ec6101dd1ffc11a00cb6"
+      "packageVersion": "0.5.5",
+      "entrySha256": "b5a012c8cd766e04cafb550e62eeec1c3b85eae07ac2fa69175f472268ddfbb2"
     },
     {
       "plugin": "documents",
@@ -255,7 +255,7 @@
     {
       "path": ".vite/manifest.json",
       "bytes": 23614,
-      "sha256": "73c1dd5fa498ac20dff8d7ef174ea092ab98b11504b5bfd602d898b9653d699c"
+      "sha256": "3f5cd1589d4c851c00b0e6dedecf2df169dba3eae111302f38bdb6b7fed51460"
     },
     {
       "path": "assets/answer-board-CBkGbSLD.js",
@@ -267,55 +267,55 @@
       "bytes": 20280,
       "sha256": "b2e4c27b4627f85ce52f421d07921fcb64c1c0c816429cb8c094af6a724ba297"
     },
-    {
-      "path": "assets/choices-B-y2OYvE.js",
-      "bytes": 11095,
-      "sha256": "e9114124afd09f7b42da863bc548f539b9efcb65a4d0492c1bcd3a686374d739"
-    },
     {
       "path": "assets/choices-DLah50GC.css",
       "bytes": 1659,
       "sha256": "2285c02644e12f379880df802cd34ed6262d73a159aeb9a12e80de44f12db447"
     },
+    {
+      "path": "assets/choices-DU9kHlyQ.js",
+      "bytes": 11095,
+      "sha256": "85b5a4a9e61cc761c32c5f09bc8c760681cfc57d829088dc932e0aeff77990c9"
+    },
     {
       "path": "assets/console-By4Mvn1y.css",
       "bytes": 3779,
       "sha256": "38fdefe20f181e6a050793f715a13bcbde2e9c167f80f554a775e3578dcd78bc"
     },
     {
-      "path": "assets/console-e1P5qYQ5.js",
+      "path": "assets/console-Dbdo-5oO.js",
       "bytes": 21020,
-      "sha256": "de82e2b33fddc3401865eb64a60dd5a78261828051b13334cd98746c5aa33cde"
+      "sha256": "6a39c3e3abc4d95d81a9cb6790c7ba1c9d88045c3be266916bbf455be1f642eb"
     },
     {
-      "path": "assets/dist-CBM2oq6g.js",
-      "bytes": 35411,
-      "sha256": "e082177027b22e9100f90213342d1f29ac735add695ceb592da6a9fc4a228b7b"
+      "path": "assets/dist-B2V0VDO0.js",
+      "bytes": 183314,
+      "sha256": "3ab47b21fad70499d77744c23d95b1320a2c7fdcd00e2a57e4b108bdbf935004"
     },
     {
-      "path": "assets/dist-CH56yNDn.js",
+      "path": "assets/dist-BV3hWfn_.js",
       "bytes": 37498,
-      "sha256": "a7022c2c528d9d083c294bf943b7134214935262753a12761a32bd60d6f5d7ec"
+      "sha256": "eb2266a7b0b351d4975a1964d7fb473c7d980ac055365ca142f03e1ed5029b39"
     },
     {
-      "path": "assets/dist-DCtcCJPs.js",
-      "bytes": 34901,
-      "sha256": "9deb65f8b227a08473b422b448735f045aa2251acf498f169640f7d38d96173e"
+      "path": "assets/dist-CLNF2g-E.js",
+      "bytes": 35411,
+      "sha256": "07fd5602ed1daf630dd57c1783d6c93f5a31fb53fdcf0be9582660ec2d7cdad3"
     },
     {
-      "path": "assets/dist-Dd3iAGFy.js",
-      "bytes": 183314,
-      "sha256": "67a004264480b8770b75661ec74a64b29f4364d632be674a1539da8171f6b316"
+      "path": "assets/dist-D25Vn17i.js",
+      "bytes": 44651,
+      "sha256": "88fcb93008219182ced64313e5c93fe4cb47b67320ce98fc257291b707e12ad6"
     },
     {
-      "path": "assets/dist-DEorbOW0.js",
-      "bytes": 44651,
-      "sha256": "2835ba838b5d22251d642ec7b3408a30509c014db71b2804f4886ed564b70b20"
+      "path": "assets/dist-DCtcCJPs.js",
+      "bytes": 34901,
+      "sha256": "9deb65f8b227a08473b422b448735f045aa2251acf498f169640f7d38d96173e"
     },
     {
-      "path": "assets/explore-in-muWXOGOY.js",
+      "path": "assets/explore-in-8Q5ftt-E.js",
       "bytes": 783,
-      "sha256": "3be0b18340c3b93c6b13a3b68841126dee8f90417d76bcc41efb58086aae5e1a"
+      "sha256": "6ebe9c13e83db24b8ca8a2e4f3786ef7881f28fafb9ce8c85ace154567dea030"
     },
     {
       "path": "assets/facts-BMO6V3-3.js",
@@ -333,9 +333,9 @@
       "sha256": "e84aa51d7376fc0a6104c0b140821c54bc25a2b55be32be6005e08b85dd7e0df"
     },
     {
-      "path": "assets/graph-CK-df5lh.js",
+      "path": "assets/graph-hS2kvHTI.js",
       "bytes": 48764,
-      "sha256": "e1d8e1df49559b199e53b222a352bf539136e1ce6d27d35aaaaf95d26faa17a1"
+      "sha256": "8044be54a3190fe3c827e3f8a35d1f9b77fedc596f1903a4af40d71e5a68b2b6"
     },
     {
       "path": "assets/home-CCbP6kS-.js",
@@ -343,14 +343,14 @@
       "sha256": "6bbbe67af01bd03b2777abcc02e63dda1bad1fa7aaf9296b07cda04ac481e7cb"
     },
     {
-      "path": "assets/index-BYuKpyoi.js",
-      "bytes": 1718445,
-      "sha256": "efd135bd3200c1fa1f6f84bc02fe7603c9af4becdcfc86905f298c4db8f32624"
+      "path": "assets/index-BHQIaDsx.js",
+      "bytes": 1762439,
+      "sha256": "bf3f31d63d0e5440f7c52c8948ef756d25d73062eb6dcd937f50a14abaee62f6"
     },
     {
-      "path": "assets/index-DBd77u4a.css",
-      "bytes": 109992,
-      "sha256": "ed7e295fdd91974451eabab3fb801db8a549c9a8ce53308ec3fcb9dafcd488da"
+      "path": "assets/index-Cj1_iqyK.css",
+      "bytes": 111026,
+      "sha256": "289f0730221144e47d64798dd722e39289c5f119b258e09ba1a501e97fb816ea"
     },
     {
       "path": "assets/KaTeX_AMS-Regular-BQhdFMY1.woff2",
@@ -663,9 +663,14 @@
       "sha256": "717274e2c02c05db67e7f1bf6fec4dfae799f3a2780ea7a95c4fdf0d160dfab8"
     },
     {
-      "path": "assets/notes-meaning-B3HFbh84.js",
+      "path": "assets/notes-meaning-DdPbtNzJ.js",
       "bytes": 5850,
-      "sha256": "b30da1564e36fe28385931cbb68fdd2b472a8ff444e8da86d756ec67d0199795"
+      "sha256": "8fa69b98fa48426a9eed7998f4c890906739e203e9e36156afb25ab9903e143e"
+    },
+    {
+      "path": "assets/overview-BV6ZO5TO.js",
+      "bytes": 48360,
+      "sha256": "f0fe461d635c2f04b7066cabea7419a186e880588de4d4e0b94b48937ac91174"
     },
     {
       "path": "assets/overview-CmC7mah4.css",
@@ -673,14 +678,9 @@
       "sha256": "f6b19e1fbbb7cc884faff634b6f7b016f806313b946600b11bbf76dc59caf1a9"
     },
     {
-      "path": "assets/overview-D1Ev2OC_.js",
-      "bytes": 48360,
-      "sha256": "75af11602160708703bf2fad8a8c3f9fe3133100abb118902cb3eaa1f39c9dc3"
-    },
-    {
-      "path": "assets/preview-HbmQKUGY.js",
+      "path": "assets/preview-n5lOOdjN.js",
       "bytes": 4705,
-      "sha256": "8386028a035490ae285ae9f8a87e7e0afc2535a28954c1799471c73decd93828"
+      "sha256": "bfe4a5b0af6059c01e9051f2573802abc5aa690228b4792cb89013455f94de07"
     },
     {
       "path": "assets/r-CxDmU1I4.js",
@@ -698,9 +698,9 @@
       "sha256": "364a909acd2231cafe737e8f9b19ad58ba16d3b6cbb90b0de78015dd437bd56b"
     },
     {
-      "path": "assets/review-BVh9jWMB.js",
+      "path": "assets/review-CmWou4Iv.js",
       "bytes": 4860,
-      "sha256": "af9ed74625287dff37bf23c4f7669c3ceff65993c8a0625c639cc0e87ac0e311"
+      "sha256": "1665cca29b3db5e5c7a70ed7ed053b48d797d026dbf2336b325270bcad8d9287"
     },
     {
       "path": "assets/rolldown-runtime-XKyaHtl9.js",
@@ -708,9 +708,9 @@
       "sha256": "548d1dbf321e7d2ae804fcc158b588706a7c52f8ca175de1490c6ccb4dbe55b7"
     },
     {
-      "path": "assets/skills-DPaEYkln.js",
+      "path": "assets/skills-Dy7n3L9d.js",
       "bytes": 12538,
-      "sha256": "85cb2ce9fca863dfa92fcbed0af31411f7157fbd371b650fa0c9317ba7f4e7ca"
+      "sha256": "2779f6bc30eecb6a28d973a6b58582ccf4a000319cb95fdba4e134909ec3c240"
     },
     {
       "path": "assets/skills-WkE0KCzn.css",
@@ -718,9 +718,9 @@
       "sha256": "162823ce43fd1e1f2bd92a330516c171280b59a0b5460752f0d7aba5f194f3eb"
     },
     {
-      "path": "assets/skills-work-dvjfy_tu.js",
+      "path": "assets/skills-work-Cj0W6b-I.js",
       "bytes": 2528,
-      "sha256": "684ed0ad2a9ce20721997e00bbad3d37bcf3525652cede531345de7aed3880cf"
+      "sha256": "89756a0567fcad66589853d68a007adc07842ee1cc1ec34af2b12da0a2393170"
     },
     {
       "path": "assets/snapshot-CAxBYPvV.js",
@@ -733,29 +733,29 @@
       "sha256": "7acddf1303643a15a8df990808a42e218033edf56b8c03b0fcc8271683b0195f"
     },
     {
-      "path": "assets/studio-process-BYm8mjRJ.js",
+      "path": "assets/studio-process-QOY_n2_8.js",
       "bytes": 22888,
-      "sha256": "ffae8099f551f88647551c6b15c06a4da3c7b9990352d59214f48b7aee4a9e02"
+      "sha256": "1304e5eb2ca890173dd7252bcb9dc54e6e2f041d60fb253a94e201f17719234e"
     },
     {
-      "path": "assets/timeline-events-CDZ7wiJX.js",
+      "path": "assets/timeline-events-DmX1BCh3.js",
       "bytes": 2227,
-      "sha256": "4f9a2b4f3cf4e1c3ef14c77f8a6a933c88e2bd2c9f51e762a963762d14af3c09"
+      "sha256": "71dfdab4a0cd37bfb42c81433a906ac4158ff0e7681ff84bdb0de7f70075db3f"
     },
     {
-      "path": "assets/work-turns-BeCt303c.js",
+      "path": "assets/work-turns-Co0C71rJ.js",
       "bytes": 1460,
-      "sha256": "0f9aff74186d972c40a011c7b0026db65099340cb046f7138f40de004cb33ff7"
+      "sha256": "4aa3aef0ffcbfc25cbfed3c82eabe46fb81a23c946ef1aaa6938b744bae8e9ed"
     },
     {
-      "path": "assets/workspace-d5Hw_ClZ.js",
+      "path": "assets/workspace-BKFefRfJ.js",
       "bytes": 81806,
-      "sha256": "1c39694ffca7a0fc19a881bdb4cf57ca317265b74db67bd9eaa19752f61df349"
+      "sha256": "56ada93c5dd4e4ea68f3c020d3d56df20418b72710dcdf017129bda524cc196e"
     },
     {
       "path": "index.html",
       "bytes": 1142,
-      "sha256": "49127803afe002be4fc0e8a4d9c15034008f5a5a3ba165a1761b395a9dec73fa"
+      "sha256": "59d7727507695bb05eb2c28e08978e50536dbd272dc63bf93818a2ef1f7c7c54"
     },
     {
       "path": "licenses.md",
@@ -765,10 +765,10 @@
     {
       "path": "renderer.json",
       "bytes": 85,
-      "sha256": "c09ea3b45e1d045fbf0757268037e38873e96ad332ffa4bdb1c5cc389166579a"
+      "sha256": "aaac148d95413846299416f8f8314510ae658869308342c54b2db2c576cc7602"
     }
   ],
-  "assetsSha256": "263dc1e92446b456e3e411ad23dad21c6ec9cef04df819d29d5fdea30a10c2fe",
+  "assetsSha256": "c3e8d826c3113df961293ef759a581501caa44f869cf279b118cd4c4e5cc7424",
   "licenses": "licenses.md",
   "node": "v22.23.4"
 }

package/dist/web/index.html

@@ -6,13 +6,13 @@
     <meta name="color-scheme" content="light" />
     <title>Rho Workspace</title>
     <link rel="icon" href="data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 32 32'%3E%3Crect width='32' height='32' rx='8' fill='%231e6b52'/%3E%3Ctext x='16' y='23' font-family='Georgia,serif' font-size='22' text-anchor='middle' fill='white'%3E%CF%81%3C/text%3E%3C/svg%3E" />
-    <script type="module" crossorigin src="/assets/index-BYuKpyoi.js"></script>
+    <script type="module" crossorigin src="/assets/index-BHQIaDsx.js"></script>
     <link rel="modulepreload" crossorigin href="/assets/rolldown-runtime-XKyaHtl9.js">
     <link rel="modulepreload" crossorigin href="/assets/react-Dss-ouuy.js">
     <link rel="modulepreload" crossorigin href="/assets/markdown-0ngRuTpW.js">
     <link rel="modulepreload" crossorigin href="/assets/home-CCbP6kS-.js">
     <link rel="modulepreload" crossorigin href="/assets/canvas-BXhC8RDZ.js">
-    <link rel="stylesheet" crossorigin href="/assets/index-DBd77u4a.css">
+    <link rel="stylesheet" crossorigin href="/assets/index-Cj1_iqyK.css">
   </head>
   <body>
     <div id="root"></div>

package/dist/web/renderer.json

@@ -1 +1 @@
-{"rendererBuild":"0f756895a02299d87adeef11395d33392605448723c95db1c0ff3abbdbc736b6"}
+{"rendererBuild":"485f1b19e789f432be41a9566199b3dddf2ff479e48ab4e3c1cd4ea75fe16033"}

package/docs/FRONTEND.md

@@ -160,18 +160,31 @@ inspect what happened. The application gives those actions direct places:
   an ended session stay with their cells in the Notebook. With these views on the page, the
   Notebook leaves its own variables and plots out.
 - **Data flow** (`rho.flow`) shows how the values of a live session were made, as a tab beside
-  Variables (else in the right column). Each cell that made something still there is a box, in
-  the order the cells ran: its first line or purpose, the project files and folders it read, and
-  what it made one to a line (values with type and size, its plots, the files it wrote). A line
-  in the left margin runs from a value, or a written file, to each box that read it. A cell
-  that changed a value it read (`m$x <- …`) continues the cell that made it: its box says
-  "Changes what R 6 made", and what that value came from goes with it. A box that read a value
-  or file made again since says so in amber. Pointing at a box keeps its path in view and fades
-  the rest; the newest cell's box is outlined. A value opens as its own view, a file in its
-  viewer; the box's head opens its code (with the code of the cells it continues), its plots,
-  who ran it and Show in the Notebook. It follows the kernel's records (below), not the code:
-  60 values, 8 plots and 24 written files are drawn at most, and older ones are counted
-  ([episode](SIMULATED-PROJECT-EPISODE.md#data-flow-html-pages-and-object-dependent-cases)).
+  Variables (else in the right column). It is a graph of values: the project files and folders
+  the session read at the top, the results at the bottom (the files it wrote and the plots it
+  drew, else the values nothing reads), and the values between in rows. Each node is titled with
+  the meaning its `# means:` comment gives (the Agent writes these above the statement that first
+  makes the value; `# means NAME:` names one of several), with the name beneath, and shows the
+  name alone without one. A bar names the results: choosing one draws what leads to it, and the
+  first is chosen when every result at once would put more than six values in a row. Values that
+  lead to no result are named below the graph, and choosing one draws what leads to it. A chosen
+  value colors what it comes from and what comes of it; its panel gives its meaning, how and where
+  it was made, what it uses and leads to, and which results it reaches. A value can be looked at,
+  a file opened, and the cell that made it shown in the Notebook. A narrow view (under 640 px)
+  puts the chosen value above the graph. Its values come from the kernel's records (below), each
+  meaning from the code of the cell that made the value, and at most 80 values are drawn at once
+  ([episode](VARIABLE-FLOW-EPISODE.md#meaning-in-the-code)).
+- **How variables relate** ([episode](VARIABLE-FLOW-EPISODE.md)). Under each Notebook cell, what it
+  read and from which cell ("Read co from R 3"), and the later cells that read what it made ("ratio
+  read in R 6"); a cell named there goes to that cell and marks it. A cell that makes at least three
+  values offers "How its values came about", the same graph, under it. Variables names the cell that
+  made each value as it is now and the cells that read it. An R or Python script's editor has a Data
+  flow switch in its header, kept with the page: the script's flow, read from the text in the editor
+  as it is typed (nothing runs), shows beside the code, or below it in a view under 640 px. Its
+  nodes are titled by the same comments as the session's, and the flow line says how many values
+  have a meaning written in the code. The code marks the lines that make the chosen value, those it
+  comes from and those it leads to, in the colors of the key above the flow; choosing a value puts
+  the cursor on the line that makes it, and a click on a line that makes a value chooses it.
 - **Servers** (`rho.servers`) shows where the live sessions run: this machine and each place, a
   folder on one of the person's servers, reached through serverctl when serverctl manages it and
   with ssh otherwise. A place shows its server and folder, how it is reached, what its last check saw
@@ -502,8 +515,11 @@ opening a value or a server's file as a view, code waiting for the Notebook's li
 Notebook's form with the page, which views the page has, and a conversation's share of the
 sessions. Highlighting and Markdown come from the shell services (`highlight`, `markdown`).
 The plugin's `./code` finds the statement a script line runs (`statementAt`), writes the code
-that loads a table or runs a script, and makes Data flow's boxes and lanes (`lineage`);
-`web/entries/documents.tsx` sends a line through the page's `runCode` shell service.
+that loads a table or runs a script, what each cell read from which cell (`cellRelations`), and
+Data flow's graph of values from a session (`sessionGraph`) or a script's text (`scriptGraph`);
+`web/entries/documents.tsx` sends a line through the page's `runCode` shell service, draws a
+script's graph with the plugin's `ScriptFlowView`, keeps the chosen value (from the graph or the
+cursor's line, `graphNodeAt`) and marks the lines behind and in front of it (`graphMarks`).
 The HTML page view is `html.reader` from Rho-plugins (HTML 0.1.0); Rho gives it `pageFrame`, the
 service's `/frame.html` (sandboxed, with its own policy and no network; the page's policy adds
 only `frame-src 'self'`), and `fileBytes`, a file snapshot's bytes (`readFile` in `web/previews.ts`).

package/docs/HEADLESS.md

@@ -37,23 +37,39 @@ it. Missing browser renderers do not disable the headless protocol.
 ## Install and start
 
 The selected baseline is macOS arm64, Node 22.22.3 (engine range
-`>=22.22.0 <23`), npm 10.9.8, Python 3 with `fcntl`, and Rscript 4.5.2. Windows x64
+`>=22.22.0 <27`; the suite and the installed check also passed on Node 24.22.2 and
+26.13.0), npm 10.9.8, Python 3 with `fcntl`, and Rscript 4.5.2. Windows x64
 was checked with Node 22.23.4 and Rscript 4.5.1; its writer lock needs no Python, and
 there `rho.cmd` starts Rho and Ctrl+Break on its console stops it in order.
-The unsigned local tarball contains Plugins and the selected digest-checked Core
-binary. R and any project-selected packages are external prerequisites, and so are
-the Agent clients: conversations drive the person's installed Claude Code or Codex.
+The unsigned npm package `@rho-workspace/rho` contains Plugins and one digest-checked Core
+binary for each of macOS arm64, Linux x64 and arm64 and Windows x64; CI installs it on each.
+R and any project-selected packages are external prerequisites, and so are the Agent
+clients: conversations drive the person's installed Claude Code or Codex.
 The service, documents, declared files and saved resource readers work without R.
 An unavailable Rscript returns an unknown dependency probe and prevents managed R execution.
-Other platforms and npm registry publication are unverified.
+Other platforms are unverified.
 
 ```sh
-npm install --prefix /absolute/install /absolute/rho-workspace-rho-0.5.2.tgz
-/absolute/install/node_modules/.bin/rho \
-  --root /absolute/projects --state-dir /absolute/service-state
+npm install -g @rho-workspace/rho
+rho --root /absolute/projects --state-dir /absolute/service-state
 ```
 
 Create the allowed projects directory first. Keep service state outside projects.
+
+A person who has no folders to name runs the package with no arguments instead (from
+0.5.4; 0.5.3 prints its usage and exits 2):
+
+```sh
+npx @rho-workspace/rho
+```
+
+That start uses `~/Rho/projects` and `~/Rho/state`, creates both, ships the example
+project on a new state, and prints — after the machine line — the address to open,
+the two folders, and whether the Agent client and R were found, so a missing one is
+read at startup rather than discovered later. It opens the address in a browser when
+stdout is an interactive terminal. Every flagged start keeps the output it had; no
+argument used to print this page and exit 2.
+
 Startup prints the loopback URL and private connection-file location, never the
 credential. Opening that URL in a browser on the same machine is the access: the
 service answers a same-origin request from loopback as the local person, with the
@@ -63,7 +79,17 @@ must expire; that link is a credential and is only as good as its five-minute
 window and single use. A credential that is present must still be valid, so an old
 link never silently widens to local access; a same-origin request that carries no
 credential is the machine's own. Host and Origin are checked on every request, and
-a browser request marked as coming from another site is refused. `--port`, `--rscript`, `--core`, `--plugins` and `--limits` are explicit
+a browser request marked as coming from another site is refused.
+
+A start without `--port` takes the port this state's last start had, so a bookmarked
+address and every Agent connection still reach it after a restart; only when another
+program holds that port does it take a new one, and then each Agent connection file in
+the state that named the old address is rewritten to the new one, keeping its token.
+`--port 0` always takes a new port. A selected port that is in use is refused with the
+port named, never replaced. A second start on a state that is already running is
+refused with the running service's address.
+
+`--port`, `--rscript`, `--core`, `--plugins` and `--limits` are explicit
 operator selections; `RHO_RSCRIPT`, `RHO_CORE_BINARY` and `RHO_PYTHON` select
 equivalent runtimes. A Core override is outside bundled digest verification.
 A source checkout has no bundled Core: packaging supplies one per platform under
@@ -106,17 +132,32 @@ Exact Host and supplied Origin are checked. The bearer credential is project
 scoped for external callers. CLI shutdown stops only Hosts started by this
 service and reports confirmation separately. Existing Hosts keep their owner.
 
-### Connect Claude Code
+### Connect Claude Code or Codex
+
+The running service's operator connection adds Rho to the person's own Claude Code
+or Codex for one project, as the project page's "Add to …" button does:
+
+```sh
+rho --grant /absolute/service-state/connection.json --project PROJECT_FOLDER --agent claude-code|codex
+```
+
+It gives that Agent its own grant to the project (kept when it still reaches the
+service), runs that Agent's `mcp remove` and `mcp add` on this machine — Claude Code's
+with `-s local` in the project folder, Codex's for every folder — and records it, so the
+page shows it under that Agent. The JSON reply names the project, its root, the number
+of granted methods, whether a new grant was made, and what was added (`name`, `scope`,
+`at`). A session that was already open does not have the tools; a new one does.
 
-The running service's operator connection grants one project to one Agent session
-and prints how Claude Code starts that session's MCP server:
+Without `--agent`, the same connection grants one project to one Agent session and
+prints how Claude Code starts that session's MCP server:
 
 ```sh
 rho --grant /absolute/service-state/connection.json --project PROJECT_FOLDER [--session NAME]
 ```
 
 `--project` is the folder relative to `--root`; `--session` defaults to
-`claude-code`. The JSON reply names the project, the private session connection
+`claude-code`, the session `--agent claude-code` uses, and `--session codex` is the one
+`--agent codex` uses. When the service is not running, both forms say so and exit 1. The JSON reply names the project, the private session connection
 file, the number of granted methods (the server default), an `mcp` entry
 (`name`, `command`, `args`) for an MCP configuration file, and the equivalent
 `claude mcp add rho-<folder> -- … --mcp <file>` command. `rho --mcp FILE` serves
@@ -952,6 +993,11 @@ Notebook 0.1.0 (`@rho-workspace/plugin-kernel`) keeps one live R session and one
 live Python session per project, in the project folder, shared by the person and
 their Agent. `kernel.run` queues a cell in its language's session and starts the
 session when none is live; `waitMs` waits up to `maxWaitMs` for it to end.
+Since Notebook 0.5.3 a cell may name `interpreter`, a program in a folder of the project
+such as an environment's `.venv/bin/python`; the project keeps it for that language's later
+sessions, and a session in which only that caller ran cells starts again with it, while one
+where anyone else ran a cell is refused. Each session and each cell records the program
+(relative to the project when it is in it) and the version that ran it.
 `kernel.read` returns the sessions, their variables and the cells, and never starts
 a session. `kernel.inspect` returns one value of a live session as its session
 describes it: its kind (table, model, vector, list, function, value or other), class,