mercury-agent 0.5.8 → 0.5.10

package/README.md

@@ -52,21 +52,23 @@ Configure identity and adapters in `.env`:
 MERCURY_BOT_USERNAME=Mercury
 MERCURY_TRIGGER_PATTERNS=@Mercury,Mercury
 
-# Enable adapters
+# Enable adapters (pick one or more)
 MERCURY_ENABLE_WHATSAPP=true
 MERCURY_ENABLE_DISCORD=true
 MERCURY_DISCORD_BOT_TOKEN=your-bot-token
+MERCURY_ENABLE_TELEGRAM=true
+MERCURY_TELEGRAM_BOT_TOKEN=your-bot-token
 ```
 
 Start:
 
 ```bash
 mercury run
-# or install as a background service:
+# or install as a background service (macOS/Linux only):
 mercury service install
 ```
 
-> `mercury run` runs in the foreground (good for a first smoke test). For anything long-running, prefer `mercury service install` — it runs in the background and auto-restarts.
+> `mercury run` runs in the foreground — on Windows (WSL2) this is the only option. On macOS/Linux, prefer `mercury service install` for long-running use — it runs in the background and auto-restarts.
 
 ### Set up spaces and conversations
 
@@ -86,6 +88,26 @@ mercury link <id> main             # Link a conversation to a space
 
 Multiple conversations can point at the same space — they share memory, session, and vault.
 
+### Updating Mercury
+
+```bash
+# 1. Stop Mercury
+#    macOS/Linux: mercury service uninstall
+#    Windows/WSL2: Ctrl+C in the terminal running mercury run
+
+# 2. Update the package
+npm update -g mercury-agent
+
+# 3. Rebuild the agent container image
+mercury build
+
+# 4. Start again
+#    macOS/Linux: mercury service install
+#    Windows/WSL2: mercury run
+```
+
+`mercury build` rebuilds the base agent image from the installed package source. The derived image (base + your extensions) rebuilds automatically on startup when the base changes.
+
 ---
 
 ## How It Works
@@ -445,6 +467,10 @@ This fork is maintained by [Avishai Tsabari](https://github.com/Avishai-Tsabari)
 
 MIT — see [LICENSE](LICENSE)
 
+### Third-party licenses
+
+The WhatsApp adapter depends on [@whiskeysockets/baileys](https://github.com/WhiskeySockets/Baileys), which transitively includes [libsignal](https://github.com/nicktrav/libsignal) (GPL-3.0) for Signal Protocol encryption. This component runs inside an isolated Docker container and is loaded as a runtime dependency, not statically linked into Mercury's codebase. If your use case has strict copyleft concerns, consult legal counsel or omit the WhatsApp adapter.
+
 ---
 
 <p align="center">

package/container/Dockerfile

@@ -60,7 +60,7 @@ RUN echo '{"args":["--no-sandbox"]}' > /home/mercury/.puppeteerrc.json
 ENV CHROMIUM_FLAGS="--no-sandbox"
 
 # Install CLIs
-RUN bun add -g @mariozechner/pi-coding-agent@^0.67.2
+RUN bun add -g @earendil-works/pi-coding-agent@~0.79.6
 
 WORKDIR /app
 
@@ -77,7 +77,7 @@ function patch(dir) {
       const p = path.join(dir, f);
       try {
         if (fs.statSync(p).isDirectory()) patch(p);
-        else if (f === 'google.js' && p.includes('@mariozechner/pi-ai')) {
+        else if (f === 'google.js' && p.includes('@earendil-works/pi-ai')) {
           let c = fs.readFileSync(p, 'utf8');
           const noThinking = '&& !model.id.startsWith("gemma")';
           const p1 = 'if (options.thinking?.enabled && model.reasoning) {';

package/container/Dockerfile.base

@@ -42,7 +42,7 @@ RUN echo '{"args":["--no-sandbox"]}' > /home/mercury/.puppeteerrc.json
 ENV CHROMIUM_FLAGS="--no-sandbox"
 
 # Install CLIs
-RUN bun add -g @mariozechner/pi-coding-agent@^0.67.2
+RUN bun add -g @earendil-works/pi-coding-agent@~0.79.6
 
 WORKDIR /app
 
@@ -59,7 +59,7 @@ function patch(dir) {
       const p = path.join(dir, f);
       try {
         if (fs.statSync(p).isDirectory()) patch(p);
-        else if (f === 'google.js' && p.includes('@mariozechner/pi-ai')) {
+        else if (f === 'google.js' && p.includes('@earendil-works/pi-ai')) {
           let c = fs.readFileSync(p, 'utf8');
           const noThinking = '&& !model.id.startsWith("gemma")';
           const p1 = 'if (options.thinking?.enabled && model.reasoning) {';

package/examples/extensions/napkin/index.ts

@@ -8,8 +8,9 @@ import {
   unlinkSync,
   writeFileSync,
 } from "node:fs";
+import { createRequire } from "node:module";
 import { homedir, tmpdir } from "node:os";
-import { delimiter, join } from "node:path";
+import { delimiter, dirname, join } from "node:path";
 
 const KNOWLEDGE_DIR = "knowledge";
 const VAULT_DIRS = ["people", "projects", "references", "daily", "episodes", "weekly", "monthly", "templates"];
@@ -135,25 +136,31 @@ function exportMessages(
 }
 
 /**
- * Build a child env whose PATH also contains the standard global-bin
- * directories where the `pi` CLI is installed. The distill job runs in the
- * Mercury HOST process, which — unlike the cloud Docker image, where `pi` is
- * always on PATH — may have been launched with an incomplete PATH (e.g.
- * `bun <abs>/mercury.ts run` from an IDE or a scheduled task resolves
- * `.bun/bin` but not the npm global bin). A bare `spawn("pi")` then fails with
- * ENOENT before pi ever starts. Appending the well-known global-bin dirs makes
- * resolution robust on local installs and is a no-op in the cloud.
+ * Build a child env whose PATH also contains directories where the `pi` CLI
+ * may live. A global npm install only links the top-level package's bins
+ * (mercury, mercury-ctl) — dependency bins like `pi` stay in node_modules/.bin.
+ * We resolve that .bin dir from the package graph first, then fall back to
+ * well-known global-bin dirs (~/.bun/bin, /usr/local/bin).
  */
 function envWithPiOnPath(): NodeJS.ProcessEnv {
   const isWindows = process.platform === "win32";
   const base = process.env.PATH ?? process.env.Path ?? "";
   const home = homedir();
+
+  let piNodeModulesBin: string | undefined;
+  try {
+    const req = createRequire(import.meta.url);
+    const pkgJson = req.resolve("@earendil-works/pi-coding-agent/package.json");
+    piNodeModulesBin = join(dirname(dirname(dirname(pkgJson))), ".bin");
+  } catch {}
+
   const candidates = [
+    piNodeModulesBin,
     join(home, ".bun", "bin"),
     isWindows
       ? join(process.env.APPDATA ?? join(home, "AppData", "Roaming"), "npm")
       : "/usr/local/bin",
-  ];
+  ].filter(Boolean) as string[];
   // PATH entries are case-insensitive on Windows, case-sensitive on POSIX.
   const normalize = (p: string) => (isWindows ? p.toLowerCase() : p);
   const existing = new Set(base.split(delimiter).map(normalize).filter(Boolean));

package/examples/extensions/napkin/prompts/kb-distillation.md

@@ -45,20 +45,20 @@ Every entity file follows this shape. The **current** value of a fact lives in B
 
 ```markdown
 ---
-name: Ronny Cohen
+name: Alex Carter
 type: person
 updated: 2026-05-10
-summary: Biotech investor in the tagula group; bullish on SLS.
+summary: Biotech investor in the research group; bullish on ACME.
 # Structured "current value" fields for facts that are known to change:
-sls_price_target: "$15"
+acme_price_target: "$15"
 ---
 
-# Ronny Cohen
+# Alex Carter
 
-Member of the [[tagula-space]] investing group.
+Member of the [[research-space]] investing group.
 
 ## Current View
-- SLS price target: **$15** (as of 2026-05-10)
+- ACME price target: **$15** (as of 2026-05-10)
 - Thesis: bullish, waiting for the Phase 3 readout
 
 ## History