shapewall 0.3.2 → 0.3.3

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 (75) hide show
  1. package/CHANGELOG.md +108 -0
  2. package/NOTICE +7 -0
  3. package/README.md +1 -1
  4. package/THIRD_PARTY.md +39 -0
  5. package/dist/agent/package-lock.json +2 -2
  6. package/dist/client/assets/BoardChat-DxehB761.js +27 -0
  7. package/dist/client/assets/BuzzDialog-Ix9qJvim.js +1 -0
  8. package/dist/client/assets/ChecksPanel-pA_ueIaJ.js +1 -0
  9. package/dist/client/assets/History-C9N32kCv.js +1 -0
  10. package/dist/client/assets/LocalSettings-DawtKnvi.js +1 -0
  11. package/dist/client/assets/{Management-DmTh1-tA.js → Management-NVFDtSZB.js} +1 -1
  12. package/dist/client/assets/QuickConnect-DO1TjS1t.js +1 -0
  13. package/dist/client/assets/ShareDialog-By0ETg6n.js +2 -0
  14. package/dist/client/assets/app-update-dialog-RGIw24iZ.js +1 -0
  15. package/dist/client/assets/{circle-x-3UxAvczM.js → circle-x-B6KfScOE.js} +1 -1
  16. package/dist/client/assets/index-CsqLdqGx.css +2 -0
  17. package/dist/client/assets/index-DnZarJ3U.js +37 -0
  18. package/dist/client/assets/{refresh-cw-BRHNyCnY.js → refresh-cw-vkgvCCfR.js} +1 -1
  19. package/dist/client/assets/rolldown-runtime-XKyaHtl9.js +1 -0
  20. package/dist/client/assets/{shield-check-DMpniYP6.js → shield-check-QzwGhz0t.js} +1 -1
  21. package/dist/client/assets/ui-DI-FGWWK.js +41 -0
  22. package/dist/client/build-info.json +1 -1
  23. package/dist/client/index.html +4 -3
  24. package/dist/client/sw.js +2 -2
  25. package/dist/console/assets/{LocalAccountsApp-IvHd9zWN.js → LocalAccountsApp-VOCZg8dg.js} +1 -1
  26. package/dist/console/assets/{LocalConsole-DOyLou56.js → LocalConsole-CMwAW-mF.js} +1 -1
  27. package/dist/console/assets/{app-update-dialog-Da46CJpv.js → app-update-dialog-Cw6UDqNP.js} +1 -1
  28. package/dist/console/assets/console-DgfWmUEx.js +55 -0
  29. package/dist/console/assets/console-Lis0vvdL.css +2 -0
  30. package/dist/console/build-info.json +1 -1
  31. package/dist/console/console.html +2 -2
  32. package/docs/agents.md +62 -2
  33. package/docs/config.md +1 -1
  34. package/docs/deployment.md +2 -0
  35. package/docs/design-system.md +20 -15
  36. package/docs/hosted.md +19 -0
  37. package/docs/where-to-run.md +88 -0
  38. package/package.json +2 -1
  39. package/src/agent/agent-logos.js +81 -0
  40. package/src/agent/config.js +27 -2
  41. package/src/agent/icon-store.js +100 -0
  42. package/src/agent/identity.js +77 -0
  43. package/src/agent/owner-mcp.js +19 -3
  44. package/src/agent/routes.js +80 -20
  45. package/src/agent/run.js +3 -1
  46. package/src/agent/settings-routes.js +233 -14
  47. package/src/agent/test-timing.js +14 -0
  48. package/src/agent/tools.js +4 -2
  49. package/src/agent/user-settings.js +51 -3
  50. package/src/capture/element-map.js +61 -4
  51. package/src/hosted/agent-presence.js +40 -0
  52. package/src/hosted/app.js +6 -0
  53. package/src/hosted/board-routes.js +7 -0
  54. package/src/hosted/console-routes.js +47 -1
  55. package/src/hosted/events.js +6 -4
  56. package/src/hosted/presence.js +1 -1
  57. package/src/hosted/projects.js +32 -1
  58. package/src/hosted/token-api.js +5 -1
  59. package/src/hosted/token-events.js +5 -2
  60. package/src/hosted/tokens.js +3 -2
  61. package/src/mcp.js +10 -2
  62. package/src/store.js +5 -0
  63. package/dist/client/assets/BoardChat-BeRp6007.js +0 -27
  64. package/dist/client/assets/BuzzDialog-CrYy48hh.js +0 -1
  65. package/dist/client/assets/ChecksPanel-CB820mhj.js +0 -1
  66. package/dist/client/assets/History-Ba909bGJ.js +0 -1
  67. package/dist/client/assets/LocalSettings-ChMi9Zir.js +0 -1
  68. package/dist/client/assets/QuickConnect-CrVweWZB.js +0 -1
  69. package/dist/client/assets/ShareDialog-DO2HhY6g.js +0 -2
  70. package/dist/client/assets/app-update-dialog-C09ODdUQ.js +0 -1
  71. package/dist/client/assets/index-BIjfZKnp.js +0 -37
  72. package/dist/client/assets/index-CXtuJi1K.css +0 -2
  73. package/dist/client/assets/ui-mhL9gsne.js +0 -41
  74. package/dist/console/assets/console-CIBv7cXU.js +0 -55
  75. package/dist/console/assets/console-Fp4k9iyx.css +0 -2
package/CHANGELOG.md CHANGED
@@ -3,6 +3,114 @@
3
3
  All notable changes to this project are documented here. The format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
4
4
  and the project uses [Semantic Versioning](https://semver.org/).
5
5
 
6
+ ## 0.3.3 - 2026-11-11
7
+
8
+ - Commenting goes one step at a time, and the board always says which step you are at. Pick: in comment mode the element under the
9
+ mouse is outlined, now named in plain words ("Heading: Notes that keep up...", "Button: Start free") in place of a CSS selector.
10
+ Write: once you click, picking is over. Nothing else lights up, the cursor is a normal one again, the element you picked keeps a
11
+ solid outline, and the banner reads "Commenting on ..." with Cancel. A click elsewhere moves the comment only while it is still
12
+ empty; once it has text, an image or a drawing it stays where it is and the composer nudges. Esc goes back exactly one step:
13
+ from drawing to the comment, from the comment to picking, from picking out of comment mode.
14
+ - The comment box and an open thread keep off the element they are about: beside the pin on the side away from it, else below
15
+ it, else above it. They only overlap it when it fills the canvas. Both cards can be dragged by their top line (the "#17 Home"
16
+ row of a thread, the "Home · Desktop · ..." line of a new comment) to see the page or a drawing under them; a moved card stays
17
+ where you put it while the canvas moves, never goes under the side panel, and is back at its pin the next time it opens.
18
+ - A comment you are writing is never thrown away by a stray click. With text, an image or a drawing in it, clicking another pin, a
19
+ row in the comments list, a link to a comment or pressing C leaves it open (the box nudges); before, each of those dropped it
20
+ without a word. An empty one makes way as before. Esc still cancels, but when the comment holds a drawing or images it asks
21
+ first ("Discard this comment?"); Cancel never asks.
22
+ - Scrolling and zooming the board always work over a live page, and Ctrl/Cmd+wheel or a trackpad pinch never zooms the whole
23
+ browser tab while the pointer is on the board. The cause was "Select text": once turned on for a page it gave that page the
24
+ mouse for good, wheel included, with nothing on screen saying so (comment mode hid the problem). Select text now has two visible
25
+ steps: on, and the board still scrolls and zooms over the page; click the page and it takes the mouse so you can select and
26
+ copy, until the pointer leaves it or you press Esc. A note at the top says which step you are at, with Done. Ctrl/Cmd+wheel over
27
+ the bars floating on the canvas zooms the board too, and over an open comment card it no longer zooms the browser.
28
+ - You can see that agents are working without hunting for the comment. The Agent button in the toolbar (the Comments button on
29
+ boards without an agent chat, the More button on a phone) carries a mark for the whole board: a pulsing dot while an agent
30
+ works, with the number when more than one does; a still dot in the attention colour when an agent needs your OK or a comment
31
+ waits on a person; a green dot for a moment when the last one finishes. Its tooltip says it in words ("2 agents working: #17
32
+ Home, #21 Settings", "Agent needs your OK on #21 Settings"), and when exactly one thing needs you, the button opens it. With
33
+ reduced motion the dot does not pulse.
34
+ - Hosted boards say whether an agent is listening. A comment is only picked up while some machine runs `shapewall watch --remote`
35
+ (or an MCP client) for the project; the same tooltip now reads "Agent online: <token name>" or "No agent is listening: comments
36
+ wait until one is", and a thread whose comment was sent to the agent says so too when none is. The server keeps this in memory
37
+ only (the token's name and when it was last heard, for 90 seconds), and tells members, never share link guests.
38
+ - Search moved out of the top bar into the sidebar: one field at the top of the expanded sidebar ("Search pages, journeys,
39
+ comments", Ctrl/Cmd+K), a search icon when the sidebar is collapsed. It opens the same search as before, and Ctrl/Cmd+K still
40
+ works from anywhere. The expanded sidebar no longer has a separate "Filter pages" box under its tabs. The top bar now keeps its
41
+ shape: opening a journey only changes the Views button, in place (the journey's name and a clear button), where before the
42
+ search box collapsed to a lone icon in the middle of the bar.
43
+ - An open comment closes when you go somewhere else: opening or stepping through a journey, going to a page from the search or the
44
+ sidebar, switching to a screen size the comment is not on, entering compare, opening a page's history from its card. It stays
45
+ open while you pan, zoom, use the comments list, or switch between Comments, Agent and Checks. The address drops the comment
46
+ too, so a reload does not reopen it; a reply you had not sent is still there when you open the thread again. A new comment with
47
+ something in it is never lost this way: it is put aside and a note offers it back ("Draft kept for Home", Reopen or Discard).
48
+ - The agent activity mark on the Agent button sits where the Comments count does, at the right end of the button, in the same size:
49
+ a dot for one agent, a number for more. Its motion is a slow, small breath that stays inside the button (a working pin breathes
50
+ the same way); the expanding ring is gone.
51
+ - A journey arrow that leads to a step off screen no longer runs out of the canvas like a stray line: it fades out at the edge and
52
+ ends in a small chip with the step's number ("continues to step 2: Sign in" on hover); click the chip to go there. Arrows whose
53
+ both ends are on screen are unchanged.
54
+ - A link that names both a comment and a journey opens the comment: its thread at its pin, the journey left out of the address.
55
+ - Keyboard focus is visible again on the controls that had lost their ring: the Comments, Agent and Checks buttons, the sidebar's
56
+ items and its expand button, the page list, the journey bar's steps and more. They showed a tooltip but no outline when reached
57
+ with Tab.
58
+ - A comment picked in the search (Ctrl/Cmd+K) puts the keyboard in its thread, so Tab reaches the reply box. Screen readers hear
59
+ "Draw an arrow on the page" and "Draw freehand on the page" (they said "Draw a arrow", "Draw a pen").
60
+ - Esc closes the open thread first, also while the mouse rests on a pin and its preview is showing. A comment card you moved and
61
+ then re-aimed at another element (while still empty) goes back beside its new pin.
62
+ - Drawing is clearly a mode. A bar at the top says "Drawing on Home · Desktop" and holds the tools, the inks, Undo, Clear and a
63
+ Done button; the page you draw on is framed and the other pages step back; no element outlines appear under the pen. Entering it
64
+ no longer moves the view (it did, to fit the page) unless the page is mostly off screen or drawn too small to draw on, and then
65
+ the view goes back when you are done. Scrolling, Space and middle-drag still move the canvas while you draw. Done and Esc return
66
+ to your comment with the drawing attached. In the composer the three tools are labelled "Draw". The bar never blocks the pen:
67
+ where it sits over the top of the page a stroke can start on its label or between its buttons, and it fades back while you draw.
68
+ - The side panel (comments, agent, checks) can be dragged no wider than 560 px or 40% of the window, whichever is less. Before, it
69
+ could take 60% of the window and cover most of the board; a wider width remembered from before comes back inside the limit. The
70
+ comment box and an open thread stay on the canvas beside their pin, also when the panel is wide: before, they could end up on top
71
+ of the panel.
72
+ - The board toolbar is one system: every control except the board name and Comment is the same quiet box (same height, corner,
73
+ hairline), and Comments, Agent and Checks sit on one track like the screen sizes, with the open panel raised. Thin dividers
74
+ separate the groups. Comment stays the one accent button. The status dot's tooltip says what it means ("Pages captured 3 hours
75
+ ago").
76
+ - Hosted server: one board of a project can be removed. On the project page each board has "Remove board" (admins and owners, with
77
+ a passkey check, behind a confirmation that names the board). It deletes that board's captures, history, comments and comment
78
+ images from the server and frees their storage; the project, its other boards, tokens and share links stay. Pushing the same
79
+ board id again brings the captures back but not the comments. Before, a board pushed by mistake stayed until the whole project
80
+ was deleted.
81
+ - Hosted console, "Sign in a terminal": if you close the passkey check that Approve asks for, the page now says the login was not
82
+ approved and why. Before, Approve looked as if it had done nothing.
83
+ - Agents have a name you choose and an icon. Connect asks for the name: the **Allow this?** confirmation has a Name field, filled in
84
+ with "Claude Code", "Codex" and so on, so you can call it "Harry" before it is connected, and an optional icon. Later, **Edit** on
85
+ each connected agent's row of the Agents page changes the name, the icon and a colour. Saving restarts nothing, runs no test, and
86
+ works while the agent is answering. Before, the name could only be typed in the full settings form, the one-click Connect gave no
87
+ chance to name an agent, and every agent showed two initials.
88
+ - Agent icons: twelve built-in avatars drawn for Shapewall, or a picture you upload (PNG, JPEG or WebP up to 2 MB, cropped to a
89
+ square, re-encoded by the server and kept next to your agent settings; never an SVG). A connected Claude Code, Codex (the OpenAI
90
+ mark), goose or Gemini CLI shows its product mark until you pick something else, and **Default** goes back to it; other agents
91
+ and endpoints show initials. Sources and terms of the marks are in `THIRD_PARTY.md`.
92
+ - The name and icon show wherever the agent does: the Agents page and its default list, the chat header and its menu, the agent's
93
+ answers, **Fix with <name>**, the batch of fixes and the `shapewall serve` start line. An agent's replies on a comment thread are
94
+ signed with its name and marked as an agent's; replies written before keep the name they had. A command fixed with `--agent-acp`
95
+ or `SHAPEWALL_AGENT_ACP` can be renamed too: the flag decides which agent runs, not what it is called. Only the owner on the
96
+ machine that runs Shapewall can change any of it.
97
+ - Right after Connect, while a real agent is still starting for its connection test (several seconds; the test may take up to
98
+ 30), nothing answers "A connection test is running" any more. A name or an icon saved in that window is kept: for the agent
99
+ being connected, Save waits ("Saving when the connection test finishes...") and then saves, or says that the agent did not
100
+ connect; for another agent it saves at once and survives a failed test. The Agents page and the chat header say "Testing the
101
+ connection" instead of looking finished; Test connection, Remove, Connect and the default are off with the reason until the
102
+ test ends; a chat message or a Fix sent meanwhile says "Waiting for the connection test to finish" and then runs (the board now
103
+ waits 45 seconds, longer than a test can last; it gave up after 30). Before, renaming an agent within seconds of connecting it
104
+ failed with "A connection test is running. Wait for it, then save."
105
+ - Renaming an agent keeps the model and effort it last used: new chats start from them as before. They were remembered under the
106
+ agent's name, so a rename started them over.
107
+ - Hosted server: a token name over 60 characters is refused when the token is made ("Token name: 1 to 60 characters."), as on a
108
+ rename. Before, it was cut to 60 without a word.
109
+ - Hosted server: an API token can be renamed on the token lists (admins and owners, like revoking it), so a watcher shows up as
110
+ "Harry" instead of "laptop (shapewall login)". The token itself, its scopes and what it already wrote do not change.
111
+ - Website contact page: the "Thanks, your message is on its way" heading no longer shows a focus rectangle, and the form's spacing
112
+ is even (the character count sits beside the hint, above the field).
113
+
6
114
  ## 0.3.2 - 2026-11-11
7
115
 
8
116
  - A comment or a reply can be a drawing or images with no text. Before, Post and Send stayed off until you typed something, and
package/NOTICE CHANGED
@@ -10,3 +10,10 @@ Apache License, Version 2.0 two years after it is released.
10
10
  The built board includes third-party code and data for the natural read-aloud
11
11
  voices (transformers.js, ONNX Runtime Web, misaki's lexicons and others), each
12
12
  under its own license; see THIRD_PARTY.md.
13
+
14
+ The board shows the product marks of coding agents as their default icons
15
+ (the Claude mark of Anthropic, PBC, the OpenAI mark of OpenAI for
16
+ Codex, the goose mark of LF Projects, LLC and the Gemini mark of Google LLC).
17
+ These marks are trademarks of their respective owners. They are used only to
18
+ identify the agent you connected; no endorsement by or affiliation with their
19
+ owners is implied. Sources and terms: THIRD_PARTY.md.
package/README.md CHANGED
@@ -112,7 +112,7 @@ Good to know:
112
112
  - Edits to titles, pages and journeys in the config show up on the next refresh of the board, with no restart.
113
113
 
114
114
  Next: [configuration and sign-in](docs/config.md#auth), [capture warnings and pacing](docs/capture-warnings.md),
115
- [local accounts](docs/local-accounts.md), [updates](docs/updates.md) and [deployment](docs/deployment.md).
115
+ [local accounts](docs/local-accounts.md), [updates](docs/updates.md) and [deployment](docs/deployment.md). Not sure which shape you need? [Where to run Shapewall](docs/where-to-run.md).
116
116
 
117
117
  ### Multiplayer on your own server
118
118
 
package/THIRD_PARTY.md CHANGED
@@ -45,6 +45,45 @@ Notes:
45
45
 
46
46
  [ort-notices]: https://github.com/microsoft/onnxruntime/blob/main/ThirdPartyNotices.txt
47
47
 
48
+ ## Agent product marks (`src/agent/agent-logos.js`)
49
+
50
+ The board shows the product mark of a coding agent you connected as that agent's default icon (docs/agents.md, "Name and icon"). The
51
+ marks are data in one file, each a single-colour SVG path used exactly as sourced: not redrawn, not recoloured, not combined with
52
+ anything else. They ship inside the npm package and the built board.
53
+
54
+ | Mark | Shown for | Trademark of | Source | Terms of the source |
55
+ | ------------- | ----------- | ------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------- |
56
+ | Claude | Claude Code | Anthropic, PBC | [Simple Icons](https://simpleicons.org) 16.37.0 (npm `simple-icons`), `icons/claude.svg` | CC0 1.0 (the Simple Icons project) |
57
+ | OpenAI | Codex | OpenAI | Simple Icons 15.22.0 (npm `simple-icons@15.22.0`, published 2025-11-23), `icons/openai.svg`; taken 2026-11-11 | CC0 1.0 (the Simple Icons project); see the note below |
58
+ | goose | goose | LF Projects, LLC (the goose project, founded by Block, now with the Agentic AI Foundation) | The project's own repository, <https://github.com/aaif-goose/goose> (where `github.com/block/goose` redirects), `documentation/static/img/goose.svg` at commit `0c5b5e2f2e7933fca4de5377d239645dcbe4cbb3` (file last changed in `bf760fd`, 2025-03-24); taken 2026-11-11 | Apache 2.0 (the repository's licence); the name and logo under the [LF Projects trademark policy](https://lfprojects.org/policies/trademark-policy/) |
59
+ | Google Gemini | Gemini CLI | Google LLC | Simple Icons 16.37.0, `icons/googlegemini.svg` | CC0 1.0 (the Simple Icons project) |
60
+
61
+ Notes:
62
+
63
+ - Simple Icons releases its collection under CC0 1.0 and records no separate licence for these two marks. Its
64
+ [disclaimer](https://github.com/simple-icons/simple-icons/blob/develop/DISCLAIMER.md) says a brand may still set its own terms, and
65
+ CC0 waives no trademark rights: the marks remain trademarks of their owners. Shapewall uses them only to identify the agent the
66
+ owner connected, at icon size, with no endorsement or affiliation implied (see `NOTICE`).
67
+ - **The OpenAI mark's provenance.** It is the "blossom" monogram (no wordmark), byte for byte the path of `icons/openai.svg` in
68
+ `simple-icons@15.22.0`, the last release that has it. Simple Icons **removed** the icon in 16.0.0 (2025-11-30,
69
+ [pull request 13944](https://github.com/simple-icons/simple-icons/pull/13944), "Remove OpenAI ... assuming no permissions are
70
+ sought/obtained before then", closing [issue 12739](https://github.com/simple-icons/simple-icons/issues/12739), which asked
71
+ whether the icon still matched OpenAI's 2025 rebrand). So the CC0 statement of that release covers the file as Simple Icons
72
+ published it, but Simple Icons itself no longer distributes it, the drawing may predate the 2025 redraw, and OpenAI's own brand
73
+ guidelines (<https://openai.com/brand>) apply to any use of the mark. That page could not be fetched from the build machine when
74
+ this was added (it answered 403 to a plain request), so the guidelines were **not** reviewed against this use. The project owner
75
+ chose to ship the mark for Codex with this provenance; check the guidelines, or ask OpenAI, before relying on it.
76
+ - **The goose mark** is the single path of the project's own `goose.svg` (one colour, 45 by 45), unchanged; only the file's empty
77
+ clipping frame is left out. The repository is Apache 2.0, whose section 6 grants no trademark rights; its `GOVERNANCE.md` points
78
+ to the LF Projects policies for the trademark. That policy asks, among other things, that a logo is not altered, not shown "with
79
+ color variations" or with other elements on top of it, and not used to promote a product without written permission. Shapewall
80
+ shows it only as the icon of a goose you connected. Like the other marks it is drawn in the board's text colour (near black on
81
+ light, near white on dark), where the file itself is near black (`#101010`): if that counts as a colour variation, the dark theme
82
+ needs a look.
83
+ - Nothing here was drawn to resemble a mark and nothing was copied from an unofficial site.
84
+ - Adding or removing a mark is one entry in `src/agent/agent-logos.js` and one row here. The twelve built-in avatars
85
+ (`client/src/chat/agentIcons.jsx`) are original drawings made for Shapewall and are not third-party material.
86
+
48
87
  ## Live board presence
49
88
 
50
89
  Yjs 13.6.33 and y-protocols 1.0.7 provide transient awareness state; lib0 is their shared utility dependency. These are MIT-licensed and
@@ -1,12 +1,12 @@
1
1
  {
2
2
  "name": "shapewall",
3
- "version": "0.3.2",
3
+ "version": "0.3.3",
4
4
  "lockfileVersion": 3,
5
5
  "requires": true,
6
6
  "packages": {
7
7
  "": {
8
8
  "name": "shapewall",
9
- "version": "0.3.2",
9
+ "version": "0.3.3",
10
10
  "license": "Apache-2.0 AND FSL-1.1-ALv2",
11
11
  "dependencies": {
12
12
  "@agentclientprotocol/sdk": "2.4.0",