agent-relay-plugin 0.4.33 → 0.4.35

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.33"
+  "version": "0.4.35"
 }

package/hooks/poll-inbox.sh

@@ -25,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")
@@ -52,6 +53,28 @@ 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 send-keys -t "$AGENT_RELAY_CLAUDE_TMUX_SESSION" -l "$line" 2>/dev/null &&
+      tmux send-keys -t "$AGENT_RELAY_CLAUDE_TMUX_SESSION" C-m 2>/dev/null; then
+      return 0
+    fi
+    echo "warn: tmux delivery failed for ${AGENT_RELAY_CLAUDE_TMUX_SESSION}" >&2
+    return 1
+  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)
@@ -153,7 +176,8 @@ while true; do
 
   count=$(echo "$msgs" | jq 'length' 2>/dev/null || echo 0)
   if [ "$count" -gt 0 ] 2>/dev/null && [ "$count" != "0" ]; then
-    echo "$msgs" | jq -c '.[]' | while IFS= read -r msg; do
+    delivery_failed=false
+    while IFS= read -r msg; do
       mid=$(printf '%s' "$msg" | jq -r '.id')
       claimable=$(printf '%s' "$msg" | jq -r '.claimable // false')
       if [ "$(ar_message_matches_channels "$msg")" != "true" ]; then
@@ -170,13 +194,20 @@ 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
-    done
-    since_id=$(echo "$msgs" | jq '[.[].id] | max')
+      if ! line=$(printf '%s' "$msg" | jq -r '(.meta.pairId // "") 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') || [ -z "$line" ]; then
+        echo "warn: failed to format relay message ${mid}" >&2
+        delivery_failed=true
+        continue
+      fi
+      if deliver_message "$line"; then
+        mark_read_or_queue "$mid"
+      else
+        delivery_failed=true
+      fi
+    done < <(echo "$msgs" | jq -c '.[]')
+    if [ "$delivery_failed" = "false" ]; then
+      since_id=$(echo "$msgs" | jq '[.[].id] | max')
+    fi
   fi
 
   sleep "$INTERVAL"

package/hooks/relay-monitor.sh

@@ -140,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/set-status.sh

@@ -36,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.33",
+  "version": "0.4.35",
   "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",