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

{tina_python-0.6.5/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.5
+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
@@ -50,6 +50,12 @@ pip install tina-python
 # 如果需要使用 MCP（模型上下文协议）服务
 pip install tina-python[mcp]
 
+# 如果需要 TUI 终端界面
+pip install tina-python[tui]
+
+# 一次装齐所有可选功能（TUI + MCP）
+pip install tina-python[all]
+
 # 如果需要运行测试
 pip install tina-python[test]
 ```
@@ -211,8 +217,9 @@ result = await llm.apredict(
     stream=False
 )
 
-# 异步流式
-async for chunk in llm.apredict(input_text="讲个故事", stream=True):
+# 异步流式：先 await 拿到异步生成器
+result = await llm.apredict(input_text="讲个故事", stream=True)
+async for chunk in result:
     print(chunk["content"], end="")
 ```
 
@@ -242,8 +249,6 @@ async for chunk in llm.apredict(input_text="讲个故事", stream=True):
 {
     "role": "assistant",
     "content": "回复内容",
-    # 推理模型时会出现
-    "reasoning_content": "推理链...",
     # 有工具调用时会出现
     "tool_calls": [
         {
@@ -255,7 +260,8 @@ async for chunk in llm.apredict(input_text="讲个故事", stream=True):
     ]
 }
 
-# 流式：逐块返回，格式与非流式一致
+# 流式：逐块返回片段，工具调用以 tool_name / tool_arguments 片段给出；
+# 推理模型的思维链在 reasoning_content 中，末尾可能带有 usage
 ```
 
 ### 1.8 获取可用模型列表
@@ -392,9 +398,12 @@ tool_calls = [
         }
     }
 ]
-results = tools.execute(tool_calls)
+# execute 需要事件对象（Agent 内部会自动传入）
+from tina import AgentEvents
+
+results = tools.execute(tool_calls, events=AgentEvents())
 # [
-#   {"role": "tool", "tool_call_id": "call_123", "name": "get_weather", "content": "北京今天天气晴朗"}
+#   {"role": "tool", "tool_call_id": "call_123", "tool_name": "get_weather", "content": "北京今天天气晴朗"}
 # ]
 ```
 
@@ -542,7 +551,7 @@ elif agent.state == AgentState.ERROR:
 # 获取消息列表
 messages = agent.get_messages()
 
-# 清空消息（保留系统提示词）
+# 清空全部消息（含系统提示词，之后需重新 set_system_prompt）
 agent.clear_messages()
 
 # 获取系统提示词
@@ -630,7 +639,7 @@ def on_turn_end():
 agent_a = Agent(llm=llm, tools=tools, name="agent_a")
 agent_b = Agent(llm=llm, tools=tools, name="agent_b")
 
-# 连接：共享消息列表
+# 关联另一个 Agent（记录到 other_agents，目前不会自动共享消息列表）
 agent_a.connect_agent(agent_b)
 
 # 断开连接
@@ -707,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
@@ -734,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()
@@ -759,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")
@@ -889,8 +904,8 @@ from tina import Agent, Tools
 from tina.llm import BaseAPI
 from tina.utils.system_tools import system_tools
 
-tools = Tools()
-tools += system_tools  # 添加 tina 自带的系统工具包
+tools = Tools(name="my_tools")
+tools += system_tools  # 添加 tina 自带的系统工具包（工具集需命名）
 
 agent = Agent(
     llm=BaseAPI(),
@@ -992,7 +1007,7 @@ run_agent_in_cli(agent)
 |------|------|
 | `#context` | 查看当前对话上下文（消息列表） |
 | `#clear` | 清屏 |
-| `#exit` | 退出（或直接输入 `exit` / `quit`） |
+| `exit` / `quit` | 退出对话（`#exit` 不支持，会被当作普通输入） |
 
 ### 6.4 多模态消息构建器 `build_multimodal_message`
 

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

@@ -15,6 +15,12 @@ pip install tina-python
 # 如果需要使用 MCP（模型上下文协议）服务
 pip install tina-python[mcp]
 
+# 如果需要 TUI 终端界面
+pip install tina-python[tui]
+
+# 一次装齐所有可选功能（TUI + MCP）
+pip install tina-python[all]
+
 # 如果需要运行测试
 pip install tina-python[test]
 ```
@@ -176,8 +182,9 @@ result = await llm.apredict(
     stream=False
 )
 
-# 异步流式
-async for chunk in llm.apredict(input_text="讲个故事", stream=True):
+# 异步流式：先 await 拿到异步生成器
+result = await llm.apredict(input_text="讲个故事", stream=True)
+async for chunk in result:
     print(chunk["content"], end="")
 ```
 
@@ -207,8 +214,6 @@ async for chunk in llm.apredict(input_text="讲个故事", stream=True):
 {
     "role": "assistant",
     "content": "回复内容",
-    # 推理模型时会出现
-    "reasoning_content": "推理链...",
     # 有工具调用时会出现
     "tool_calls": [
         {
@@ -220,7 +225,8 @@ async for chunk in llm.apredict(input_text="讲个故事", stream=True):
     ]
 }
 
-# 流式：逐块返回，格式与非流式一致
+# 流式：逐块返回片段，工具调用以 tool_name / tool_arguments 片段给出；
+# 推理模型的思维链在 reasoning_content 中，末尾可能带有 usage
 ```
 
 ### 1.8 获取可用模型列表
@@ -357,9 +363,12 @@ tool_calls = [
         }
     }
 ]
-results = tools.execute(tool_calls)
+# execute 需要事件对象（Agent 内部会自动传入）
+from tina import AgentEvents
+
+results = tools.execute(tool_calls, events=AgentEvents())
 # [
-#   {"role": "tool", "tool_call_id": "call_123", "name": "get_weather", "content": "北京今天天气晴朗"}
+#   {"role": "tool", "tool_call_id": "call_123", "tool_name": "get_weather", "content": "北京今天天气晴朗"}
 # ]
 ```
 
@@ -507,7 +516,7 @@ elif agent.state == AgentState.ERROR:
 # 获取消息列表
 messages = agent.get_messages()
 
-# 清空消息（保留系统提示词）
+# 清空全部消息（含系统提示词，之后需重新 set_system_prompt）
 agent.clear_messages()
 
 # 获取系统提示词
@@ -595,7 +604,7 @@ def on_turn_end():
 agent_a = Agent(llm=llm, tools=tools, name="agent_a")
 agent_b = Agent(llm=llm, tools=tools, name="agent_b")
 
-# 连接：共享消息列表
+# 关联另一个 Agent（记录到 other_agents，目前不会自动共享消息列表）
 agent_a.connect_agent(agent_b)
 
 # 断开连接
@@ -672,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
@@ -699,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()
@@ -724,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")
@@ -854,8 +869,8 @@ from tina import Agent, Tools
 from tina.llm import BaseAPI
 from tina.utils.system_tools import system_tools
 
-tools = Tools()
-tools += system_tools  # 添加 tina 自带的系统工具包
+tools = Tools(name="my_tools")
+tools += system_tools  # 添加 tina 自带的系统工具包（工具集需命名）
 
 agent = Agent(
     llm=BaseAPI(),
@@ -957,7 +972,7 @@ run_agent_in_cli(agent)
 |------|------|
 | `#context` | 查看当前对话上下文（消息列表） |
 | `#clear` | 清屏 |
-| `#exit` | 退出（或直接输入 `exit` / `quit`） |
+| `exit` / `quit` | 退出对话（`#exit` 不支持，会被当作普通输入） |
 
 ### 6.4 多模态消息构建器 `build_multimodal_message`
 

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

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "tina-python"
-version = "0.6.5"
+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.5 → tina_python-0.6.7}/setup.py

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

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

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

{tina_python-0.6.5 → 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.5 → 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 的字段改名
 
@@ -30,6 +105,70 @@ def _tool_input_schema(tool: Any) -> Dict[str, Any]:
     return schema or {}
 
 
+def _normalize_property(prop: Any) -> Dict[str, Any]:
+    """将单个 MCP 属性 schema 归一化为 Tina/大模型友好的形式。
+
+    修复原先只保留 `type` 且缺省退化为 Python 类型名 ``"str"`` 的问题：
+    - 缺少顶层 `type` 时，从 enum / anyOf 推断，最后回退为 JSON Schema 的
+      ``"string"``，不再输出 ``"str"``；
+    - 保留 `enum` 等约束信息，避免模型失去取值范围；
+    - 将带 null 的 `anyOf`/`oneOf` 及 ``["string", "null"]`` 形式的 type
+      压平为 `type` + `nullable`，提升对不支持联合类型的模型兼容性。
+    """
+    prop = dict(prop) if isinstance(prop, dict) else {}
+    description = prop.get("description", "")
+
+    # 压平 nullable 联合类型（例如 zod 的 z.enum([...]).nullable()）
+    variants = prop.get("anyOf") or prop.get("oneOf")
+    if isinstance(variants, list):
+        non_null = [
+            v for v in variants if isinstance(v, dict) and v.get("type") != "null"
+        ]
+        has_null = any(
+            isinstance(v, dict) and v.get("type") == "null" for v in variants
+        )
+        if len(non_null) == 1 and has_null:
+            merged = dict(non_null[0])
+            merged.setdefault("description", description)
+            merged["nullable"] = True
+            return _normalize_property(merged)
+
+    # 压平 type 为数组的形式，如 ["string", "null"]
+    raw_type = prop.get("type")
+    if isinstance(raw_type, list):
+        types = [t for t in raw_type if t != "null"]
+        prop["nullable"] = prop.get("nullable", "null" in raw_type)
+        if len(types) == 1:
+            prop["type"] = types[0]
+        else:
+            prop.pop("type", None)
+
+    # 缺少 type 时从 enum 推断，否则回退 "string"（而非 Python 的 "str"）
+    if "type" not in prop:
+        values = prop.get("enum")
+        if isinstance(values, list) and values:
+            if all(isinstance(v, str) for v in values):
+                prop["type"] = "string"
+            elif all(
+                isinstance(v, (int, float)) and not isinstance(v, bool)
+                for v in values
+            ):
+                prop["type"] = "number"
+        elif not (
+            prop.get("anyOf") or prop.get("oneOf") or prop.get("$ref")
+        ):
+            prop["type"] = "string"
+
+    prop["description"] = description
+    return prop
+
+
+def _convert_input_schema(schema: Dict[str, Any]) -> Dict[str, Any]:
+    """将 MCP 工具的 input schema.properties 转为 Tina 工具参数格式"""
+    properties = schema.get("properties", {}) or {}
+    return {name: _normalize_property(prop) for name, prop in properties.items()}
+
+
 class MCPClient:
     def __init__(self):
         if not MCP_AVAILABLE:
@@ -79,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"],
@@ -91,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()
@@ -127,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
@@ -269,17 +472,10 @@ class MCPClient:
                     # 注意：Tina Tools 内部可能还会根据包名加一层前缀
                     # 这里的 register_no_function 保持你习惯的格式
                     schema = _tool_input_schema(tool)
-                    properties = schema.get("properties", {}) or {}
                     tina_tools.register_no_function(
                         name=f"{sid}_{tool.name}",  # 外部包名是mcp，内部就是 mcp_sid_name
                         description=f"[MCP:{sid}] {tool.description}",
-                        parameters={
-                            k: {
-                                "type": v.get("type", "str"),
-                                "description": v.get("description", ""),
-                            }
-                            for k, v in properties.items()
-                        },
+                        parameters=_convert_input_schema(schema),
                         required_parameters=schema.get("required", []) or [],
                     )
         return tina_tools

{tina_python-0.6.5 → 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.5 → 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.5
+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
@@ -50,6 +50,12 @@ pip install tina-python
 # 如果需要使用 MCP（模型上下文协议）服务
 pip install tina-python[mcp]
 
+# 如果需要 TUI 终端界面
+pip install tina-python[tui]
+
+# 一次装齐所有可选功能（TUI + MCP）
+pip install tina-python[all]
+
 # 如果需要运行测试
 pip install tina-python[test]
 ```
@@ -211,8 +217,9 @@ result = await llm.apredict(
     stream=False
 )
 
-# 异步流式
-async for chunk in llm.apredict(input_text="讲个故事", stream=True):
+# 异步流式：先 await 拿到异步生成器
+result = await llm.apredict(input_text="讲个故事", stream=True)
+async for chunk in result:
     print(chunk["content"], end="")
 ```
 
@@ -242,8 +249,6 @@ async for chunk in llm.apredict(input_text="讲个故事", stream=True):
 {
     "role": "assistant",
     "content": "回复内容",
-    # 推理模型时会出现
-    "reasoning_content": "推理链...",
     # 有工具调用时会出现
     "tool_calls": [
         {
@@ -255,7 +260,8 @@ async for chunk in llm.apredict(input_text="讲个故事", stream=True):
     ]
 }
 
-# 流式：逐块返回，格式与非流式一致
+# 流式：逐块返回片段，工具调用以 tool_name / tool_arguments 片段给出；
+# 推理模型的思维链在 reasoning_content 中，末尾可能带有 usage
 ```
 
 ### 1.8 获取可用模型列表
@@ -392,9 +398,12 @@ tool_calls = [
         }
     }
 ]
-results = tools.execute(tool_calls)
+# execute 需要事件对象（Agent 内部会自动传入）
+from tina import AgentEvents
+
+results = tools.execute(tool_calls, events=AgentEvents())
 # [
-#   {"role": "tool", "tool_call_id": "call_123", "name": "get_weather", "content": "北京今天天气晴朗"}
+#   {"role": "tool", "tool_call_id": "call_123", "tool_name": "get_weather", "content": "北京今天天气晴朗"}
 # ]
 ```
 
@@ -542,7 +551,7 @@ elif agent.state == AgentState.ERROR:
 # 获取消息列表
 messages = agent.get_messages()
 
-# 清空消息（保留系统提示词）
+# 清空全部消息（含系统提示词，之后需重新 set_system_prompt）
 agent.clear_messages()
 
 # 获取系统提示词
@@ -630,7 +639,7 @@ def on_turn_end():
 agent_a = Agent(llm=llm, tools=tools, name="agent_a")
 agent_b = Agent(llm=llm, tools=tools, name="agent_b")
 
-# 连接：共享消息列表
+# 关联另一个 Agent（记录到 other_agents，目前不会自动共享消息列表）
 agent_a.connect_agent(agent_b)
 
 # 断开连接
@@ -707,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
@@ -734,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()
@@ -759,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")
@@ -889,8 +904,8 @@ from tina import Agent, Tools
 from tina.llm import BaseAPI
 from tina.utils.system_tools import system_tools
 
-tools = Tools()
-tools += system_tools  # 添加 tina 自带的系统工具包
+tools = Tools(name="my_tools")
+tools += system_tools  # 添加 tina 自带的系统工具包（工具集需命名）
 
 agent = Agent(
     llm=BaseAPI(),
@@ -992,7 +1007,7 @@ run_agent_in_cli(agent)
 |------|------|
 | `#context` | 查看当前对话上下文（消息列表） |
 | `#clear` | 清屏 |
-| `#exit` | 退出（或直接输入 `exit` / `quit`） |
+| `exit` / `quit` | 退出对话（`#exit` 不支持，会被当作普通输入） |
 
 ### 6.4 多模态消息构建器 `build_multimodal_message`
 

{tina_python-0.6.5 → 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