Docs: Handle Throwing Expression in SpeziLLMOpenAI.md's LLMOpenAIDemo Example

README.md

@@ -127,8 +127,12 @@ struct LLMLocalDemoView: View {
                     )
                 )
 
-                for try await token in try await llmSession.generate() {
-                    responseText.append(token)
+                do {
+                    for try await token in try await llmSession.generate() {
+                        responseText.append(token)
+                    }
+                } catch {
+                    // Handle errors here. E.g., you can use `ViewState` and `viewStateAlert` from SpeziViews.
                 }
             }
     }
@@ -150,6 +154,10 @@ In order to use OpenAI LLMs within the Spezi ecosystem, the [SpeziLLM](https://s
 See the [SpeziLLM documentation](https://swiftpackageindex.com/stanfordspezi/spezillm/documentation/spezillm) for more details.
 
 ```swift
+import Spezi
+import SpeziLLM
+import SpeziLLMOpenAI
+
 class LLMOpenAIAppDelegate: SpeziAppDelegate {
     override var configuration: Configuration {
         Configuration {
@@ -171,6 +179,10 @@ The code example below showcases the interaction with an OpenAI LLM through the
 The `LLMOpenAISchema` defines the type and configurations of the to-be-executed `LLMOpenAISession`. This transformation is done via the [`LLMRunner`](https://swiftpackageindex.com/stanfordspezi/spezillm/documentation/spezillm/llmrunner) that uses the `LLMOpenAIPlatform`. The inference via `LLMOpenAISession/generate()` returns an `AsyncThrowingStream` that yields all generated `String` pieces.
 
 ```swift
+import SpeziLLM
+import SpeziLLMOpenAI
+import SwiftUI
+
 struct LLMOpenAIDemoView: View {
     @Environment(LLMRunner.self) var runner
     @State var responseText = ""
@@ -189,8 +201,12 @@ struct LLMOpenAIDemoView: View {
                     )
                 )
 
-                for try await token in try await llmSession.generate() {
-                    responseText.append(token)
+                do {
+                    for try await token in try await llmSession.generate() {
+                        responseText.append(token)
+                    }
+                } catch {
+                    // Handle errors here. E.g., you can use `ViewState` and `viewStateAlert` from SpeziViews.
                 }
             }
     }
@@ -263,8 +279,12 @@ struct LLMFogDemoView: View {
                     )
                 )
 
-                for try await token in try await llmSession.generate() {
-                    responseText.append(token)
+                do {
+                    for try await token in try await llmSession.generate() {
+                        responseText.append(token)
+                    }
+                } catch {
+                    // Handle errors here. E.g., you can use `ViewState` and `viewStateAlert` from SpeziViews.
                 }
             }
     }

Sources/SpeziLLMFog/LLMFogSession.swift

@@ -50,8 +50,12 @@ import SpeziLLM
 ///                     )
 ///                 )
 ///
-///                 for try await token in try await llmSession.generate() {
-///                     responseText.append(token)
+///                 do {
+///                     for try await token in try await llmSession.generate() {
+///                         responseText.append(token)
+///                     }
+///                 } catch {
+///                     // Handle errors here. E.g., you can use `ViewState` and `viewStateAlert` from SpeziViews.
 ///                 }
 ///             }
 ///     }

Sources/SpeziLLMFog/SpeziLLMFog.docc/SpeziLLMFog.md

@@ -100,8 +100,12 @@ struct LLMFogDemoView: View {
                     )
                 )
 
-                for try await token in try await llmSession.generate() {
-                    responseText.append(token)
+                do {
+                    for try await token in try await llmSession.generate() {
+                        responseText.append(token)
+                    }
+                } catch {
+                    // Handle errors here. E.g., you can use `ViewState` and `viewStateAlert` from SpeziViews.
                 }
             }
     }

Sources/SpeziLLMLocal/LLMLocalSession.swift

@@ -46,8 +46,12 @@ import SpeziLLM
 ///                     )
 ///                 )
 ///
-///                 for try await token in try await llmSession.generate() {
-///                     responseText.append(token)
+///                 do {
+///                     for try await token in try await llmSession.generate() {
+///                         responseText.append(token)
+///                     }
+///                 } catch {
+///                     // Handle errors here. E.g., you can use `ViewState` and `viewStateAlert` from SpeziViews.
 ///                 }
 ///             }
 ///     }

Sources/SpeziLLMLocal/SpeziLLMLocal.docc/SpeziLLMLocal.md

@@ -111,8 +111,12 @@ struct LLMLocalDemoView: View {
                     )
                 )
 
-                for try await token in try await llmSession.generate() {
-                    responseText.append(token)
+                do {
+                    for try await token in try await llmSession.generate() {
+                        responseText.append(token)
+                    }
+                } catch {
+                    // Handle errors here. E.g., you can use `ViewState` and `viewStateAlert` from SpeziViews.
                 }
             }
     }

Sources/SpeziLLMOpenAI/LLMOpenAISession.swift

@@ -33,6 +33,10 @@ import SpeziSecureStorage
 /// The example below demonstrates a minimal usage of the ``LLMOpenAISession`` via the `LLMRunner`.
 ///
 /// ```swift
+/// import SpeziLLM
+/// import SpeziLLMOpenAI
+/// import SwiftUI
+///
 /// struct LLMOpenAIDemoView: View {
 ///     @Environment(LLMRunner.self) var runner
 ///     @State var responseText = ""
@@ -51,8 +55,12 @@ import SpeziSecureStorage
 ///                     )
 ///                 )
 ///
-///                 for try await token in try await llmSession.generate() {
-///                     responseText.append(token)
+///                 do {
+///                     for try await token in try await llmSession.generate() {
+///                         responseText.append(token)
+///                     }
+///                 } catch {
+///                     // Handle errors here. E.g., you can use `ViewState` and `viewStateAlert` from SpeziViews.
 ///                 }
 ///             }
 ///     }

Sources/SpeziLLMOpenAI/SpeziLLMOpenAI.docc/SpeziLLMOpenAI.md

@@ -65,6 +65,10 @@ In order to use OpenAI LLMs, the [SpeziLLM](https://swiftpackageindex.com/stanfo
 See the [SpeziLLM documentation](https://swiftpackageindex.com/stanfordspezi/spezillm/documentation/spezillm) for more details.
 
 ```swift
+import Spezi
+import SpeziLLM
+import SpeziLLMOpenAI
+
 class LLMOpenAIAppDelegate: SpeziAppDelegate {
     override var configuration: Configuration {
          Configuration {
@@ -86,6 +90,10 @@ The ``LLMOpenAISession`` contains the ``LLMOpenAISession/context`` property whic
 Ensure the property always contains all necessary information, as the ``LLMOpenAISession/generate()`` function executes the inference based on the ``LLMOpenAISession/context``
 
 ```swift
+import SpeziLLM
+import SpeziLLMOpenAI
+import SwiftUI
+
 struct LLMOpenAIDemoView: View {
     @Environment(LLMRunner.self) var runner
     @State var responseText = ""
@@ -104,8 +112,12 @@ struct LLMOpenAIDemoView: View {
                     )
                 )
 
-                for try await token in try await llmSession.generate() {
-                    responseText.append(token)
+                do {
+                    for try await token in try await llmSession.generate() {
+                        responseText.append(token)
+                    }
+                } catch {
+                    // Handle errors here. E.g., you can use `ViewState` and `viewStateAlert` from SpeziViews.
                 }
             }
     }
@@ -125,10 +137,12 @@ The ``LLMOpenAIAPITokenOnboardingStep`` provides a view that can be used for the
 First, create a new view to show the onboarding step:
 
 ```swift
+import SpeziLLMOpenAI
 import SpeziOnboarding
+import SwiftUI
 
 struct OpenAIAPIKey: View {
-    @EnvironmentObject private var onboardingNavigationPath: OnboardingNavigationPath
+    @Environment(OnboardingNavigationPath.self) private var onboardingNavigationPath: OnboardingNavigationPath
 
     var body: some View {
         LLMOpenAIAPITokenOnboardingStep {
@@ -142,6 +156,7 @@ This view can then be added to the `OnboardingFlow` within the Spezi Template Ap
 
 ```swift
 import SpeziOnboarding
+import SwiftUI
 
 struct OnboardingFlow: View {
     @AppStorage(StorageKeys.onboardingFlowComplete) var completedOnboardingFlow = false