agent-relay-plugin 0.4.39 → 0.6.1

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.39"
+  "version": "0.6.1"
 }

package/hooks/poll-inbox.sh

@@ -26,6 +26,7 @@ fi
 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"
+cursor_file="/tmp/agent-relay-cursor-${AGENT_ID}.state"
 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")
@@ -44,6 +45,19 @@ fetch_cursor() {
   esac
 }
 
+read_saved_cursor() {
+  local cursor
+  cursor=$(head -1 "$cursor_file" 2>/dev/null || true)
+  case "$cursor" in
+    ''|*[!0-9]*) return 1 ;;
+    *) printf '%s\n' "$cursor" ;;
+  esac
+}
+
+save_cursor() {
+  printf '%s\n' "$1" > "$cursor_file"
+}
+
 current_status() {
   local status
   status=$(head -1 "$status_file" 2>/dev/null || true)
@@ -107,8 +121,10 @@ set_status() {
     -H 'Content-Type: application/json' -d "{\"status\":\"$1\"}" 2>/dev/null
 }
 
-# Bootstrap cursor at current max so we only see messages arriving after session start.
-since_id=$(fetch_cursor || echo 0)
+# First start bootstraps at current max; restarted monitors resume their saved
+# cursor so messages that arrived during downtime are still delivered.
+since_id=$(read_saved_cursor || fetch_cursor || echo 0)
+save_cursor "$since_id"
 
 fail_streak=0
 marked_ready=false
@@ -132,12 +148,8 @@ while true; do
   # Agent was pruned — re-register instead of exiting.
   if [ "$hb_code" = "404" ]; then
     if re_register; then
-      if since_id=$(fetch_cursor); then
-        marked_ready=false
-        hb_code="200"
-      else
-        hb_code="000"
-      fi
+      marked_ready=false
+      hb_code="200"
     else
       hb_code="000"
     fi
@@ -194,7 +206,7 @@ while true; do
         fi
       fi
 
-      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
+      if ! line=$(printf '%s' "$msg" | jq -r '(.payload.pairId // "") as $pair | (if $pair != "" then " [pair:\($pair)]" else "" end) as $pairText | (.body | gsub("\r"; "\\r") | gsub("\n"; "\\n")) as $body | if .kind == "system" or .kind == "control" 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
@@ -207,6 +219,7 @@ while true; do
     done < <(echo "$msgs" | jq -c '.[]')
     if [ "$delivery_failed" = "false" ]; then
       since_id=$(echo "$msgs" | jq '[.[].id] | max')
+      save_cursor "$since_id"
     fi
   fi
 

package/hooks/relay-monitor.sh

@@ -38,6 +38,7 @@ fi
 ar_init_profile "claude" "$rig" "$project"
 
 session_key="${CLAUDE_CODE_SESSION_ID:-$PPID}"
+safe_session_key=$(printf '%s' "$session_key" | sed 's/[^A-Za-z0-9_.:-]/_/g')
 if command -v shasum >/dev/null 2>&1; then
   short_pid=$(printf '%s' "$session_key" | shasum -a 1 | head -c 6)
 elif command -v sha1sum >/dev/null 2>&1; then
@@ -66,6 +67,25 @@ if [ -f "$instance_state" ]; then
 fi
 printf '%s\n' "$agent_id" > "$instance_state"
 
+context_dir="${HOME:-/tmp}/.agent-relay/contexts"
+context_path="${context_dir}/${safe_session_key}.json"
+mkdir -p "$context_dir" 2>/dev/null || true
+jq -n \
+  --arg agentId "$agent_id" \
+  --arg relayUrl "$RELAY_URL" \
+  --arg cwd "${PWD:-}" \
+  --arg session "$session_key" \
+  --arg updatedAt "$(date -u +%Y-%m-%dT%H:%M:%SZ)" \
+  '{
+    version: 1,
+    agentId: $agentId,
+    provider: "claude",
+    relayUrl: $relayUrl,
+    cwd: $cwd,
+    matchEnv: [{name: "CLAUDE_CODE_SESSION_ID", value: $session}],
+    updatedAt: $updatedAt
+  }' > "$context_path" 2>/dev/null || true
+
 reg_code=$(curl -s -o /dev/null -w '%{http_code}' -X POST "${RELAY_URL}/api/agents" "${auth_header_args[@]}" \
   -H 'Content-Type: application/json' \
   -d "$(jq -n \
@@ -88,7 +108,7 @@ fi
 server_version=$(curl -s "${auth_header_args[@]}" "${RELAY_URL}/api/stats" 2>/dev/null | jq -r '.version // empty' 2>/dev/null)
 version_warning=""
 if [ -z "$server_version" ]; then
-  version_warning="⚠ Server does not report its version — consider updating: bunx agent-relay-server@latest"
+  version_warning="⚠ Server does not report its version — consider updating: agent-relay upgrade"
 elif [ "$PLUGIN_VERSION" = "unknown" ]; then
   version_warning="⚠ Version mismatch — server ${server_version}, plugin unknown. Restart Claude Code or update the Agent Relay plugin."
 elif [ "$server_version" != "$PLUGIN_VERSION" ]; then
@@ -128,7 +148,7 @@ To reply to a message (threading):
   Anti-loop rule: do not auto-reply to pure acknowledgements, "thanks", or "received" messages; acknowledge once, then only send follow-ups when there is new work, a decision, or a deliverable.
 
 To send a claimable task (only one agent can claim it):
-  curl -s -X POST ${RELAY_URL}/api/messages${auth_header_example} -H 'Content-Type: application/json' -d '{"from":"${agent_id}","to":"cap:review","body":"TASK","claimable":true}'
+  curl -s -X POST ${RELAY_URL}/api/messages${auth_header_example} -H 'Content-Type: application/json' -d '{"from":"${agent_id}","to":"cap:review","kind":"task","body":"TASK","claimable":true,"payload":{"title":"TASK"}}'
 
 To claim a task:
   curl -s -X POST ${RELAY_URL}/api/messages/MSG_ID/claim${auth_header_example} -H 'Content-Type: application/json' -d '{"agentId":"${agent_id}"}'

package/hooks/session-end.sh

@@ -20,6 +20,8 @@ if [ -z "$session_key" ]; then
   exit 0
 fi
 instance_state="/tmp/agent-relay-instance-${session_key}.state"
+safe_session_key=$(printf '%s' "$session_key" | sed 's/[^A-Za-z0-9_.:-]/_/g')
+context_path="${HOME:-/tmp}/.agent-relay/contexts/${safe_session_key}.json"
 
 if [ -f "$instance_state" ]; then
   agent_id=$(head -1 "$instance_state" 2>/dev/null)
@@ -40,6 +42,7 @@ if [ -n "${agent_id:-}" ]; then
     -d '{"status":"offline"}' \
     > /dev/null 2>&1 &
   [ -n "$instance_state" ] && [ -f "$instance_state" ] && rm -f "$instance_state"
+  [ -f "$context_path" ] && rm -f "$context_path"
 fi
 
 exit 0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agent-relay-plugin",
-  "version": "0.4.39",
+  "version": "0.6.1",
   "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",