From 039c7cac7a1336defa9c9aff7613d75b07926bd3 Mon Sep 17 00:00:00 2001 From: khaliqgant Date: Thu, 8 Oct 2026 09:21:04 -0700 Subject: [PATCH 1/2] desktop 1.1.10: the socket guard names an unset or stale relay_socket The fail-fast check fires both when relay_socket is unset and when it names a missing or stale socket; the message now says which path it saw (agentrelay.com#172 review). Co-Authored-By: Claude Opus 5.5 (1M context) Session-Id: 26d00c25-77c9-401f-b9f0-51ce6c9deda6 --- README.md | 2 +- prpm.json | 2 +- skills/setting-up-agent-relay-desktop/SKILL.md | 2 +- 3 files changed, 3 insertions(+), 3 deletions(-) diff --git a/README.md b/README.md index 44feffc2..95a3e3be 100644 --- a/README.md +++ b/README.md @@ -11,7 +11,7 @@ Package metadata lives in [prpm.json](prpm.json). The repo currently publishes ` | [choosing-swarm-patterns](skills/choosing-swarm-patterns/SKILL.md) | 1.1.5 | Pick the right Agent Relay orchestration pattern across the 10 core swarm patterns plus specialized patterns. | | [writing-agent-relay-workflows](skills/writing-agent-relay-workflows/SKILL.md) | 2.0.0 | **DEPRECATED** - the superseded v1 `@relayflows/core` WorkflowBuilder engine. Use [`writing-relayflows`](skills/writing-relayflows/SKILL.md) for v2; keep this only to maintain an existing v1 workflow. | | [setting-up-relayfile](skills/setting-up-relayfile/SKILL.md) | 1.1.2 | Set up Relayfile mounts and writeback for provider files through local filesystem access. | -| [setting-up-agent-relay-desktop](skills/setting-up-agent-relay-desktop/SKILL.md) | 1.1.9 | Install and configure Agent Relay Desktop end-to-end from a Codex or Claude session, including headless Linux, device login, registration, webhooks, integrations, and verification. | +| [setting-up-agent-relay-desktop](skills/setting-up-agent-relay-desktop/SKILL.md) | 1.1.10 | Install and configure Agent Relay Desktop end-to-end from a Codex or Claude session, including headless Linux, device login, registration, webhooks, integrations, and verification. | | [setting-up-agent-relay-sessions](skills/setting-up-agent-relay-sessions/SKILL.md) | 0.2.8 | Set a person up for live agent-to-agent session handoff end-to-end from a Codex or Claude session: reuse `setting-up-agent-relay-desktop` for the desktop leg, install the agent-sessions cloud MCP before the session starts, confirm the handoff tools loaded, and prove a live round trip with a teammate (or self-verify the roster + own-session read path when no teammate is online yet). | | [signing-in-to-agent-relay-cloud](skills/signing-in-to-agent-relay-cloud/SKILL.md) | 0.1.0 | Sign a person in to Agent Relay Cloud through the OAuth device flow from an agent session: device grant, polling, refresh, whoami, and the CLI credential handoff, with no token printed. | | [setting-up-agent-relay-flows](skills/setting-up-agent-relay-flows/SKILL.md) | 0.1.0 | Choose a catalog flow and repository, connect tools and coding-agent credentials, activate the listener through the direct-source deploy API, and verify it is listening. Builds on `signing-in-to-agent-relay-cloud`. | diff --git a/prpm.json b/prpm.json index 2f806774..5c0faf1d 100644 --- a/prpm.json +++ b/prpm.json @@ -95,7 +95,7 @@ }, { "name": "setting-up-agent-relay-desktop", - "version": "1.1.9", + "version": "1.1.10", "description": "Set up or repair Agent Relay Desktop end-to-end from a running Codex or Claude session on macOS or Linux, including verified installation, headless systemd service, device sign-in, new-session uploads, self-registration, direct delivery, webhooks, GitHub subscriptions, and delivery verification.", "format": "claude", "subtype": "skill", diff --git a/skills/setting-up-agent-relay-desktop/SKILL.md b/skills/setting-up-agent-relay-desktop/SKILL.md index 130f8301..aadc4bee 100644 --- a/skills/setting-up-agent-relay-desktop/SKILL.md +++ b/skills/setting-up-agent-relay-desktop/SKILL.md @@ -118,7 +118,7 @@ interval without it. If the socket exists, inspect it before installing anything: ```sh -test -S "${relay_socket:-/nonexistent}" || { printf 'relay_socket is not set: run the socket discovery block first.\n' >&2; exit 1; } +test -S "${relay_socket:-/nonexistent}" || { printf 'relay_socket is unset or not a live socket (%s): run the socket discovery block first; a stale path means the app is not running.\n' "${relay_socket:-unset}" >&2; exit 1; } curl -sS --max-time 60 --unix-socket "$relay_socket" http://relay/setup/status | jq ``` From fd7d2b12f1f5e6bd6b4f03ba59a91d0caee8e3e8 Mon Sep 17 00:00:00 2001 From: khaliqgant Date: Thu, 8 Oct 2026 10:50:17 -0700 Subject: [PATCH 2/2] desktop 1.1.10: the socket guard checks only for a socket file, and says so test -S passes for a stale socket file a crashed app leaves behind, so the guard no longer claims the socket is live; the curl after it is what proves the app answers. Co-Authored-By: Claude Opus 5.5 (1M context) Session-Id: 26d00c25-77c9-401f-b9f0-51ce6c9deda6 --- skills/setting-up-agent-relay-desktop/SKILL.md | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/skills/setting-up-agent-relay-desktop/SKILL.md b/skills/setting-up-agent-relay-desktop/SKILL.md index aadc4bee..514f0863 100644 --- a/skills/setting-up-agent-relay-desktop/SKILL.md +++ b/skills/setting-up-agent-relay-desktop/SKILL.md @@ -118,7 +118,9 @@ interval without it. If the socket exists, inspect it before installing anything: ```sh -test -S "${relay_socket:-/nonexistent}" || { printf 'relay_socket is unset or not a live socket (%s): run the socket discovery block first; a stale path means the app is not running.\n' "${relay_socket:-unset}" >&2; exit 1; } +# Checks only that a socket file exists; the curl below is what proves the +# app answers (a crashed app can leave a stale socket file behind). +test -S "${relay_socket:-/nonexistent}" || { printf 'relay_socket is unset or names no socket file (%s): run the socket discovery block first.\n' "${relay_socket:-unset}" >&2; exit 1; } curl -sS --max-time 60 --unix-socket "$relay_socket" http://relay/setup/status | jq ```