tamar-file-hub-client 0.0.1__py3-none-any.whl → 0.0.2__py3-none-any.whl

file_hub_client/rpc/sync_client.py

@@ -14,6 +14,9 @@ from typing import Optional, Dict, List, Tuple
 from ..enums import Role
 from ..errors import ConnectionError
 from ..schemas.context import UserContext, RequestContext, FullContext
+from ..utils.logging import get_logger, setup_logging
+from .interceptors import create_sync_interceptors
+import logging
 
 
 class SyncGrpcClient:
@@ -22,7 +25,7 @@ class SyncGrpcClient:
     def __init__(
             self,
             host: str = "localhost",
-            port: int = 50051,
+            port: Optional[int] = None,
             secure: bool = False,
             credentials: Optional[dict] = None,
             options: Optional[list] = None,
@@ -31,13 +34,15 @@ class SyncGrpcClient:
             default_metadata: Optional[Dict[str, str]] = None,
             user_context: Optional[UserContext] = None,
             request_context: Optional[RequestContext] = None,
+            enable_logging: bool = True,
+            log_level: str = "INFO",
     ):
         """
         初始化同步gRPC客户端
         
         Args:
-            host: 服务器地址
-            port: 服务器端口
+            host: 服务器地址（可以是域名或IP）
+            port: 服务器端口（可选，如果不指定则根据secure自动选择）
             secure: 是否使用安全连接（TLS）
             credentials: 认证凭据字典（如 {'api_key': 'xxx'}）
             options: gRPC通道选项
@@ -46,10 +51,19 @@ class SyncGrpcClient:
             default_metadata: 默认的元数据（如 org_id, user_id 等）
             user_context: 用户上下文
             request_context: 请求上下文
+            enable_logging: 是否启用日志记录
+            log_level: 日志级别
         """
         self.host = host
         self.port = port
-        self.address = f"{host}:{port}"
+        
+        # 构建地址：如果没有指定端口，则使用域名作为地址
+        if port is not None:
+            self.address = f"{host}:{port}"
+        else:
+            # 如果没有指定端口，直接使用host
+            # gRPC会自动根据secure选择默认端口（80/443）
+            self.address = host
         self.secure = secure
         self.credentials = credentials
         self.options = options or []
@@ -59,6 +73,20 @@ class SyncGrpcClient:
         self._channel: Optional[grpc.Channel] = None
         self._stubs = {}
         self._stub_lock = threading.Lock()
+        
+        # 日志配置
+        self.enable_logging = enable_logging
+        self.log_level = log_level
+        
+        # 只有在明确启用日志时才设置SDK日志
+        # 默认不设置，让用户自己控制
+        if enable_logging:
+            # 检查是否已经有处理器，避免重复设置
+            sdk_logger = get_logger()
+            if not sdk_logger.handlers:
+                setup_logging(level=log_level, enable_grpc_logging=True, use_json_format=True)
+        
+        self.logger = get_logger()
 
         # 上下文管理
         self._user_context = user_context
@@ -86,7 +114,7 @@ class SyncGrpcClient:
         return RequestContext(
             client_ip=client_ip,
             client_type="python-sdk",
-            client_version="1.0.0",  # TODO: 从包版本获取
+            client_version="1.0.0",
             user_agent=f"FileHubClient/1.0.0 Python/{platform.python_version()} {platform.system()}/{platform.release()}"
         )
 
@@ -126,6 +154,9 @@ class SyncGrpcClient:
 
                 channel_credentials = self._create_channel_credentials()
 
+                # 创建拦截器
+                interceptors = create_sync_interceptors() if self.enable_logging else []
+
                 if channel_credentials:
                     self._channel = grpc.secure_channel(
                         self.address,
@@ -137,6 +168,10 @@ class SyncGrpcClient:
                         self.address,
                         options=self.options
                     )
+                
+                # 如果有拦截器，需要包装channel
+                if interceptors:
+                    self._channel = grpc.intercept_channel(self._channel, *interceptors)
 
                 # 连接
                 try:
@@ -145,12 +180,41 @@ class SyncGrpcClient:
                     raise ConnectionError(f"连接超时：{self.address}")
 
                 # 连接成功
+                if self.enable_logging:
+                    log_record = logging.LogRecord(
+                        name=self.logger.name,
+                        level=logging.INFO,
+                        pathname="",
+                        lineno=0,
+                        msg=f"🔗 已连接到 gRPC 服务器",
+                        args=(),
+                        exc_info=None
+                    )
+                    log_record.log_type = "info"
+                    log_record.data = {"server": self.address}
+                    self.logger.handle(log_record)
                 return
 
             except Exception as e:
                 last_error = e
                 if attempt < self.retry_count - 1:
-                    print(f"连接失败 (尝试 {attempt + 1}/{self.retry_count}): {str(e)}")
+                    if self.enable_logging:
+                        log_record = logging.LogRecord(
+                            name=self.logger.name,
+                            level=logging.WARNING,
+                            pathname="",
+                            lineno=0,
+                            msg=f"⚠️ 连接失败，正在重试",
+                            args=(),
+                            exc_info=None
+                        )
+                        log_record.log_type = "info"
+                        log_record.data = {
+                            "attempt": attempt + 1,
+                            "max_attempts": self.retry_count,
+                            "error": str(e)
+                        }
+                        self.logger.handle(log_record)
                     if self._channel:
                         self._channel.close()
                         self._channel = None
@@ -168,6 +232,19 @@ class SyncGrpcClient:
     def close(self):
         """关闭连接"""
         if self._channel:
+            if self.enable_logging:
+                log_record = logging.LogRecord(
+                    name=self.logger.name,
+                    level=logging.INFO,
+                    pathname="",
+                    lineno=0,
+                    msg=f"👋 正在关闭 gRPC 连接",
+                    args=(),
+                    exc_info=None
+                )
+                log_record.log_type = "info"
+                log_record.data = {"server": self.address}
+                self.logger.handle(log_record)
             self._channel.close()
             self._channel = None
             self._stubs.clear()
@@ -191,11 +268,12 @@ class SyncGrpcClient:
                 self._stubs[stub_name] = stub_class(self._channel)
             return self._stubs[stub_name]
 
-    def build_metadata(self, **kwargs) -> List[Tuple[str, str]]:
+    def build_metadata(self, *, request_id: Optional[str] = None, **kwargs) -> List[Tuple[str, str]]:
         """
         构建请求元数据
         
         Args:
+            request_id: 显式指定的请求ID，如果提供则优先使用
             **kwargs: 要覆盖或添加的元数据
             
         Returns:
@@ -209,8 +287,12 @@ class SyncGrpcClient:
         # 添加/覆盖传入的元数据
         metadata.update(kwargs)
 
-        # 如果没有 request_id，自动生成一个
-        if 'x-request-id' not in metadata:
+        # 处理 request_id（优先级：显式传入 > metadata中的x-request-id > RequestContext > 自动生成）
+        if request_id is not None:
+            # 优先使用显式传入的 request_id
+            metadata['x-request-id'] = request_id
+        elif 'x-request-id' not in metadata:
+            # 如果没有显式传入且metadata中也没有，则尝试从RequestContext获取或自动生成
             metadata['x-request-id'] = (
                     self._request_context.extra.get("request_id") or str(uuid.uuid4())
             )

file_hub_client/schemas/__init__.py

@@ -20,6 +20,36 @@ from .context import (
     RequestContext,
     FullContext,
 )
+from .taple import (
+    Table,
+    Sheet,
+    Column,
+    Row,
+    Cell,
+    MergedCell,
+    TableView,
+    CellUpdate,
+    TableResponse,
+    SheetResponse,
+    ColumnResponse,
+    RowResponse,
+    CellResponse,
+    MergedCellResponse,
+    ViewResponse,
+    ListSheetsResponse,
+    ListColumnsResponse,
+    ListRowsResponse,
+    BatchCreateRowsResponse,
+    BatchUpdateCellsResponse,
+    GetCellsByRangeResponse,
+    ListMergedCellsResponse,
+    ListViewsResponse,
+    ImportTableDataResponse,
+    TableViewResponse,
+    BatchCreateTableViewResult,
+    BatchCreateTableViewsResponse,
+    ListTableViewsResponse,
+)
 
 __all__ = [
     # 文件相关
@@ -40,4 +70,34 @@ __all__ = [
     "UserContext",
     "RequestContext",
     "FullContext",
+
+    # Taple 相关
+    "Table",
+    "Sheet",
+    "Column",
+    "Row",
+    "Cell",
+    "MergedCell",
+    "TableView",
+    "CellUpdate",
+    "TableResponse",
+    "SheetResponse",
+    "ColumnResponse",
+    "RowResponse",
+    "CellResponse",
+    "MergedCellResponse",
+    "ViewResponse",
+    "ListSheetsResponse",
+    "ListColumnsResponse",
+    "ListRowsResponse",
+    "BatchCreateRowsResponse",
+    "BatchUpdateCellsResponse",
+    "GetCellsByRangeResponse",
+    "ListMergedCellsResponse",
+    "ListViewsResponse",
+    "ImportTableDataResponse",
+    "TableViewResponse",
+    "BatchCreateTableViewResult",
+    "BatchCreateTableViewsResponse",
+    "ListTableViewsResponse",
 ]

file_hub_client/schemas/taple.py

@@ -0,0 +1,413 @@
+"""
+Taple 相关数据模型
+"""
+from datetime import datetime
+from typing import Optional, List, Dict, Any
+from pydantic import BaseModel, Field
+
+
+class Table(BaseModel):
+    """表格信息模型"""
+    id: str = Field(..., description="表格ID")
+    file_id: str = Field(..., description="关联文件ID")
+    org_id: str = Field(..., description="组织ID")
+    user_id: str = Field(..., description="用户ID")
+    name: Optional[str] = Field(None, description="表格名称")
+    description: Optional[str] = Field(None, description="表格描述")
+    created_by_role: str = Field(..., description="创建者角色")
+    created_by: str = Field(..., description="创建者ID")
+    created_at: datetime = Field(..., description="创建时间")
+    updated_at: datetime = Field(..., description="更新时间")
+    deleted_at: Optional[datetime] = Field(None, description="删除时间")
+
+    class Config:
+        json_encoders = {
+            datetime: lambda v: v.isoformat()
+        }
+
+
+class Sheet(BaseModel):
+    """工作表信息模型"""
+    id: str = Field(..., description="工作表ID")
+    table_id: str = Field(..., description="所属表格ID")
+    org_id: str = Field(..., description="组织ID")
+    user_id: str = Field(..., description="用户ID")
+    name: str = Field(..., description="工作表名称")
+    description: Optional[str] = Field(None, description="工作表描述")
+    position: int = Field(..., description="工作表位置")
+    version: int = Field(..., description="版本号")
+    created_by_role: str = Field(..., description="创建者角色")
+    created_by: str = Field(..., description="创建者ID")
+    created_at: datetime = Field(..., description="创建时间")
+    updated_at: datetime = Field(..., description="更新时间")
+    deleted_at: Optional[datetime] = Field(None, description="删除时间")
+
+    class Config:
+        json_encoders = {
+            datetime: lambda v: v.isoformat()
+        }
+
+
+class Column(BaseModel):
+    """列信息模型"""
+    id: str = Field(..., description="列ID")
+    sheet_id: str = Field(..., description="所属工作表ID")
+    org_id: str = Field(..., description="组织ID")
+    user_id: str = Field(..., description="用户ID")
+    column_key: str = Field(..., description="列索引key")
+    name: str = Field(..., description="列名称")
+    column_type: str = Field(..., description="列数据类型")
+    description: Optional[str] = Field(None, description="列描述信息")
+    position: int = Field(..., description="列位置")
+    width: Optional[int] = Field(None, description="列宽度")
+    hidden: Optional[bool] = Field(None, description="是否隐藏")
+    properties: Optional[Dict[str, Any]] = Field(None, description="列属性")
+    version: int = Field(..., description="版本号")
+    created_by_role: str = Field(..., description="创建者角色")
+    created_by: str = Field(..., description="创建者ID")
+    created_at: datetime = Field(..., description="创建时间")
+    updated_at: datetime = Field(..., description="更新时间")
+    deleted_at: Optional[datetime] = Field(None, description="删除时间")
+
+    class Config:
+        json_encoders = {
+            datetime: lambda v: v.isoformat()
+        }
+
+
+class Row(BaseModel):
+    """行信息模型"""
+    id: str = Field(..., description="行ID")
+    sheet_id: str = Field(..., description="所属工作表ID")
+    org_id: str = Field(..., description="组织ID")
+    user_id: str = Field(..., description="用户ID")
+    row_key: str = Field(..., description="行索引key")
+    position: int = Field(..., description="行位置")
+    height: Optional[int] = Field(None, description="行高度")
+    hidden: Optional[bool] = Field(None, description="是否隐藏")
+    version: int = Field(..., description="版本号")
+    created_by_role: str = Field(..., description="创建者角色")
+    created_by: str = Field(..., description="创建者ID")
+    created_at: datetime = Field(..., description="创建时间")
+    updated_at: datetime = Field(..., description="更新时间")
+    deleted_at: Optional[datetime] = Field(None, description="删除时间")
+
+    class Config:
+        json_encoders = {
+            datetime: lambda v: v.isoformat()
+        }
+
+
+class Cell(BaseModel):
+    """单元格信息模型"""
+    id: str = Field(..., description="单元格ID")
+    sheet_id: str = Field(..., description="所属工作表ID")
+    column_id: str = Field(..., description="所属列ID")
+    row_id: str = Field(..., description="所属行ID")
+    org_id: str = Field(..., description="组织ID")
+    user_id: str = Field(..., description="用户ID")
+    column_key: str = Field(..., description="列索引key")
+    row_key: str = Field(..., description="行索引key")
+    raw_value: Optional[str] = Field(None, description="原始值")
+    formatted_value: Optional[str] = Field(None, description="格式化值")
+    formula: Optional[str] = Field(None, description="公式")
+    styles: Optional[Dict[str, Any]] = Field(None, description="样式")
+    data_type: Optional[str] = Field(None, description="数据类型")
+    version: int = Field(..., description="版本号")
+    created_by_role: str = Field(..., description="创建者角色")
+    created_by: str = Field(..., description="创建者ID")
+    created_at: datetime = Field(..., description="创建时间")
+    updated_at: datetime = Field(..., description="更新时间")
+    deleted_at: Optional[datetime] = Field(None, description="删除时间")
+
+    class Config:
+        json_encoders = {
+            datetime: lambda v: v.isoformat()
+        }
+
+
+class MergedCell(BaseModel):
+    """合并单元格信息模型"""
+    id: str = Field(..., description="合并单元格ID")
+    sheet_id: str = Field(..., description="所属工作表ID")
+    org_id: str = Field(..., description="组织ID")
+    user_id: str = Field(..., description="用户ID")
+    start_column_id: str = Field(..., description="起始列ID")
+    end_column_id: str = Field(..., description="结束列ID")
+    start_row_id: str = Field(..., description="起始行ID")
+    end_row_id: str = Field(..., description="结束行ID")
+    created_at: datetime = Field(..., description="创建时间")
+    updated_at: datetime = Field(..., description="更新时间")
+    deleted_at: Optional[datetime] = Field(None, description="删除时间")
+
+    class Config:
+        json_encoders = {
+            datetime: lambda v: v.isoformat()
+        }
+
+
+class TableView(BaseModel):
+    """表格视图信息模型"""
+    id: str = Field(..., description="视图ID")
+    table_id: str = Field(..., description="所属表格ID")
+    sheet_id: str = Field(..., description="所属工作表ID")
+    org_id: str = Field(..., description="组织ID")
+    user_id: str = Field(..., description="用户ID")
+    file_id: str = Field(..., description="关联文件ID")
+    
+    # 视图配置字段
+    filter_criteria: Optional[Dict[str, Any]] = Field(None, description="过滤条件（JSON）")
+    sort_criteria: Optional[Dict[str, Any]] = Field(None, description="排序条件（JSON）")
+    visible_columns: Optional[List[str]] = Field(None, description="可见列（列key数组）")
+    group_criteria: Optional[Dict[str, Any]] = Field(None, description="分组条件（JSON）")
+    
+    # 创建者信息
+    created_by_role: str = Field(..., description="创建者角色：user-用户；agent-智能体")
+    created_by: str = Field(..., description="创建者ID")
+    
+    # 视图基本信息
+    view_name: str = Field(..., description="视图名称")
+    view_type: str = Field(..., description="视图类型：table-表格视图; gantt-甘特图; calendar-日历视图等")
+    
+    # 视图状态
+    is_hidden: bool = Field(False, description="是否隐藏")
+    is_default: bool = Field(False, description="是否默认视图")
+    
+    # 扩展配置
+    config: Optional[Dict[str, Any]] = Field(None, description="视图扩展配置（JSON）")
+    
+    # 时间戳
+    created_at: datetime = Field(..., description="创建时间")
+    updated_at: datetime = Field(..., description="更新时间")
+    deleted_at: Optional[datetime] = Field(None, description="删除时间")
+
+    class Config:
+        json_encoders = {
+            datetime: lambda v: v.isoformat()
+        }
+
+
+# 请求和响应模型
+class CellUpdate(BaseModel):
+    """单元格更新模型"""
+    column_key: str = Field(..., description="列索引key")
+    row_key: str = Field(..., description="行索引key")
+    raw_value: Optional[str] = Field(None, description="原始值")
+    formula: Optional[str] = Field(None, description="公式")
+    styles: Optional[Dict[str, Any]] = Field(None, description="样式")
+
+
+# 响应模型
+class TableResponse(BaseModel):
+    """表格响应模型"""
+    table: Table = Field(..., description="表格信息")
+
+
+class SheetResponse(BaseModel):
+    """工作表响应模型"""
+    sheet: Sheet = Field(..., description="工作表信息")
+
+
+class ColumnResponse(BaseModel):
+    """列响应模型"""
+    column: Optional[Column] = Field(None, description="列信息")
+    current_version: Optional[int] = Field(None, description="当前版本号")
+    applied_immediately: Optional[bool] = Field(None, description="是否立即应用")
+
+
+class RowResponse(BaseModel):
+    """行响应模型"""
+    row: Optional[Row] = Field(None, description="行信息")
+    current_version: Optional[int] = Field(None, description="当前版本号")
+    applied_immediately: Optional[bool] = Field(None, description="是否立即应用")
+    success: Optional[bool] = Field(None, description="操作是否成功")
+    error_message: Optional[str] = Field(None, description="错误信息")
+    conflict_info: Optional['ConflictInfo'] = Field(None, description="冲突信息")
+
+
+class CellResponse(BaseModel):
+    """单元格响应模型"""
+    cell: Optional[Cell] = Field(None, description="单元格信息")
+    current_version: Optional[int] = Field(None, description="当前版本号")
+    applied_immediately: Optional[bool] = Field(None, description="是否立即应用")
+    success: Optional[bool] = Field(None, description="操作是否成功")
+    error_message: Optional[str] = Field(None, description="错误信息")
+    conflict_info: Optional['ConflictInfo'] = Field(None, description="冲突信息")
+
+
+class MergedCellResponse(BaseModel):
+    """合并单元格响应模型"""
+    merged_cell: MergedCell = Field(..., description="合并单元格信息")
+
+
+class ViewResponse(BaseModel):
+    """视图响应模型"""
+    view: TableView = Field(..., description="视图信息")
+
+
+# 列表响应模型
+class ListSheetsResponse(BaseModel):
+    """工作表列表响应模型"""
+    sheets: List[Sheet] = Field(..., description="工作表列表")
+
+
+class ListColumnsResponse(BaseModel):
+    """列列表响应模型"""
+    columns: List[Column] = Field(..., description="列列表")
+
+
+class ListRowsResponse(BaseModel):
+    """行列表响应模型"""
+    rows: List[Row] = Field(..., description="行列表")
+    total: int = Field(..., description="总数")
+
+
+class BatchCreateRowsResponse(BaseModel):
+    """批量创建行响应模型"""
+    rows: List[Row] = Field(..., description="创建的行列表")
+
+
+class BatchUpdateCellsResponse(BaseModel):
+    """批量更新单元格响应模型"""
+    cells: List[Cell] = Field(..., description="更新的单元格列表")
+
+
+class GetCellsByRangeResponse(BaseModel):
+    """按范围获取单元格响应模型"""
+    cells: List[Cell] = Field(..., description="单元格列表")
+
+
+class ListMergedCellsResponse(BaseModel):
+    """合并单元格列表响应模型"""
+    merged_cells: List[MergedCell] = Field(..., description="合并单元格列表")
+
+
+class ListViewsResponse(BaseModel):
+    """视图列表响应模型"""
+    views: List[TableView] = Field(..., description="视图列表")
+
+
+class GetSheetVersionResponse(BaseModel):
+    """获取工作表版本响应模型"""
+    sheet_id: str = Field(..., description="工作表ID")
+    version: int = Field(..., description="当前版本号")
+    metadata: Optional[Sheet] = Field(None, description="工作表元数据")
+
+
+class GetSheetDataResponse(BaseModel):
+    """获取工作表数据响应模型"""
+    sheet_id: str = Field(..., description="工作表ID")
+    version: int = Field(..., description="当前版本号")
+    metadata: Optional[Sheet] = Field(None, description="工作表元数据")
+    columns: List[Column] = Field(default_factory=list, description="列数据")
+    rows: List[Row] = Field(default_factory=list, description="行数据")
+    cells: List[Cell] = Field(default_factory=list, description="单元格数据")
+    last_updated: Optional[datetime] = Field(None, description="最后更新时间")
+
+    class Config:
+        json_encoders = {
+            datetime: lambda v: v.isoformat()
+        }
+
+
+class ConflictInfo(BaseModel):
+    """冲突信息模型"""
+    has_conflict: bool = Field(..., description="是否有冲突")
+    server_version: int = Field(..., description="服务器版本号")
+    conflict_type: str = Field(..., description="冲突类型")
+    conflicted_columns: List[str] = Field(default_factory=list, description="冲突的列")
+    resolution_suggestion: Optional[str] = Field(None, description="解决建议")
+
+
+class BatchEditSheetResponse(BaseModel):
+    """批量编辑工作表响应模型"""
+    success: bool = Field(..., description="是否成功")
+    batch_id: str = Field(..., description="批次ID")
+    current_version: int = Field(..., description="当前版本号")
+    results: List[Any] = Field(default_factory=list, description="操作结果")
+    error_message: Optional[str] = Field(None, description="错误信息")
+    conflict_info: Optional[ConflictInfo] = Field(None, description="冲突信息")
+
+
+class CloneTableDataResponse(BaseModel):
+    """克隆表格数据响应模型"""
+    success: bool = Field(..., description="是否成功")
+    new_table_id: str = Field(..., description="新创建的表格ID")
+    new_file_id: str = Field(..., description="新创建的文件ID")
+    sheets_cloned: int = Field(..., description="克隆的工作表数量")
+    cells_cloned: int = Field(..., description="克隆的单元格数量")
+    error_message: Optional[str] = Field(None, description="错误信息")
+    created_at: datetime = Field(..., description="创建时间")
+
+    class Config:
+        json_encoders = {
+            datetime: lambda v: v.isoformat()
+        }
+
+
+class ExportTableDataResponse(BaseModel):
+    """导出表格数据响应模型"""
+    success: bool = Field(..., description="是否成功")
+    export_id: str = Field(..., description="导出记录ID")
+    file_url: str = Field(..., description="GCS文件URL（内部使用）")
+    download_url: str = Field(..., description="下载链接（带签名的临时链接）")
+    file_size: int = Field(..., description="文件大小（字节）")
+    file_name: str = Field(..., description="导出的文件名")
+    format: str = Field(..., description="导出格式")  # Changed from 'ExportFormat' to str
+    sheets_exported: int = Field(..., description="导出的工作表数量")
+    error_message: Optional[str] = Field(None, description="错误信息")
+    created_at: datetime = Field(..., description="导出时间")
+    expires_at: datetime = Field(..., description="下载链接过期时间")
+
+    class Config:
+        json_encoders = {
+            datetime: lambda v: v.isoformat()
+        }
+
+
+
+
+class TableViewResponse(BaseModel):
+    """表格视图响应模型"""
+    view: TableView = Field(..., description="视图信息")
+
+
+class BatchCreateTableViewResult(BaseModel):
+    """批量创建表格视图结果模型"""
+    success: bool = Field(..., description="是否成功")
+    view: Optional[TableView] = Field(None, description="成功时返回创建的视图")
+    error_message: Optional[str] = Field(None, description="失败时的错误信息")
+    view_name: Optional[str] = Field(None, description="视图名称（用于标识是哪个视图）")
+
+
+class BatchCreateTableViewsResponse(BaseModel):
+    """批量创建表格视图响应模型"""
+    results: List[BatchCreateTableViewResult] = Field(default_factory=list, description="批量创建结果")
+    success_count: int = Field(..., description="成功创建的数量")
+    failed_count: int = Field(..., description="失败的数量")
+
+
+class ListTableViewsResponse(BaseModel):
+    """列出表格视图响应模型"""
+    views: List[TableView] = Field(default_factory=list, description="视图列表")
+    total_count: int = Field(..., description="总数量")
+
+
+class ImportTableDataResponse(BaseModel):
+    """导入表格数据响应模型"""
+    success: bool = Field(..., description="是否成功")
+    table_id: str = Field(..., description="导入的表格ID（新建或现有）")
+    file_id: Optional[str] = Field(None, description="创建的文件ID（如果创建了新表格）")
+    sheets_imported: int = Field(..., description="导入的工作表数量")
+    rows_imported: int = Field(..., description="导入的行数")
+    cells_imported: int = Field(..., description="导入的单元格数量")
+    sheet_results: List[Dict[str, Any]] = Field(default_factory=list, description="每个工作表的导入结果")
+    error_message: Optional[str] = Field(None, description="错误信息（如果失败）")
+    warnings: List[Dict[str, Any]] = Field(default_factory=list, description="警告信息")
+    created_at: datetime = Field(..., description="导入时间")
+    processing_time_ms: int = Field(..., description="处理时间（毫秒）")
+
+    class Config:
+        json_encoders = {
+            datetime: lambda v: v.isoformat()
+        }