Swift SDK: rich channels facade (list/create/delete) (TS participant SDK parity)

[willwashburn]

What the TS participant SDK provides

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

• list / get / create / update / archive
• join / leave / invite
• members
• mute / unmute

What the Swift AgentRelaySDK lacks

The Swift client only resolves a channel handle and subscribes/posts (channel(_), RelayChannel.subscribe() / .post(_), plus post(to:message:) in AgentRelayClient.swift). It cannot list, create, update, archive, join/leave, invite, list members, or mute/unmute channels.

Proposed Swift API sketch

public struct RelayChannelInfo: Decodable, Sendable {}
public struct RelayChannelMember: Decodable, Sendable {}

extension AgentClient {
    public func channels(/* filters */) async throws -> [RelayChannelInfo]
    public func channelInfo(_ name: String) async throws -> RelayChannelInfo
    public func createChannel(_ input: RelayCreateChannelInput) async throws -> RelayChannelInfo
    public func archiveChannel(_ name: String) async throws
    public func joinChannel(_ name: String) async throws
    public func leaveChannel(_ name: String) async throws
    public func invite(_ agent: String, to channel: String) async throws
    public func members(of channel: String) async throws -> [RelayChannelMember]
    // update / mute / unmute ...
}

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 a rich channels facade natively.

Relaycast's Relaycast product provides AgentChannelsService / RelayChannelsService (agent.channels.create/list/get/join/leave/setTopic/archive/invite/members/update/mute/unmute).

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). RelayChannels implements every operation listed here: list/get/create/update/archive/join/leave/invite/members/mute/unmute, exposed as AgentClient.channels (packages/sdk-swift/Sources/AgentRelaySDK/RelayFacades.swift). Verified against main (86af7c5).

---

Generated by Claude Code