fix(types): tighten permission_suggestions type in SDKControlPermissionRequest (#955)

## Problem

`SDKControlPermissionRequest.permission_suggestions` is typed as
`list[Any] | None`, which suppresses all type-checking on every consumer
of that field. The wire protocol delivers raw JSON objects for each
suggestion (plain dicts), so `Any` was a placeholder with no
enforcement.

This was noted in a TODO comment added alongside the original field
declaration.

## Fix

Replace `list[Any] | None` with `list[dict[str, Any]] | None` on
`permission_suggestions` in `SDKControlPermissionRequest` and remove the
TODO comment.

The wire shape is raw JSON objects — `dict[str, Any]` accurately
reflects that. Consumers that call `PermissionUpdate.from_dict(s)` on
each item now get proper type-checking on the input to that call.

No runtime behaviour changes.

## Tests

- `mypy src/`: clean (no new errors)
- `ruff check src/ tests/`: clean
- `pytest tests/`: 745 passed, 5 skipped — same baseline as `main`

Closes #957.

Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com>

Author: Ameen-Alam

src/claude_agent_sdk/types.py

@@ -1942,8 +1942,7 @@ class SDKControlPermissionRequest(TypedDict):
     subtype: Literal["can_use_tool"]
     tool_name: str
     input: dict[str, Any]
-    # TODO: Add PermissionUpdate type here
-    permission_suggestions: list[Any] | None
+    permission_suggestions: list[dict[str, Any]] | None
     blocked_path: str | None
     decision_reason: NotRequired[str]
     title: NotRequired[str]