Swift SDK: integrations + webhooks (TS participant SDK parity)

[willwashburn]

What the TS participant SDK provides

AgentRelay.integrations and AgentRelay.webhooks (packages/sdk/src/agent-relay.ts) expose RelayMessaging['integrations'] and RelayMessaging['webhooks'] (packages/sdk/src/messaging/types.ts, readonly integrations / readonly webhooks):

• integrations.webhooks: create / list / delete / trigger (outbound webhooks).
• integrations.subscriptions: create / list / get / delete (event subscriptions).
• webhooks: createInbound / subscribe / list / delete / subscriptions / unsubscribe (inbound webhooks + subscriptions).

What the Swift AgentRelaySDK lacks

AgentClient has no integrations or webhook surface at all — no event subscriptions, no inbound/outbound webhook management.

Proposed Swift API sketch

extension AgentClient {
    public var integrations: RelayIntegrations { get }   // webhooks + subscriptions
    public var webhooks: RelayWebhooks { get }            // inbound webhooks + subscribe/unsubscribe
}

public struct RelayIntegrations {
    public func createWebhook(_ input: RelayCreateWebhookInput) async throws -> RelayWebhook
    public func listWebhooks() async throws -> [RelayWebhook]
    public func deleteWebhook(_ id: String) async throws
    public func triggerWebhook(_ id: String, payload: JSONValue?) async throws -> JSONValue
    public func createSubscription(_ input: RelayCreateSubscriptionInput) async throws -> RelayEventSubscription
    public func listSubscriptions() async throws -> [RelayEventSubscription]
    // get / delete ...
}

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 integrations and webhooks natively.

Relaycast's Relaycast product provides RelayWebhooksService (relay.webhooks.create/createInbound/list/delete/trigger) and RelaySubscriptionsService (relay.subscriptions.create/list/get/delete).

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]

Implemented in the shipped AgentRelaySDK (v10.2.0). AgentClient.integrations exposes RelayIntegrations with webhooks (create/list/delete) and subscriptions (create/list/get/delete) — see packages/sdk-swift/Sources/AgentRelaySDK/RelayFacades.swift (tagged #1153). Closing as completed.

---

Generated by Claude Code