@agentvault/secure-channel 0.4.4 → 0.5.1

package/README.md

@@ -2,28 +2,21 @@
 
 End-to-end encrypted communication channel for AI agents on the [AgentVault](https://agentvault.chat) platform. Connect your agent to its owner with XChaCha20-Poly1305 encryption and Double Ratchet forward secrecy.
 
-## What's New in v0.4.0
+## What's New in v0.5.0
 
-**Webhook Notifications** — Your agent can now receive HTTP webhook callbacks when a new message arrives, even when it's not connected via WebSocket. This is ideal for serverless agents, agents that poll on a schedule, or any agent that isn't always online.
+**Desktop Notifications** — Incoming messages now trigger native OS notifications (macOS Notification Center, Windows Toast, Linux notify-send) when using the CLI. Enabled by default — disable with `--no-notifications`.
 
-### Upgrading from v0.3.x
+**Webhook URL CLI Flag** (v0.4.4) — `--webhook-url` flag and `AGENTVAULT_WEBHOOK_URL` env var for programmatic webhook registration.
 
-```bash
-npm install @agentvault/secure-channel@latest
-```
+**Webhook Notifications** (v0.4.0) — HTTP webhook callbacks when a new message arrives, even when not connected via WebSocket.
 
-Add `webhookUrl` to your config to enable:
+### Upgrading
 
-```js
-const channel = new SecureChannel({
-  inviteToken: "your-token",
-  dataDir: "./agentvault-data",
-  apiUrl: "https://api.agentvault.chat",
-  webhookUrl: "https://your-server.com/webhook/agentvault", // NEW in 0.4.0
-});
+```bash
+npm install @agentvault/secure-channel@latest
 ```
 
-No other code changes required — fully backward-compatible.
+No code changes required — fully backward-compatible.
 
 ---
 
@@ -58,8 +51,10 @@ The CLI will:
 | `--name` | `"CLI Agent"` | Agent display name |
 | `--data-dir` | `./agentvault-data` | Directory for persistent state |
 | `--api-url` | `https://api.agentvault.chat` | API endpoint |
+| `--webhook-url` | (none) | URL for HTTP webhook notifications |
+| `--no-notifications` | (notifications on) | Disable OS desktop notifications |
 
-Environment variables (`AGENTVAULT_INVITE_TOKEN`, `AGENTVAULT_AGENT_NAME`, `AGENTVAULT_DATA_DIR`, `AGENTVAULT_API_URL`) work as alternatives to flags.
+Environment variables (`AGENTVAULT_INVITE_TOKEN`, `AGENTVAULT_AGENT_NAME`, `AGENTVAULT_DATA_DIR`, `AGENTVAULT_API_URL`, `AGENTVAULT_WEBHOOK_URL`, `AGENTVAULT_NO_NOTIFICATIONS`) work as alternatives to flags.
 
 ### Option 2: SDK (Programmatic)
 
@@ -216,6 +211,32 @@ AgentVault supports multiple owner devices (e.g., desktop + mobile). The channel
 
 No additional configuration needed — multi-device is handled transparently.
 
+## Running as a Service
+
+The agent process must stay running to receive messages and desktop notifications. Use [pm2](https://pm2.keymetrics.io/) to keep it alive:
+
+```bash
+# Install pm2 globally
+npm install -g pm2
+
+# Start your agent as a background service
+pm2 start npx --name "my-agent" -- @agentvault/secure-channel \
+  --token=YOUR_TOKEN --name="My Agent"
+
+# View logs
+pm2 logs my-agent
+
+# Auto-restart on crash
+pm2 save
+
+# Stop the agent
+pm2 stop my-agent
+```
+
+pm2 keeps the process running if the terminal closes and auto-restarts on crashes. Desktop notifications continue to work as long as pm2 was started from your desktop session.
+
+For headless servers (no desktop), use `--no-notifications` and configure `--webhook-url` instead.
+
 ## Security
 
 - **XChaCha20-Poly1305** symmetric encryption (192-bit nonces)

package/dist/cli.js

@@ -45770,12 +45770,15 @@ var SecureChannel = class extends EventEmitter {
 // src/cli.ts
 import { resolve } from "node:path";
 import { createInterface } from "node:readline";
+import notifier from "node-notifier";
 var args = process.argv.slice(2);
 var flags = {};
 for (const arg of args) {
-  const match = arg.match(/^--(\w[\w-]*)=(.+)$/);
-  if (match) {
-    flags[match[1]] = match[2];
+  const kvMatch = arg.match(/^--(\w[\w-]*)=(.+)$/);
+  if (kvMatch) {
+    flags[kvMatch[1]] = kvMatch[2];
+  } else if (arg.startsWith("--")) {
+    flags[arg.slice(2)] = "true";
   }
 }
 var token = flags["token"] || process.env.AGENTVAULT_INVITE_TOKEN;
@@ -45783,6 +45786,7 @@ var name = flags["name"] || process.env.AGENTVAULT_AGENT_NAME || "CLI Agent";
 var dataDir = flags["data-dir"] || process.env.AGENTVAULT_DATA_DIR || "./agentvault-data";
 var apiUrl = flags["api-url"] || process.env.AGENTVAULT_API_URL || "https://api.agentvault.chat";
 var webhookUrl = flags["webhook-url"] || process.env.AGENTVAULT_WEBHOOK_URL;
+var noNotifications = flags["no-notifications"] === "true" || process.env.AGENTVAULT_NO_NOTIFICATIONS === "1";
 if (!token) {
   console.error(`
 AgentVault Secure Channel CLI
@@ -45796,13 +45800,15 @@ Options:
   --data-dir=PATH        Directory for persistent state (default: ./agentvault-data)
   --api-url=URL          API endpoint (default: https://api.agentvault.chat)
   --webhook-url=URL      URL for HTTP webhook notifications on new messages
+  --no-notifications     Disable OS desktop notifications (enabled by default)
 
 Environment variables:
-  AGENTVAULT_INVITE_TOKEN    Same as --token
-  AGENTVAULT_AGENT_NAME      Same as --name
-  AGENTVAULT_DATA_DIR        Same as --data-dir
-  AGENTVAULT_API_URL         Same as --api-url
-  AGENTVAULT_WEBHOOK_URL     Same as --webhook-url
+  AGENTVAULT_INVITE_TOKEN       Same as --token
+  AGENTVAULT_AGENT_NAME         Same as --name
+  AGENTVAULT_DATA_DIR           Same as --data-dir
+  AGENTVAULT_API_URL            Same as --api-url
+  AGENTVAULT_WEBHOOK_URL        Same as --webhook-url
+  AGENTVAULT_NO_NOTIFICATIONS   Set to "1" to disable desktop notifications
 
 Example:
   npx @agentvault/secure-channel --token=av_tok_abc123 --name="My Agent"
@@ -45831,6 +45837,14 @@ var channel = new SecureChannel({
     console.log(`
   [${time}] Owner: ${plaintext}`);
     process.stdout.write("\n> ");
+    if (!noNotifications) {
+      const body = plaintext.length > 100 ? plaintext.slice(0, 100) + "..." : plaintext;
+      notifier.notify({
+        title: "AgentVault \u2014 New Message",
+        message: body,
+        sound: true
+      });
+    }
   },
   onStateChange: (state) => {
     console.log(`
@@ -45856,6 +45870,7 @@ console.log(`
 \u2551  Agent: ${name.padEnd(37)}\u2551
 \u2551  API:   ${apiUrl.padEnd(37)}\u2551
 \u255A\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u255D
+  Keep this process running to receive messages${noNotifications ? "." : " and notifications."}
 `);
 await channel.start();
 var rl = createInterface({