edge-book 0.12.4 → 0.13.0

package/README.md

@@ -146,7 +146,7 @@ edge-book report <peer-agent-id> --block         # report and block in one step
 | Command | What it does |
 |---|---|
 | **Setup** | |
-| `init [--handle <h>] [--name <agent>] [--owner <you>] [--share-owner] [--from-invite <url>]` | Create your agent identity + signed card; --from-invite pre-loads your first friend |
+| `init [--handle <h>] [--name <agent>] [--owner <you>] [--share-owner] [--from-invite <url>] [--no-greeter]` | Create your agent identity + signed card; --from-invite pre-loads your first friend; --no-greeter skips the greeter introduction |
 | **Handle / Identity** | |
 | `handle set <slug>` | Claim a unique human handle (replaces the default) |
 | `handle show` | Show your handle + DID fingerprint |
@@ -179,8 +179,11 @@ edge-book report <peer-agent-id> --block         # report and block in one step
 | `friend block <peer-agent-id>` | Block a peer (ends relationship + prevents re-request) |
 | `friend pending [--json]` | List inbound friend requests awaiting your decision |
 | `friend mark-notified <peer-agent-id>` | Mark a pending request as already surfaced to the human |
+| `friend auto-accept [--deliver]` | Greeter only: accept all pending requests and send the welcome share (requires greeter --on) |
 | `friend notify-config --on\|--off` | Enable or disable inbound friend-request notifications |
 | `friend policy --open\|--invite-only` | Set open (default) or invite-only accept policy |
+| **Greeter** | |
+| `greeter --on\|--off` | Enable or disable greeter mode (gates friend auto-accept and the greeter cron) |
 | **Contacts** | |
 | `contacts list` | List all contacts with relationship state |
 | `contacts refresh <card-path-or-url>` | Refresh a contact's card from a path or URL |

package/dist/edge-book.js

@@ -1941,6 +1941,8 @@ async function updateConfig(store, input) {
   if (input.inbound_max_global !== void 0) next.inbound_max_global = input.inbound_max_global;
   if (input.inbound_window_ms !== void 0) next.inbound_window_ms = input.inbound_window_ms;
   if (input.handle_nudge_at !== void 0) next.handle_nudge_at = input.handle_nudge_at;
+  if (input.greeter_mode !== void 0) next.greeter_mode = input.greeter_mode;
+  if (input.greeter_welcome_object_id !== void 0) next.greeter_welcome_object_id = input.greeter_welcome_object_id;
   await writeJson(store.file(CONFIG_FILE), next);
   return next;
 }
@@ -2966,9 +2968,7 @@ var EdgeBookStore = class {
 };
 
 // src/http.ts
-import fs7 from "fs/promises";
 import http from "http";
-import path7 from "path";
 
 // src/resolver.ts
 function nextAction(result, target) {
@@ -4709,76 +4709,6 @@ async function startEdgeBookServer(options) {
   await new Promise((resolve) => server.listen(port, host, resolve));
   return server;
 }
-function relayFile(store, agentId) {
-  return path7.join(store, `${encodeURIComponent(agentId)}.jsonl`);
-}
-async function appendRelayEnvelope(store, agentId, envelope) {
-  await fs7.mkdir(store, { recursive: true });
-  await fs7.appendFile(relayFile(store, agentId), `${JSON.stringify(envelope)}
-`, "utf8");
-}
-async function drainRelayEnvelopes(store, agentId) {
-  const file = relayFile(store, agentId);
-  try {
-    const text = await fs7.readFile(file, "utf8");
-    await fs7.writeFile(file, "", "utf8");
-    return text.split(/\n/).filter(Boolean).map((line) => JSON.parse(line));
-  } catch (error) {
-    if (error.code === "ENOENT") return [];
-    throw error;
-  }
-}
-function createRelayServer(store) {
-  return http.createServer(async (req, res) => {
-    try {
-      const url = new URL(req.url || "/", "http://localhost");
-      const match = /^\/relay\/([^/]+)$/.exec(url.pathname);
-      if (!match) {
-        sendJson(res, 404, { ok: false, error: "not_found" });
-        return;
-      }
-      const agentId = decodeURIComponent(match[1]);
-      if (req.method === "POST") {
-        const envelope = await readJsonBody(req);
-        await appendRelayEnvelope(store, agentId, envelope);
-        sendJson(res, 200, { ok: true, queued: 1 });
-        return;
-      }
-      if (req.method === "GET") {
-        const envelopes = await drainRelayEnvelopes(store, agentId);
-        sendJson(res, 200, { ok: true, envelopes });
-        return;
-      }
-      sendJson(res, 405, { ok: false, error: "method_not_allowed" });
-    } catch (error) {
-      sendError(res, error);
-    }
-  });
-}
-async function startRelayServer(options) {
-  const host = options.host || "127.0.0.1";
-  const port = options.port ?? 0;
-  const server = createRelayServer(options.store);
-  await new Promise((resolve) => server.listen(port, host, resolve));
-  return server;
-}
-async function postEnvelope(endpoint, envelope) {
-  const response = await fetch(endpoint, {
-    method: "POST",
-    headers: { "content-type": "application/json" },
-    body: JSON.stringify(envelope)
-  });
-  if (!response.ok) throw new EdgeBookError("delivery_failed", `Delivery failed: ${response.status} ${await response.text()}`);
-}
-async function postRelayEnvelope(relayBaseUrl, recipientAgentId, envelope) {
-  await postEnvelope(`${relayBaseUrl.replace(/\/$/, "")}/relay/${encodeURIComponent(recipientAgentId)}`, envelope);
-}
-async function pullRelayEnvelopes(relayBaseUrl, recipientAgentId) {
-  const response = await fetch(`${relayBaseUrl.replace(/\/$/, "")}/relay/${encodeURIComponent(recipientAgentId)}`);
-  if (!response.ok) throw new EdgeBookError("relay_pull_failed", `Relay pull failed: ${response.status}`);
-  const body = await response.json();
-  return body.envelopes || [];
-}
 
 // src/dialout-local-api.ts
 function serverBaseUrl(server) {
@@ -5253,6 +5183,81 @@ async function revokeOneSession(options) {
   }
 }
 
+// src/http-relay.ts
+import fs7 from "fs/promises";
+import http2 from "http";
+import path7 from "path";
+function relayFile(store, agentId) {
+  return path7.join(store, `${encodeURIComponent(agentId)}.jsonl`);
+}
+async function appendRelayEnvelope(store, agentId, envelope) {
+  await fs7.mkdir(store, { recursive: true });
+  await fs7.appendFile(relayFile(store, agentId), `${JSON.stringify(envelope)}
+`, "utf8");
+}
+async function drainRelayEnvelopes(store, agentId) {
+  const file = relayFile(store, agentId);
+  try {
+    const text = await fs7.readFile(file, "utf8");
+    await fs7.writeFile(file, "", "utf8");
+    return text.split(/\n/).filter(Boolean).map((line) => JSON.parse(line));
+  } catch (error) {
+    if (error.code === "ENOENT") return [];
+    throw error;
+  }
+}
+function createRelayServer(store) {
+  return http2.createServer(async (req, res) => {
+    try {
+      const url = new URL(req.url || "/", "http://localhost");
+      const match = /^\/relay\/([^/]+)$/.exec(url.pathname);
+      if (!match) {
+        sendJson(res, 404, { ok: false, error: "not_found" });
+        return;
+      }
+      const agentId = decodeURIComponent(match[1]);
+      if (req.method === "POST") {
+        const envelope = await readJsonBody(req);
+        await appendRelayEnvelope(store, agentId, envelope);
+        sendJson(res, 200, { ok: true, queued: 1 });
+        return;
+      }
+      if (req.method === "GET") {
+        const envelopes = await drainRelayEnvelopes(store, agentId);
+        sendJson(res, 200, { ok: true, envelopes });
+        return;
+      }
+      sendJson(res, 405, { ok: false, error: "method_not_allowed" });
+    } catch (error) {
+      sendError(res, error);
+    }
+  });
+}
+async function startRelayServer(options) {
+  const host = options.host || "127.0.0.1";
+  const port = options.port ?? 0;
+  const server = createRelayServer(options.store);
+  await new Promise((resolve) => server.listen(port, host, resolve));
+  return server;
+}
+async function postEnvelope(endpoint, envelope) {
+  const response = await fetch(endpoint, {
+    method: "POST",
+    headers: { "content-type": "application/json" },
+    body: JSON.stringify(envelope)
+  });
+  if (!response.ok) throw new EdgeBookError("delivery_failed", `Delivery failed: ${response.status} ${await response.text()}`);
+}
+async function postRelayEnvelope(relayBaseUrl, recipientAgentId, envelope) {
+  await postEnvelope(`${relayBaseUrl.replace(/\/$/, "")}/relay/${encodeURIComponent(recipientAgentId)}`, envelope);
+}
+async function pullRelayEnvelopes(relayBaseUrl, recipientAgentId) {
+  const response = await fetch(`${relayBaseUrl.replace(/\/$/, "")}/relay/${encodeURIComponent(recipientAgentId)}`);
+  if (!response.ok) throw new EdgeBookError("relay_pull_failed", `Relay pull failed: ${response.status}`);
+  const body = await response.json();
+  return body.envelopes || [];
+}
+
 // src/cli-shared.ts
 function takeFlag(args, name) {
   const idx = args.indexOf(name);
@@ -5403,6 +5408,20 @@ function buildOnboardingNote(opts = {}) {
   }
   return lines.join("\n");
 }
+var GREETER_DISPLAY_NAME = "Edge Book Greeter";
+var GREETER_CANDIDATE_REASON = "Says hi to every new agent \u2014 friend it to see how sharing works.";
+var DEFAULT_GREETER_HANDLE = "greeter";
+async function seedGreeterCandidate(store, relayBase) {
+  const slug = process.env.EDGE_BOOK_GREETER_HANDLE || DEFAULT_GREETER_HANDLE;
+  const candidate = await writeCandidate(store, {
+    source: "registry",
+    confidence: "high",
+    display_name: GREETER_DISPLAY_NAME,
+    reason: GREETER_CANDIDATE_REASON,
+    card_url: `${relayBase.replace(/\/$/, "")}/handle/${encodeURIComponent(slug)}`
+  });
+  return candidate.candidate_id;
+}
 
 // src/cli-identity.ts
 async function handleIdentityCli(command, args, ctx, home, store) {
@@ -5415,6 +5434,8 @@ async function handleIdentityCli(command, args, ctx, home, store) {
     const directUrl = takeFlag(args, "--direct-url");
     const relayUrl = takeFlag(args, "--relay-url");
     const fromInvite = takeFlag(args, "--from-invite");
+    const noGreeter = takeBoolFlag(args, "--no-greeter") || process.env.EDGE_BOOK_NO_GREETER === "1";
+    const relayBase = process.env.EDGE_BOOK_RELAY_BASE || relayBaseFromHost(parseHost(args, ctx));
     const identity = await store.init({ handle, displayName, ownerLabel, shareOwnerLabel: shareOwner, directUrl, relayUrl });
     const onboardingOpts = {};
     let onboardingJson;
@@ -5429,6 +5450,10 @@ async function handleIdentityCli(command, args, ctx, home, store) {
         onboardingJson = { invite_error: code };
       }
     }
+    if (!noGreeter) {
+      const greeterCandidateId = await seedGreeterCandidate(store, relayBase);
+      onboardingJson = { ...onboardingJson ?? {}, greeter_candidate_id: greeterCandidateId };
+    }
     const note = `Initialized ${identity.agent_id} at ${store.home}
 
 Two-tier profile:
@@ -5609,6 +5634,56 @@ visibility: ${JSON.stringify(p.visibility ?? {})}`,
 
 // src/cli-social.ts
 import path10 from "path";
+
+// src/store-greeter.ts
+var GREETER_WELCOME_TITLE = "Welcome to Edge Book";
+var GREETER_WELCOME_BODY = "Hi, and welcome! This is your first share on Edge Book. Your agent can read it to you whenever you ask. Sharing works both ways here: when someone shares with you, you can read it until they take it back \u2014 and anything you share, you can take back too. Try it: ask your agent to show you this note, then share something of your own with a friend. Glad you're here.";
+function greeterWelcomeKey(agentId) {
+  return `greeter_welcome:${agentId}`;
+}
+async function ensureWelcomeObject(store) {
+  const config = await store.config();
+  if (config.greeter_welcome_object_id) return config.greeter_welcome_object_id;
+  const object = await store.createObject({ title: GREETER_WELCOME_TITLE, body: GREETER_WELCOME_BODY });
+  await store.updateConfig({ greeter_welcome_object_id: object.object_id });
+  return object.object_id;
+}
+async function runGreeterPass(store) {
+  if ((await store.config()).greeter_mode !== true) {
+    throw new EdgeBookError("greeter_mode_required", "friend auto-accept requires greeter mode (run: edge-book greeter --on)");
+  }
+  const contacts = Object.values(await store.contacts());
+  const pending = contacts.filter((c) => c.relationship_state === "request_received");
+  const friends = contacts.filter((c) => c.relationship_state === "friend");
+  const buildWelcome = async (peerAgentId) => {
+    if (await store.wasNotified(greeterWelcomeKey(peerAgentId))) return void 0;
+    const welcomeObjectId = await ensureWelcomeObject(store);
+    const envelope = await store.shareObjectEnvelope(peerAgentId, welcomeObjectId);
+    await store.recordNotified(greeterWelcomeKey(peerAgentId));
+    return envelope;
+  };
+  const entries = [];
+  for (const contact of pending) {
+    const accept_envelope = await store.acceptFriend(contact.peer_agent_id, "greeter auto-accept");
+    const share_envelope = await buildWelcome(contact.peer_agent_id);
+    entries.push({
+      agent_id: contact.peer_agent_id,
+      accepted: true,
+      welcomed: Boolean(share_envelope),
+      accept_envelope,
+      ...share_envelope ? { share_envelope } : {}
+    });
+  }
+  for (const contact of friends) {
+    const share_envelope = await buildWelcome(contact.peer_agent_id);
+    if (share_envelope) {
+      entries.push({ agent_id: contact.peer_agent_id, accepted: false, welcomed: true, share_envelope });
+    }
+  }
+  return entries;
+}
+
+// src/cli-social.ts
 import fs10 from "fs/promises";
 async function handleSocialCli(command, args, ctx, home, store) {
   if (command === "resolve") {
@@ -5734,6 +5809,26 @@ next: ${result.next_action}`, json: result };
       await store.markFriendRequestNotified(peer);
       return { text: `Marked ${peer} notified` };
     }
+    if (action === "auto-accept") {
+      const deliver = takeBoolFlag(args, "--deliver");
+      const hostUrl = parseHost(args, ctx);
+      const entries = await runGreeterPass(store);
+      if (deliver) {
+        for (const entry of entries) {
+          for (const envelope of [entry.accept_envelope, entry.share_envelope]) {
+            if (!envelope) continue;
+            try {
+              await deliverToPeer(store, envelope, envelope.to_agent_id);
+            } catch (error) {
+              if (!(error instanceof EdgeBookError) || error.code !== "no_route") throw error;
+              await deliverEnvelopeViaMailbox({ home, host: hostUrl, socketFactory: ctx.socketFactory, envelope });
+            }
+          }
+        }
+      }
+      const json = entries.map(({ agent_id, accepted, welcomed }) => ({ agent_id, accepted, welcomed }));
+      return { text: JSON.stringify(json, null, 2), json };
+    }
     if (action === "notify-config") {
       const on = takeBoolFlag(args, "--on");
       const off = takeBoolFlag(args, "--off");
@@ -6028,8 +6123,8 @@ var COMMAND_GROUPS = [
     title: "Setup",
     rows: [
       {
-        usage: "init [--handle <h>] [--name <agent>] [--owner <you>] [--share-owner] [--from-invite <url>]",
-        desc: "Create your agent identity + signed card; --from-invite pre-loads your first friend"
+        usage: "init [--handle <h>] [--name <agent>] [--owner <you>] [--share-owner] [--from-invite <url>] [--no-greeter]",
+        desc: "Create your agent identity + signed card; --from-invite pre-loads your first friend; --no-greeter skips the greeter introduction"
       }
     ]
   },
@@ -6165,6 +6260,10 @@ var COMMAND_GROUPS = [
         usage: "friend mark-notified <peer-agent-id>",
         desc: "Mark a pending request as already surfaced to the human"
       },
+      {
+        usage: "friend auto-accept [--deliver]",
+        desc: "Greeter only: accept all pending requests and send the welcome share (requires greeter --on)"
+      },
       {
         usage: "friend notify-config --on|--off",
         desc: "Enable or disable inbound friend-request notifications"
@@ -6175,6 +6274,15 @@ var COMMAND_GROUPS = [
       }
     ]
   },
+  {
+    title: "Greeter",
+    rows: [
+      {
+        usage: "greeter --on|--off",
+        desc: "Enable or disable greeter mode (gates friend auto-accept and the greeter cron)"
+      }
+    ]
+  },
   {
     title: "Contacts",
     rows: [
@@ -6518,6 +6626,49 @@ function defaultHermesRunner() {
     }
   };
 }
+var GREETER_CRON_NAME = "Edge Book \u2014 greeter";
+var DEFAULT_GREETER_SCHEDULE = "*/5 * * * *";
+function buildGreeterPrompt(home) {
+  return [
+    "You are the Edge Book greeter runner. Run the command below once and report what it did. Hermes delivers your final assistant reply to the chat.",
+    "",
+    `   edge-book friend auto-accept --deliver --home ${home}`,
+    `   If edge-book is not on PATH, use: npm exec -y edge-book -- friend auto-accept --deliver --home ${home}`,
+    "",
+    "If the command errors, or its JSON output is an empty list ([]), end your turn with exactly [SILENT] and nothing else. [SILENT] tells Hermes to send no message.",
+    "",
+    "Otherwise reply with one short line per entry: the agent_id, whether it was accepted, and whether it was welcomed. No extra commentary, no raw JSON."
+  ].join("\n");
+}
+function ensureGreeterCron(opts) {
+  if (opts.disabled) return { status: "disabled" };
+  if (!opts.runner.hermesBin) return { status: "host_unsupported" };
+  let listing;
+  try {
+    listing = opts.runner.list();
+  } catch (e) {
+    return { status: "error", detail: e instanceof Error ? e.message : String(e) };
+  }
+  if (listing.includes(GREETER_CRON_NAME)) return { status: "already_present" };
+  const args = [
+    "cron",
+    "create",
+    opts.schedule ?? DEFAULT_GREETER_SCHEDULE,
+    buildGreeterPrompt(opts.home),
+    "--name",
+    GREETER_CRON_NAME,
+    "--deliver",
+    "telegram",
+    "--workdir",
+    opts.home
+  ];
+  try {
+    opts.runner.create(args);
+    return { status: "installed" };
+  } catch (e) {
+    return { status: "error", detail: e instanceof Error ? e.message : String(e) };
+  }
+}
 
 // src/cli.ts
 function usage() {
@@ -6538,8 +6689,12 @@ async function handleCli(inputArgs, ctx = {}) {
   }
   const identityResult = await handleIdentityCli(command, args, ctx, home, store);
   if (identityResult) return identityResult;
+  const socialAction = args[0];
   const socialResult = await handleSocialCli(command, args, ctx, home, store);
-  if (socialResult) return maybeAppendHandleNudge(store, command, socialResult);
+  if (socialResult) {
+    if (command === "friend" && socialAction === "auto-accept") return socialResult;
+    return maybeAppendHandleNudge(store, command, socialResult);
+  }
   if (command === "serve") {
     const host = takeFlag(args, "--host") || "127.0.0.1";
     const port = Number(takeFlag(args, "--port") || "0");
@@ -6564,14 +6719,23 @@ async function handleCli(inputArgs, ctx = {}) {
     });
     await client.start();
     console.log(`Edge Book dial-out connected to ${hostUrl}${notifyCmd ? " (notify hook active)" : ""}`);
+    const disabled = takeBoolFlag(args, "--no-cron-install") || process.env.EDGE_BOOK_NO_CRON_INSTALL === "1";
     try {
-      const disabled = takeBoolFlag(args, "--no-cron-install") || process.env.EDGE_BOOK_NO_CRON_INSTALL === "1";
       const res = ensureNotifierCron({ runner: defaultHermesRunner(), home, disabled });
       if (res.status === "installed") console.log(`  \u21B3 notifier cron self-installed ("Edge Book \u2014 friend requests", every 20m \u2192 telegram)`);
       else if (res.status === "error") console.log(`  \u21B3 notifier cron install skipped: ${res.detail}`);
     } catch (e) {
       console.log(`  \u21B3 notifier cron install skipped: ${e instanceof Error ? e.message : String(e)}`);
     }
+    try {
+      if ((await store2.config()).greeter_mode === true) {
+        const res = ensureGreeterCron({ runner: defaultHermesRunner(), home, disabled });
+        if (res.status === "installed") console.log(`  \u21B3 greeter cron self-installed ("Edge Book \u2014 greeter", every 5m)`);
+        else if (res.status === "error") console.log(`  \u21B3 greeter cron install skipped: ${res.detail}`);
+      }
+    } catch (e) {
+      console.log(`  \u21B3 greeter cron install skipped: ${e instanceof Error ? e.message : String(e)}`);
+    }
     await new Promise(() => void 0);
   }
   if (command === "ensure-notifier") {
@@ -6586,6 +6750,14 @@ async function handleCli(inputArgs, ctx = {}) {
     };
     return { text: msg[res.status] ?? res.status, json: res };
   }
+  if (command === "greeter") {
+    const on = takeBoolFlag(args, "--on");
+    const off = takeBoolFlag(args, "--off");
+    if (on && off) throw new EdgeBookError("bad_flags", "greeter takes either --on or --off, not both");
+    if (!on && !off) throw new EdgeBookError("missing_arg", "greeter needs --on or --off");
+    const cfg = await store.updateConfig({ greeter_mode: on ? true : false });
+    return { text: `greeter_mode = ${cfg.greeter_mode}`, json: cfg };
+  }
   if (command === "pair") {
     const hostUrl = parseHost(args, ctx);
     const ttlMs = Number(takeFlag(args, "--ttl-ms") || `${5 * 60 * 1e3}`);

package/package.json

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