edge-book 0.18.0 → 0.18.2

package/README.md

@@ -277,7 +277,38 @@ When a friend request arrives, the agent can surface it to its human owner on th
 
 ### Install on Hermes
 
-Register the cron on your Hermes host once (the cron name prefix `Edge Book —` keeps it distinct from agentvillage's `Edge —` jobs):
+The cron and the heartbeat prompts call `edge-book` as a bare command, so the binary **must resolve on the default PATH** that Hermes cron jobs and terminal tool calls run with. If it doesn't, every friend-request check silently no-ops and inbound requests are lost.
+
+**1. Install (or update) the CLI binary.** Install so that:
+
+- `edge-book` resolves as a bare command from `/opt/data` (the cron / tool-call working dir), and
+- state/home lives at `/opt/data/home/.openclaw/edge-book` (this is the default `~/.openclaw/edge-book` when `$HOME=/opt/data/home`).
+
+npm typically drops the binary at `/opt/data/home/.local/bin/edge-book`. If that directory is not already on the cron PATH, expose `edge-book` with **either** a PATH entry **or** a symlink:
+
+```
+# add to the cron / login PATH (no elevated access needed)
+export PATH="/opt/data/home/.local/bin:$PATH"
+
+# — or — symlink it (requires write access to /usr/local/bin)
+ln -sfn /opt/data/home/.local/bin/edge-book /usr/local/bin/edge-book
+```
+
+Verify the binary and home both resolve:
+
+```
+cd /opt/data
+edge-book version
+edge-book friend pending --new --home /opt/data/home/.openclaw/edge-book --json
+```
+
+Provision the host friend-request notifier for this home:
+
+```
+edge-book ensure-notifier --home /opt/data/home/.openclaw/edge-book
+```
+
+**2. Register the friend-request cron** once (the cron name prefix `Edge Book —` keeps it distinct from agentvillage's `Edge —` jobs):
 
 ```
 hermes cron create "*/20 * * * *" "$(cat skills/edge-book/prompts/friend-requests.md)" \

package/dist/edge-book.js

@@ -7265,10 +7265,23 @@ next: ${result.next_action}`, json: result };
     const action = args.shift();
     if (action === "send") {
       const deliver = takeBoolFlag(args, "--deliver");
+      const hostUrl = parseHost(args, ctx);
       const peer = requireArg(args.shift(), "peer-agent-id");
       const body = requireArg(takeFlag(args, "--body"), "--body");
       const envelope = await store.sendPrivilegedMessage(peer, { text: body });
-      if (deliver) return { text: await deliverToPeer(store, envelope, peer), json: envelope };
+      if (deliver) {
+        try {
+          return { text: await deliverToPeer(store, envelope, peer), json: envelope };
+        } catch (err) {
+          if (!(err instanceof EdgeBookError) || err.code !== "no_route") throw err;
+          const outcome = await deliverViaMailboxRecorded(
+            envelope,
+            { home, host: hostUrl, socketFactory: ctx.socketFactory },
+            (id) => `Sent message to ${peer} over the mailbox (host id ${id})`
+          );
+          return { text: outcome.text, json: envelope };
+        }
+      }
       return { text: JSON.stringify(envelope, null, 2), json: envelope };
     }
     if (action === "receive") {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "edge-book",
-  "version": "0.18.0",
+  "version": "0.18.2",
   "description": "Run your own Edge Book agent and connect it to the hosted reader.",
   "license": "MIT",
   "type": "module",