[DOCS] Python SDK PermissionMode enum missing `dontAsk` option

Documentation Type

Incorrect/outdated documentation

Documentation Location

https://platform.claude.com/docs/en/agent-sdk/python

Section/Topic

"Permissions" section, PermissionMode enum definition

Current Documentation

The Python SDK documentation shows PermissionMode with 3 options:

``python class PermissionMode(str, Enum): ALLOW = "allow" DENY = "deny" ASK = "ask" ``

What's Wrong or Missing?

The PermissionMode enum is missing the dontAsk option that exists in the TypeScript SDK and is documented in the permissions reference.

The dontAsk mode allows denying a permission without prompting the user - useful for automated/headless environments where user interaction isn't possible.

Suggested Improvement

Add the missing permission mode:

class PermissionMode(str, Enum):
ALLOW = "allow"
DENY = "deny"
ASK = "ask"
DONT_ASK = "dontAsk"  # Deny without prompting

Or add a note explaining the difference between deny and dontAsk and why dontAsk may or may not be available in Python.

Impact

Medium - Makes feature difficult to understand

Additional Context

Affected Pages:
| Page | Section |
|------|---------|
| https://platform.claude.com/docs/en/agent-sdk/python | Permissions |
| https://platform.claude.com/docs/en/agent-sdk/typescript | Permissions (has dontAsk) |

Total scope: 1 page needs update (agent-sdk/python)