diff --git a/src/claude_agent_sdk/client.py b/src/claude_agent_sdk/client.py
index 66b39896..25d4d353 100644
--- a/src/claude_agent_sdk/client.py
+++ b/src/claude_agent_sdk/client.py
@@ -324,8 +324,8 @@ async def set_permission_mode(self, mode: PermissionMode) -> None:
                 - 'acceptEdits': Auto-accept file edits
                 - 'plan': Plan-only mode (no tool execution)
                 - 'bypassPermissions': Allow all tools (use with caution)
-                - 'dontAsk': Allow all tools without prompting
-                - 'auto': Automatically determine permission mode
+                - 'dontAsk': Deny anything not pre-approved by allow rules
+                - 'auto': A model classifier approves or denies each tool call
 
         Example:
             ```python
diff --git a/src/claude_agent_sdk/query.py b/src/claude_agent_sdk/query.py
index 0efa7c6e..a91ed519 100644
--- a/src/claude_agent_sdk/query.py
+++ b/src/claude_agent_sdk/query.py
@@ -57,8 +57,8 @@ async def query(
                  - 'acceptEdits': Auto-accept file edits
                  - 'plan': Plan-only mode (no tool execution)
                  - 'bypassPermissions': Allow all tools (use with caution)
-                 - 'dontAsk': Allow all tools without prompting
-                 - 'auto': Automatically determine permission mode
+                 - 'dontAsk': Deny anything not pre-approved by allow rules
+                 - 'auto': A model classifier approves or denies each tool call
                  Set options.cwd for working directory.
         transport: Optional transport implementation. If provided, this will be used
                   instead of the default transport selection based on options.