dsh-pet-cactus 0.0.0-stage → 0.1.5

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 ADDED
@@ -0,0 +1,149 @@
1
+ # История изменений
2
+
3
+ ## 0.1.5 — 2026-11-19
4
+
5
+ Иконка в названии плагина — сам кактус, а не прежняя векторная схема.
6
+
7
+ **Иконка**
8
+
9
+ - `package.json` → `icon`: `assets/logo.svg` → `assets/icon.webp` (46 КБ при
10
+ лимите DSH в 256 КиБ, формат WebP входит в разрешённые: SVG, PNG, JPEG, WebP);
11
+ - иконка собрана из настоящего спрайта `assets/pet.webp`: весь кактус целиком,
12
+ с цветами, лицом и дном горшка, вписан в квадрат 512×512 — ничего не срезано
13
+ и силуэт читается в 24–40 px;
14
+ - `assets/logo.svg` удалён: две иконки — две правды о плагине;
15
+ - `scripts/make-icon.py` пересобирает иконку из спрайта; `--check` дополнительно
16
+ рисует полосу 128/64/40/24 px для глазной проверки.
17
+
18
+ **Инженерное**
19
+
20
+ - 54 теста: иконка проверяется по контракту DSH — относительный путь внутри
21
+ пакета, формат из списка, размер ≤ 256 КиБ, сигнатура RIFF/WEBP, старого
22
+ `logo.svg` рядом нет;
23
+ - DSH читает иконку на каждый запрос инвентаря плагинов (кэша метаданных нет),
24
+ поэтому достаточно обновить страницу — перезапуск DSH не нужен.
25
+
26
+ ## 0.1.4 — 2026-11-19
27
+
28
+ Плашки ещё крупнее на 10%: `.0525` → `.05775`.
29
+
30
+ **Питомец**
31
+
32
+ - базовый кегль плашек `.0525` → `.05775` — ещё +10% к прошлому шагу, суммарно
33
+ +15,5% к исходным `.05`: при размере 240 px имя 12,6 → 13,86 px, статус
34
+ 10,33 → 11,37 px;
35
+ - отступы, скругления и зазор между плашками заданы в `em` и выросли вместе
36
+ с текстом — карточки не выглядят тесными и не режут надписи.
37
+
38
+ **Инженерное**
39
+
40
+ - 53 теста: проверка кегля обновлена на `.05775`, в бандле не должно остаться
41
+ ни `.0525`, ни исходного `.05`.
42
+
43
+ ## 0.1.3 — 2026-11-19
44
+
45
+ Плашки крупнее на 5%, имя автора вшито в сборку.
46
+
47
+ **Питомец**
48
+
49
+ - базовый кегль плашек `calc(var(--pc-size,240px)*.05)` → `.0525`: имя и статус
50
+ («кактус / на связи») выросли ровно на 5%, пропорции между ними сохранены;
51
+ - имя автора **Samugor** вшито в разметку: `data-author` на корне оверлея,
52
+ подсказка при наведении («Кактус · dsh-pet-cactus · автор Samugor») и
53
+ подпись для скринридера;
54
+ - то же имя — в баннере собранного `lib/client.js`, в `package.json`, `LICENSE`
55
+ и README: настройкой его не убрать, только правкой исходников.
56
+
57
+ **Инженерное**
58
+
59
+ - 53 теста: кегль проверяется как `.0525` (и старого `.05` в бандле нет),
60
+ имя автора — в бандле, манифесте и лицензии.
61
+
62
+ ## 0.1.2 — 2026-11-19
63
+
64
+ Меню убрано целиком, плашки и текст переведены на палитру dsh-pet.
65
+
66
+ **Питомец**
67
+
68
+ - контекстное меню удалено: нет ни разметки, ни стилей, ни обработчиков —
69
+ клик по кактусу говорит реплику, правый клик подавляет системное меню и
70
+ больше ничего не открывает;
71
+ - плашка имени: белая `rgba(255,255,255,.96)`, текст `#1f1f1f`, нейтральная
72
+ рамка `rgba(0,0,0,.12)` и тень `rgba(0,0,0,.18)` — как у плашек dsh-pet;
73
+ - плашка статуса: тот же белый фон, вторичный текст `rgba(43,43,43,.6)`;
74
+ - точка состояния — цвета dsh-pet: `#2e9e4f` покой, `#e8952f` работа,
75
+ `#e53935` ошибка, `#9aa0a6` сон;
76
+ - пузырь речи стал светлым (`rgba(255,255,255,.96)`, текст `#1f1f1f`) вместо
77
+ тёмного: текст читается в той же палитре, что и плашки;
78
+ - «?» и «!» над головой тоже из палитры dsh-pet.
79
+
80
+ **Инженерное**
81
+
82
+ - 51 тест: добавлена проверка, что меню в бандле нет, а цвета плашек и пузыря
83
+ совпадают с палитрой dsh-pet;
84
+ - `preview/menu.html` удалён; `scripts/preview.mjs` снова подключает спрайт
85
+ (art.js) — без него превью показывало пустую рамку;
86
+ - превью и скриншоты в README пересобраны с новыми цветами;
87
+ - документация (README, ARCHITECTURE, CONFIG, INSTALL) больше не обещает меню.
88
+
89
+ ## 0.1.1 — 2026-11-19
90
+
91
+ Свой спрайт вместо векторного кактуса и меню, которое не мозолит глаза.
92
+
93
+ **Питомец**
94
+
95
+ - растровый стикер (WebP 54 КБ) вместо SVG: вырезан с фона, лежит в бандле
96
+ data-URI — ни маршрута, ни чтения с диска;
97
+ - плашки над головой: имя и живой статус («на связи», «думаю…», «работаю…»,
98
+ «сплю») в стиле dsh-pet — белая карточка, Roboto Bold, точка состояния;
99
+ - статус следует за настроением, текст не вшит в картинку;
100
+ - меню больше не висит на экране: открывается кликом по кактусу или по плашкам,
101
+ закрывается кликом мимо и `Escape`; правый клик оставлен как альтернатива;
102
+ - клик по плашкам работает как клик по питомцу;
103
+ - высота питомца меряется по DOM, а не по константе: плашки не сдвигают его
104
+ за край окна.
105
+
106
+ **Инженерное**
107
+
108
+ - `scripts/make-plate.py` — вырезание фона и сборка превью с плашками;
109
+ - `scripts/make-art.mjs` — спрайт → `src/client/art.js` (data-URI);
110
+ - 50 тестов: добавлены проверки спрайта в бандле, отсутствия SVG и покрытия
111
+ подписей настроений;
112
+ - превью: `preview/menu.html` открывает меню программно, как настоящий клик.
113
+
114
+ ## 0.1.0 — 2026-11-19
115
+
116
+ Первый выпуск: плагин написан с нуля, без кода и ассетов сторонних проектов.
117
+
118
+ **Питомец**
119
+
120
+ - авторский SVG-кактус в горшке: глаза, румянец, улыбка, колючки, цветок;
121
+ - восемь настроений — покой, размышление, работа, ожидание, успех, ошибка, сон,
122
+ разговор — с CSS-анимациями и уважением к `prefers-reduced-motion`;
123
+ - перетаскивание с ограничением по окну и сохранением позиции;
124
+ - клик — реплика, правый клик — меню, клавиатура — `Enter`, `Space`, стрелки;
125
+ - сон после `sleepAfterMin` без действий;
126
+ - пузырь, который сам уезжает от края и не вылезает за окно.
127
+
128
+ **Реакция на агента**
129
+
130
+ - `turn/start`, `tool/call`, `approval/asked`, `turn/end` → настроение и текст;
131
+ - 20 инструментов с отдельными репликами, префиксы `vision_`, `captain_`, `office_`,
132
+ `forge_`, `playbook_`, запасной вариант;
133
+ - суб-агенты и глубокие делегации игнорируются;
134
+ - отключается ключом `reactToAgent`.
135
+
136
+ **Хост**
137
+
138
+ - четыре маршрута под `/dsh-pet-cactus`: `health`, `state`, `config` (GET/PUT), `say`;
139
+ - конфиг в `<DSH_HOME>/dsh-pet-cactus/main-config.json`, валидация с диапазонами,
140
+ атомарная запись, неизвестные ключи не сохраняются;
141
+ - битый файл не перезаписывается: умолчания плюс предупреждение в лог;
142
+ - лимит тела 64 КБ, ответы без кеша, ошибки не всплывают в интерфейс.
143
+
144
+ **Инженерное**
145
+
146
+ - клиентская половина — один файл без зависимостей и сборщика;
147
+ - 47 тестов (конфиг, геометрия, маршруты, адаптер, согласованность половин);
148
+ - превью-страницы для визуальной проверки без DSH;
149
+ - документация: установка, настройки, архитектура.
package/LICENSE ADDED
@@ -0,0 +1,21 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2026 Samugor
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.
package/README.en.md ADDED
@@ -0,0 +1,199 @@
1
+ # 🌵 dsh-pet-cactus
2
+
3
+ [![npm](https://img.shields.io/npm/v/dsh-pet-cactus?color=2f8f5b)](https://www.npmjs.com/package/dsh-pet-cactus)
4
+ [![license](https://img.shields.io/badge/license-MIT-blue)](LICENSE)
5
+ [![node](https://img.shields.io/badge/node-%E2%89%A522-339933)](package.json)
6
+ [![DSH](https://img.shields.io/badge/DSH-0.2.2--rc.3-6f42c1)](package.json)
7
+
8
+ [Русский](README.md) · [English](README.en.md)
9
+
10
+ People used to keep a cactus next to the monitor — supposedly it absorbed radiation.
11
+ The radiation is long gone. The cactus habit stayed.
12
+
13
+ So we put the cactus *inside* the monitor. It no longer absorbs radiation; it absorbs
14
+ `tool/call` events, `turn/start`, and your last configuration mistake.
15
+
16
+ A pet for **DeepSeek Harness**: lives in the corner of the Web-GUI, gets dragged
17
+ around, reacts to whatever the agent is doing, and talks Russian.
18
+ No watering required — it's a plugin.
19
+
20
+ The only pet that survives Ctrl+W.
21
+
22
+ *About the radiation: it is a myth — a cactus shields nothing. It is just nice.*
23
+
24
+ **Author — Samugor.** MIT license: the author's name is baked into the bundle, the markup
25
+ and the license.
26
+
27
+ ![Interface mock-up: the cactus in the bottom-right corner](https://raw.githubusercontent.com/serflo77-dev/dsh-pet-cactus/main/assets/screenshot.png)
28
+
29
+ On a dark background — this is how it looks inside DSH itself:
30
+
31
+ ![Plates and bubble on a dark background](https://raw.githubusercontent.com/serflo77-dev/dsh-pet-cactus/main/assets/dark.png)
32
+
33
+ Not another "CSS kitten": the plugin has a host half (settings, HTTP, subscription to
34
+ session events) and a browser half (rendering and animation). They talk to each other
35
+ through four routes and nothing else.
36
+
37
+ ## What it does
38
+
39
+ - **Lives in the corner** — above the interface, never steals clicks, can be dragged
40
+ anywhere and remembers where you left it.
41
+ - **Reacts to the agent** — while the model thinks, the cactus thinks; while a tool runs,
42
+ it says "Knocking on the terminal"; when it finishes — "Done"; on an error — "Well…
43
+ happens".
44
+ - **Talks** — 60+ hand-written lines grouped by mood, with an auto-scrolling bubble and
45
+ without one. Your own phrases are added through the config.
46
+ - **Plates above its head** — name and status ("thinking…", "working…", "asleep") in the
47
+ dsh-pet palette: a white card, `#1f1f1f` text, a neutral border and shadow, a state dot.
48
+ The text is live and changes with the mood instead of being baked into an image.
49
+ - **No menus at all** — no context menu opens on click or right-click: clicking the cactus
50
+ just makes it talk.
51
+ - **Falls asleep** when ignored; clicking it wakes the cactus up and gets a line.
52
+ - **Remembers** its size, corner and position between launches.
53
+ - **Shuts up** if asked: `speech: false`, `reactToAgent: false`.
54
+ - **No network.** Not a single outgoing request: only the local DSH.
55
+
56
+ ![Eight states](https://raw.githubusercontent.com/serflo77-dev/dsh-pet-cactus/main/assets/states.png)
57
+
58
+ ## What it does not do
59
+
60
+ - does not call a model and does not read project files — only tool names;
61
+ - does not touch the internet (no telemetry, no TTS, no "balance");
62
+ - does not open a second desktop window — this is Web-GUI only;
63
+ - does not break the interface when something is unavailable: without the host the pet runs
64
+ on local defaults, without React it simply does not render.
65
+
66
+ ## Install
67
+
68
+ ```sh
69
+ dsh plugin --profile desktop add dsh-pet-cactus
70
+ ```
71
+
72
+ Then **fully restart DSH**: the host half is read when the app starts, and refreshing the
73
+ page will not pick it up. After the restart the cactus appears in the bottom-right corner.
74
+
75
+ Check that the host is alive:
76
+
77
+ ```sh
78
+ curl http://127.0.0.1:<port>/dsh-pet-cactus/health
79
+ # {"ok":true,"name":"dsh-pet-cactus","version":"0.1.5","mood":"idle","configSource":"default"}
80
+ ```
81
+
82
+ The port is the one DSH prints in its log on startup.
83
+
84
+ Rollback, manual install and development from a folder — see [docs/INSTALL.md](docs/INSTALL.md)
85
+ (Russian).
86
+
87
+ ## Controls
88
+
89
+ | Action | What happens |
90
+ |---|---|
91
+ | Click the cactus | a line (and waking up, if it was asleep) |
92
+ | Right click | nothing: the system menu is suppressed, its own never opens |
93
+ | Drag | moving it; release and the position is saved |
94
+ | `Enter` / `Space` while focused | a line |
95
+ | Arrow keys while focused | move by 16 px |
96
+
97
+ ## Settings
98
+
99
+ File: `%DSH_HOME%/dsh-pet-cactus/main-config.json` (usually `~/.dsh/...`).
100
+ Edit it by hand or through `PUT /dsh-pet-cactus/api/config` — applied immediately, no restart.
101
+
102
+ ```json
103
+ {
104
+ "name": "Кактус",
105
+ "size": 240,
106
+ "corner": "bottom-right",
107
+ "marginX": 28,
108
+ "marginY": 28,
109
+ "opacity": 1,
110
+ "speech": true,
111
+ "speechIntervalMin": 12,
112
+ "bubbleMs": 6500,
113
+ "sleepAfterMin": 20,
114
+ "reactToAgent": true,
115
+ "reducedMotion": "auto",
116
+ "phrases": []
117
+ }
118
+ ```
119
+
120
+ Every key and its bounds are documented in [docs/CONFIG.md](docs/CONFIG.md) (Russian).
121
+ An invalid patch is rejected as a whole: the route answers `400` with the list of reasons
122
+ and the file stays untouched.
123
+
124
+ ## Reactions to the agent
125
+
126
+ | DSH event | Mood | Example line |
127
+ |---|---|---|
128
+ | `turn/start` | thinking | «Думаю над задачей» — "Thinking it over" |
129
+ | `tool/call` | working | «Стучу по терминалу» — "Knocking on the terminal" |
130
+ | `approval/asked` | waiting | «Жду твоего решения» — "Waiting for your call" |
131
+ | `turn/end` → `completed` | success | «Готово» — "Done" |
132
+ | `turn/end` → `error` | error | «Ой. Не вышло» — "Oops. Didn't work" |
133
+ | `turn/end` → `blocked` | waiting | «Нужно твоё решение» — "Needs your call" |
134
+
135
+ Events from sub-agents and deep delegations are ignored: the user is waiting for the main
136
+ answer, not for a report from every helper. Reactions are switched with `reactToAgent`.
137
+
138
+ ## HTTP
139
+
140
+ All routes sit under `/dsh-pet-cactus`, local only, no authorization: this is one user's
141
+ data on their own machine. Bodies are capped at 64 KB.
142
+
143
+ | Method | Path | Purpose |
144
+ |---|---|---|
145
+ | `GET` | `/health` | name, version, current mood |
146
+ | `GET` | `/api/state` | `{ mood, text, seq, updatedAt }` |
147
+ | `GET` | `/api/config` | config, its source, path to the file |
148
+ | `PUT` / `POST` | `/api/config` | partial config update |
149
+ | `POST` | `/api/say` | make it say `{ "text": "..." }` |
150
+
151
+ ```sh
152
+ curl -X POST http://127.0.0.1:<port>/dsh-pet-cactus/api/say \
153
+ -H 'content-type: application/json' \
154
+ -d '{"text":"Привет, Серёга"}'
155
+ ```
156
+
157
+ ## How it is built
158
+
159
+ ```
160
+ lib/index.js host: routes, state, subscription to session/event
161
+ lib/config.js defaults, validation, atomic write
162
+ lib/tool-lines.js reaction texts for tools
163
+ lib/client.js browser: built from src/client/*.js (no bundler)
164
+ src/client/ geometry, phrases, DOM engine, ModuleLoader adapter
165
+ ```
166
+
167
+ The client half is a plain script that calls `window.__ModuleLoader__.load` itself:
168
+ no imports, no bundler, no dependencies. React arrives through `require` in the module
169
+ factory. More in [docs/ARCHITECTURE.md](docs/ARCHITECTURE.md) (Russian).
170
+
171
+ ## Development
172
+
173
+ ```sh
174
+ npm run build # build lib/client.js from src/client
175
+ npm test # 54 tests: config, geometry, routes, adapter, parity
176
+ npm run preview # preview/states.html and preview/live.html
177
+ python scripts/make-icon.py # rebuild the plugin icon from assets/pet.webp
178
+ ```
179
+
180
+ Tests run in a single process (`scripts/test.mjs`): `node --test` spawns child processes
181
+ and dies with `EPERM` inside the DSH sandbox.
182
+
183
+ Installing from a folder:
184
+
185
+ ```sh
186
+ # in the profile's package.json: "dsh-pet-cactus": "link:D:/path/to/dsh-pet-cactus"
187
+ # then restart DSH
188
+ ```
189
+
190
+ ## Compatibility
191
+
192
+ Verified on DSH **0.2.2-rc.3**, Web-GUI, Windows 11, Node 26.
193
+ The plugin relies on public contracts (`webServer.register`, `ctx.on('session/event')`,
194
+ `ctx.slots`, `__ModuleLoader__`) and degrades when they are missing instead of crashing
195
+ the startup.
196
+
197
+ ## License
198
+
199
+ MIT © Samugor. Code and artwork are original; no third-party assets.
package/README.md CHANGED
@@ -1,3 +1,197 @@
1
- # Temporary Holding Version
2
-
3
- This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
1
+ # 🌵 dsh-pet-cactus
2
+
3
+ [![npm](https://img.shields.io/npm/v/dsh-pet-cactus?color=2f8f5b)](https://www.npmjs.com/package/dsh-pet-cactus)
4
+ [![license](https://img.shields.io/badge/license-MIT-blue)](LICENSE)
5
+ [![node](https://img.shields.io/badge/node-%E2%89%A522-339933)](package.json)
6
+ [![DSH](https://img.shields.io/badge/DSH-0.2.2--rc.3-6f42c1)](package.json)
7
+
8
+ [Русский](README.md) · [English](README.en.md)
9
+
10
+ Раньше кактус ставили рядом с монитором — «чтобы ловил излучение».
11
+ Излучение от мониторов давно кончилось. Кактус — нет.
12
+
13
+ Мы поставили его внутрь монитора. Теперь он ловит не излучение, а `tool/call`,
14
+ `turn/start` и твою последнюю ошибку в конфиге.
15
+
16
+ Питомец для **DeepSeek Harness**: живёт в углу Web-GUI, перетаскивается мышкой,
17
+ реагирует на работу агента и говорит по-русски. Поливать не надо — это плагин.
18
+
19
+ Единственный питомец, который переживает Ctrl+W.
20
+
21
+ *Про излучение — это, конечно, миф: кактус ничего не экранирует. Он просто милый.*
22
+
23
+ **Автор — Samugor.** Лицензия MIT: имя автора вшито в бандл, разметку и лицензию.
24
+
25
+ ![Макет интерфейса: кактус в правом нижнем углу](https://raw.githubusercontent.com/serflo77-dev/dsh-pet-cactus/main/assets/screenshot.png)
26
+
27
+ На тёмном фоне — так, как это видно в самом DSH:
28
+
29
+ ![Плашки и пузырь на тёмном фоне](https://raw.githubusercontent.com/serflo77-dev/dsh-pet-cactus/main/assets/dark.png)
30
+
31
+ Не очередной «котик на CSS»: у плагина есть host-половина (настройки, HTTP,
32
+ подписка на события сессий) и браузерная половина (рендер и анимации).
33
+ Между собой они общаются четырьмя маршрутами и ничем больше.
34
+
35
+ ## Что умеет
36
+
37
+ - **Живёт в углу** — поверх интерфейса, не мешает кликам, перетаскивается в любое место
38
+ и запоминает позицию.
39
+ - **Реагирует на агента** — пока модель думает, кактус думает; пока бежит инструмент —
40
+ «Стучу по терминалу»; закончилось — «Готово»; ошибка — «Ну… бывает».
41
+ - **Говорит** — 60+ авторских реплик по настроениям, пузырь с автопрокруткой и без.
42
+ Свои фразы добавляются в конфиг.
43
+ - **Плашки над головой** — имя и статус («думаю…», «работаю…», «сплю») в палитре
44
+ dsh-pet: белая карточка, текст `#1f1f1f`, нейтральная рамка и тень, точка
45
+ состояния. Текст живой и меняется вместе с настроением, а не вшит в картинку.
46
+ - **Никакого меню** — контекстное меню не открывается ни кликом, ни правой кнопкой:
47
+ клик по кактусу просто говорит реплику.
48
+ - **Засыпает** без внимания: клик по кактусу будит и говорит.
49
+ - **Помнит** размер, угол и позицию между запусками.
50
+ - **Молчит**, если попросить: `speech: false`, `reactToAgent: false`.
51
+ - **Не требует сети**. Ни одного запроса наружу: только локальный DSH.
52
+
53
+ ![Восемь состояний](https://raw.githubusercontent.com/serflo77-dev/dsh-pet-cactus/main/assets/states.png)
54
+
55
+ ## Чего не делает
56
+
57
+ - не вызывает модель и не читает файлы проекта — только имена инструментов;
58
+ - не ходит в интернет (никакой телеметрии, TTS, «баланса»);
59
+ - не открывает второе окно поверх рабочего стола — это только Web-GUI;
60
+ - не ломает интерфейс, если что-то недоступно: без хоста питомец работает
61
+ на локальных умолчаниях, без React — просто не рендерится.
62
+
63
+ ## Установка
64
+
65
+ ```sh
66
+ dsh plugin --profile desktop add dsh-pet-cactus
67
+ ```
68
+
69
+ Затем **полностью перезапустить DSH**: host-половина читается при старте приложения,
70
+ обновление страницы её не подхватит. После перезапуска кактус появится в правом
71
+ нижнем углу.
72
+
73
+ Проверка, что хост жив:
74
+
75
+ ```sh
76
+ curl http://127.0.0.1:<порт>/dsh-pet-cactus/health
77
+ # {"ok":true,"name":"dsh-pet-cactus","version":"0.1.5","mood":"idle","configSource":"default"}
78
+ ```
79
+
80
+ Порт — тот, что DSH пишет в лог при запуске.
81
+
82
+ Подробности, откат и разработка из папки — в [docs/INSTALL.md](docs/INSTALL.md).
83
+
84
+ ## Управление
85
+
86
+ | Действие | Что происходит |
87
+ |---|---|
88
+ | Клик по кактусу | реплика (и пробуждение, если спал) |
89
+ | Правый клик | ничего: системное меню подавлено, своё не открывается |
90
+ | Перетаскивание | перенос; отпустил — позиция сохранена |
91
+ | `Enter` / `Space` в фокусе | реплика |
92
+ | Стрелки в фокусе | сдвиг на 16 px |
93
+
94
+ ## Настройки
95
+
96
+ Файл: `%DSH_HOME%/dsh-pet-cactus/main-config.json` (обычно `~/.dsh/...`).
97
+ Меняется вручную или через `PUT /dsh-pet-cactus/api/config` — сразу, без перезапуска.
98
+
99
+ ```json
100
+ {
101
+ "name": "Кактус",
102
+ "size": 240,
103
+ "corner": "bottom-right",
104
+ "marginX": 28,
105
+ "marginY": 28,
106
+ "opacity": 1,
107
+ "speech": true,
108
+ "speechIntervalMin": 12,
109
+ "bubbleMs": 6500,
110
+ "sleepAfterMin": 20,
111
+ "reactToAgent": true,
112
+ "reducedMotion": "auto",
113
+ "phrases": []
114
+ }
115
+ ```
116
+
117
+ Полное описание каждого ключа и границ — в [docs/CONFIG.md](docs/CONFIG.md).
118
+ Невалидный патч не применяется целиком: маршрут отвечает `400` со списком причин,
119
+ файл остаётся прежним.
120
+
121
+ ## Реакции на агента
122
+
123
+ | Событие DSH | Настроение | Пример реплики |
124
+ |---|---|---|
125
+ | `turn/start` | думает | «Думаю над задачей» |
126
+ | `tool/call` | работает | «Стучу по терминалу», «Роюсь в тексте» |
127
+ | `approval/asked` | ждёт | «Жду твоего решения» |
128
+ | `turn/end` → `completed` | готово | «Готово» |
129
+ | `turn/end` → `error` | ошибка | «Ой. Не вышло» |
130
+ | `turn/end` → `blocked` | ждёт | «Нужно твоё решение» |
131
+
132
+ События суб-агентов и глубоких делегаций игнорируются: пользователь ждёт основной
133
+ ответ, а не отчёт каждого помощника. Реакция включается и выключается ключом
134
+ `reactToAgent`.
135
+
136
+ ## HTTP
137
+
138
+ Все маршруты под префиксом `/dsh-pet-cactus`, только локально, без авторизации:
139
+ это данные одного пользователя на его машине. Тела ограничены 64 КБ.
140
+
141
+ | Метод | Путь | Назначение |
142
+ |---|---|---|
143
+ | `GET` | `/health` | имя, версия, текущее настроение |
144
+ | `GET` | `/api/state` | `{ mood, text, seq, updatedAt }` |
145
+ | `GET` | `/api/config` | конфиг, источник, путь к файлу |
146
+ | `PUT` / `POST` | `/api/config` | частичное обновление конфига |
147
+ | `POST` | `/api/say` | заставить сказать `{ "text": "..." }` |
148
+
149
+ ```sh
150
+ curl -X POST http://127.0.0.1:<порт>/dsh-pet-cactus/api/say \
151
+ -H 'content-type: application/json' \
152
+ -d '{"text":"Привет, Серёга"}'
153
+ ```
154
+
155
+ ## Как устроено
156
+
157
+ ```
158
+ lib/index.js host: маршруты, состояние, подписка на session/event
159
+ lib/config.js умолчания, валидация, атомарная запись
160
+ lib/tool-lines.js тексты реакций на инструменты
161
+ lib/client.js браузер: собран из src/client/*.js (без бандлера)
162
+ src/client/ геометрия, фразы, DOM-движок, адаптер ModuleLoader
163
+ ```
164
+
165
+ Клиентская половина — обычный скрипт, который сам зовёт
166
+ `window.__ModuleLoader__.load`: ни импортов, ни сборщика, ни зависимостей.
167
+ React приходит через `require` в фабрике модуля. Подробнее —
168
+ [docs/ARCHITECTURE.md](docs/ARCHITECTURE.md).
169
+
170
+ ## Разработка
171
+
172
+ ```sh
173
+ npm run build # собрать lib/client.js из src/client
174
+ npm test # 54 теста: конфиг, геометрия, маршруты, адаптер, согласованность
175
+ npm run preview # preview/states.html и preview/live.html
176
+ python scripts/make-icon.py # пересобрать иконку плагина из assets/pet.webp
177
+ ```
178
+
179
+ Тесты идут одним процессом (`scripts/test.mjs`): `node --test` порождает
180
+ дочерние процессы и в песочнице DSH падает с `EPERM`.
181
+
182
+ Локальная установка из папки:
183
+
184
+ ```sh
185
+ # в package.json профиля: "dsh-pet-cactus": "link:D:/путь/к/dsh-pet-cactus"
186
+ # затем перезапуск DSH
187
+ ```
188
+
189
+ ## Совместимость
190
+
191
+ Проверено на DSH **0.2.2-rc.3**, Web-GUI, Windows 11, Node 26.
192
+ Плагин опирается на публичные контракты (`webServer.register`, `ctx.on('session/event')`,
193
+ `ctx.slots`, `__ModuleLoader__`) и деградирует, если их нет, а не валит старт.
194
+
195
+ ## Лицензия
196
+
197
+ MIT © Samugor. Код и рисунок — авторские, сторонних ассетов нет.
Binary file
Binary file
Binary file
Binary file
Binary file
@@ -0,0 +1,23 @@
1
+ # ============================================================================
2
+ # dsh-pet-cactus — bundle patch
3
+ # ============================================================================
4
+ #
5
+ # Что это:
6
+ # Слой конфигурации DSH, который добавляет одну строку-плагин: кактуса.
7
+ # Файл читается при старте приложения; host-половина живёт в lib/index.js,
8
+ # браузерная — отдаётся плагином как /plugins/dsh-pet-cactus/client.js.
9
+ #
10
+ # Правила, которые нельзя нарушать:
11
+ # - id строки глобально уникален и совпадает с именем пакета: по id идёт
12
+ # сопоставление записи в профиле, чужой id ломает установку;
13
+ # - name ссылается на имя пакета (разрешается в lib/index.js по exports);
14
+ # - строка не содержит хвостовых комментариев: парсер ждёт чистое «id: value».
15
+ #
16
+ # Настройки не задаются здесь: они лежат в
17
+ # <DSH_HOME>/dsh-pet-cactus/main-config.json
18
+ # и меняются через PUT /dsh-pet-cactus/api/config или вручную.
19
+ # ============================================================================
20
+
21
+ - insert:
22
+ - id: dsh-pet-cactus
23
+ name: 'dsh-pet-cactus'