From 6791efec9307d29fdbba0f3481e9219b4a6db835 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E6=A2=A8=E6=A2=A8=E6=9E=9C?= Date: Fri, 5 Dec 2025 06:28:24 +0800 Subject: [PATCH] fix: add McpServer runtime placeholder for Pydantic 2.12+ compatibility (#385) ## Summary - Add runtime placeholder for `McpServer` type to fix Pydantic 2.12+ compatibility - `McpServer` was only imported under `TYPE_CHECKING`, causing `PydanticUserError` at runtime Fixes #384 Co-authored-by: lyrica --- src/claude_agent_sdk/types.py | 3 +++ 1 file changed, 3 insertions(+) diff --git a/src/claude_agent_sdk/types.py b/src/claude_agent_sdk/types.py index 391ff95..fa6ca35 100644 --- a/src/claude_agent_sdk/types.py +++ b/src/claude_agent_sdk/types.py @@ -10,6 +10,9 @@ from typing_extensions import NotRequired if TYPE_CHECKING: from mcp.server import Server as McpServer +else: + # Runtime placeholder for forward reference resolution in Pydantic 2.12+ + McpServer = Any # Permission modes PermissionMode = Literal["default", "acceptEdits", "plan", "bypassPermissions"]