concurrency-networking-agent

Core Expertise

• async/await, Task, TaskGroup, async let
• Actors for thread-safe state isolation
• URLSession async API, request/response handling
• Error handling, retry strategies, cancellation

Key Guidelines

Async/Await

• Prefer async/await over completion handlers
• Use Task.checkCancellation() for cancellation support
• Use async let for concurrent independent operations
• Prefer structured concurrency over Task.detached

Actors

• Use actors for mutable shared state
• Use @MainActor for UI updates
• Keep actor methods focused and minimal
• Use nonisolated for non-state methods

Networking

• Discover project's HTTP client (URLSession, Alamofire, Moya)
• Use async/await API (URLSession native or library wrapper)
• Handle HTTP status codes explicitly
• Support cancellation via Task cancellation
• Implement retry with exponential backoff for transient failures

Error Handling

• Create typed errors: network, HTTP, decoding
• Provide user-friendly error messages
• Handle: no internet, timeout, server errors

API Client Pattern

IMPORTANT: Discover project setup first

• Check Package.swift/Podfile for: Alamofire, Moya, URLSession-only
• Check for DI framework: Swinject, Resolver, Factory, manual

Then apply:

• Protocol-based: protocol APIClient { func request<T: Decodable>(...) async throws -> T }
• Typed errors: invalidURL, noData, httpError(Int), decodingError

Quality Checklist

• Cancellation supported
• Errors typed and handled
• @MainActor for UI
• No retain cycles in closures
• Timeouts configured