From 75c5c63a48dbfae672fe0f6329250107418de62f Mon Sep 17 00:00:00 2001 From: Sarah Deaton Date: Wed, 22 Apr 2026 08:05:31 -0700 Subject: [PATCH] docs: fix dontAsk and auto permission_mode descriptions MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit The dontAsk description was inverted — it said 'Allow all tools without prompting', which is what bypassPermissions does. dontAsk actually denies any tool call that isn't pre-approved by allow rules. Also clarified that auto mode uses a model classifier to approve or deny each tool call, rather than the vague 'automatically determine'. --- src/claude_agent_sdk/client.py | 4 ++-- src/claude_agent_sdk/query.py | 4 ++-- 2 files changed, 4 insertions(+), 4 deletions(-) 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.