Swift SDK: inbox management (TS participant SDK parity)

[willwashburn]

What the TS participant SDK provides

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

• get(options?): Promise<RelayInbox> — inbox summary (channels, DMs, reactions, unread counts).
• list(input?): Promise<InboxListResult> — list inbox items.
• subscribe(input?): AsyncIterable<InboxItem> — stream inbox items.
• ack / fail / defer / markRead — per-item delivery disposition, each returning RelayDeliveryResult.

What the Swift AgentRelaySDK lacks

AgentClient has no inbox surface. There is no inbox summary, no item listing, no inbox-scoped subscription, and no ack/fail/defer/markRead controls. (Note: this overlaps conceptually with delivery tracking, but the inbox APIs are item-oriented and have their own listing/subscription model — see the separate deliveries issue.)

Proposed Swift API sketch

public struct RelayInbox: Decodable, Sendable { /* summary */ }
public struct InboxItem: Decodable, Sendable {}

extension AgentClient {
    public func inbox(limit: Int? = nil) async throws -> RelayInbox
    public func inboxItems(/* filters */) async throws -> [InboxItem]
    public func inboxStream(/* filters */) -> AsyncStream<InboxItem>
    public func ack(inboxItem id: String) async throws
    public func fail(inboxItem id: String, reason: String?) async throws
    public func defer(inboxItem id: String, until: Date?) async throws
    public func markRead(inboxItem id: String) async throws
}

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 the inbox natively.

Relaycast's Relaycast product provides AgentClient.inbox(options:), .markRead(messageID:), .readers(messageID:), and .readStatus(channel:).

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). RelayInboxService provides get/list/markRead/ack/fail/defer, exposed as AgentClient.inbox (packages/sdk-swift/Sources/AgentRelaySDK/RelayFacades.swift). Item streaming is covered by the existing events/inboundMessages streams rather than a dedicated inboxStream. Verified against main (86af7c5).

---

Generated by Claude Code