Swift SDK: nodes (fleet node query) (TS participant SDK parity)

[willwashburn]

What the TS participant SDK provides

AgentRelay.nodes (packages/sdk/src/agent-relay.ts) exposes RelayMessaging['nodes'] (packages/sdk/src/messaging/types.ts, readonly nodes):

• list(options?): Promise<RelayNode[]> — query fleet nodes.
• get(name): Promise<RelayNode | null> — fetch a single node by name.

What the Swift AgentRelaySDK lacks

AgentClient has no node surface. There is no way to enumerate fleet nodes or look one up by name.

Proposed Swift API sketch

public struct RelayNode: Decodable, Sendable {}

extension AgentClient {
    public func nodes(/* filters */) async throws -> [RelayNode]
    public func node(_ name: String) async throws -> RelayNode?
}

Part of bringing the Swift AgentRelaySDK to parity with the TS participant SDK (follow-up to #1143 / #1147).

[willwashburn]

Closing as resolved-by-strategy: AgentRelaySDK (the relay-owned Swift facade this issue targeted) is being retired — it was always a thin wrapper over relaycast's official Swift SDK, and that SDK already implements nodes natively.

Relaycast's Relaycast product provides RelayNodesService (relay.nodes.create/list/get/listAgents/bindAgent/unbindAgent).

Swift consumers needing hosted-workspace participation should depend on relaycast's Relaycast product directly (https://github.com/AgentWorkforce/relaycast.git) going forward instead of AgentRelaySDK, which no longer ships from this repo.

---

Generated by Claude Code

[willwashburn]

Reopening: course reversal on PR #1259. Rather than retiring AgentRelaySDK and pointing consumers at relaycast's SDK directly, we're rebuilding it as a real sidecar matching @agent-relay/sdk's TS facade (relay-specific abstractions on top of relaycast, not just a rename-and-delegate wrapper) — same model the TS SDK already uses. This issue's ask will be implemented directly rather than closed by strategy.

---

Generated by Claude Code

[willwashburn]

Closing as resolved — shipped in the Swift SDK facade rebuild (#1259). RelayNodes provides list(options) and get(name) (plus bind/unbind), exposed as AgentClient.nodes (packages/sdk-swift/Sources/AgentRelaySDK/RelayFacades.swift). Verified against main (86af7c5).

---

Generated by Claude Code