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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: tina-python
-Version: 0.6.5
+Version: 0.6.6
 Summary: tina is in your computer!
 Home-page: https://gitee.com/wang-churi/tina
 Author: 王出日
@@ -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)
 
 # 断开连接
@@ -889,8 +898,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 +1001,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.6}/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)
 
 # 断开连接
@@ -854,8 +863,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 +966,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.6}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "tina-python"
-version = "0.6.5"
+version = "0.6.6"
 description = "tina is in your computer!"
 readme = { file = "README.md", content-type = "text/markdown" }
 requires-python = ">=3.10"

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

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

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

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

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

@@ -30,6 +30,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:
@@ -269,17 +333,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.6/tina_python.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: tina-python
-Version: 0.6.5
+Version: 0.6.6
 Summary: tina is in your computer!
 Home-page: https://gitee.com/wang-churi/tina
 Author: 王出日
@@ -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)
 
 # 断开连接
@@ -889,8 +898,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 +1001,7 @@ run_agent_in_cli(agent)
 |------|------|
 | `#context` | 查看当前对话上下文（消息列表） |
 | `#clear` | 清屏 |
-| `#exit` | 退出（或直接输入 `exit` / `quit`） |
+| `exit` / `quit` | 退出对话（`#exit` 不支持，会被当作普通输入） |
 
 ### 6.4 多模态消息构建器 `build_multimodal_message`