sycommon-python-lib 0.2.10a2__py3-none-any.whl → 0.2.10a4__py3-none-any.whl

sycommon/agent/deep_agent.py

@@ -180,6 +180,10 @@ class AgentConfig(BaseModel):
     sensitive_guard: bool = True        # 是否启用敏感信息检测守卫
     # 敏感降级目标内部模型名（由应用层透传，避免基础库硬编码应用常量）
     internal_model_name: Optional[str] = None
+    # 敏感检测器专用模型名（可选，与降级模型解耦）：
+    #   - 传了 → 检测分类器用它（适合配更快/更准的小模型），降级生成仍用 internal_model_name
+    #   - None → 沿用 internal_model_name（原行为，兼容存量调用方）
+    sensitive_detector_model_name: Optional[str] = None
     # 敏感检测提示词（应用层可覆盖）；未传(None)用基础库 DEFAULT_DETECT_PROMPT
     sensitive_detect_prompt: Optional[str] = None
     # 命中敏感后的动作："allow"=不检测放行；"downgrade"=降级内部模型继续；
@@ -1246,6 +1250,7 @@ async def create_deep_agent(
         model_tier=config.model_tier,
         enabled=config.sensitive_guard,
         internal_model_name=config.internal_model_name,
+        detector_model_name=config.sensitive_detector_model_name,
         detect_prompt=config.sensitive_detect_prompt,
         action=config.sensitive_action,
     )

sycommon/agent/middleware/sensitive_guard.py

@@ -264,6 +264,9 @@ class SensitiveGuardMiddleware(AgentMiddleware):
         self,
         model_tier: str,
         internal_model_name: Optional[str] = None,
+        # 检测器专用模型名：解耦「检测分类器」与「命中后的降级生成模型」。
+        # None 时沿用 internal_model_name（原行为，兼容所有存量调用方）。
+        detector_model_name: Optional[str] = None,
         on_downgrade: Optional[Callable[[], Awaitable[None]]] = None,
         enabled: bool = True,
         state: Optional[DowngradeState] = None,
@@ -286,6 +289,9 @@ class SensitiveGuardMiddleware(AgentMiddleware):
         self._model_tier = model_tier
         # None 时检测器/降级目标都用 get_llm() 读 nacos default 模型，不写死模型名
         self._internal_name = internal_model_name
+        # 检测器模型：detector_model_name 优先（应用层想用更快/更准的分类器时传），
+        # 未传(None)回退 internal_model_name——与原行为完全一致。
+        self._detector_name = detector_model_name or internal_model_name
         self._on_downgrade = on_downgrade
         self._on_block = on_block
         # 默认 allow（不检测）：应用层未显式指定时按"放行"处理，避免误伤。
@@ -396,7 +402,7 @@ class SensitiveGuardMiddleware(AgentMiddleware):
                     # 流式回调；且这里用独立 config（不取 agent 的 StreamMessagesHandler），
                     # 从源头断开检测器与用户事件流。
                     self._detector = get_llm(
-                        self._internal_name, temperature=0.0, wrap_structured=False)
+                        self._detector_name, temperature=0.0, wrap_structured=False)
         return self._detector
 
     async def _get_internal_raw(self):

sycommon/agent/multi_agent_team.py

@@ -684,6 +684,7 @@ async def create_multi_agent_team(
             enabled=config.sensitive_guard,
             state=shared_downgrade_state,
             internal_model_name=config.internal_model_name,
+            detector_model_name=config.sensitive_detector_model_name,
             detect_prompt=config.sensitive_detect_prompt,
             action=config.sensitive_action,
             detect=detect,

sycommon/database/async_database_service.py

@@ -212,7 +212,11 @@ class AsyncDatabaseConnector:
         def tune_keepalive(dbapi_connection, connection_record):
             import socket as _socket
             try:
-                writer = getattr(dbapi_connection, "_writer", None)
+                # SQLAlchemy 2.x 异步方言把 aiomysql 连接包在
+                # AsyncAdapt_aiomysql_connection._connection 里；老版本/裸 aiomysql
+                # 则直接挂 _writer。两级都探测。
+                inner = getattr(dbapi_connection, "_connection", dbapi_connection)
+                writer = getattr(inner, "_writer", None)
                 transport = getattr(writer, "transport", None)
                 raw_sock = transport.get_extra_info("socket") if transport else None
                 if raw_sock is None:

sycommon/database/database_service.py

@@ -1,3 +1,5 @@
+import sys
+
 from sqlalchemy import create_engine, text, event
 
 from sycommon.config.Config import SingletonMeta
@@ -106,17 +108,57 @@ class DatabaseConnector(metaclass=SingletonMeta):
         SYLogger.info(f"Database URL: {safe_url}")
 
         # 优化连接池配置
+        # 🔑 同步引擎与异步引擎（AsyncDatabaseConnector）同源风险：池中空闲连接被中间
+        # 网络设备静默掐死（不回 RST）时，pre_ping 的 SELECT 1 发进黑洞，会挂到内核
+        # TCP 重传放弃。分驱动两层防护（实测验证，见 test_db_keepalive.py）：
+        # - C 扩展（CMySQLConnection，装了 _mysql_driver 时默认）：不暴露 Python 层
+        #   socket，keepalive 钩子拿不到 raw socket；用 read_timeout=60 兜底——黑洞
+        #   读挂死 60s 后抛错，pre_ping 捕获弃连重建（真实环境已验证 SELECT SLEEP
+        #   按 read_timeout 抛 OperationalError）。
+        # - pure 实现（MySQLConnection）：钩子对 _socket.sock 补 keepalive 参数，
+        #   死连接 ~60s 内被内核暴露为错误（与异步侧 73f2156 同一套参数）。
         self.engine = create_engine(
             self.db_url,
-            connect_args=params,
+            connect_args={
+                **params,
+                "connect_timeout": 10,  # TCP 建连超时（秒）
+                "read_timeout": 60,  # 查询级读超时（秒）：C 扩展拿不到 socket 时的黑洞兜底
+                "write_timeout": 60,  # 写超时（秒）：同上
+            },
             pool_size=10,  # 连接池大小
             max_overflow=20,  # 最大溢出连接数
             pool_timeout=30,  # 连接超时时间（秒）
-            pool_recycle=3600,  # 连接回收时间（秒）
+            pool_recycle=300,  # 连接回收时间（秒）；赶在防火墙空闲回收窗口（常见 5-15min）前换血
             pool_pre_ping=True,  # 每次获取连接前检查连接是否有效
             echo=False,  # 打印 SQL 语句
         )
 
+        # 每个新连接补齐 TCP keepalive 参数（连接建立后才能拿到 raw socket）
+        @event.listens_for(self.engine, "connect")
+        def tune_keepalive(dbapi_connection, connection_record):
+            import socket as _socket
+            try:
+                # mysql-connector-python: raw socket 在 MySQLSocket 包装对象的 .sock 上
+                sock_wrapper = getattr(dbapi_connection, "_socket", None)
+                raw_sock = getattr(sock_wrapper, "sock", None)
+                if raw_sock is None:
+                    return
+                raw_sock.setsockopt(_socket.SOL_SOCKET, _socket.SO_KEEPALIVE, 1)
+                if sys.platform == "win32":
+                    # Windows: SIO_KEEPALIVE_VALS = (on/off, idle ms, interval ms)
+                    raw_sock.ioctl(_socket.SIO_KEEPALIVE_VALS, (1, 30000, 10000))
+                else:
+                    # Linux: 空闲 30s 发首个探测，每 10s 一次，3 次无回应判死（约 60s 暴露）
+                    if hasattr(_socket, "TCP_KEEPIDLE"):
+                        raw_sock.setsockopt(_socket.IPPROTO_TCP, _socket.TCP_KEEPIDLE, 30)
+                    if hasattr(_socket, "TCP_KEEPINTVL"):
+                        raw_sock.setsockopt(_socket.IPPROTO_TCP, _socket.TCP_KEEPINTVL, 10)
+                    if hasattr(_socket, "TCP_KEEPCNT"):
+                        raw_sock.setsockopt(_socket.IPPROTO_TCP, _socket.TCP_KEEPCNT, 3)
+            except Exception as e:
+                # keepalive 调优失败不阻断连接创建（回退内核默认）
+                SYLogger.warning(f"TCP keepalive 调优失败（回退默认）: {e}")
+
         # 注册 SQL 日志拦截器
         SQLTraceLogger.setup_sql_logging(self.engine)
 

sycommon/database/redis_service.py

@@ -3,6 +3,8 @@ Redis 异步服务
 使用 redis-py 官方异步客户端
 """
 import logging
+import socket
+import sys
 from typing import Optional, Any, Union
 
 from sycommon.config.Config import SingletonMeta
@@ -32,6 +34,18 @@ class RedisService(metaclass=SingletonMeta):
         """
         cls.init(config)
 
+    # TCP keepalive 探测参数：空闲 30s 首探、每 10s 一次、3 次无回应判死。
+    # 与 MySQL 引擎同套参数（见 async_database_service.py tune_keepalive）。
+    # redis-py 只按平台常量透传 setsockopt；macOS 用 TCP_KEEPALIVE 表 idle。
+    # Windows 无 per-socket keepalive 常量（需 SIO_KEEPALIVE_VALS ioctl），
+    # 且其 TCP_KEEPALIVE 语义不同，透传会抛 WSAENOPROTOOPT —— 直接留空回退默认。
+    _KEEPALIVE_OPTIONS = {} if sys.platform == "win32" else {
+        getattr(socket, name, None): value
+        for name, value in (("TCP_KEEPIDLE", 30), ("TCP_KEEPALIVE", 30),
+                            ("TCP_KEEPINTVL", 10), ("TCP_KEEPCNT", 3))
+        if getattr(socket, name, None) is not None
+    }
+
     @classmethod
     def init(cls, config: Optional[dict] = None):
         """
@@ -104,6 +118,8 @@ class RedisService(metaclass=SingletonMeta):
             db=cls._config.database,
             max_connections=max_connections,
             socket_timeout=cls._config.timeout,
+            socket_keepalive=True,  # 开 TCP keepalive；探测参数见下方 _KEEPALIVE_OPTIONS
+            socket_keepalive_options=RedisService._KEEPALIVE_OPTIONS,
             decode_responses=True  # 自动解码为字符串
         )
 
@@ -151,6 +167,8 @@ class RedisService(metaclass=SingletonMeta):
         cls._client = sentinel.master_for(
             sentinel_config.master,
             socket_timeout=cls._config.timeout,
+            socket_keepalive=True,  # 与单机模式一致，防空闲连接被静默掐死
+            socket_keepalive_options=RedisService._KEEPALIVE_OPTIONS,
             password=cls._config.password,
             db=cls._config.database,
             decode_responses=True

sycommon/database/token_usage_db_service.py

@@ -3,10 +3,11 @@ Token 使用量记录专用数据库服务
 独立于业务系统的数据库连接，使用 llm 配置中的数据库信息
 """
 import logging
+import sys
 from contextlib import asynccontextmanager
 from typing import Optional
 
-from sqlalchemy import text
+from sqlalchemy import event, text
 from sqlalchemy.ext.asyncio import (
     AsyncSession,
     async_sessionmaker,
@@ -197,17 +198,50 @@ class TokenUsageDBConnector(metaclass=SingletonMeta):
 
         # 创建异步引擎（Token 记录连接池较小，增加连接超时防止慢 MySQL 拖垮主服务）
         # 4 workers × (pool_size=1 + max_overflow=2) = 12
+        # 🔑 TCP keepalive：与 AsyncDatabaseConnector（73f2156）同源风险——aiomysql 无查询
+        # 级读超时，池中死连接会让 Token 落库黑洞挂死。pool_recycle 同步降为 300，
+        # 赶在防火墙空闲回收窗口（常见 5-15min）前换血。
         self.engine = create_async_engine(
             self.db_url,
             connect_args={**params, "connect_timeout": 3},
             pool_size=1,
             max_overflow=2,
             pool_timeout=5,
-            pool_recycle=3600,
+            pool_recycle=300,
             pool_pre_ping=True,
             echo=False,
         )
 
+        # 每个新连接补齐 TCP keepalive 参数（连接建立后才能拿到 raw socket）
+        @event.listens_for(self.engine.sync_engine, "connect")
+        def tune_keepalive(dbapi_connection, connection_record):
+            import socket as _socket
+            try:
+                # SQLAlchemy 2.x 异步方言把 aiomysql 连接包在
+                # AsyncAdapt_aiomysql_connection._connection 里；老版本/裸 aiomysql
+                # 则直接挂 _writer。两级都探测。
+                inner = getattr(dbapi_connection, "_connection", dbapi_connection)
+                writer = getattr(inner, "_writer", None)
+                transport = getattr(writer, "transport", None)
+                raw_sock = transport.get_extra_info("socket") if transport else None
+                if raw_sock is None:
+                    return
+                raw_sock.setsockopt(_socket.SOL_SOCKET, _socket.SO_KEEPALIVE, 1)
+                if sys.platform == "win32":
+                    # Windows: SIO_KEEPALIVE_VALS = (on/off, idle ms, interval ms)
+                    raw_sock.ioctl(_socket.SIO_KEEPALIVE_VALS, (1, 30000, 10000))
+                else:
+                    # Linux: 空闲 30s 发首个探测，每 10s 一次，3 次无回应判死（约 60s 暴露）
+                    if hasattr(_socket, "TCP_KEEPIDLE"):
+                        raw_sock.setsockopt(_socket.IPPROTO_TCP, _socket.TCP_KEEPIDLE, 30)
+                    if hasattr(_socket, "TCP_KEEPINTVL"):
+                        raw_sock.setsockopt(_socket.IPPROTO_TCP, _socket.TCP_KEEPINTVL, 10)
+                    if hasattr(_socket, "TCP_KEEPCNT"):
+                        raw_sock.setsockopt(_socket.IPPROTO_TCP, _socket.TCP_KEEPCNT, 3)
+            except Exception as e:
+                # keepalive 调优失败不阻断连接创建（回退内核默认）
+                SYLogger.warning(f"TCP keepalive 调优失败（回退默认）: {e}")
+
         # 注册 SQL 日志拦截器
         from sycommon.logging.async_sql_logger import AsyncSQLTraceLogger
         AsyncSQLTraceLogger.setup_sql_logging(self.engine)

sycommon/heartbeat_process/heartbeat_process_worker.py

@@ -178,6 +178,9 @@ class HeartbeatProcessWorker:
                 username=self.nacos_config.username,
                 password=self.nacos_config.password
             )
+            # SDK 默认单请求超时仅 3 秒，网络/DNS 抖动即抛
+            # "All server are not available"，放宽到 10 秒
+            self.nacos_client.set_options(default_timeout=10)
             logger.info("Nacos 客户端初始化成功")
             return True
         except Exception as e:

sycommon/middleware/traceid.py

@@ -68,7 +68,7 @@ def setup_trace_id_handler(app):
         token = SYLogger.set_trace_id(trace_id)
         # 🔒 白名单过滤：Authorization/Cookie/SYT_TOKEN 等凭证 header 不进
         # 日志上下文，防止下游任何日志路径把凭证打到日志。
-        header_token = SYLogger.set_headers(_filtered_headers(request.headers.raw))
+        header_token = SYLogger.set_headers(request.headers.raw)
 
         # 获取请求参数
         query_params = dict(request.query_params)

sycommon/models/base_http.py

@@ -1,4 +1,6 @@
 from typing import TypeVar, Any, Generic
+import warnings
+
 from pydantic import BaseModel, Field
 from fastapi.responses import JSONResponse
 from fastapi import status
@@ -8,7 +10,11 @@ T = TypeVar('T')
 
 
 class BaseResponseModel(BaseModel, Generic[T]):
-    """基础响应模型，支持自定义状态码"""
+    """基础响应模型，支持自定义状态码
+
+    注意:code 默认 0 是旧版 0/1 业务码的兼容默认值,新代码请走
+    ok()/fail()(code=200/500)。默认值暂不改,避免破坏旧接口反序列化。
+    """
     code: int = Field(default=0, description="业务响应码，默认0成功，1失败，支持自定义")
     message: str | None = Field(default=None, description="业务响应信息")
     success: bool = Field(default=True, description="请求是否成功")
@@ -20,6 +26,23 @@ class BaseResponseModel(BaseModel, Generic[T]):
         from_attributes = True
 
 
+# =====================================================================
+# 【Deprecated】旧版 0/1 业务码方式 —— 未来将移除,请勿在新代码中使用。
+#
+# 新代码请用下方的 ok() / fail()(HTTP 语义:成功 code=200 / 失败 code=500,
+# HTTP status 与业务码一致,success 由 2xx 推导)。
+# =====================================================================
+
+
+def _deprecate_01_style(name: str) -> None:
+    warnings.warn(
+        f"sycommon.models.base_http.{name} 已废弃(0/1 业务码方式),"
+        f"请改用 ok()/fail()(HTTP 语义 code=200/500);未来版本将移除。",
+        DeprecationWarning,
+        stacklevel=3,
+    )
+
+
 def build_response_content(
     data: T | Any = None,
     code: int = 0,
@@ -59,7 +82,8 @@ def create_response(
     message: str = None,
     status_code: int = status.HTTP_200_OK
 ) -> JSONResponse:
-    """创建完整响应，支持自定义业务状态码"""
+    """【Deprecated】创建完整响应,支持自定义业务状态码 —— 改用 http_response()"""
+    _deprecate_01_style("create_response")
     content = build_response_content(data=data, code=code, message=message)
     return JSONResponse(
         content=content,
@@ -68,7 +92,8 @@ def create_response(
 
 
 def success_response(data: T | Any = None, code: int = 0, message: str = None) -> JSONResponse:
-    """快捷创建成功响应（code=0, success=True）"""
+    """【Deprecated】快捷创建成功响应(code=0, success=True) —— 改用 ok()"""
+    _deprecate_01_style("success_response")
     return create_response(data=data, code=code, message=message)
 
 
@@ -78,7 +103,8 @@ def error_response(
     data: T | Any = None,
     status_code: int = status.HTTP_500_INTERNAL_SERVER_ERROR
 ) -> JSONResponse:
-    """快捷创建错误响应，支持自定义错误码（如200）"""
+    """【Deprecated】快捷创建错误响应(code=1) —— 改用 fail()"""
+    _deprecate_01_style("error_response")
     return create_response(
         data=data,
         code=code,
@@ -88,7 +114,8 @@ def error_response(
 
 
 def success_content(data: T | Any = None) -> dict:
-    """构建成功响应内容字典"""
+    """【Deprecated】构建成功响应内容字典(code=0) —— 改用 ok()"""
+    _deprecate_01_style("success_content")
     return build_response_content(data=data)
 
 
@@ -97,7 +124,8 @@ def error_content(
     code: int = 1,
     data: T | Any = None
 ) -> dict:
-    """构建错误响应内容字典，支持自定义错误码"""
+    """【Deprecated】构建错误响应内容字典(code=1) —— 改用 fail()"""
+    _deprecate_01_style("error_content")
     return build_response_content(data=data, code=code, message=message)
 
 
@@ -107,7 +135,7 @@ def error_content(
 # 与上面 0/1 业务码的区别：code 直接用 HTTP 状态码语义——
 #   成功 code=200 / 失败 code=500，HTTP status 同步对应（200 / 500），
 # success 由 code 是否为 2xx 推导。不再用 0/1 代表成功失败。
-# 旧函数保留兼容，新项目请用 ok() / fail()。
+# 旧函数已标记 Deprecated(调用即抛 DeprecationWarning),未来版本移除。
 # =====================================================================
 
 

sycommon/notice/uvicorn_monitor.py

@@ -55,6 +55,9 @@ async def send_wechat_markdown_msg(
 ) -> Optional[dict]:
     """
     异步发送企业微信Markdown格式的WebHook消息
+
+    失败（网络异常/非0 errcode）时等 2 秒重试一次，
+    避免网络瞬时抖动导致告警丢失（例如只收到"恢复"没收到"断开"）。
     """
     # 构造请求体（Markdown格式）
     payload = {
@@ -64,26 +67,34 @@ async def send_wechat_markdown_msg(
         }
     }
 
-    try:
-        # 使用 json 参数自动处理序列化和 Content-Type
-        async with aiohttp.ClientSession() as session:
-            async with session.post(
-                url=webhook,
-                json=payload,
-                timeout=aiohttp.ClientTimeout(total=10)
-            ) as response:
-                response_data = await response.json()
-
-                if response.status == 200 and response_data.get("errcode") == 0:
-                    SYLogger.info(f"消息发送成功: {response_data}")
-                    return response_data
-                else:
-                    SYLogger.warning(
-                        f"消息发送失败 - 状态码: {response.status}, 响应: {response_data}")
-                    return None
-    except Exception as e:
-        SYLogger.error(f"发送企业微信消息异常: {str(e)}")
-        return None
+    max_attempts = 2
+    for attempt in range(1, max_attempts + 1):
+        try:
+            # 使用 json 参数自动处理序列化和 Content-Type
+            async with aiohttp.ClientSession() as session:
+                async with session.post(
+                    url=webhook,
+                    json=payload,
+                    timeout=aiohttp.ClientTimeout(total=10)
+                ) as response:
+                    response_data = await response.json()
+
+                    if response.status == 200 and response_data.get("errcode") == 0:
+                        SYLogger.info(f"消息发送成功: {response_data}")
+                        return response_data
+                    else:
+                        SYLogger.warning(
+                            f"消息发送失败 - 状态码: {response.status}, 响应: {response_data}")
+                        if attempt < max_attempts:
+                            await asyncio.sleep(2)
+                            continue
+                        return None
+        except Exception as e:
+            SYLogger.error(f"发送企业微信消息异常: {str(e)}")
+            if attempt < max_attempts:
+                await asyncio.sleep(2)
+                continue
+            return None
 
 
 async def send_webhook(error_info: dict = None, webhook: str = None):

sycommon/synacos/nacos_client_base.py

@@ -88,6 +88,9 @@ class NacosClientBase:
                     server_addresses=register_ip,
                     namespace=namespace_id
                 )
+                # SDK 默认单请求超时仅 3 秒，网络/DNS 抖动即抛
+                # "All server are not available"，放宽到 10 秒
+                self.nacos_client.set_options(default_timeout=10)
                 SYLogger.info("nacos:客户端初始化成功")
                 self._client_initialized = True
                 return True
@@ -120,6 +123,9 @@ class NacosClientBase:
                         server_addresses=register_ip,
                         namespace=namespace_id
                     )
+                    # SDK 默认单请求超时仅 3 秒，网络/DNS 抖动即抛
+                    # "All server are not available"，放宽到 10 秒
+                    self.nacos_client.set_options(default_timeout=10)
 
                     if self._verify_client_connection():
                         self._client_initialized = True

sycommon/tests/test_db_keepalive.py

@@ -0,0 +1,178 @@
+"""
+数据库连接 TCP keepalive 调优验证（不依赖真实数据库）。
+
+覆盖三个建连点：
+- 同步 DatabaseConnector（mysqlconnector, raw socket 在 _socket.sock）
+- 异步 AsyncDatabaseConnector（aiomysql, raw socket 在 _writer.transport）
+- 异步 TokenUsageDBConnector（aiomysql, 同上）
+
+验证方式：构造连接器拿到 engine 上注册的 "connect" 事件监听器，
+用假 dbapi 连接触发，断言对 raw socket 调了 SO_KEEPALIVE 与
+KEEPIDLE/KEEPINTVL/KEEPCNT 三个参数（即 73f2156 事故修复的参数集）。
+"""
+import socket
+import sys
+import unittest
+from unittest.mock import MagicMock, patch
+
+from sycommon.config.DatabaseConfig import DatabaseConfig, HikariConfig
+
+DB_CONFIG = DatabaseConfig(
+    url="mysql://user@127.0.0.1:3306/testdb",
+    username="user",
+    password="secret",
+    driver_class_name="com.mysql.cj.jdbc.Driver",
+    time_between_eviction_runs_millis=30000,
+    min_evictable_idle_time_millis=60000,
+    validation_query="SELECT 1",
+    test_while_idle=True,
+    test_on_borrow=True,
+    test_on_return=False,
+    hikari=HikariConfig(minimum_idle=5, maximum_pool_size=10, idle_timeout=600000),
+)
+
+
+def _make_async_fake_conn():
+    """模拟 aiomysql 连接（SQLAlchemy 2.x 包装在 AsyncAdapt._connection 里）：
+    raw socket 挂在内层 _writer.transport 上。"""
+    raw_sock = MagicMock(name="raw_socket")
+    writer = MagicMock()
+    writer.transport.get_extra_info.return_value = raw_sock
+    inner = MagicMock()
+    inner._writer = writer
+    conn = MagicMock(spec=["_connection", "cursor", "character_set_name",
+                           "rollback", "commit", "autocommit"])
+    conn._connection = inner
+    conn.cursor.return_value = _make_smart_cursor()
+    conn.character_set_name.return_value = "utf8mb4"
+    conn.autocommit = False
+    return conn, raw_sock
+
+
+def _make_smart_cursor():
+    """按 SQL 语句返回可解析结果的假 cursor（方言初始化 + 时区钩子都会走它）。"""
+    cursor = MagicMock()
+
+    def execute(sql, *a, **kw):
+        cursor._last_sql = sql
+
+    def fetchone():
+        sql = getattr(cursor, "_last_sql", "")
+        if "VERSION" in sql:
+            return ("8.0.30",)
+        if "transaction_isolation" in sql or "tx_isolation" in sql:
+            return ("READ-COMMITTED",)
+        if "time_zone" in sql:
+            return ("+08:00",)
+        if "sql_mode" in sql:
+            return ("",)
+        if "lower_case_table_names" in sql:
+            return (0,)
+        if "collation" in sql.lower():
+            return ("utf8mb4_general_ci",)
+        return ("",)
+
+    cursor.execute.side_effect = execute
+    cursor.fetchone.side_effect = fetchone
+    return cursor
+
+
+def _make_sync_fake_conn():
+    """模拟 mysql-connector 连接：raw socket 在 _socket.sock 上。"""
+    raw_sock = MagicMock(name="raw_socket")
+    conn = MagicMock()
+    conn._socket = MagicMock(sock=raw_sock)
+    conn.cursor.return_value = _make_smart_cursor()
+    conn.get_server_version.return_value = (8, 0, 30)
+    conn.autocommit = False
+    return conn, raw_sock
+
+
+class KeepaliveHookTest(unittest.TestCase):
+    """三个连接器的 keepalive 钩子统一断言。"""
+
+    def _trigger_hooks(self, engine, fake_conn):
+        """触发 engine 上全部 connect 监听器（public dispatch 路径，与真实建连一致）。"""
+        pool = engine.pool if hasattr(engine, "pool") else engine.sync_engine.pool
+        pool.dispatch.connect(fake_conn, MagicMock())
+        return [fake_conn]
+
+    def _assert_keepalive_opts(self, raw_sock):
+        """断言与 73f2156 相同的参数集被设置到 raw socket。"""
+        calls = raw_sock.setsockopt.call_args_list
+        sol_opts = [c.args[1] for c in calls if c.args[0] == socket.SOL_SOCKET]
+        self.assertIn(socket.SO_KEEPALIVE, sol_opts, "SO_KEEPALIVE 未开启")
+        if sys.platform != "win32":
+            calls_ipproto = {c.args[1]: c.args[2] for c in calls
+                             if c.args[0] == socket.IPPROTO_TCP}
+            expected = {
+                getattr(socket, "TCP_KEEPIDLE", None): 30,
+                getattr(socket, "TCP_KEEPINTVL", None): 10,
+                getattr(socket, "TCP_KEEPCNT", None): 3,
+            }
+            for opt, val in expected.items():
+                if opt is not None:
+                    self.assertEqual(calls_ipproto.get(opt), val,
+                                     f"TCP 选项 {opt} 未按预期设置为 {val}")
+
+    def test_sync_connector_keepalive(self):
+        """同步 DatabaseConnector：钩子从 _socket.sock 取 raw socket 并调参。"""
+        from sycommon.database.database_service import DatabaseConnector
+        with patch.object(DatabaseConnector, "test_connection", return_value=True):
+            connector = DatabaseConnector(DB_CONFIG)
+        fake_conn, raw_sock = _make_sync_fake_conn()
+        fired = self._trigger_hooks(connector.engine, fake_conn)
+        self.assertTrue(fired, "connect 监听器未被触发")
+        self._assert_keepalive_opts(raw_sock)
+        # 同步引擎建连参数带上超时（connect_args 在 pool creator 调 dialect.connect
+        # 时才合并，故在此处捕获断言）
+        with patch.object(connector.engine.dialect, "connect",
+                          return_value=MagicMock()) as m:
+            connector.engine.pool._invoke_creator(MagicMock())
+        self.assertEqual(m.call_args.kwargs.get("connect_timeout"), 10)
+
+    def test_async_connector_keepalive(self):
+        """异步 AsyncDatabaseConnector：钩子从 _writer.transport 取 raw socket。"""
+        import asyncio
+        from sycommon.database.async_database_service import AsyncDatabaseConnector
+
+        async def build():
+            return AsyncDatabaseConnector(DB_CONFIG)
+
+        connector = asyncio.new_event_loop().run_until_complete(build())
+        fake_conn, raw_sock = _make_async_fake_conn()
+        fired = self._trigger_hooks(connector.engine, fake_conn)
+        self.assertTrue(fired, "connect 监听器未被触发")
+        self._assert_keepalive_opts(raw_sock)
+        with patch.object(connector.engine.sync_engine.dialect, "connect",
+                          return_value=MagicMock()) as m:
+            connector.engine.sync_engine.pool._invoke_creator(MagicMock())
+        self.assertEqual(m.call_args.kwargs.get("connect_timeout"), 10)
+
+    def test_token_usage_connector_keepalive(self):
+        """TokenUsageDBConnector：与异步主链路同一套 keepalive 参数。"""
+        import asyncio
+        from sycommon.database.token_usage_db_service import TokenUsageDBConnector
+
+        async def build():
+            return TokenUsageDBConnector(DB_CONFIG)
+
+        connector = asyncio.new_event_loop().run_until_complete(build())
+        fake_conn, raw_sock = _make_async_fake_conn()
+        fired = self._trigger_hooks(connector.engine, fake_conn)
+        self.assertTrue(fired, "connect 监听器未被触发")
+        self._assert_keepalive_opts(raw_sock)
+
+    def test_keepalive_failure_does_not_block(self):
+        """setsockopt 抛异常不阻断建连（钩子内部吞掉）。"""
+        from sycommon.database.database_service import DatabaseConnector
+        with patch.object(DatabaseConnector, "test_connection", return_value=True):
+            connector = DatabaseConnector(DB_CONFIG)
+        fake_conn, raw_sock = _make_sync_fake_conn()
+        raw_sock.setsockopt.side_effect = OSError("perm")
+        # 不应抛异常
+        self._trigger_hooks(connector.engine, fake_conn)
+
+
+if __name__ == "__main__":
+    unittest.main()

sycommon/tests/test_upgrade_verification.py

@@ -1,7 +1,7 @@
 """验证本次依赖升级 + 补丁适配的正确性（纯离线，不依赖 RabbitMQ/真实 LLM）。
 
 覆盖本次改动：
-A. 依赖版本落地：langchain 1.3.15 / langchain_openai 1.5.1 / langchain_core 1.5.5。
+A. 依赖版本落地：langchain 1.3.18 / langchain_openai 1.6.0 / langchain_core 1.6.1。
 B. summarization_utils.py 的 ContextOverflow 补丁：在当前版本上成功替换
    _handle_openai_bad_request / _handle_openai_api_error，且：
    - MiniMax/vLLM 句式 "maximum context length is ..." 仍被正确转成
@@ -28,12 +28,12 @@ def test_installed_versions():
     import langchain_openai
     import langchain_core
 
-    assert langchain.__version__ == "1.3.15", (
-        f"langchain 应为 1.3.15, 实际 {langchain.__version__}")
-    assert langchain_openai.__version__ == "1.5.1", (
-        f"langchain_openai 应为 1.5.1, 实际 {langchain_openai.__version__}")
-    assert langchain_core.__version__ == "1.5.5", (
-        f"langchain_core 应为 1.5.5, 实际 {langchain_core.__version__}")
+    assert langchain.__version__ == "1.3.18", (
+        f"langchain 应为 1.3.18, 实际 {langchain.__version__}")
+    assert langchain_openai.__version__ == "1.6.0", (
+        f"langchain_openai 应为 1.6.0, 实际 {langchain_openai.__version__}")
+    assert langchain_core.__version__ == "1.6.1", (
+        f"langchain_core 应为 1.6.1, 实际 {langchain_core.__version__}")
     print(f"  [OK] langchain={langchain.__version__} "
           f"langchain_openai={langchain_openai.__version__} "
           f"langchain_core={langchain_core.__version__}")

{sycommon_python_lib-0.2.10a2.dist-info → sycommon_python_lib-0.2.10a4.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: sycommon-python-lib
-Version: 0.2.10a2
+Version: 0.2.10a4
 Summary: Add your description here
 Requires-Python: >=3.11
 Description-Content-Type: text/markdown
@@ -13,36 +13,36 @@ Requires-Dist: deepagents==0.7.6
 Requires-Dist: elasticsearch==9.5.0
 Requires-Dist: fastapi==0.141.1
 Requires-Dist: jinja2==3.1.6
-Requires-Dist: kafka-python==3.0.10
-Requires-Dist: langchain==1.3.15
-Requires-Dist: langchain-core==1.5.5
-Requires-Dist: langchain-openai==1.5.1
-Requires-Dist: langfuse==4.14.4
+Requires-Dist: kafka-python==3.0.11
+Requires-Dist: langchain==1.3.18
+Requires-Dist: langchain-core==1.6.1
+Requires-Dist: langchain-openai==1.6.0
+Requires-Dist: langfuse==4.15.1
 Requires-Dist: langgraph==1.2.11
 Requires-Dist: langgraph-checkpoint-postgres==3.1.2
-Requires-Dist: langgraph-checkpoint-redis==0.5.1
+Requires-Dist: langgraph-checkpoint-redis==0.5.2
 Requires-Dist: ldap3==2.9.1
 Requires-Dist: loguru==0.7.3
 Requires-Dist: mysql-connector-python==26.7.0
 Requires-Dist: nacos-sdk-python<3.0,==2.0.11
 Requires-Dist: psutil==7.2.2
 Requires-Dist: pyxxl==0.4.8
-Requires-Dist: pydantic==2.13.4
-Requires-Dist: python-dotenv==1.2.2
+Requires-Dist: pydantic==2.13.5
+Requires-Dist: python-dotenv==1.2.3
 Requires-Dist: python-multipart==0.0.32
 Requires-Dist: pyyaml==6.0.3
 Requires-Dist: redis==7.4.0
-Requires-Dist: sentry-sdk[fastapi]==2.68.0
+Requires-Dist: sentry-sdk[fastapi]==2.68.1
 Requires-Dist: sqlalchemy[asyncio]==2.0.52
 Requires-Dist: starlette[full]==1.6.0
-Requires-Dist: tiktoken==0.13.0
-Requires-Dist: uvicorn==0.52.3
+Requires-Dist: tiktoken==0.14.0
+Requires-Dist: uvicorn==0.52.4
 Requires-Dist: wecom-aibot-python-sdk==1.0.2
 Requires-Dist: twine==7.0.0
 Requires-Dist: minio==7.2.20
 Requires-Dist: langchain-mcp-adapters==0.3.2
 Requires-Dist: fastapi-mcp==0.4.0
-Requires-Dist: psycopg[binary,pool]==3.3.4
+Requires-Dist: psycopg[binary,pool]==3.3.5
 Requires-Dist: agent-client-protocol==0.11.0
 Requires-Dist: langchain-acp==1.7.0
 Requires-Dist: pypinyin==0.55.0

{sycommon_python_lib-0.2.10a2.dist-info → sycommon_python_lib-0.2.10a4.dist-info}/RECORD

@@ -137,8 +137,8 @@ sycommon/services.py,sha256=BalCSLqx0aictqEsyUOUXimjqdMGbZgZyd0MqViaBI0,27315
 sycommon/agent/__init__.py,sha256=mxceAeUifQ-DKvWp7ZEJIFlmOCb5wpYHPGQw3rwEN8I,4378
 sycommon/agent/agent_manager.py,sha256=UhhaekEumT7g4v_Z1UB4jTp13X0n8M8erYaQdkGGWkA,13620
 sycommon/agent/chat_events.py,sha256=t7qWa6OrIWLfqtd1AnqaVP67QWkn1JxpCBTZYQpoLuM,14226
-sycommon/agent/deep_agent.py,sha256=Bkur9ybj7cKSqI6ZBPbtVXXNN_hmvOIHlEh5fOHjEVs,87488
-sycommon/agent/multi_agent_team.py,sha256=227UgO0XrrPxvQE4xXTNCCYq-5WiUi13r_AUolTpLS4,34719
+sycommon/agent/deep_agent.py,sha256=gBQ2rzQIS53PZhaU50zIsJ3cWMEg_IaBbH_IzycmHGU,87895
+sycommon/agent/multi_agent_team.py,sha256=GRXjjrPblsMnLjY2aB5CeFJ6-F7wvPhUc_JxNjfBXes,34789
 sycommon/agent/reasoning_content_patch.py,sha256=HZ_If0qVDHlz_b1mDT3tuTqbExhzRVhP4VgsoDt0JLc,3945
 sycommon/agent/resume_compactor.py,sha256=CJp3AUqeStr8U2JeWP31DyulomXZdrkLL4kVtLxnwn8,20849
 sycommon/agent/skills_retry_patch.py,sha256=LwlNIQdl0Hz9tywT5foPipULReMlWJyRK5nGibgp948,4049
@@ -154,7 +154,7 @@ sycommon/agent/mcp/models.py,sha256=zda4ho-UTYOJ5oPAZPZ-vxhfDRLghUCsMroHnA2A2QQ,
 sycommon/agent/mcp/tool_loader.py,sha256=pwhZoSoZuQVYo6BgfdMoRHlGnRPDRxvOvxEgvUM5q7Q,17818
 sycommon/agent/middleware/model_request_prep.py,sha256=W0dTgdFo6RI0Tg9jdN7jSB9QOroQR5XHIrm2hw5lslk,7618
 sycommon/agent/middleware/sandbox_path_guard.py,sha256=K1SnxA8pDxkCSucOkranwUvC9_8rd3l_-TIR8gMMTK8,8102
-sycommon/agent/middleware/sensitive_guard.py,sha256=Ql4BUwF0rNOcpqB7OOHTaO0-65MTEJ9Qk-sC6p7SIQ4,31834
+sycommon/agent/middleware/sensitive_guard.py,sha256=TN1SEFzUborxx7l24-XvR6TZY0s5G61kTbJnyaB11tE,32350
 sycommon/agent/middleware/skill_write_guard.py,sha256=ZLW-OIG56z5LvLRMaMnryhPz_O5PbrdTLuHTfC3PveA,3101
 sycommon/agent/sandbox/__init__.py,sha256=jR7LlkD4J4Y6QYyRXQClkwmqDBCCPmycV_hQV9p9YHw,4621
 sycommon/agent/sandbox/consistent_hash.py,sha256=8Jgk-W4NAD2-u5_vKRVlPmql_e0Vy4aNORiXOuzvIrs,7277
@@ -187,14 +187,14 @@ sycommon/config/XxlJobConfig.py,sha256=VSG6dn9ysfUVunOs7PqugyZUGJWmX_cEePz2ZCfqH
 sycommon/config/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 sycommon/config/config_change_notifier.py,sha256=7qQe7vdBS1zohEfVq0d5IaDqYsLdgd2ckF4mKKgh0gE,6848
 sycommon/database/async_base_db_service.py,sha256=8mPZ2yI1hIYvuHYxcpeU0gus_1WGjrpRqv2bm9TIBCk,6186
-sycommon/database/async_database_service.py,sha256=eS7Vje0eqB6xLNXHoHBan-44w9XrSKCjcQCrHSgLtm8,12692
+sycommon/database/async_database_service.py,sha256=Ghop6On0H2H1yZBhP3xt8EKvYjAZ1kjyjDpDP9dhE_g,12985
 sycommon/database/base_db_service.py,sha256=urdAibaCUt3hxwwKzEMBceWkIwsw3ja_WDJ1QKc8nLU,4116
-sycommon/database/database_service.py,sha256=svkg6MBxcar6nWSepBv40mSfpZi5tVecloTDu1O1Tns,6099
+sycommon/database/database_service.py,sha256=mspi98qQnzl7gvaEjGM40lvM_LfjGdQZR1jp5RaFDkc,8974
 sycommon/database/elasticsearch_service.py,sha256=BJnBcoeSDtK1a1IcCyLbzQaOMb5hCfIh0wgBRQ9XmpU,4257
 sycommon/database/pg_checkpoint_service.py,sha256=lR73iZTDJDZc7tfx4_D6vjdlJAUTDe49zAOa3QIkBsg,7342
-sycommon/database/redis_service.py,sha256=_Sr9RRSsiMh_xPSyxKxjfDkECVf5Lii2yGBzKZRi_hE,21473
+sycommon/database/redis_service.py,sha256=Gz9ovGIeHZdcvY7_DTG_pU1t1OqfV29cS9CvN6A0q5E,22598
 sycommon/database/resilient_pg_saver.py,sha256=S5hOoF7gGTa0b4-P3dM_iLy1GFesG_jEnIxv-WRwd3s,7148
-sycommon/database/token_usage_db_service.py,sha256=wU9jSUyOafLSI_45gbfv7_kOU0nG2bmwOmEQnN2mLpU,7913
+sycommon/database/token_usage_db_service.py,sha256=iYK51ZtGNpBA4nj2IhflltbftE5Fsc3C0UksSJr-phY,10152
 sycommon/health/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 sycommon/health/health_check.py,sha256=EhfbhspRpQiKJaxdtE-PzpKQO_ucaFKtQxIm16F5Mpk,391
 sycommon/health/metrics.py,sha256=fHqO73JuhoZkNPR-xIlxieXiTCvttq-kG-tvxag1s1s,268
@@ -202,7 +202,7 @@ sycommon/health/ping.py,sha256=FTlnIKk5y1mPfS1ZGOeT5IM_2udF5aqVLubEtuBp18M,250
 sycommon/heartbeat_process/__init__.py,sha256=8HPwckgg7UW6dhf_h71BidiZy6Uj5Q2la8OnmqVcPSU,1899
 sycommon/heartbeat_process/heartbeat_config.py,sha256=qbxxsYYhYNS5jEQ644aYmJB1wJCnhwFn04m92EQ0iSg,5486
 sycommon/heartbeat_process/heartbeat_process_manager.py,sha256=24qUKs8qegdWHqcoxL0gTaypjNHoSCFDwlbzi5SgkYw,9252
-sycommon/heartbeat_process/heartbeat_process_worker.py,sha256=duuAEFwda43Y6pZE8tOOspitlyxecaFsg1n1iH9jQDQ,16863
+sycommon/heartbeat_process/heartbeat_process_worker.py,sha256=18XtfMTYrbOeC9EsZF5oKTUb2vNIoV8JzqiGqemwiv4,17064
 sycommon/llm/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 sycommon/llm/embedding.py,sha256=n2PtKlfJ4E1-V8DIHTilR-y9y1TYB5iaATlWOKjid28,19878
 sycommon/llm/get_llm.py,sha256=DK-kZSz6NtQ8lpbEdleLyYXm7qnAJwAItDKUqF6Xxkw,10079
@@ -243,9 +243,9 @@ sycommon/middleware/sandbox_gateway.py,sha256=ZyXV9iwvaLNNTk0oM-RdjGRSgkBPaPp67A
 sycommon/middleware/timeout.py,sha256=KlxOPa8xl2dg6yuRi_EzkVJG8bX4stb5ueYxctzzGM8,1433
 sycommon/middleware/token_tracking.py,sha256=rEbgV1bgWMdzAERx4aq5XAvOIT6jTY_tK1P0xHJnL3o,6609
 sycommon/middleware/tool_result_truncation.py,sha256=xtwBf8q11Z8EPzmo3Ju4OfUbULOklSsWo_oystxCW0o,13640
-sycommon/middleware/traceid.py,sha256=LMZB7JykO6dX250rrorowFBpJBL7JljQbZ2Sq3VDHh0,19884
+sycommon/middleware/traceid.py,sha256=NZ2zLtqnd3MfNSGMal2pfnKlc57t-CLIi5j1L1NAaFU,19865
 sycommon/models/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-sycommon/models/base_http.py,sha256=efxtsxmQmInlsRVqQU9P17MSVXx3TsNmgimMlz0hNV0,4788
+sycommon/models/base_http.py,sha256=pLa6IBWZtVy92bKiZ8_Sdo5jUjlojAqhJ1TH4C-nxvQ,6042
 sycommon/models/log.py,sha256=rZpj6VkDRxK3B6H7XSeWdYZshU8F0Sks8bq1p6pPlDw,500
 sycommon/models/mcp_server_config.py,sha256=cm_oDEDXVJR4nCKgWPli5zFI0DUy6xtvRs-___EWAW8,1768
 sycommon/models/mqlistener_config.py,sha256=ZFGg_vc9HcIV22L5Jgrynkjj5B6Ci8ETQNUbNUiXrVw,1830
@@ -257,7 +257,7 @@ sycommon/models/token_usage.py,sha256=w3Aash7jUVSUIgKxBUzI6SqJ9VV5Pk7rLBbMUlLv6n
 sycommon/models/token_usage_mysql.py,sha256=eWnCvI2FDwyTA_fr4wWQtAmUnFJgLwrt0WXMXHLAESQ,2633
 sycommon/models/xxljob_handler_config.py,sha256=XiSv9AlJ8UsLRai4hvTMeiSZ6VsO5Ijx8HcDwLxJL64,376
 sycommon/notice/__init__.py,sha256=cVYbKlLLMFHckyDpx21CTZCMTufqZk_uHuEIxUNxwx4,104
-sycommon/notice/uvicorn_monitor.py,sha256=_SlLB91N7g-Jt_xP_AX1IWFgA7_1lCqsQFwm_Y6QjFk,11756
+sycommon/notice/uvicorn_monitor.py,sha256=68VC2d6JvlVsH-Ev87JS-TIbCBGhIjneg3Uxx9LMkOg,12308
 sycommon/notice/wecom_message.py,sha256=_oA6hg0Ask7NkFbvUpL78WOmyUb6uW7KcY71GhNKiJY,12363
 sycommon/rabbitmq/process_pool_consumer.py,sha256=EXdNypgathjTfPqkccoAW0HiVB9HuZLGhPbWUcYh0_Q,29750
 sycommon/rabbitmq/rabbit_management_client.py,sha256=cf7GSbvdzOA6vFV4jC3IL6wh8yu8IEDgTPHUqRV2_uE,4021
@@ -279,7 +279,7 @@ sycommon/synacos/example.py,sha256=FOnBkvodR8WF_jf-RovM3ngVmvZQX6wKwMLscUTGn2M,8
 sycommon/synacos/example2.py,sha256=yYuQscfHUIl1HLZ8kSRBuZpHUcNWZMi5H3Mb-LjYnvk,8136
 sycommon/synacos/feign.py,sha256=RU6p2gRP3LZoHYBBEUUY9z5KKzGiUmwj4qdo7aF9UNA,12610
 sycommon/synacos/feign_client.py,sha256=i6O20JWl1g2fjD-et7olFaO-0z2yEbKT8-pKluAHCgs,19917
-sycommon/synacos/nacos_client_base.py,sha256=iP5kLkBD2VOrx6X8v6_RnC9NWiBWmL6-Bgf493QOtxc,6899
+sycommon/synacos/nacos_client_base.py,sha256=dBKtGG1g-in8cAILHUVxPmfZZ3fNEuYMDFAHBgTYfJM,7337
 sycommon/synacos/nacos_config_manager.py,sha256=LdmMwyQcc09K0fNWCuSqobyV-wdSW_qVZXb-TEASgxY,8330
 sycommon/synacos/nacos_heartbeat_manager.py,sha256=LfimUKpG4KaqsVQl150sg3MLK8psanuUwQ07tjL3uBE,10963
 sycommon/synacos/nacos_service.py,sha256=nmL007c2SBMHaVJXlzBHV2_R8whfl_X_rmgCpjRDqZw,12319
@@ -295,6 +295,7 @@ sycommon/tests/test_consumer_loss_rootcause.py,sha256=rP_XdbGbzOM9RB36vk0gU4kqip
 sycommon/tests/test_consumer_recovery.py,sha256=pMMtOwHIijNTZxg3IVBYSGFYgezMX0PUeylks8xzMM8,10364
 sycommon/tests/test_consumer_recovery_fix.py,sha256=q2OW0-KEsTqHpelNIDr15G8p-ZOC49rXGxq2wqBmFZM,12857
 sycommon/tests/test_consumer_tags_sync.py,sha256=E9BZs9WGUIE5ygHsGzLlaohG2qlAVnkpOcjaYW9WHkg,5702
+sycommon/tests/test_db_keepalive.py,sha256=xp2MSwMpVFjq4gdT0UCFptUKau95xiwJHUXzXGs3YBM,7576
 sycommon/tests/test_deep_agent.py,sha256=YDbDdMbTjUjLjgGjT1kPwyeMRQ4fqjliJd71dJ0rOPA,5918
 sycommon/tests/test_dynamic_max_tokens.py,sha256=mk2QXZIxpyClEBvS9g88NXr9xmXoNdVrIjFAsN5t6CQ,17934
 sycommon/tests/test_email.py,sha256=-oPtYVGQzJ3Cv-op3ZNRMeyYOF-UNidGJC35CHRgjGQ,5442
@@ -322,7 +323,7 @@ sycommon/tests/test_summarization_real.py,sha256=iTwwA_xQd5Zgkn849lu2M0zIHPnMp-3
 sycommon/tests/test_summary_leak_e2e.py,sha256=vE5r9QCcZRmUy3YQASwdwCBsVrRcl8vU95sLUyB6u9s,34739
 sycommon/tests/test_upgrade_aio_pika.py,sha256=HIvy0Gs-aNNGX6Q3Y2fwSq2nDODbsWt7kl7-bk3gTk0,6115
 sycommon/tests/test_upgrade_langgraph_stream.py,sha256=1FEVuv8FPNeLOB6yht6NoQifHoiCtkrtBI4pB_PQYTE,5443
-sycommon/tests/test_upgrade_verification.py,sha256=mLBKM7bVSp-Vgdhx1VqzSFHnjYN1ao_oOpUugwTK8r0,7589
+sycommon/tests/test_upgrade_verification.py,sha256=HS0KQ1q-Djolf1Km2xMFNKtoUHKLNLjacTHv_Wh5O8Y,7589
 sycommon/tools/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 sycommon/tools/async_utils.py,sha256=e2Bp8v0LDrnViBIZ3zcCWtm_01w67vG34VhnAyGu9ZM,1015
 sycommon/tools/docs.py,sha256=OPj2ETheuWjXLyaXtaZPbwmJKfJaYXV5s4XMVAUNrms,1607
@@ -335,8 +336,8 @@ sycommon/tools/timing.py,sha256=OiiE7P07lRoMzX9kzb8sZU9cDb0zNnqIlY5pWqHcnkY,2064
 sycommon/tools/user_id.py,sha256=o-zsubGSR5rSSZf8Pk8B7AhE21ahDTTIW5JZmJO6Flw,4761
 sycommon/xxljob/__init__.py,sha256=7eoBlQxv-B39IfRSCY2bkqdGYs1QRe1umAWd88VMEEM,86
 sycommon/xxljob/xxljob_service.py,sha256=1yifwIBNGsCIxLnQjHKiBlbsigc_zvPH-dMTZcNxe-Q,7649
-sycommon_python_lib-0.2.10a2.dist-info/METADATA,sha256=gM2vnr9a4QSKvGHKPwTF8h4Of6bbnOhO-f34BC91N5Q,8033
-sycommon_python_lib-0.2.10a2.dist-info/WHEEL,sha256=YVMoNqKzERt-wjUZwJ33xBGAwnFl-4cqbYkTtWa4itE,91
-sycommon_python_lib-0.2.10a2.dist-info/entry_points.txt,sha256=gsR4SssKxDWjRU8ggidzNcdMXDPRSKRS7UaGyNP84Qg,92
-sycommon_python_lib-0.2.10a2.dist-info/top_level.txt,sha256=RgphKrg7nJyZ7irJqbxFr-5H2LUYTvI7ivoWZH2hcD0,29
-sycommon_python_lib-0.2.10a2.dist-info/RECORD,,
+sycommon_python_lib-0.2.10a4.dist-info/METADATA,sha256=LEDBGdzj5bGZDBhJBAJ0w7v0IeSMsw9MQJsoxrXYCKM,8033
+sycommon_python_lib-0.2.10a4.dist-info/WHEEL,sha256=YVMoNqKzERt-wjUZwJ33xBGAwnFl-4cqbYkTtWa4itE,91
+sycommon_python_lib-0.2.10a4.dist-info/entry_points.txt,sha256=gsR4SssKxDWjRU8ggidzNcdMXDPRSKRS7UaGyNP84Qg,92
+sycommon_python_lib-0.2.10a4.dist-info/top_level.txt,sha256=RgphKrg7nJyZ7irJqbxFr-5H2LUYTvI7ivoWZH2hcD0,29
+sycommon_python_lib-0.2.10a4.dist-info/RECORD,,