refactor: remove ElevenLabs enum namespace and global configure

Promote LogLevel, AgentState, and version to module-level API, move Events under Conversation, and replace ElevenLabs.configure with ConversationClient(logLevel:).

Co-authored-by: Cursor <cursoragent@cursor.com>

Author: renal128

Documentation/Usage.md

@@ -716,9 +716,7 @@ The SDK uses `os.Logger` for high-performance logging. You can filter logs in Xc
 Adjust the verbosity of the SDK:
 
 ```swift
-ElevenLabs.configure(
-    ElevenLabs.Configuration(logLevel: .debug) // .trace for full event logs
-)
+let client = ConversationClient(logLevel: .debug) // .trace for full event logs
 ```
 
 ---

README.md

@@ -222,14 +222,12 @@ Task {
 
 ## Configuration & Tuning
 
-### Global Setup
+### Logging
 
-Configure logging and global behaviors at app launch:
+Set verbosity per client:
 
 ```swift
-ElevenLabs.configure(
-    ElevenLabs.Configuration(logLevel: .info)
-)
+let client = ConversationClient(logLevel: .info)
 ```
 
 ### Custom Endpoints

Scripts/generate-version.sh

@@ -12,17 +12,15 @@ VERSION=$(git describe --tags --abbrev=0 2>/dev/null || echo "0.0.0")
 VERSION=${VERSION#v}
 
 # Path to the Version.swift file
-VERSION_FILE="Sources/ElevenLabs/Internal/Version.swift"
+VERSION_FILE="Sources/ElevenLabs/Public/Version.swift"
 
 # Generate the Version.swift file
 cat > "$VERSION_FILE" << EOF
 // This file is auto-generated from git tags
 // Run Scripts/generate-version.sh to update
 import Foundation
 
-enum SDKVersion {
-    static let version = "$VERSION"
-}
+public let version = "$VERSION"
 EOF
 
 echo "Generated Version.swift with version: $VERSION"

Sources/ElevenLabs/Internal/Conversation/AgentStateManager.swift

@@ -15,8 +15,8 @@ private typealias TimerTask = Task<Void, Never>
 
 @MainActor
 final class AgentStateManager {
-    private(set) var currentState: ElevenLabs.AgentState = .listening
-    var onStateChange: ((ElevenLabs.AgentState) -> Void)?
+    private(set) var currentState: AgentState = .listening
+    var onStateChange: ((AgentState) -> Void)?
 
     private let configuration: AgentStateConfiguration
 
@@ -90,7 +90,7 @@ final class AgentStateManager {
         }
     }
 
-    private func transitionTo(_ newState: ElevenLabs.AgentState) {
+    private func transitionTo(_ newState: AgentState) {
         guard newState != currentState else { return }
         currentState = newState
         onStateChange?(newState)

Sources/ElevenLabs/Internal/Conversation/Conversation.swift

@@ -15,7 +15,7 @@ final class Conversation: ObservableObject {
 
     @Published var state: ConversationState = .idle
     @Published var messages: [Message] = []
-    @Published var agentState: ElevenLabs.AgentState = .listening
+    @Published var agentState: AgentState = .listening
 
     /// Stream of client tool calls that need to be executed by the app
     @Published var pendingToolCalls: [ClientToolCallEvent] = []
@@ -44,7 +44,7 @@ final class Conversation: ObservableObject {
     var agentStateManager: AgentStateManager?
 
     /// Forward a signal to the event-based state manager, or fall back to directly setting `agentState`.
-    func applyStateSignal(_ signal: AgentStateSignal, fallback: ElevenLabs.AgentState) {
+    func applyStateSignal(_ signal: AgentStateSignal, fallback: AgentState) {
         if let manager = agentStateManager {
             manager.processSignal(signal)
         } else {

Sources/ElevenLabs/Internal/DI/Dependencies.swift

@@ -14,9 +14,8 @@ final class Dependencies: ConversationDependencyProvider {
     let webRTCConnectionManager: any WebRTCConnectionManaging
     let webSocketConnectionManager: any WebSocketConnectionManaging
 
-    init(endpoints: Endpoints = .production) {
-        let globalConfig = ElevenLabs.Global.shared.configuration
-        let logger = SDKLogger(logLevel: globalConfig.logLevel)
+    init(logLevel: LogLevel = .warning, endpoints: Endpoints = .production) {
+        let logger = SDKLogger(logLevel: logLevel)
         self.logger = logger
         webRTCConnectionManager = WebRTCConnectionManager(
             logger: logger,

Sources/ElevenLabs/Internal/Utilities/EventSerializer.swift

@@ -120,7 +120,7 @@ enum EventSerializer {
         // Add source_info (equivalent to client in React Native)
         var sourceInfo: [String: Any] = [:]
         sourceInfo["source"] = "swift_sdk"
-        sourceInfo["version"] = SDKVersion.version
+        sourceInfo["version"] = version
         json["source_info"] = sourceInfo
 
         // Add user_id if provided

Sources/ElevenLabs/Internal/Utilities/SDKLogger.swift

@@ -37,12 +37,12 @@ extension Logging {
 struct SDKLogger: Logging {
     private let subsystem: String
     private let category: String
-    private let logLevel: ElevenLabs.LogLevel
+    private let logLevel: LogLevel
 
     init(
         subsystem: String = "com.elevenlabs.sdk",
         category: String = "ElevenLabs",
-        logLevel: ElevenLabs.LogLevel = .info
+        logLevel: LogLevel = .info
     ) {
         self.subsystem = subsystem
         self.category = category

Sources/ElevenLabs/Public/Authorization/TokenService.swift

@@ -88,7 +88,7 @@ public struct TokenService: Sendable {
         queryItems += [
             URLQueryItem(name: "agent_id", value: agentId),
             URLQueryItem(name: "source", value: "swift_sdk"),
-            URLQueryItem(name: "version", value: SDKVersion.version)
+            URLQueryItem(name: "version", value: version)
         ]
         if let environment {
             queryItems.append(URLQueryItem(name: "environment", value: environment))

…nversation/AgentStateConfiguration.swift …abs/Public/Conversation/AgentState.swiftSources/ElevenLabs/Public/Conversation/AgentStateConfiguration.swift renamed to Sources/ElevenLabs/Public/Conversation/AgentState.swift Sources/ElevenLabs/Public/Conversation/AgentStateConfiguration.swift renamed to Sources/ElevenLabs/Public/Conversation/AgentState.swift

@@ -1,5 +1,15 @@
 import Foundation
 
+/// Agent state indicating what the agent is currently doing.
+public enum AgentState: Sendable, Equatable {
+    /// Agent is listening to the user
+    case listening
+    /// Agent is speaking
+    case speaking
+    /// Agent is thinking (e.g. preparing a tool call)
+    case thinking
+}
+
 /// Configuration for event-based agent state management using VAD and client events.
 /// Pass `nil` to use the default LiveKit-based behaviour.
 public struct AgentStateConfiguration: Sendable {