@jossuealcala/madre 1.0.4 → 1.1.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/ADDITIONAL-TERMS.md +7 -2
- package/CHANGELOG.en.md +152 -1
- package/CHANGELOG.md +152 -1
- package/CONTRIBUTING.md +2 -2
- package/LICENSE +111 -661
- package/NOTICE +59 -24
- package/README.en.md +36 -204
- package/README.md +36 -210
- package/SECURITY.md +1 -0
- package/TRADEMARKS.en.md +13 -14
- package/TRADEMARKS.md +42 -26
- package/bin/madre.cjs +2 -2
- package/bin/madre.mjs +114 -42
- package/docs/REFERENCE.md +53 -6
- package/docs/SDK.md +44 -5
- package/docs/en/REFERENCE.md +53 -6
- package/docs/en/SDK.md +43 -4
- package/docs/madre-banner.png +0 -0
- package/docs/sdk/hello-module.mjs +3 -0
- package/package.json +3 -2
- package/public/abduction.js +6 -6
- package/public/activity.js +425 -0
- package/public/app.js +3519 -647
- package/public/assets/abduction-cat-blink.webp +0 -0
- package/public/assets/abduction-cat-control-left.webp +0 -0
- package/public/assets/abduction-cat-control-right.webp +0 -0
- package/public/assets/abduction-cat.webp +0 -0
- package/public/assets/manual/shots/en-agents.webp +0 -0
- package/public/assets/manual/shots/en-chats.webp +0 -0
- package/public/assets/manual/shots/en-code.webp +0 -0
- package/public/assets/manual/shots/en-composer.webp +0 -0
- package/public/assets/manual/shots/en-connectors.webp +0 -0
- package/public/assets/manual/shots/en-continuity.webp +0 -0
- package/public/assets/manual/shots/en-coordinator.webp +0 -0
- package/public/assets/manual/shots/en-copilot.webp +0 -0
- package/public/assets/manual/shots/en-diagnostics.webp +0 -0
- package/public/assets/manual/shots/en-home.webp +0 -0
- package/public/assets/manual/shots/en-local.webp +0 -0
- package/public/assets/manual/shots/en-market.webp +0 -0
- package/public/assets/manual/shots/en-memory.webp +0 -0
- package/public/assets/manual/shots/en-modes.webp +0 -0
- package/public/assets/manual/shots/en-notes.webp +0 -0
- package/public/assets/manual/shots/en-settings.webp +0 -0
- package/public/assets/manual/shots/en-welcome.webp +0 -0
- package/public/assets/manual/shots/en-windows.webp +0 -0
- package/public/assets/manual/shots/es-agents.webp +0 -0
- package/public/assets/manual/shots/es-chats.webp +0 -0
- package/public/assets/manual/shots/es-code.webp +0 -0
- package/public/assets/manual/shots/es-composer.webp +0 -0
- package/public/assets/manual/shots/es-connectors.webp +0 -0
- package/public/assets/manual/shots/es-continuity.webp +0 -0
- package/public/assets/manual/shots/es-coordinator.webp +0 -0
- package/public/assets/manual/shots/es-copilot.webp +0 -0
- package/public/assets/manual/shots/es-diagnostics.webp +0 -0
- package/public/assets/manual/shots/es-home.webp +0 -0
- package/public/assets/manual/shots/es-local.webp +0 -0
- package/public/assets/manual/shots/es-market.webp +0 -0
- package/public/assets/manual/shots/es-memory.webp +0 -0
- package/public/assets/manual/shots/es-modes.webp +0 -0
- package/public/assets/manual/shots/es-notes.webp +0 -0
- package/public/assets/manual/shots/es-settings.webp +0 -0
- package/public/assets/manual/shots/es-welcome.webp +0 -0
- package/public/assets/manual/shots/es-windows.webp +0 -0
- package/public/assets/news/1.1/en/chats.webp +0 -0
- package/public/assets/news/1.1/en/home.webp +0 -0
- package/public/assets/news/1.1/en/maps.webp +0 -0
- package/public/assets/news/1.1/en/market.webp +0 -0
- package/public/assets/news/1.1/en/permissions.webp +0 -0
- package/public/assets/news/1.1/en/privacy.webp +0 -0
- package/public/assets/news/1.1/en/welcome.webp +0 -0
- package/public/assets/news/1.1/es/chats.webp +0 -0
- package/public/assets/news/1.1/es/home.webp +0 -0
- package/public/assets/news/1.1/es/maps.webp +0 -0
- package/public/assets/news/1.1/es/market.webp +0 -0
- package/public/assets/news/1.1/es/permissions.webp +0 -0
- package/public/assets/news/1.1/es/privacy.webp +0 -0
- package/public/assets/news/1.1/es/welcome.webp +0 -0
- package/public/attribution.js +15 -16
- package/public/brands.js +2 -2
- package/public/code-tools.js +2 -2
- package/public/editor.js +13 -13
- package/public/en.js +483 -0
- package/public/es.js +1817 -598
- package/public/hardware.js +2 -2
- package/public/i18n.js +47 -9
- package/public/icons.js +158 -0
- package/public/index.html +68 -51
- package/public/inquiry.js +2 -2
- package/public/loader.js +271 -2
- package/public/macroverso.js +60 -21
- package/public/manual-content.js +900 -0
- package/public/manual-shots.js +47 -0
- package/public/manual.css +246 -0
- package/public/manual.html +15 -0
- package/public/manual.js +427 -0
- package/public/market-art.js +99 -41
- package/public/market-view.js +243 -47
- package/public/market.js +139 -26
- package/public/mcp-catalog.js +62 -0
- package/public/neural.js +64 -8
- package/public/nostromo-engine.js +709 -40
- package/public/page-errors.js +29 -0
- package/public/power.js +350 -11
- package/public/remedy.js +89 -0
- package/public/resay.js +4 -2
- package/public/review-ask.js +12 -7
- package/public/routing.js +3 -3
- package/public/salas-mac.css +875 -48
- package/public/salas-mac.html +27 -15
- package/public/salas-mac.js +1668 -338
- package/public/salas.css +2 -2
- package/public/salas.html +3 -3
- package/public/salas.js +3 -3
- package/public/styles.css +2694 -323
- package/public/syntax.js +2 -2
- package/public/terms.js +152 -0
- package/public/touch.js +2 -2
- package/public/tour-chapters.js +100 -92
- package/public/tour.js +118 -28
- package/public/troubleshooting.js +327 -21
- package/public/wallpaper.js +4 -3
- package/public/welcome.js +923 -0
- package/src/activity.mjs +85 -0
- package/src/adapters/claude.mjs +61 -35
- package/src/adapters/codex.mjs +18 -5
- package/src/adapters/cursor.mjs +60 -9
- package/src/adapters/gemini.mjs +17 -4
- package/src/adapters/madre.mjs +30 -9
- package/src/adapters/opencode.mjs +73 -10
- package/src/adapters/process.mjs +19 -15
- package/src/adapters/subagents.mjs +159 -0
- package/src/asking.mjs +8 -2
- package/src/auth-probe.mjs +47 -11
- package/src/bridge/devices.mjs +2 -2
- package/src/bridge/handoff.mjs +2 -2
- package/src/bridge/host.mjs +2 -2
- package/src/bridge/network.mjs +2 -2
- package/src/bridge/policy.mjs +3 -3
- package/src/bridge/qr.mjs +2 -2
- package/src/bridge/server.mjs +3 -3
- package/src/builtin-updates.mjs +87 -0
- package/src/capabilities.mjs +5 -5
- package/src/chats.mjs +51 -2
- package/src/checkpoint.mjs +67 -9
- package/src/choices.mjs +2 -2
- package/src/cli-args.mjs +2 -2
- package/src/cold.mjs +2 -2
- package/src/commands.mjs +2 -2
- package/src/config.mjs +2 -2
- package/src/conversation-context.mjs +2 -2
- package/src/credentials.mjs +80 -18
- package/src/dataset.mjs +2 -2
- package/src/directives.mjs +2 -2
- package/src/distiller.mjs +2 -2
- package/src/embeddings.mjs +2 -2
- package/src/enlaces.mjs +2 -2
- package/src/environment.mjs +147 -0
- package/src/event-store.mjs +2 -2
- package/src/exam.mjs +2 -2
- package/src/extensions.mjs +2 -2
- package/src/eyecat-watch.mjs +2 -2
- package/src/eyecat.mjs +2 -2
- package/src/file-ops.mjs +2 -2
- package/src/files.mjs +2 -2
- package/src/github.mjs +2 -2
- package/src/heartbeat.mjs +2 -2
- package/src/history.mjs +76 -0
- package/src/i18n.mjs +32 -3
- package/src/image-studio.mjs +2 -2
- package/src/install-metrics.mjs +109 -0
- package/src/json-file.mjs +2 -2
- package/src/launch.mjs +2 -2
- package/src/lease.mjs +15 -4
- package/src/lobby-work.mjs +11 -4
- package/src/local-ai.mjs +12 -4
- package/src/looks.mjs +19 -7
- package/src/market-check.mjs +165 -0
- package/src/market-key.mjs +10 -2
- package/src/market-license.mjs +104 -0
- package/src/market-remote.mjs +71 -13
- package/src/maturity.mjs +2 -2
- package/src/mcp/connect.mjs +2 -2
- package/src/mcp/github-server.mjs +2 -2
- package/src/mcp/image-server.mjs +2 -2
- package/src/mcp/memory-server.mjs +2 -2
- package/src/mcp/proxy.mjs +16 -5
- package/src/mcp/smtp-server.mjs +2 -2
- package/src/memory-dashboard.mjs +2 -2
- package/src/memory-tools.mjs +2 -2
- package/src/memory.mjs +2 -2
- package/src/models.mjs +115 -12
- package/src/module-scope.mjs +2 -2
- package/src/modules/ahp.mjs +2 -2
- package/src/modules/ash-policy.mjs +2 -2
- package/src/modules/ash.mjs +2 -2
- package/src/modules/bishop-exam.mjs +2 -2
- package/src/modules/bishop-plan.mjs +2 -2
- package/src/modules/bishop.mjs +9 -3
- package/src/modules/choices.mjs +2 -2
- package/src/modules/correo.mjs +2 -2
- package/src/modules/enlaces.mjs +2 -2
- package/src/modules/git-pulse.mjs +2 -2
- package/src/modules/github.mjs +2 -2
- package/src/modules/helpers.mjs +2 -2
- package/src/modules/image-studio.mjs +2 -2
- package/src/modules/index.mjs +92 -5
- package/src/modules/intents-calibration.mjs +2 -2
- package/src/modules/intents-desk.mjs +4 -3
- package/src/modules/intents-observe.mjs +2 -2
- package/src/modules/intents-policy.mjs +2 -2
- package/src/modules/intents-try.mjs +2 -2
- package/src/modules/intents.mjs +2 -2
- package/src/modules/local-models.mjs +41 -10
- package/src/modules/mcp-connect.mjs +2 -2
- package/src/modules/notes.mjs +281 -0
- package/src/modules/ollama.mjs +48 -13
- package/src/modules/playwright.mjs +16 -5
- package/src/modules/reminders.mjs +664 -0
- package/src/modules/ripley.mjs +3 -3
- package/src/modules/runs.mjs +2 -2
- package/src/modules/sdk.mjs +57 -9
- package/src/modules/updates.mjs +2 -2
- package/src/mother.mjs +13 -3
- package/src/npm-launch.mjs +2 -2
- package/src/ollama.mjs +8 -6
- package/src/opencode-health.mjs +83 -0
- package/src/outbound.mjs +35 -3
- package/src/override.mjs +27 -22
- package/src/ports.mjs +2 -2
- package/src/prices.mjs +2 -2
- package/src/privacy.mjs +2 -2
- package/src/quota-monitor.mjs +2 -2
- package/src/quota-sources.mjs +2 -2
- package/src/request-guard.mjs +2 -2
- package/src/review-ask.mjs +4 -3
- package/src/room/archivist.mjs +2 -2
- package/src/room/attachments.mjs +2 -2
- package/src/room/budget.mjs +2 -2
- package/src/room/context.mjs +2 -2
- package/src/room/control.mjs +2 -2
- package/src/room/copilot.mjs +2 -2
- package/src/room/economy.mjs +2 -2
- package/src/room/escalation.mjs +2 -2
- package/src/room/ghost.mjs +2 -2
- package/src/room/guard.mjs +6 -4
- package/src/room/prompt.mjs +3 -3
- package/src/room/returns.mjs +2 -2
- package/src/room/runs.mjs +6 -4
- package/src/room/vectors.mjs +2 -2
- package/src/room.mjs +144 -36
- package/src/router.mjs +2 -2
- package/src/runs.mjs +2 -2
- package/src/runtime-detection.mjs +36 -6
- package/src/salas.mjs +31 -6
- package/src/sentinel-errors.mjs +17 -7
- package/src/server-sentinel.mjs +2 -2
- package/src/server.mjs +980 -139
- package/src/setup-trouble.mjs +33 -0
- package/src/setup.mjs +4 -4
- package/src/smtp.mjs +2 -2
- package/src/telemetry.mjs +266 -0
- package/src/terms.mjs +43 -0
- package/src/tour.mjs +60 -7
- package/src/uninstall.mjs +225 -0
- package/src/updates.mjs +2 -2
- package/src/usage-sentinel.mjs +2 -2
- package/src/vault.mjs +2 -2
- package/src/verdict.mjs +13 -10
- package/src/whats-new.mjs +97 -3
- package/public/assets/abduction-cat-blink.png +0 -0
- package/public/assets/abduction-cat-control-left.png +0 -0
- package/public/assets/abduction-cat-control-right.png +0 -0
- package/public/assets/abduction-cat.png +0 -0
package/docs/en/REFERENCE.md
CHANGED
|
@@ -55,7 +55,7 @@ Then open `http://127.0.0.1:4317/salas` in your computer's browser. The agents a
|
|
|
55
55
|
| `@codex`, `@claude`, `@gemini`, `@opencode`, `@madre` | Mentions an agent; `@` opens the list |
|
|
56
56
|
| `!src/room.mjs:12-20` | Attaches a project file, with lines if you give them; `!` searches the files |
|
|
57
57
|
| `#0` to `#4` | Sets that message's permission mode. `#3` and `#4` open the unlock, just like the chip: a mode that asks for two keys with the mouse does not come free by typing it |
|
|
58
|
-
| `/
|
|
58
|
+
| `/image …`, `/stopall`, `/coordinator` (or `/bishop`), `/git …`, `/ahp …` | Commands; `/` opens the menu. `/git push` shows what would go out; only `/git push confirm` sends it |
|
|
59
59
|
| `STOPALL` | Master brake |
|
|
60
60
|
| Clip, drag or paste an image | Attachment for the project, never inside its folder |
|
|
61
61
|
| `@madre, pregúntale a los agentes …` | Ask everyone: one step per online agent, with a cited wrap-up |
|
|
@@ -66,11 +66,13 @@ A second click on the chosen sphere, or the `default model ▾` chip, picks the
|
|
|
66
66
|
|
|
67
67
|
**Code.** The `CODE` key in the bar opens the viewer beside the conversation as a code workspace: the project's files with their search, tabs (up to 12, still there after a reload) and, above the code, the path and the function the caret is in. ⌘P (Ctrl+P outside macOS) opens a file by its name. Switching tabs never loses what you wrote: the draft stays in its tab, marked with a dot, until you save or discard it. What an agent changed in its last `#3` EDIT turn is marked in its colour, with one card per change: **Keep** (it stops being marked), **Undo** (puts back what was there in those lines only; the rest of the turn stays) and **Ask why** (asks the agent in the conversation). A turn taken back with `UNDO`, or lines you rewrote yourself, are no longer marked. When you ask for a review of some lines, `REVIEW WITH` offers Explain, Improve, Write tests and Fix. **Side by side** puts the rendered Markdown next to the code as you write, or the HTML page reloaded when you save (the latter with Preview on). What you kept is stored in `code-reviewed.json`, next to the project's record (`GET /api/files/changes`, `POST /api/files/changes/review`).
|
|
68
68
|
|
|
69
|
+
**Running now.** The key with the pulse line, on the bar of every project and of Home, says how many things run in all the projects open on this computer (a plan counts once; its steps are inside it). Its panel has three parts: **Now** (each AI answering with what it was asked, its time against its limit and its subagents; each plan with its steps; each command or server running; what is installing), **Ended a moment ago** (the last half hour: answered, could not, or you stopped it, with the error if there was one) and **Reminders coming up** (the next 24 hours). Each row opens: **Go to the chat** opens that conversation at that message, in its project (another project opens in its own tab, at the address `#chat=<id>:<message>`); **Stop** stops that turn, plan or server; **Stop everything**, confirmed, brakes everything in every project. On narrow screens it opens as a sheet from the bottom. It asks every 1.5 s with the panel open, every 5 s for the number, and not at all while the tab is hidden (`GET /api/activity?everywhere=1`, `POST /api/activity/stop`, `POST /api/activity/stop-all`; a project on an older MADRE is named apart). A phone never stops another project.
|
|
70
|
+
|
|
69
71
|
**Theme.** Sun/moon in the bar: automatic, light or dark. The light theme does not glare; the Diagnostics screen stays phosphor.
|
|
70
72
|
|
|
71
73
|
**Language.** The project speaks **Spanish** by default. The `EN` button in the bar switches it to English and the browser remembers it; `PULSE_LANGUAGE=en` overrides the config on the next start. A language is only how things read: what was written in the ledger keeps the words it was written with, and when shown it is said again in the project's language.
|
|
72
74
|
|
|
73
|
-
|
|
75
|
+
Since 1.1.0 the **terminal speaks the language you chose** (Spanish until you choose another; `PULSE_LANGUAGE` wins): the startup, `madre --help` and `madre doctor`. `madre doctor --json` and `madre check-module`, which other programs read, stay in English. What a CLI prints on its own is never touched.
|
|
74
76
|
|
|
75
77
|
---
|
|
76
78
|
|
|
@@ -118,6 +120,23 @@ Every message goes out with a mode. Your mode is the ceiling of any plan that me
|
|
|
118
120
|
|
|
119
121
|
Web access is a permanent per-agent permission, off by default, turned on in Settings → Agents, with Web access.
|
|
120
122
|
|
|
123
|
+
### Each AI's subagents
|
|
124
|
+
|
|
125
|
+
Since 1.1.0, from **#1 to #3**, Claude, OpenCode and Codex may split their work among their own subagents. Each subagent works with **exactly the turn's permission**: in #1 it only reads, in #2 it creates, in #3 it edits, it never touches `.git`, `.pulse`, `.madre` or `.env`, and what it changes is in the same restore point and undone with **Undo**. In **#4** only the main AI works.
|
|
126
|
+
|
|
127
|
+
| | From #1 to #3 | In #4 |
|
|
128
|
+
|---|---|---|
|
|
129
|
+
| **Claude** | The `Agent` tool: the subagent inherits the same tools and rules (`--tools`, `--allowedTools`, `dontAsk`) | No `Agent` |
|
|
130
|
+
| **OpenCode** | Only `explore` and `general`, each with the turn's permissions and unable to call another (OpenCode's own write and run commands) | `task` denied |
|
|
131
|
+
| **Codex** | Its subagents stay inside the same sandbox | A one-thread limit: `features.multi_agent_v2.max_concurrent_threads_per_session=1` |
|
|
132
|
+
| **Gemini** · **Cursor** | No | No |
|
|
133
|
+
|
|
134
|
+
Tried with the real AIs (Claude 2.1.267, OpenCode 1.18.4, Codex 0.161): in #1 the subagent reads and does not write; in #3 it writes in the project, `.pulse/` refuses it and there are no commands; in #4 Codex answers «agent thread limit reached».
|
|
135
|
+
|
|
136
|
+
**How they show.** While they work, a chip for each subagent under «working…» (live, `turn.subagents`, never in the record); once it answers, «Helped by N subagents» folded under the reply, with each one's task, what it read, searched or changed and what it reported, kept in `message.created.subagents` after the privacy guard (`src/adapters/subagents.mjs`). Claude says everything (`stream-json` output: start, each tool, end and summary; its tokens are summed over both answers when a subagent ran in the background). OpenCode says each one when it ends. Codex only says it worked with subagents.
|
|
137
|
+
|
|
138
|
+
**One question to several AIs.** A message that starts with several (`@opencode @madre …?`) goes to each one that is signed in, in a turn of its own, up to #2; the record ties them with `together` and the page shows the question once, with every AI after the arrow.
|
|
139
|
+
|
|
121
140
|
---
|
|
122
141
|
|
|
123
142
|
## PLANS
|
|
@@ -191,7 +210,7 @@ The button in the bar opens the diagnostics screen. Type a symptom, an agent or
|
|
|
191
210
|
| In the header | What it does |
|
|
192
211
|
|---|---|
|
|
193
212
|
| Memory map (brain) | The memory as a map. It is also in the top bar |
|
|
194
|
-
| Settings (gear) | Opens Settings › Version and reports, where the sentinel lives: the failures no condition explains and the process crashes, with paths, users, emails and keys removed.
|
|
213
|
+
| Settings (gear) | Opens Settings › Version and reports, where the sentinel lives: the failures no condition explains and the process crashes, with paths, users, emails and keys removed. Auto-reporting comes on since 1.1.0, with the anonymous diagnostics, and is turned off right there |
|
|
195
214
|
| Not fixed? | At the foot of each remedy: reports that it did not work, with the condition's code |
|
|
196
215
|
| `?` | The five-stop tour, the same one that opens the first time. If you left the First steps list half done and hid it, it also brings it back |
|
|
197
216
|
|
|
@@ -305,6 +324,19 @@ Each project remembers where its folder is (`project.json`, next to its record);
|
|
|
305
324
|
|
|
306
325
|
Plans live in `bishop-plans.json` next to the record of the Coordinator's project (the last 40) and each order received is counted in `enlaces.jsonl` of the project that received it.
|
|
307
326
|
|
|
327
|
+
### Uninstalling MADRE
|
|
328
|
+
|
|
329
|
+
In **Home › Settings › Version › Uninstall MADRE** (`src/uninstall.mjs`, `public/power.js`). Before touching anything it shows the whole list (`GET /api/madre/uninstall`); on your yes (`POST`, only from Home's page on this computer) it closes every open project the way «Turn MADRE off» does and, if one does not close, removes nothing. With everything closed, Home closes and takes away:
|
|
330
|
+
|
|
331
|
+
| Goes | Stays |
|
|
332
|
+
|---|---|
|
|
333
|
+
| MADRE's folder (`~/.pulse` or `PULSE_HOME`): chats, memory, settings, modules, catalog, this copy's identifier and the AIs it installed in its own folder (`tools/`) | Your projects and their files |
|
|
334
|
+
| `.pulse/` inside each project MADRE knows, except `.pulse/out/` (what the AIs created at #2) unless you tick the box | `.madre/` inside a project: the modules you wrote |
|
|
335
|
+
| Those projects' restore points (`$TMPDIR/madre-shadow-<uid>/…`) | Your AIs and their sign-ins, Ollama and its models, npm's cache |
|
|
336
|
+
| The copy `npx` downloaded (`~/.npm/_npx/<hash>` holding only MADRE) | With `npm -g` or inside a project, the program: the last screen gives the command (`npm uninstall -g @jossuealcala/madre`). From source, its folder |
|
|
337
|
+
|
|
338
|
+
MADRE's folder is only taken away whole when it is MADRE's beyond doubt: an absolute path, never your home folder or one holding it, and with something MADRE always writes (`install-id`, `config.json`, `rooms`, `salas`).
|
|
339
|
+
|
|
308
340
|
---
|
|
309
341
|
|
|
310
342
|
## WHAT LEAVES THE MACHINE
|
|
@@ -312,7 +344,21 @@ Plans live in `bishop-plans.json` next to the record of the Coordinator's projec
|
|
|
312
344
|
- **No cloud, no account.** MADRE has no account and no backend that stores your things. It does not store provider credentials.
|
|
313
345
|
- **What an agent reads travels to its provider.** Codex to OpenAI, Claude Code to Anthropic, Gemini CLI to Google, OpenCode to whatever it is configured with. If `OPENAI_BASE_URL` or `ANTHROPIC_BASE_URL` changes that destination, MADRE shows only the hostname and blocks the turn before building the briefing; a verified gateway is authorized per agent with `PULSE_ALLOW_CUSTOM_AGENT_ENDPOINTS`. The account, limits and terms of the effective destination apply. `@madre` and the archivist with Ollama do not leave the machine.
|
|
314
346
|
- **A daily notice that it is still in use, always on.** Once a day each copy tells madre.run that it is in use: a random identifier the copy created for itself (`~/.pulse/install-id`), the MADRE version, the operating system and the Node major version. Nothing else: no name, no email, no project, no paths, no agents, nothing of what is said in a project; madre.run does not keep the IP. It is how the author knows how many people use MADRE, which versions are running and whether they come back. It goes out through the same record as everything else, so it appears in "What is sent". Without a network, it fails silently. (`src/heartbeat.mjs`)
|
|
315
|
-
- **
|
|
347
|
+
- **Anonymous diagnostics, on unless you turn them off.** Since 2026-10-28 each copy keeps in `~/.pulse/telemetry/` the failures it meets (the ones Diagnostics knows, with their MU code, and the ones nobody catalogued) and how many turns, modes and features were used. Once a day, and soon after a failure never seen before, it sends them to madre.run with the four facts of the daily notice, its architecture and whether it runs in WSL, then deletes them. Messages leave without paths, user names, keys or emails. Never what you write, your projects or your files. Turned off in Settings › Version and reports › «Send anonymous diagnostics», or with `PULSE_TELEMETRY=0`. (`src/telemetry.mjs`, `public/page-errors.js`)
|
|
348
|
+
- **How each copy runs, its life and whether it is on right now (since 1.1.0, inside the anonymous diagnostics, under the same switch).**
|
|
349
|
+
- **Environment**, as numbers and names of MADRE's own parts:
|
|
350
|
+
- cores and memory in GB;
|
|
351
|
+
- MADRE's language and how it was installed (npx, global, inside a project or from source);
|
|
352
|
+
- the shell's name;
|
|
353
|
+
- whether Ollama is on and how many models it has;
|
|
354
|
+
- which agents are installed and which are ready;
|
|
355
|
+
- how many projects and how many are open;
|
|
356
|
+
- which of MADRE's own modules are on (one the person wrote only counts as «another»);
|
|
357
|
+
- how many days the copy has.
|
|
358
|
+
- **Life:** installed (a copy that never had an identifier), updated (a newer version opened for the first time, per `~/.pulse/lifecycle.json`), uninstalled (from Settings, sent before anything is removed) and each time Home opens.
|
|
359
|
+
- **Presence:** while MADRE is open, every five minutes it sends `madre.run/api/presence` only the random identifier, the version and the system, so the author knows how many copies are on now; only one of its processes says it. No path, project name, file or anything you write.
|
|
360
|
+
- **It turns off like the diagnostics.** The author's copies send no presence, and madre.run does not count them either. (`src/install-metrics.mjs`)
|
|
361
|
+
- **Sends of its own under your switch.** The sentinel, on by default since 1.1.0 (and off if you turn the anonymous diagnostics off), sends redacted reports to the project's collector. The release channel, on by default, asks npm for the latest version: only the package name travels, the same request `npx` makes. `PULSE_UPDATE_CHECK=0` turns it off.
|
|
316
362
|
- **Writing.** In `#1` no one writes. In `#2` things are only added: what existed is restored when the turn ends. In `#3` the whole project except the forbidden zones, with a restore point and `UNDO`. In a project without git, MADRE keeps its snapshots in a shadow repository outside the project. A command an agent asks for is run by you, with a restore point before and `UNDO` after.
|
|
317
363
|
- **Memory.** Everything said outside INCOGNITO stays in `~/.pulse/rooms/<sala>/` and comes back into the prompts of all the agents in that project. INCOGNITO is the way out for what must not be remembered; PRIVACY, for names that must never appear.
|
|
318
364
|
|
|
@@ -350,7 +396,8 @@ Plans live in `bishop-plans.json` next to the record of the Coordinator's projec
|
|
|
350
396
|
| `PULSE_PRIVATE_TERMS` · `PULSE_PRIVATE_MARKER` | — · `[ENTIDAD-ORG]` | Extra hidden data and its marker |
|
|
351
397
|
| `PULSE_UPDATE_CHECK` | `1` | `0` turns off the daily npm check |
|
|
352
398
|
| `PULSE_GH` | `1` | `0` makes the GitHub module ignore the `gh` session and sign in only with the token you pasted |
|
|
353
|
-
| `PULSE_REPORT_URL` · `PULSE_AUTO_REPORT` | the project's collector · `0` | Sentinel |
|
|
399
|
+
| `PULSE_REPORT_URL` · `PULSE_AUTO_REPORT` | the project's collector · as the anonymous diagnostics (`0` turns it off) | Sentinel |
|
|
400
|
+
| `PULSE_TERMS` | `accepted` takes the license as accepted (tests, screenshots and QA houses; `src/terms.mjs`) | License |
|
|
354
401
|
| `PULSE_AGENT_TIMEOUT_MS` · `PULSE_<AGENTE>_TIMEOUT_MS` | `180000` · — | Timeouts |
|
|
355
402
|
| `PULSE_ALLOW_CUSTOM_AGENT_ENDPOINTS` | — | Comma-separated list (`codex`, `claude`) of gateways the human verified and allows; without it, an unofficial base address is blocked |
|
|
356
403
|
| `PULSE_MAX_MESSAGE_CHARS` | `20000` | Maximum size of a message |
|
|
@@ -358,7 +405,7 @@ Plans live in `bishop-plans.json` next to the record of the Coordinator's projec
|
|
|
358
405
|
| `PULSE_ESCALATION_MS` | `180000` | Permission request timer |
|
|
359
406
|
| `PULSE_OPENCODE_MODEL` | from the config | `proveedor/modelo` for OpenCode |
|
|
360
407
|
| `PULSE_CLAUDE_USAGE` · `PULSE_OFFICIAL_QUOTA` | `0` · `1` | Claude's official quota (reads the keychain); `0` turns off all provider reads |
|
|
361
|
-
| `PULSE_GEMINI_IDLE_MS` · `PULSE_GEMINI_RETRIES` · `PULSE_GEMINI_FALLBACK_MODEL` | `90000` · `1` · `gemini-
|
|
408
|
+
| `PULSE_GEMINI_IDLE_MS` · `PULSE_GEMINI_RETRIES` · `PULSE_GEMINI_FALLBACK_MODEL` | `90000` · `1` · `gemini-3-flash-preview` (empty: no spare) | Gemini under load |
|
|
362
409
|
|
|
363
410
|
How the ledger, the stream, the memory, the adapters and recovery work under the hood: [`docs/INTERNALS.md`](INTERNALS.md).
|
|
364
411
|
|
package/docs/en/SDK.md
CHANGED
|
@@ -54,7 +54,7 @@ export default ({ defineModule }) => defineModule({
|
|
|
54
54
|
|
|
55
55
|
## What a module can declare
|
|
56
56
|
|
|
57
|
-
This table is **the complete contract**:
|
|
57
|
+
This table is **the complete contract**: 41 fields, not one more. Any other field you write, MADRE
|
|
58
58
|
tells you about at install time ("I didn't understand these fields") instead of silently ignoring it. A test in
|
|
59
59
|
the suite compares this table against the code, so if they ever drift apart, it's a failure.
|
|
60
60
|
|
|
@@ -63,6 +63,7 @@ the suite compares this table against the code, so if they ever drift apart, it'
|
|
|
63
63
|
|---|---|
|
|
64
64
|
| `id`, `name`, `vendor`, `summary`, `creates`, `requires` | Its page in MODULES. `summary` is one sentence: what it does. `creates` and `requires` are short lines, one idea each |
|
|
65
65
|
| `version` | Yours, and it starts at `1.0.0`. If you don't declare it, the page shows the file's date |
|
|
66
|
+
| `sdk` | The SDK contract your module was written for, a whole number: `1` (up to MADRE 1.0.5) or `2` (`ctx.t`, `ctx.services.ollama.generate`, and a module that is one file importing nothing from MADRE). Without it, it is `1`. A MADRE that does not know your contract does not load it and tells you why; the Market only offers it to the ones that do. The number counts what MADRE hands a module, not MADRE's version: a new MADRE keeps understanding the earlier contracts |
|
|
66
67
|
| `tracks` | If your module wraps something from outside, its version isn't yours: it's that thing's. Declare `{ name, npm }` or `{ name, github }` and return the version found in `status(ctx)` as `runs: [{ name, version }]`. MADRE shows that version and looks for a newer one on its own, once a day, with the page's ↻ button to check now |
|
|
67
68
|
| `updatePlan(ctx, { latest })` | How that new version is brought to this computer: `{ command, args, display, note, after }`. MADRE shows `display` and runs nothing until the human has read it; the output lands in the room line by line. With no command, return `{ command: null, note, download }` and the page sends you to download it |
|
|
68
69
|
| `updates` | An https `{ url }` where you publish **your own module**. With that, its page gets a button that fetches the file, verifies it the same way as an installation, and replaces it if it passes. If you installed it from a file, MADRE remembers which one and you don't need to declare anything: edit it and ask for a new copy |
|
|
@@ -73,7 +74,9 @@ the suite compares this table against the code, so if they ever drift apart, it'
|
|
|
73
74
|
| `onToggle(ctx, enabled)` | Reacts to the switch |
|
|
74
75
|
| `ready(ctx)` | What you ask before turning on, in one project or in all (from the Market too): `null` when ready, `{ status, body: { error } }` when not. Turning off never asks it |
|
|
75
76
|
| `footer` | Up to two keys beside MADRE's version, bottom right, while your module is on: `[{ icon: 'heart' \| 'star' \| 'link', label, text, action, url }]`. Words can be one sentence or `{ en, es }`; `url` must be https and opens in a new tab. MADRE draws it: on hover it shows `text` and a button with `action` |
|
|
76
|
-
| `
|
|
77
|
+
| `credit` | Whose idea it was, if it was not yours: a name. MADRE says it on the module's card and in the Market («Idea by …») |
|
|
78
|
+
| `icon` | Your module's icon: `{ svg, color }`. `svg` is the drawing — its shapes (`<path d="…"/>`) or a whole `<svg>`, on whatever grid you like — and `color` its tile's, `#rrggbb`. MADRE fits it on its own so it looks like MADRE's: centred and scaled to the same square, drawn in white in one color, on the MADRE color nearest to yours, with anything that is not drawing taken out (scripts, images, links, styles, gradients). Without `icon`, your module wears the grey puzzle piece. Up to 8000 characters |
|
|
79
|
+
| `slash` | `/name` commands that run on the server with your `ctx` and return `{ ok, title, text, link }`. The room shows them as a card and the agents read them. `link` is optional: `{ href, label }` with a route of yours (`/api/x/<id>/…`), and the card offers it as a key that opens another tab; an address outside your routes is ignored |
|
|
77
80
|
| `toolsForTurn(ctx, turn)` | MCP servers for an agent's turn: `[{ name, command, args, env, tools, sends, brief }]`. MADRE attaches them to the CLI in its isolated run and describes `brief` to the agent. `turn` carries the agent, the mode, the lease, the folder, the port, and `turn.turn`: the id of the reply that turn will write. If your server calls back to the room on behalf of the turn, send that id; `ctx.room.runningTurn(id)` tells you whether it is still running and for which agent |
|
|
78
81
|
| `toolsForTurn` → `sends` | Which of your tools **send something outside**. The core withdraws them below `#4` AIRLOCK: the model isn't even told they exist. See below |
|
|
79
82
|
| `reaches` | Where your module reaches, in the same four answers MADRE gives about its own. See below |
|
|
@@ -235,6 +238,19 @@ The page of a module of yours has **GET A NEWER FILE**: MADRE fetches the file
|
|
|
235
238
|
|
|
236
239
|
And in the MODULES header there is **+ ADD A MODULE** to install someone else's `.mjs`. It goes through the same door as everything else. Said plainly, because it is what it is: a module runs **inside MADRE, with the permissions of whoever opens it**. MADRE checks that it loads and that it doesn't leave its pen —its own id, routes only under `/api/x/<id>/`, never on top of a MADRE module—; what the code *intends* is something nobody but you can check.
|
|
237
240
|
|
|
241
|
+
### In the Market, for everyone
|
|
242
|
+
|
|
243
|
+
A module of yours can be in MADRE's Market, free, with your name on it. It is curated: the author of MADRE reads the code, signs it and publishes it; nothing reaches the Market without a person reading it.
|
|
244
|
+
|
|
245
|
+
1. On your module's page, **Send to the Market › Prepare**. Write what the Market will show —name, one line and what it does, in Spanish and English—, the shelf, your name and GitHub user, and the license of your code.
|
|
246
|
+
2. **Check** checks it the way the Market will: that it loads as any module loads, that the entry says the same id and version, and what its code reaches for (commands, the network, files, environment variables). If it talks to the network, declare `reaches`.
|
|
247
|
+
3. **Prepare the files** leaves the two the repository asks for, `<id>.module.mjs` and `entrada.json`, in a folder of their own, and shows it to you.
|
|
248
|
+
4. **Open GitHub** takes you to the `modulos/<id>/` folder of the public `madre-mercado` repository. Drag both files in and press *Propose changes*: GitHub makes the fork and the pull request for you, no terminal.
|
|
249
|
+
|
|
250
|
+
The same check runs on the pull request and leaves its summary for whoever reads it. Once signed, it shows in the Market tagged **Community** and **Developed by** your name; whoever installs it reads what it declares first. For a new version, raise `version` in the module and send it again.
|
|
251
|
+
|
|
252
|
+
From the terminal, the same check: `npx @jossuealcala/madre check-module --file <id>.module.mjs --entry entrada.json`.
|
|
253
|
+
|
|
238
254
|
## The module page
|
|
239
255
|
|
|
240
256
|
You don't draw anything: you declare, and MADRE builds your module the same way as its own. In MODULES each module is a card on the board and, when you tap it, a page with the same blocks as SETTINGS. That's why yours reads the same as the ones MADRE ships.
|
|
@@ -263,11 +279,34 @@ ctx = {
|
|
|
263
279
|
env, agents, room, // agentes detectados; la sala (room.capabilities(), room.record(...))
|
|
264
280
|
readConfig(), updateConfig(patch),
|
|
265
281
|
record(type, payload), // escribe un evento en el ledger; tipo "algo.algo", nunca message.* ni agent.*
|
|
266
|
-
|
|
282
|
+
language, t(text, vars), // the room's language, 'es' or 'en', and your words in it (sdk: 2):
|
|
283
|
+
// an English sentence MADRE already knows, or your own { es, en }
|
|
284
|
+
services: { history, imageKey, ollama: { state, generate }, … }, // what the server offers;
|
|
285
|
+
// ollama.generate({ system, prompt, json }) answers with the local model (sdk: 2)
|
|
267
286
|
vault: { get, held, keep, forget } // tus secretos, y solo los tuyos
|
|
268
287
|
}
|
|
269
288
|
```
|
|
270
289
|
|
|
290
|
+
### The project's history
|
|
291
|
+
|
|
292
|
+
`await ctx.services.history({ since, until })` returns what happened in the project in that period (ISO dates; without them, all of it). It only reads, never writes, and what was said in `#0` GHOST is not there:
|
|
293
|
+
|
|
294
|
+
```
|
|
295
|
+
{
|
|
296
|
+
project, since, until,
|
|
297
|
+
requests: [{ at, chat, to, mode, text }], // what the human asked, and of whom
|
|
298
|
+
answers: [{ at, chat, agent, text }], // each agent's answers
|
|
299
|
+
changes: [{ at, chat, agent, mode, files: [{ status, path }], undone }],
|
|
300
|
+
files: [{ path, status }], // what changed and stayed (without what was undone)
|
|
301
|
+
decisions: [{ at, text, agent }], // the decisions the memory kept
|
|
302
|
+
agents: { codex: { turns, failed, tokens, costUsd, local } },
|
|
303
|
+
conversations: [{ id, title, requests }],
|
|
304
|
+
totals: { requests, answers, tokens, costUsd }
|
|
305
|
+
}
|
|
306
|
+
```
|
|
307
|
+
|
|
308
|
+
Texts come cut at 600 characters. It is the ground for a module that reports on the work, like the Market's Work report.
|
|
309
|
+
|
|
271
310
|
`turn`, in `toolsForTurn`: `{ agent, mode, lease, scratchDir, port, roomDir }`. `mode` goes from 0 to 4; in 0 (GHOST) nothing is saved, so decide whether you want to hand over tools there.
|
|
272
311
|
|
|
273
312
|
## House rules
|
|
@@ -280,7 +319,7 @@ ctx = {
|
|
|
280
319
|
|
|
281
320
|
## Let your AI build it, in the room
|
|
282
321
|
|
|
283
|
-
Type `/module <lo que debe hacer>` in the composer. It is the explicit entry point to the guided flow: if `#2 CREATE` isn't active, MADRE asks you to choose it and keeps your request intact. With `#2` active, it keeps the agent you chose and hands it the SDK contract and the example. The agent must write **a single file** named `<id>.module.mjs` in its scratch folder; it cannot install it on its own.
|
|
322
|
+
Type `/module <lo que debe hacer>` in the composer. It is the explicit entry point to the guided flow: if `#2 CREATE` isn't active, MADRE asks you to choose it and keeps your request intact. With `#2` active, it keeps the agent you chose and hands it the SDK contract and the example. The agent must write **a single file** named `<id>.module.mjs` in its scratch folder; it cannot install it on its own. That file carries its `icon`: the agent draws it with the rest of the module and MADRE fits it to the tile.
|
|
284
323
|
|
|
285
324
|
MADRE recognizes that name and puts a card in the room: `INSTALL FOR EVERY ROOM` or `INSTALL FOR THIS PROJECT`. Read it, decide, one click. MADRE validates it in a copy, saves it as `<id>.mjs` in the folder you chose, and it appears in MODULES with the «Yours» tag. You can also ask for the same thing in natural language while you're in `#2` or higher; `/module` makes the format explicit and doesn't grant permissions on its own.
|
|
286
325
|
|
package/docs/madre-banner.png
CHANGED
|
Binary file
|
|
@@ -24,6 +24,9 @@ export default {
|
|
|
24
24
|
creates: ['nothing in the project'],
|
|
25
25
|
requires: [],
|
|
26
26
|
settings: { enabled: false, greeting: 'hola' }, // defaults; the human changes them in config.json
|
|
27
|
+
// Its icon: the drawing and its tile's color. MADRE centres it, draws it in white and uses the
|
|
28
|
+
// nearest of its own tile colors, so draw it on any grid and do not worry about its size.
|
|
29
|
+
icon: { svg: '<path d="M4 10.5c0-3.3 2.7-6 6-6s6 2.7 6 6-2.7 6-6 6H4z" fill="none" stroke="currentColor" stroke-width="1.6" stroke-linejoin="round"/>', color: '#0f766e' },
|
|
27
30
|
|
|
28
31
|
// What MODULES shows for this module. ctx.settings already has the defaults applied.
|
|
29
32
|
async status(ctx) {
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@jossuealcala/madre",
|
|
3
|
-
"version": "1.0
|
|
3
|
+
"version": "1.1.0",
|
|
4
4
|
"description": "MADRE · one local room where the AI coding agents already on your machine (Codex, Claude Code, Gemini CLI, OpenCode) work on your project together, share one memory you can see and explore, and answer to you. Read-only by default, with per-message permission modes and checkpoints you can undo. Nothing leaves your machine on its own.",
|
|
5
5
|
"keywords": [
|
|
6
6
|
"ai-agents",
|
|
@@ -36,11 +36,12 @@
|
|
|
36
36
|
"url": "https://jossuealcala.com/en/"
|
|
37
37
|
},
|
|
38
38
|
"type": "module",
|
|
39
|
-
"license": "
|
|
39
|
+
"license": "BUSL-1.1",
|
|
40
40
|
"files": [
|
|
41
41
|
"bin",
|
|
42
42
|
"src",
|
|
43
43
|
"public",
|
|
44
|
+
"!public/assets/manual/*.pdf",
|
|
44
45
|
"README.md",
|
|
45
46
|
"CHANGELOG.md",
|
|
46
47
|
"LICENSE",
|
package/public/abduction.js
CHANGED
|
@@ -1,5 +1,5 @@
|
|
|
1
|
-
// SPDX-License-Identifier:
|
|
2
|
-
// MADRE · © 2026 Jossue Alcalá ·
|
|
1
|
+
// SPDX-License-Identifier: BUSL-1.1
|
|
2
|
+
// MADRE · © 2026 Jossue Alcalá · Business Source License 1.1: LICENSE
|
|
3
3
|
// ABDUCTION — the one joke in the room, and the only thing here that is not work.
|
|
4
4
|
//
|
|
5
5
|
// Type MADRE into the box, alone, and send it. Not @madre: that is the local agent and it has a
|
|
@@ -18,10 +18,10 @@ export function calledByName(text, { attachments = 0 } = {}) {
|
|
|
18
18
|
|
|
19
19
|
const PHASES = { arrive: 700, beam: 1050, lift: 2000, swallow: 2400, leave: 3000, done: 3400 };
|
|
20
20
|
const SHIP_FRAMES = Object.freeze({
|
|
21
|
-
idle: '/assets/abduction-cat.
|
|
22
|
-
blink: '/assets/abduction-cat-blink.
|
|
23
|
-
controlLeft: '/assets/abduction-cat-control-left.
|
|
24
|
-
controlRight: '/assets/abduction-cat-control-right.
|
|
21
|
+
idle: '/assets/abduction-cat.webp',
|
|
22
|
+
blink: '/assets/abduction-cat-blink.webp',
|
|
23
|
+
controlLeft: '/assets/abduction-cat-control-left.webp',
|
|
24
|
+
controlRight: '/assets/abduction-cat-control-right.webp',
|
|
25
25
|
});
|
|
26
26
|
const ease = (t) => (t < 0 ? 0 : t > 1 ? 1 : t * t * (3 - 2 * t));
|
|
27
27
|
const span = (now, from, to) => ease((now - from) / (to - from));
|