webhookagent 1.3.1 → 1.4.0

package/README.md

@@ -37,6 +37,21 @@ webhookagent --auto-restart --fetch --ack
 
 No open ports needed. Works behind any firewall. Events are queued so nothing is lost.
 
+## Chat Messages
+
+Chat endpoints let people message your agent through a shareable link (`webhookagent.com/agentchat/{name}?t={token}`). Chat messages arrive as `ACTION:` lines with `type: "chat_message"`:
+
+```
+ACTION:{"type":"chat_message","webhook_name":"support","sender_name":"Alex","message":"hey, is my order ready?","chat_reply_command":"curl -s -X POST ..."}
+```
+
+Key fields:
+- `sender_name` — who sent the message
+- `message` — what they said
+- `chat_reply_command` — run this with your reply text replacing `YOUR_REPLY`
+
+After replying, **RESTART the heartbeat immediately** (same as always). Create a chat endpoint by passing `"endpoint_type":"chat"` when creating a webhook.
+
 ## Options
 
 | Flag | Default | Description |

package/lib/heartbeat.js

@@ -238,7 +238,7 @@ async function api(path, method = 'GET', body = null) {
   const headers = {
     'Authorization': `Bearer ${API_KEY}`,
     'Content-Type': 'application/json',
-    'User-Agent': 'WebhookAgent-Heartbeat/1.2 (Node.js)',
+    'User-Agent': 'WebhookAgent-Heartbeat/1.4 (Node.js)',
   };
   const opts = { method, headers };
   if (body) opts.body = JSON.stringify(body);
@@ -290,8 +290,14 @@ async function processActions(actions, heartbeatData) {
         const ids = [];
         for (const item of queue.items) {
           ids.push(item.id);
+
+          // Detect chat messages
+          let bodyData = item.body_json || item.body;
+          if (typeof bodyData === 'string') { try { bodyData = JSON.parse(bodyData); } catch(e) {} }
+          const isChat = bodyData && bodyData.type === 'chat_message';
+
           const output = {
-            type: 'webhook_event',
+            type: isChat ? 'chat_message' : 'webhook_event',
             webhook_id: whId,
             webhook_name: whName,
             item_id: item.id,
@@ -303,6 +309,15 @@ async function processActions(actions, heartbeatData) {
             source_ip: item.source_ip,
             received_at: item.received_at,
           };
+
+          // Chat messages: include reply command so agents know how to respond
+          if (isChat) {
+            output.sender_name = bodyData.sender_name || 'Visitor';
+            output.message = bodyData.message || '';
+            output.chat_reply_hint = `This is a chat message from "${output.sender_name}". You MUST respond by running the reply command below. Replace YOUR_REPLY with your response text.`;
+            output.chat_reply_command = `curl -s -X POST "${BASE_URL}/webhooks/${whId}/chat/reply" -H "Authorization: Bearer ${API_KEY}" -H "Content-Type: application/json" -d '{"message":"YOUR_REPLY"}'`;
+          }
+
           // When --ack is not used, include acknowledge instructions with each item
           if (!AUTO_ACK) {
             output.needs_ack = true;
@@ -345,7 +360,7 @@ async function processActions(actions, heartbeatData) {
 // ============================================================
 
 async function main() {
-  log('WebhookAgent Heartbeat Runtime v1.3');
+  log('WebhookAgent Heartbeat Runtime v1.4');
   log(`Polling ${BASE_URL} every ${INTERVAL / 1000}s${MAX_CYCLES === Infinity ? '' : `, max ${MAX_CYCLES} cycles`}${AUTO_RESTART ? ' (continuous)' : ''}${SHOW_MODE ? ' (show mode — no break)' : ''}`);
 
   // Resolve webhook names to IDs if needed

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "webhookagent",
-  "version": "1.3.1",
+  "version": "1.4.0",
   "description": "WebhookAgent heartbeat runtime — poll, break, process webhook events at your agent's pace",
   "main": "lib/heartbeat.js",
   "bin": {