update(docs): clarify public option documentation

Author: Tom-Ryder

Sources/AgentRunKit/Core/AgentLoop/ToolApproval.swift

@@ -74,9 +74,7 @@ extension ToolApprovalDecision: Codable {
     }
 }
 
-/// Asynchronously resolves a tool approval request.
-///
-/// Callers remain responsible for approval timeout policy, while task cancellation aborts waiting immediately.
+/// Asynchronously resolves a tool approval request; no timeout is enforced, cancel the awaiting task to abort.
 public typealias ToolApprovalHandler = @Sendable (ToolApprovalRequest) async -> ToolApprovalDecision
 
 private actor ApprovalDecisionWaiter {

Sources/AgentRunKit/Core/Streaming/StreamEventJSONCodec.swift

@@ -2,7 +2,7 @@ import Foundation
 
 /// Stable JSON encoding for persisting and replaying streamed events.
 public enum StreamEventJSONCodec {
-    /// Returns a `JSONEncoder` configured for the stable event wire format.
+    /// Returns an encoder configured for the stable stream event wire format.
     public static func makeEncoder() -> JSONEncoder {
         let encoder = JSONEncoder()
         encoder.outputFormatting = [.sortedKeys]
@@ -11,7 +11,7 @@ public enum StreamEventJSONCodec {
         return encoder
     }
 
-    /// Returns a `JSONDecoder` configured for the stable event wire format.
+    /// Returns a decoder configured for the stable stream event wire format.
     public static func makeDecoder() -> JSONDecoder {
         let decoder = JSONDecoder()
         decoder.keyDecodingStrategy = .useDefaultKeys

Sources/AgentRunKit/LLM/Providers/Anthropic/AnthropicReasoningOptions.swift

@@ -2,7 +2,7 @@ import Foundation
 
 /// Provider-specific request options for Anthropic reasoning behavior.
 public struct AnthropicReasoningOptions: Sendable, Equatable {
-    /// The Anthropic wire-level strategy used to lower shared reasoning intent.
+    /// Whether reasoning uses Anthropic's manual `thinking` block or the adaptive thinking flow.
     public enum Mode: Sendable, Equatable {
         case manual
         case adaptive