shapewall 0.3.3 → 0.6.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 (98) hide show
  1. package/CHANGELOG.md +249 -0
  2. package/README.md +49 -3
  3. package/dist/agent/package-lock.json +2 -2
  4. package/dist/client/assets/BoardChat-DdwBcb2N.js +27 -0
  5. package/dist/client/assets/{BuzzDialog-Ix9qJvim.js → BuzzDialog-DpUcnU6S.js} +1 -1
  6. package/dist/client/assets/ChecksPanel-CngYV4yz.js +1 -0
  7. package/dist/client/assets/History-CD0saQA5.js +1 -0
  8. package/dist/client/assets/LocalSettings-MZy2baig.js +1 -0
  9. package/dist/client/assets/{Management-NVFDtSZB.js → Management-CSvZ-SHO.js} +1 -1
  10. package/dist/client/assets/QuickConnect-foLh2QUm.js +1 -0
  11. package/dist/client/assets/{ShareDialog-By0ETg6n.js → ShareDialog-DPWDftoL.js} +2 -2
  12. package/dist/client/assets/{app-update-dialog-RGIw24iZ.js → app-update-dialog-CtiXpTRD.js} +1 -1
  13. package/dist/client/assets/{circle-x-B6KfScOE.js → circle-x-CteRBtXC.js} +1 -1
  14. package/dist/client/assets/index-Cxz1UVcV.css +2 -0
  15. package/dist/client/assets/index-uUZVBYUS.js +37 -0
  16. package/dist/client/assets/play-BjRNIGSf.js +1 -0
  17. package/dist/client/assets/{refresh-cw-vkgvCCfR.js → refresh-cw-r_tZiFfB.js} +1 -1
  18. package/dist/client/assets/{runtime-Bft6x_6E.js → runtime-Bvq10IhH.js} +1 -1
  19. package/dist/client/assets/ui-zQpn-PdL.js +41 -0
  20. package/dist/client/build-info.json +1 -1
  21. package/dist/client/index.html +3 -3
  22. package/dist/client/sw.js +2 -2
  23. package/dist/console/assets/{LocalAccountsApp-VOCZg8dg.js → LocalAccountsApp-DIdy1KnN.js} +1 -1
  24. package/dist/console/assets/{LocalConsole-CMwAW-mF.js → LocalConsole-DfcQztF-.js} +1 -1
  25. package/dist/console/assets/{app-update-dialog-Cw6UDqNP.js → app-update-dialog-ttl9lF5A.js} +1 -1
  26. package/dist/console/assets/console-OqAjD0kV.js +55 -0
  27. package/dist/console/assets/console-kvjrAArQ.css +2 -0
  28. package/dist/console/build-info.json +1 -1
  29. package/dist/console/console.html +2 -2
  30. package/docs/agent-hardening.md +192 -0
  31. package/docs/agent-recipes.md +23 -0
  32. package/docs/agent-workflow.md +5 -0
  33. package/docs/agents.md +14 -6
  34. package/docs/hosted.md +804 -11
  35. package/docs/where-to-run.md +37 -2
  36. package/package.json +1 -1
  37. package/src/agent/backends/acp.js +528 -25
  38. package/src/agent/branch-mode.js +17 -3
  39. package/src/agent/card-hash.js +65 -0
  40. package/src/agent/context.js +41 -0
  41. package/src/agent/exec-paths.js +105 -0
  42. package/src/agent/routes.js +2 -2
  43. package/src/agent/run.js +11 -1
  44. package/src/agent/starter/cli.js +6 -1
  45. package/src/agent/turn-changes.js +70 -8
  46. package/src/cli/args.js +13 -0
  47. package/src/cli/commands.js +20 -5
  48. package/src/cli/help.js +36 -1
  49. package/src/hosted/admin.js +7 -0
  50. package/src/hosted/agent-approvals.js +28 -3
  51. package/src/hosted/agent-link.js +1032 -0
  52. package/src/hosted/agent-policy.js +10 -3
  53. package/src/hosted/agent-presence.js +63 -22
  54. package/src/hosted/agent-routes.js +135 -0
  55. package/src/hosted/agents.js +1199 -0
  56. package/src/hosted/app.js +89 -5
  57. package/src/hosted/board-routes.js +127 -3
  58. package/src/hosted/chat-frames.js +256 -0
  59. package/src/hosted/chat-job.js +204 -0
  60. package/src/hosted/chat-permissions.js +191 -0
  61. package/src/hosted/chat-routes.js +1009 -0
  62. package/src/hosted/chat-store.js +460 -0
  63. package/src/hosted/comment-files.js +8 -1
  64. package/src/hosted/comments.js +1 -1
  65. package/src/hosted/console-routes.js +11 -0
  66. package/src/hosted/db.js +165 -0
  67. package/src/hosted/device-routes.js +64 -8
  68. package/src/hosted/device.js +35 -4
  69. package/src/hosted/events.js +3 -3
  70. package/src/hosted/membership.js +9 -1
  71. package/src/hosted/pages.js +2 -0
  72. package/src/hosted/permissions.js +38 -0
  73. package/src/hosted/presence.js +17 -0
  74. package/src/hosted/projects.js +29 -2
  75. package/src/hosted/ratelimit.js +8 -0
  76. package/src/hosted/tenancy.js +18 -0
  77. package/src/hosted/token-api.js +118 -19
  78. package/src/hosted/token-events.js +5 -3
  79. package/src/hosted/tokens.js +21 -5
  80. package/src/hosted/turn-hub.js +152 -0
  81. package/src/remote/agent-connect.js +433 -0
  82. package/src/remote/agent-fix.js +611 -0
  83. package/src/remote/agent-job.js +216 -0
  84. package/src/remote/agent-link.js +904 -0
  85. package/src/remote/agent-policy-file.js +242 -0
  86. package/src/remote/credentials.js +35 -1
  87. package/src/remote/login.js +12 -2
  88. package/dist/client/assets/BoardChat-DxehB761.js +0 -27
  89. package/dist/client/assets/ChecksPanel-pA_ueIaJ.js +0 -1
  90. package/dist/client/assets/History-C9N32kCv.js +0 -1
  91. package/dist/client/assets/LocalSettings-DawtKnvi.js +0 -1
  92. package/dist/client/assets/QuickConnect-DO1TjS1t.js +0 -1
  93. package/dist/client/assets/index-CsqLdqGx.css +0 -2
  94. package/dist/client/assets/index-DnZarJ3U.js +0 -37
  95. package/dist/client/assets/shield-check-QzwGhz0t.js +0 -1
  96. package/dist/client/assets/ui-DI-FGWWK.js +0 -41
  97. package/dist/console/assets/console-DgfWmUEx.js +0 -55
  98. package/dist/console/assets/console-Lis0vvdL.css +0 -2
@@ -56,6 +56,11 @@ The hosted server never captures a page and never edits code. Those happen on a
56
56
  shapewall capture -> shapewall push -> stores the board, shows it to everyone
57
57
  agent fixes the code <- shapewall watch <- a comment someone left
58
58
  recapture, push, reply -> the thread shows the fix
59
+ agent reads the code <- shapewall agent connect <- a question in the board's chat
60
+ the answer, as it is written -> everyone with the thread open sees it
61
+ agent edits a fresh copy <- agent connect --approvals <- "Fix with Builder" on a comment
62
+ each edit, as a diff -> a person allows or denies it on the board
63
+ a new branch, a pull request -> the thread shows where the fix is
59
64
  ```
60
65
 
61
66
  1. **Sign the machine in once.** `shapewall login --remote https://your-server` shows a code; approve it in the console and choose the
@@ -67,14 +72,44 @@ The hosted server never captures a page and never edits code. Those happen on a
67
72
  code; a wrapper around it recaptures, pushes and replies. [Agent recipes](agent-recipes.md) has commands for Claude Code, Codex and
68
73
  goose.
69
74
 
70
- While the watching machine is off, comments still save on the server and wait. Nothing is lost; nothing is fixed until it is back.
75
+ 4. **Chat with your coding agent on the board (optional).** `shapewall agent connect --remote https://your-server`, run in the
76
+ project's folder, connects that machine's Claude Code. An admin approves it in the console (a name, an icon, who may use it),
77
+ and members then ask it questions from the board's Agents panel. By default it reads the project and answers; it does not
78
+ change files or run commands from the board. Codex, goose and Gemini CLI are not offered by `agent connect` in this
79
+ release: for them, `watch` is the way. Leave it running, or run it as a service.
80
+ [Connected agents](hosted.md#connected-agents) has the details.
81
+
82
+ 5. **Let it make fixes from the board (optional).** Edits are switched on only on the machine that has the code:
83
+ `shapewall agent connect --remote https://your-server --approvals owner`. **Fix with Builder** on a comment then starts a fix
84
+ there. The work happens on that machine, never on the server and never in the checked-out tree: the agent edits a fresh copy
85
+ of the base commit in a folder outside the project, each edit shows on the board as a card with the full diff that you allow
86
+ or deny, and Shapewall commits what was allowed on a new branch (`shapewall/comment-<n>-...`). The branch is pushed and a pull
87
+ request is opened when that machine has the remote and GitHub connect; otherwise the thread names the branch. A connected
88
+ Claude Code runs no commands from the board, so a fix is not built, tested or recaptured for you: `watch --exec` stays the way
89
+ for that. [Edits from the board](hosted.md#edits-from-the-board-the-trust-decision) has the details.
90
+
91
+ Each machine that watches or connects is an **agent** of the project, with a name. The board lists them in its Agent panel ("Builder: online",
92
+ "Fixer: offline, last seen 2 hours ago") and **Send to agent** on a comment names the one it goes to: the project's default agent on
93
+ the button, the others and **Any agent** in its menu. In the console, **Agents** is where an admin names each one, gives it an icon,
94
+ picks the default and says who may send it work: a new agent only takes comments from the person who connected it, until they share
95
+ it with named members or with everyone the project trusts. [Agents on a hosted board](hosted.md#agents-on-a-hosted-board) has the
96
+ whole of it.
97
+
98
+ While a watching machine is off, comments still save on the server and wait: a comment sent to that agent says "Waiting for Builder
99
+ (offline ...)" with **Let any agent take it**. Nothing is lost; nothing is fixed until an agent is back. Chat does not wait: a
100
+ connected agent that is offline says so, and takes no message until it is back. A fix cannot be asked of an offline agent either.
71
101
 
72
102
  ### One machine, several projects
73
103
 
74
104
  `shapewall login` remembers one project for each server. For a second project on the same server, make a token on that project's page
75
105
  in the console, keep it in a file only you can read, and pass it: `--token-file ~/.config/shapewall/other-project.token` (or
76
106
  `SHAPEWALL_TOKEN`). A watcher that runs as a service should use a token file of its own, so a later `login` cannot change what it
77
- talks to.
107
+ talks to. Each token is its own agent on its project's board, so one machine can be "Builder" in one project and "Docs bot" in
108
+ another; the workspace's **Agents** page lists them all.
109
+
110
+ `shapewall agent connect` keeps a token of its own for each server, apart from the login, and serves the project whose folder it
111
+ runs in. For a second project on the same server, run it in that project's folder with `--as NAME` (its own approval, its own token).
112
+ One process holds an agent's link: a second `agent connect` on the same token is refused, unless it is started with `--takeover`.
78
113
 
79
114
  ## Which one should I start with?
80
115
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "shapewall",
3
- "version": "0.3.3",
3
+ "version": "0.6.0",
4
4
  "description": "Every page of your site on one zoomable wall: desktop and phone captures, sandboxed live HTML, and element-anchored comments your coding agent can read.",
5
5
  "license": "Apache-2.0 AND FSL-1.1-ALv2",
6
6
  "author": "Dan Baruch",