tina-python 0.6.6__tar.gz → 0.6.7__tar.gz

{tina_python-0.6.6/tina_python.egg-info → tina_python-0.6.7}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: tina-python
-Version: 0.6.6
+Version: 0.6.7
 Summary: tina is in your computer!
 Home-page: https://gitee.com/wang-churi/tina
 Author: 王出日
@@ -20,14 +20,14 @@ Requires-Dist: python-dotenv
 Provides-Extra: tui
 Requires-Dist: textual>=0.80; extra == "tui"
 Provides-Extra: mcp
-Requires-Dist: mcp; extra == "mcp"
+Requires-Dist: mcp>=2.0; extra == "mcp"
 Provides-Extra: test
 Requires-Dist: pytest>=9.0; extra == "test"
 Requires-Dist: pytest-asyncio>=1.4; extra == "test"
 Requires-Dist: pytest-cov>=7.0; extra == "test"
 Provides-Extra: all
 Requires-Dist: textual>=0.80; extra == "all"
-Requires-Dist: mcp; extra == "all"
+Requires-Dist: mcp>=2.0; extra == "all"
 Dynamic: author
 Dynamic: home-page
 Dynamic: license-file
@@ -716,23 +716,31 @@ mcp = MCPClient()
 # 添加 stdio 类型 MCP 服务
 mcp.add_server(
     server_id="playwright",
-    config={
-        "type": "stdio",
-        "command": "npx",
-        "args": ["@playwright/mcp@latest"]
-    }
+    type="stdio",
+    command="npx",
+    args=["@playwright/mcp@latest"],
 )
 
-# 添加 SSE 类型 MCP 服务
+# 添加 Streamable HTTP 类型 MCP 服务（推荐，取代旧 SSE）
 mcp.add_server(
     server_id="my-service",
-    config={
-        "type": "sse",
-        "url": "http://localhost:8080/sse"
-    }
+    type="http",  # 也支持 streamable_http / streamableHttp
+    url="http://localhost:8080/mcp",
+    headers={"Authorization": "Bearer YOUR_API_KEY"},  # 可选
+)
+
+# 添加 SSE 类型 MCP 服务（旧传输，仍兼容）
+mcp.add_server(
+    server_id="my-legacy-service",
+    type="sse",
+    url="http://localhost:8080/sse",
+    headers={"Authorization": "Bearer YOUR_API_KEY"},  # 可选
 )
 ```
 
+> `type` 为必填项，用于区分传输类型；`command`/`args`/`env` 与 `url`/`headers`
+> 分别对应 stdio 与远程类型，编辑器会根据 `type` 给出对应的参数提示。
+
 ### 4.3 在 Agent 中使用 MCP
 
 ```python
@@ -743,11 +751,9 @@ from tina.mcp import MCPClient
 mcp = MCPClient()
 mcp.add_server(
     server_id="playwright",
-    config={
-        "type": "stdio",
-        "command": "npx",
-        "args": ["@playwright/mcp@latest"]
-    }
+    type="stdio",
+    command="npx",
+    args=["@playwright/mcp@latest"],
 )
 
 llm = BaseAPI()
@@ -768,8 +774,8 @@ for chunk in result:
 ### 4.4 MCP 服务管理
 
 ```python
-# 添加服务
-agent.add_mcp_server("server_id", config)
+# 添加服务（参数与 MCPClient.add_server 一致）
+agent.add_mcp_server("server_id", type="http", url="http://localhost:8080/mcp")
 
 # 移除服务
 agent.remove_mcp_server("server_id")

{tina_python-0.6.6 → tina_python-0.6.7}/README.md

@@ -681,23 +681,31 @@ mcp = MCPClient()
 # 添加 stdio 类型 MCP 服务
 mcp.add_server(
     server_id="playwright",
-    config={
-        "type": "stdio",
-        "command": "npx",
-        "args": ["@playwright/mcp@latest"]
-    }
+    type="stdio",
+    command="npx",
+    args=["@playwright/mcp@latest"],
 )
 
-# 添加 SSE 类型 MCP 服务
+# 添加 Streamable HTTP 类型 MCP 服务（推荐，取代旧 SSE）
 mcp.add_server(
     server_id="my-service",
-    config={
-        "type": "sse",
-        "url": "http://localhost:8080/sse"
-    }
+    type="http",  # 也支持 streamable_http / streamableHttp
+    url="http://localhost:8080/mcp",
+    headers={"Authorization": "Bearer YOUR_API_KEY"},  # 可选
+)
+
+# 添加 SSE 类型 MCP 服务（旧传输，仍兼容）
+mcp.add_server(
+    server_id="my-legacy-service",
+    type="sse",
+    url="http://localhost:8080/sse",
+    headers={"Authorization": "Bearer YOUR_API_KEY"},  # 可选
 )
 ```
 
+> `type` 为必填项，用于区分传输类型；`command`/`args`/`env` 与 `url`/`headers`
+> 分别对应 stdio 与远程类型，编辑器会根据 `type` 给出对应的参数提示。
+
 ### 4.3 在 Agent 中使用 MCP
 
 ```python
@@ -708,11 +716,9 @@ from tina.mcp import MCPClient
 mcp = MCPClient()
 mcp.add_server(
     server_id="playwright",
-    config={
-        "type": "stdio",
-        "command": "npx",
-        "args": ["@playwright/mcp@latest"]
-    }
+    type="stdio",
+    command="npx",
+    args=["@playwright/mcp@latest"],
 )
 
 llm = BaseAPI()
@@ -733,8 +739,8 @@ for chunk in result:
 ### 4.4 MCP 服务管理
 
 ```python
-# 添加服务
-agent.add_mcp_server("server_id", config)
+# 添加服务（参数与 MCPClient.add_server 一致）
+agent.add_mcp_server("server_id", type="http", url="http://localhost:8080/mcp")
 
 # 移除服务
 agent.remove_mcp_server("server_id")

{tina_python-0.6.6 → tina_python-0.6.7}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "tina-python"
-version = "0.6.6"
+version = "0.6.7"
 description = "tina is in your computer!"
 readme = { file = "README.md", content-type = "text/markdown" }
 requires-python = ">=3.10"
@@ -32,7 +32,7 @@ tui = [
     "textual>=0.80",
 ]
 mcp = [
-    "mcp",
+    "mcp>=2.0",
 ]
 test = [
     "pytest>=9.0",
@@ -41,7 +41,7 @@ test = [
 ]
 all = [
     "textual>=0.80",
-    "mcp",
+    "mcp>=2.0",
 ]
 
 [tool.pytest.ini_options]

{tina_python-0.6.6 → tina_python-0.6.7}/setup.py

@@ -2,7 +2,7 @@ from setuptools import setup, find_packages
 
 setup(
     name="tina-python",
-    version="0.6.6",
+    version="0.6.7",
     packages=find_packages(),
     package_data={"tina": ["py.typed"]},
     install_requires=["httpx", "python-dotenv"],

{tina_python-0.6.6 → tina_python-0.6.7}/tina/__init__.py

@@ -19,4 +19,4 @@ __all__ = [
     "AgentState",
     "AgentEvents",
 ]
-__version__ = "0.6.6"
+__version__ = "0.6.7"

{tina_python-0.6.6 → tina_python-0.6.7}/tina/agent/agent.py

@@ -10,7 +10,17 @@ Agent类：基础智能体类，默认支持API调用
 from __future__ import annotations
 
 import re
-from typing import List, Literal, Union, Generator, Dict, Any, AsyncGenerator, overload
+from typing import (
+    List,
+    Literal,
+    Union,
+    Generator,
+    Dict,
+    Any,
+    Optional,
+    AsyncGenerator,
+    overload,
+)
 
 from tina.agent.core.agent_response import AgentResponse, ToolCall
 from tina.agent.core.state import AgentState
@@ -18,7 +28,7 @@ from tina.agent.core.state import AgentState
 from ..llm.base_api import BaseAPI
 from .core.tools import Tools
 from .core.keyword_actions import KeywordActions
-from ..mcp.client import MCPClient
+from ..mcp.client import MCPClient, RemoteType, StdioType
 from .core.prompt import Prompt
 from .core.context_manager import ContextManager
 from .core.agent_runtime import ToolCallingAgentRuntime, BaseAgentRuntime
@@ -466,19 +476,69 @@ class Agent:
     def get_tools_call(self) -> list:
         return self.context_manager.get_tool_calls()
 
+    @overload
+    def add_mcp_server(
+        self,
+        server_id: str,
+        *,
+        type: StdioType,
+        command: str,
+        args: Optional[List[str]] = None,
+        env: Optional[Dict[str, str]] = None,
+        max_retries: int = 3,
+        timeout: int = 90,
+    ) -> bool: ...
+
+    @overload
     def add_mcp_server(
-        self, server_id: str, config: Dict[str, Any], max_retries=3, timeout=90
+        self,
+        server_id: str,
+        *,
+        type: RemoteType,
+        url: str,
+        headers: Optional[Dict[str, str]] = None,
+        max_retries: int = 3,
+        timeout: int = 90,
+    ) -> bool: ...
+
+    def add_mcp_server(
+        self,
+        server_id: str,
+        *,
+        type: str,
+        command: Optional[str] = None,
+        args: Optional[List[str]] = None,
+        env: Optional[Dict[str, str]] = None,
+        url: Optional[str] = None,
+        headers: Optional[Dict[str, str]] = None,
+        max_retries: int = 3,
+        timeout: int = 90,
     ) -> bool:
         """
         添加MCP服务器
         Args:
             server_id:服务器ID
-            config:服务器配置
+            type:传输类型（`stdio` / `sse` / `http`）
+            command:`stdio` 类型的启动命令
+            args:`stdio` 类型的命令参数
+            env:`stdio` 类型的环境变量
+            url:`sse` / `http` 类型的服务地址
+            headers:`sse` / `http` 类型的请求头
             max_retries:最大重试次数
             timeout:超时时间
         """
         if self.mcp_client is not None:
-            return self.mcp_client.add_server(server_id, config, max_retries, timeout)
+            return self.mcp_client.add_server(
+                server_id,
+                type=type,
+                command=command,
+                args=args,
+                env=env,
+                url=url,
+                headers=headers,
+                max_retries=max_retries,
+                timeout=timeout,
+            )
         else:
             raise ValueError("MCP客户端未初始化，请先初始化MCP客户端")
 

{tina_python-0.6.6 → tina_python-0.6.7}/tina/mcp/client.py

@@ -3,7 +3,16 @@ import concurrent.futures
 import json
 import uuid
 import threading
-from typing import Dict, List, Any, Optional, Union, Tuple
+from typing import (
+    Dict,
+    List,
+    Any,
+    Optional,
+    Union,
+    Tuple,
+    Literal,
+    overload,
+)
 from contextlib import AsyncExitStack
 from datetime import datetime
 from ..core import logger  # 假设你有统一的logger
@@ -12,12 +21,78 @@ try:
     from mcp import ClientSession, StdioServerParameters
     from mcp.client.stdio import stdio_client
     from mcp.client.sse import sse_client
+    from mcp.client.streamable_http import (
+        streamable_http_client,
+        create_mcp_http_client,
+    )
 
     MCP_AVAILABLE = True
 except ImportError:
     MCP_AVAILABLE = False
 
 
+# 远程传输类型别名：Streamable HTTP 在不同客户端里叫法不一，这里统一归一化。
+# 官方新规范为 Streamable HTTP，`sse` 为旧版（已废弃）传输。
+_REMOTE_TYPE_ALIASES = {
+    "sse": "sse",
+    "http": "http",
+    "https": "http",
+    "streamable_http": "http",
+    "streamablehttp": "http",
+    "streamable-http": "http",
+}
+
+
+def _normalize_server_type(server_type: str) -> str:
+    return _REMOTE_TYPE_ALIASES.get(str(server_type).lower(), str(server_type).lower())
+
+
+StdioType = Literal["stdio"]
+RemoteType = Literal[
+    "sse",
+    "http",
+    "https",
+    "streamable_http",
+    "streamableHttp",
+    "streamable-http",
+]
+
+
+def _build_server_config(
+    server_type: str,
+    *,
+    command: Optional[str] = None,
+    args: Optional[List[str]] = None,
+    env: Optional[Dict[str, str]] = None,
+    url: Optional[str] = None,
+    headers: Optional[Dict[str, str]] = None,
+) -> Dict[str, Any]:
+    """把扁平化参数组装为内部 config 字典，并做必要校验。"""
+    stype = _normalize_server_type(server_type)
+    if stype == "stdio":
+        if not command:
+            raise ValueError("stdio 类型必须提供 command 参数")
+        config: Dict[str, Any] = {
+            "type": "stdio",
+            "command": command,
+            "args": list(args) if args else [],
+        }
+        if env:
+            config["env"] = dict(env)
+        return config
+    if stype in ("sse", "http"):
+        if not url:
+            raise ValueError(f"{server_type} 类型必须提供 url 参数")
+        config = {"type": stype, "url": url}
+        if headers:
+            config["headers"] = dict(headers)
+        return config
+    raise ValueError(
+        f"Unsupported server type: {server_type} "
+        f"(supported: stdio, sse, http/streamable_http)"
+    )
+
+
 def _tool_input_schema(tool: Any) -> Dict[str, Any]:
     """获取 MCP 工具的输入 schema，兼容 SDK 的字段改名
 
@@ -143,7 +218,8 @@ class MCPClient:
         stack = AsyncExitStack()
         stop = asyncio.Event()
         try:
-            server_type = config.get("type", "").lower()
+            server_type = _normalize_server_type(config.get("type", ""))
+            headers = config.get("headers") or None
             if server_type == "stdio":
                 params = StdioServerParameters(
                     command=config["command"],
@@ -155,12 +231,28 @@ class MCPClient:
                     ClientSession(transport[0], transport[1])
                 )
             elif server_type == "sse":
-                transport = await stack.enter_async_context(sse_client(config["url"]))
+                transport = await stack.enter_async_context(
+                    sse_client(config["url"], headers=headers)
+                )
+                session = await stack.enter_async_context(
+                    ClientSession(transport[0], transport[1])
+                )
+            elif server_type == "http":
+                # Streamable HTTP：单端点，取代旧的 SSE 传输。
+                # headers 需通过预配置的 httpx 客户端传入；该客户端由 stack 负责关闭。
+                http_client = create_mcp_http_client(headers=headers)
+                await stack.enter_async_context(http_client)
+                transport = await stack.enter_async_context(
+                    streamable_http_client(config["url"], http_client=http_client)
+                )
                 session = await stack.enter_async_context(
                     ClientSession(transport[0], transport[1])
                 )
             else:
-                raise ValueError(f"Unsupported server type: {server_type}")
+                raise ValueError(
+                    f"Unsupported server type: {server_type} "
+                    f"(supported: stdio, sse, http/streamable_http)"
+                )
 
             await session.initialize()
             res = await session.list_tools()
@@ -191,14 +283,61 @@ class MCPClient:
 
     # --- 同步接口桥接 ---
 
+    @overload
     def add_server(
         self,
         server_id: str,
-        config: Dict[str, Any],
+        *,
+        type: StdioType,
+        command: str,
+        args: Optional[List[str]] = None,
+        env: Optional[Dict[str, str]] = None,
+        max_retries: int = 1,
+        timeout: int = 90,
+    ) -> bool: ...
+
+    @overload
+    def add_server(
+        self,
+        server_id: str,
+        *,
+        type: RemoteType,
+        url: str,
+        headers: Optional[Dict[str, str]] = None,
+        max_retries: int = 1,
+        timeout: int = 90,
+    ) -> bool: ...
+
+    def add_server(
+        self,
+        server_id: str,
+        *,
+        type: str,
+        command: Optional[str] = None,
+        args: Optional[List[str]] = None,
+        env: Optional[Dict[str, str]] = None,
+        url: Optional[str] = None,
+        headers: Optional[Dict[str, str]] = None,
         max_retries: int = 1,
         timeout: int = 90,
     ) -> bool:
-        """添加并连接一个 MCP 服务器，失败时按 max_retries 重试"""
+        """添加并连接一个 MCP 服务器，失败时按 max_retries 重试。
+
+        参数按传输类型扁平化：
+
+        - ``type="stdio"``：需要 ``command``，可选 ``args`` / ``env``。
+        - ``type="http"``（或 ``streamable_http`` 等别名）/ ``type="sse"``：
+          需要 ``url``，可选 ``headers``。
+        """
+        config = _build_server_config(
+            type,
+            command=command,
+            args=args,
+            env=env,
+            url=url,
+            headers=headers,
+        )
+
         with self._lock:
             if server_id in self.servers:
                 return True

{tina_python-0.6.6 → tina_python-0.6.7}/tina/utils/tui/tui.py

@@ -498,9 +498,10 @@ class TinaTUI(App):
 
     # 渲染泵间隔：界面更新与滚动统一在这里做，与 chunk 速率解耦
     PUMP_INTERVAL = 0.1
-    # 流式块重渲染的最小间隔（秒），内容越长间隔越大，避免 O(n²) 重解析
-    RENDER_INTERVAL = 0.08
-    RENDER_INTERVAL_MAX = 0.5
+    # 流式块重渲染的最小间隔（秒）。采用增量 append 后，开销与新增内容成正比，
+    # 因此只需轻微随长度放宽，长文本也能保持较顺滑的刷新。
+    RENDER_INTERVAL = 0.06
+    RENDER_INTERVAL_MAX = 0.2
 
     # 确认框内联显示参数的上限，超过则只显示提示（按 Ctrl+O 查看完整参数）
     CONFIRM_INLINE_ARGS = 200
@@ -1149,7 +1150,7 @@ class TinaTUI(App):
                 collapsed=bool(block.metadata.get("collapsed", False)),
                 markup=bool(block.metadata.get("markup", False)),
             )
-        return Markdown("", classes="assistant-message")
+        return Markdown(classes="assistant-message")
 
     def _ensure_widget(self, block: TuiBlock) -> Any:
         widget = self._widgets.get(block.id)
@@ -1160,15 +1161,31 @@ class TinaTUI(App):
             self._messages_widget().mount(widget)
         return widget
 
+    def _render_markdown(self, widget: Markdown, content: str) -> Any:
+        """增量渲染助手 Markdown：只解析新增片段，避免整篇重解析。
+
+        `Markdown.update()` 每次都会整篇重解析并重建所有子块，流式输出时呈
+        O(n²) 开销，正文越长越卡。挂载完成后改用 `append()`，只解析新增片段，
+        开销与新增内容成正比。
+
+        注意：`_initial_markdown` 要始终保持为最新内容，供 `Markdown._on_mount`
+        首次渲染使用，避免挂载时用空串覆盖已写入的内容。
+        """
+        widget._initial_markdown = content
+        current = widget.source
+        if content == current:
+            return None  # 内容未变化，跳过昂贵的 Markdown 解析
+        if widget.is_mounted and content.startswith(current):
+            # 纯追加：append() 只解析新增部分
+            return widget.append(content[len(current):])
+        # 尚未挂载完成 或 内容被替换/回退：整篇刷新一次
+        return widget.update(content)
+
     def _apply_block(self, block: TuiBlock) -> Any:
         """把块更新到组件；Markdown 为异步渲染，返回可等待对象"""
         widget = self._ensure_widget(block)
         if isinstance(widget, Markdown):
-            # Markdown.update() 异步全量重解析，必须在渲染泵里按节流调用。
-            # Textual 挂载时会用 _initial_markdown 再渲染一次，这里同步成最新内容，
-            # 避免它用空串覆盖已流式写入的内容。
-            widget._initial_markdown = block.content
-            return widget.update(block.content)
+            return self._render_markdown(widget, block.content)
         if isinstance(widget, (ReasoningBlock, ToolBlock, ResultBlock)):
             widget.set_block(block)
         elif block.role in ("user", "error", "system"):
@@ -1178,10 +1195,10 @@ class TinaTUI(App):
         return None
 
     def _should_render(self, block_id: int, length: int = 0) -> bool:
-        """流式节流：内容越长间隔越大，避免反复全量重解析"""
+        """流式节流：增量 append 足够便宜，仅轻微随长度放宽间隔"""
         now = time.monotonic()
         interval = min(
-            self.RENDER_INTERVAL_MAX, self.RENDER_INTERVAL + length / 20000
+            self.RENDER_INTERVAL_MAX, self.RENDER_INTERVAL + length / 100000
         )
         last = self._last_render.get(block_id, 0.0)
         if now - last >= interval:

{tina_python-0.6.6 → tina_python-0.6.7/tina_python.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: tina-python
-Version: 0.6.6
+Version: 0.6.7
 Summary: tina is in your computer!
 Home-page: https://gitee.com/wang-churi/tina
 Author: 王出日
@@ -20,14 +20,14 @@ Requires-Dist: python-dotenv
 Provides-Extra: tui
 Requires-Dist: textual>=0.80; extra == "tui"
 Provides-Extra: mcp
-Requires-Dist: mcp; extra == "mcp"
+Requires-Dist: mcp>=2.0; extra == "mcp"
 Provides-Extra: test
 Requires-Dist: pytest>=9.0; extra == "test"
 Requires-Dist: pytest-asyncio>=1.4; extra == "test"
 Requires-Dist: pytest-cov>=7.0; extra == "test"
 Provides-Extra: all
 Requires-Dist: textual>=0.80; extra == "all"
-Requires-Dist: mcp; extra == "all"
+Requires-Dist: mcp>=2.0; extra == "all"
 Dynamic: author
 Dynamic: home-page
 Dynamic: license-file
@@ -716,23 +716,31 @@ mcp = MCPClient()
 # 添加 stdio 类型 MCP 服务
 mcp.add_server(
     server_id="playwright",
-    config={
-        "type": "stdio",
-        "command": "npx",
-        "args": ["@playwright/mcp@latest"]
-    }
+    type="stdio",
+    command="npx",
+    args=["@playwright/mcp@latest"],
 )
 
-# 添加 SSE 类型 MCP 服务
+# 添加 Streamable HTTP 类型 MCP 服务（推荐，取代旧 SSE）
 mcp.add_server(
     server_id="my-service",
-    config={
-        "type": "sse",
-        "url": "http://localhost:8080/sse"
-    }
+    type="http",  # 也支持 streamable_http / streamableHttp
+    url="http://localhost:8080/mcp",
+    headers={"Authorization": "Bearer YOUR_API_KEY"},  # 可选
+)
+
+# 添加 SSE 类型 MCP 服务（旧传输，仍兼容）
+mcp.add_server(
+    server_id="my-legacy-service",
+    type="sse",
+    url="http://localhost:8080/sse",
+    headers={"Authorization": "Bearer YOUR_API_KEY"},  # 可选
 )
 ```
 
+> `type` 为必填项，用于区分传输类型；`command`/`args`/`env` 与 `url`/`headers`
+> 分别对应 stdio 与远程类型，编辑器会根据 `type` 给出对应的参数提示。
+
 ### 4.3 在 Agent 中使用 MCP
 
 ```python
@@ -743,11 +751,9 @@ from tina.mcp import MCPClient
 mcp = MCPClient()
 mcp.add_server(
     server_id="playwright",
-    config={
-        "type": "stdio",
-        "command": "npx",
-        "args": ["@playwright/mcp@latest"]
-    }
+    type="stdio",
+    command="npx",
+    args=["@playwright/mcp@latest"],
 )
 
 llm = BaseAPI()
@@ -768,8 +774,8 @@ for chunk in result:
 ### 4.4 MCP 服务管理
 
 ```python
-# 添加服务
-agent.add_mcp_server("server_id", config)
+# 添加服务（参数与 MCPClient.add_server 一致）
+agent.add_mcp_server("server_id", type="http", url="http://localhost:8080/mcp")
 
 # 移除服务
 agent.remove_mcp_server("server_id")

{tina_python-0.6.6 → tina_python-0.6.7}/tina_python.egg-info/requires.txt

@@ -3,10 +3,10 @@ python-dotenv
 
 [all]
 textual>=0.80
-mcp
+mcp>=2.0
 
 [mcp]
-mcp
+mcp>=2.0
 
 [test]
 pytest>=9.0