agent-relay-plugin 0.4.32 → 0.4.34

package/.claude-plugin/plugin.json

@@ -1,5 +1,5 @@
 {
   "name": "agent-relay",
   "description": "Client connector for Agent Relay — auto-registers Claude Code sessions as agents and enables inter-agent messaging via a lightweight HTTP message bus",
-  "version": "0.4.32"
+  "version": "0.4.34"
 }

package/hooks/approval-gate.sh

@@ -2,6 +2,10 @@
 # Agent Relay plugin — approval gate for PreToolUse and PermissionDenied hooks.
 # Enforces AGENT_RELAY_APPROVAL/profile approval policy: open (default), guarded, read-only.
 
+if [ "${AGENT_RELAY_DISABLED:-}" = "1" ]; then
+  exit 0
+fi
+
 script_dir=$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)
 source "${script_dir}/profile-lib.sh"
 project=$(basename "${PWD:-unknown}")

package/hooks/poll-inbox.sh

@@ -3,6 +3,10 @@
 # Each new message prints one stdout line (consumed by Monitor as a notification).
 # Usage: poll-inbox.sh <relay-url> <agent-id> [interval-seconds]
 
+if [ "${AGENT_RELAY_DISABLED:-}" = "1" ]; then
+  exit 0
+fi
+
 RELAY_URL="$1"
 AGENT_ID="$2"
 INTERVAL="${3:-10}"
@@ -21,6 +25,7 @@ fi
 # PID file so session-start.sh can find and kill us on /clear or /compact.
 pid_file="/tmp/agent-relay-poll-${AGENT_ID}.pid"
 status_file="/tmp/agent-relay-status-${AGENT_ID}.state"
+delivered_file="/tmp/agent-relay-delivered-${AGENT_ID}.queue"
 project=$(basename "${PWD:-unknown}")
 if [ -n "$CLAUDE_RIG_NAME" ]; then rig="$CLAUDE_RIG_NAME"
 elif [ -n "$CLAUDE_CONFIG_DIR" ]; then rig=$(basename "$CLAUDE_CONFIG_DIR")
@@ -48,6 +53,27 @@ current_status() {
   esac
 }
 
+deliver_message() {
+  local line="$1"
+  if [ "${AGENT_RELAY_CLAUDE_DELIVERY:-monitor}" = "tmux" ] && [ -n "${AGENT_RELAY_CLAUDE_TMUX_SESSION:-}" ] && command -v tmux >/dev/null 2>&1; then
+    if tmux set-buffer "$line" 2>/dev/null &&
+      tmux paste-buffer -t "$AGENT_RELAY_CLAUDE_TMUX_SESSION" 2>/dev/null &&
+      tmux send-keys -t "$AGENT_RELAY_CLAUDE_TMUX_SESSION" C-m 2>/dev/null; then
+      return 0
+    fi
+  fi
+
+  printf '%s\n' "$line"
+}
+
+mark_read_or_queue() {
+  local mid="$1"
+  curl -s -X PATCH "${RELAY_URL}/api/messages/${mid}" "${auth_header_args[@]}" \
+    -H 'Content-Type: application/json' \
+    -d "{\"readBy\":\"${AGENT_ID}\"}" > /dev/null 2>&1 ||
+    printf '%s\n' "$mid" >> "$delivered_file"
+}
+
 re_register() {
   local machine rig project reg_code
   machine=$(hostname)
@@ -88,6 +114,11 @@ marked_ready=false
 # Save parent PID (Claude Code wrapper) — if it dies, we're orphaned.
 _parent_pid="$PPID"
 while true; do
+  if [ "${AGENT_RELAY_DISABLED:-}" = "1" ]; then
+    set_status "offline"
+    exit 0
+  fi
+
   # Exit if parent process is gone — prevents orphaned monitors from heartbeating forever.
   if ! kill -0 "$_parent_pid" 2>/dev/null; then
     set_status "offline"
@@ -161,11 +192,9 @@ while true; do
         fi
       fi
 
-      printf '%s' "$msg" | jq -r '(.meta.pairId // empty) as $pair | (if $pair != "" then " [pair:\($pair)]" else "" end) as $pairText | if .type == "system" then "⚠ SYSTEM [msg:\(.id)]\($pairText): \(.body)" else "[msg:\(.id)]\($pairText) \(.from) → \(.to) | \(.subject // "(no subject)"): \(.body)" end'
-
-      curl -s -X PATCH "${RELAY_URL}/api/messages/${mid}" "${auth_header_args[@]}" \
-        -H 'Content-Type: application/json' \
-        -d "{\"readBy\":\"${AGENT_ID}\"}" > /dev/null 2>&1 || true
+      line=$(printf '%s' "$msg" | jq -r '(.meta.pairId // empty) as $pair | (if $pair != "" then " [pair:\($pair)]" else "" end) as $pairText | (.body | gsub("\r"; "\\r") | gsub("\n"; "\\n")) as $body | if .type == "system" then "⚠ SYSTEM [msg:\(.id)]\($pairText): \($body)" else "[msg:\(.id)]\($pairText) \(.from) → \(.to) | \(.subject // "(no subject)"): \($body)" end')
+      deliver_message "$line"
+      mark_read_or_queue "$mid"
     done
     since_id=$(echo "$msgs" | jq '[.[].id] | max')
   fi

package/hooks/relay-monitor.sh

@@ -4,6 +4,10 @@
 # Runs automatically via monitors.json — no user interaction required.
 # CLAUDE_CODE_SESSION_ID = stable session key for state file coordination between monitor and hooks.
 
+if [ "${AGENT_RELAY_DISABLED:-}" = "1" ]; then
+  exit 0
+fi
+
 RELAY_URL="${AGENT_RELAY_URL:-http://localhost:4850}"
 script_dir=$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)
 source "${script_dir}/profile-lib.sh"
@@ -136,6 +140,7 @@ To check messages:
 
 To mark read:
   curl -s -X PATCH ${RELAY_URL}/api/messages/ID${auth_header_example} -H 'Content-Type: application/json' -d '{"readBy":"${agent_id}"}'
+  The inbox monitor marks read after it successfully delivers a message to Claude. The Stop hook retries any failed read acknowledgements.
 
 To find agents by capability:
   curl -s${auth_header_example} '${RELAY_URL}/api/agents/find?capability=review'

package/hooks/session-end.sh

@@ -2,6 +2,10 @@
 # Agent Relay plugin — SessionEnd hook
 # Marks this session's agent as offline using state file written by relay-monitor.
 
+if [ "${AGENT_RELAY_DISABLED:-}" = "1" ]; then
+  exit 0
+fi
+
 RELAY_URL="${AGENT_RELAY_URL:-http://localhost:4850}"
 auth_header_args=()
 if [ -n "${AGENT_RELAY_TOKEN:-}" ]; then

package/hooks/set-status.sh

@@ -2,6 +2,10 @@
 # Agent Relay plugin — status update helper for Claude turn hooks.
 # Usage: set-status.sh <online|idle|busy|offline>
 
+if [ "${AGENT_RELAY_DISABLED:-}" = "1" ]; then
+  exit 0
+fi
+
 status="${1:-}"
 case "$status" in
   online|idle|busy|offline) ;;
@@ -32,4 +36,23 @@ curl -s -o /dev/null -X PATCH "${RELAY_URL}/api/agents/${agent_id}/status" "${au
   -d "{\"status\":\"${status}\"}" \
   2>/dev/null || true
 
+if [ "$status" = "idle" ]; then
+  delivered_file="/tmp/agent-relay-delivered-${agent_id}.queue"
+  if [ -s "$delivered_file" ]; then
+    processing_file="${delivered_file}.$$"
+    if mv "$delivered_file" "$processing_file" 2>/dev/null; then
+      sort -n -u "$processing_file" | while IFS= read -r mid; do
+        case "$mid" in
+          ''|*[!0-9]*) continue ;;
+        esac
+        curl -s -o /dev/null -X PATCH "${RELAY_URL}/api/messages/${mid}" "${auth_header_args[@]}" \
+          -H 'Content-Type: application/json' \
+          -d "{\"readBy\":\"${agent_id}\"}" \
+          2>/dev/null || printf '%s\n' "$mid" >> "$delivered_file"
+      done
+      rm -f "$processing_file"
+    fi
+  fi
+fi
+
 exit 0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agent-relay-plugin",
-  "version": "0.4.32",
+  "version": "0.4.34",
   "description": "Claude Code plugin for Agent Relay — auto-registers sessions as agents and enables inter-agent messaging",
   "type": "module",
   "license": "AGPL-3.0-or-later",