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.
- package/CHANGELOG.md +249 -0
- package/README.md +49 -3
- package/dist/agent/package-lock.json +2 -2
- package/dist/client/assets/BoardChat-DdwBcb2N.js +27 -0
- package/dist/client/assets/{BuzzDialog-Ix9qJvim.js → BuzzDialog-DpUcnU6S.js} +1 -1
- package/dist/client/assets/ChecksPanel-CngYV4yz.js +1 -0
- package/dist/client/assets/History-CD0saQA5.js +1 -0
- package/dist/client/assets/LocalSettings-MZy2baig.js +1 -0
- package/dist/client/assets/{Management-NVFDtSZB.js → Management-CSvZ-SHO.js} +1 -1
- package/dist/client/assets/QuickConnect-foLh2QUm.js +1 -0
- package/dist/client/assets/{ShareDialog-By0ETg6n.js → ShareDialog-DPWDftoL.js} +2 -2
- package/dist/client/assets/{app-update-dialog-RGIw24iZ.js → app-update-dialog-CtiXpTRD.js} +1 -1
- package/dist/client/assets/{circle-x-B6KfScOE.js → circle-x-CteRBtXC.js} +1 -1
- package/dist/client/assets/index-Cxz1UVcV.css +2 -0
- package/dist/client/assets/index-uUZVBYUS.js +37 -0
- package/dist/client/assets/play-BjRNIGSf.js +1 -0
- package/dist/client/assets/{refresh-cw-vkgvCCfR.js → refresh-cw-r_tZiFfB.js} +1 -1
- package/dist/client/assets/{runtime-Bft6x_6E.js → runtime-Bvq10IhH.js} +1 -1
- package/dist/client/assets/ui-zQpn-PdL.js +41 -0
- package/dist/client/build-info.json +1 -1
- package/dist/client/index.html +3 -3
- package/dist/client/sw.js +2 -2
- package/dist/console/assets/{LocalAccountsApp-VOCZg8dg.js → LocalAccountsApp-DIdy1KnN.js} +1 -1
- package/dist/console/assets/{LocalConsole-CMwAW-mF.js → LocalConsole-DfcQztF-.js} +1 -1
- package/dist/console/assets/{app-update-dialog-Cw6UDqNP.js → app-update-dialog-ttl9lF5A.js} +1 -1
- package/dist/console/assets/console-OqAjD0kV.js +55 -0
- package/dist/console/assets/console-kvjrAArQ.css +2 -0
- package/dist/console/build-info.json +1 -1
- package/dist/console/console.html +2 -2
- package/docs/agent-hardening.md +192 -0
- package/docs/agent-recipes.md +23 -0
- package/docs/agent-workflow.md +5 -0
- package/docs/agents.md +14 -6
- package/docs/hosted.md +804 -11
- package/docs/where-to-run.md +37 -2
- package/package.json +1 -1
- package/src/agent/backends/acp.js +528 -25
- package/src/agent/branch-mode.js +17 -3
- package/src/agent/card-hash.js +65 -0
- package/src/agent/context.js +41 -0
- package/src/agent/exec-paths.js +105 -0
- package/src/agent/routes.js +2 -2
- package/src/agent/run.js +11 -1
- package/src/agent/starter/cli.js +6 -1
- package/src/agent/turn-changes.js +70 -8
- package/src/cli/args.js +13 -0
- package/src/cli/commands.js +20 -5
- package/src/cli/help.js +36 -1
- package/src/hosted/admin.js +7 -0
- package/src/hosted/agent-approvals.js +28 -3
- package/src/hosted/agent-link.js +1032 -0
- package/src/hosted/agent-policy.js +10 -3
- package/src/hosted/agent-presence.js +63 -22
- package/src/hosted/agent-routes.js +135 -0
- package/src/hosted/agents.js +1199 -0
- package/src/hosted/app.js +89 -5
- package/src/hosted/board-routes.js +127 -3
- package/src/hosted/chat-frames.js +256 -0
- package/src/hosted/chat-job.js +204 -0
- package/src/hosted/chat-permissions.js +191 -0
- package/src/hosted/chat-routes.js +1009 -0
- package/src/hosted/chat-store.js +460 -0
- package/src/hosted/comment-files.js +8 -1
- package/src/hosted/comments.js +1 -1
- package/src/hosted/console-routes.js +11 -0
- package/src/hosted/db.js +165 -0
- package/src/hosted/device-routes.js +64 -8
- package/src/hosted/device.js +35 -4
- package/src/hosted/events.js +3 -3
- package/src/hosted/membership.js +9 -1
- package/src/hosted/pages.js +2 -0
- package/src/hosted/permissions.js +38 -0
- package/src/hosted/presence.js +17 -0
- package/src/hosted/projects.js +29 -2
- package/src/hosted/ratelimit.js +8 -0
- package/src/hosted/tenancy.js +18 -0
- package/src/hosted/token-api.js +118 -19
- package/src/hosted/token-events.js +5 -3
- package/src/hosted/tokens.js +21 -5
- package/src/hosted/turn-hub.js +152 -0
- package/src/remote/agent-connect.js +433 -0
- package/src/remote/agent-fix.js +611 -0
- package/src/remote/agent-job.js +216 -0
- package/src/remote/agent-link.js +904 -0
- package/src/remote/agent-policy-file.js +242 -0
- package/src/remote/credentials.js +35 -1
- package/src/remote/login.js +12 -2
- package/dist/client/assets/BoardChat-DxehB761.js +0 -27
- package/dist/client/assets/ChecksPanel-pA_ueIaJ.js +0 -1
- package/dist/client/assets/History-C9N32kCv.js +0 -1
- package/dist/client/assets/LocalSettings-DawtKnvi.js +0 -1
- package/dist/client/assets/QuickConnect-DO1TjS1t.js +0 -1
- package/dist/client/assets/index-CsqLdqGx.css +0 -2
- package/dist/client/assets/index-DnZarJ3U.js +0 -37
- package/dist/client/assets/shield-check-QzwGhz0t.js +0 -1
- package/dist/client/assets/ui-DI-FGWWK.js +0 -41
- package/dist/console/assets/console-DgfWmUEx.js +0 -55
- package/dist/console/assets/console-Lis0vvdL.css +0 -2
package/docs/where-to-run.md
CHANGED
|
@@ -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
|
-
|
|
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
|
+
"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",
|