tina-python 0.6.8__tar.gz → 0.7.1__tar.gz

{tina_python-0.6.8 → tina_python-0.7.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: tina-python
-Version: 0.6.8
+Version: 0.7.1
 Summary: tina is in your computer!
 Home-page: https://gitee.com/wang-churi/tina
 Author: 王出日
@@ -18,7 +18,9 @@ License-File: LICENSE
 Requires-Dist: httpx
 Requires-Dist: python-dotenv
 Provides-Extra: tui
-Requires-Dist: textual>=0.80; extra == "tui"
+Requires-Dist: tina-tui>=0.1.0; extra == "tui"
+Provides-Extra: multi-agent
+Requires-Dist: tina-multi-agent>=0.1.0; extra == "multi-agent"
 Provides-Extra: mcp
 Requires-Dist: mcp>=2.0; extra == "mcp"
 Provides-Extra: test
@@ -26,7 +28,8 @@ 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: tina-tui>=0.1.0; extra == "all"
+Requires-Dist: tina-multi-agent>=0.1.0; extra == "all"
 Requires-Dist: mcp>=2.0; extra == "all"
 Dynamic: author
 Dynamic: home-page
@@ -50,10 +53,13 @@ pip install tina-python
 # 如果需要使用 MCP（模型上下文协议）服务
 pip install tina-python[mcp]
 
-# 如果需要 TUI 终端界面
+# 如果需要 TUI 终端界面（独立发行包 tina-tui）
 pip install tina-python[tui]
 
-# 一次装齐所有可选功能（TUI + MCP）
+# 如果需要多 Agent 环境 + Web 调试控制台（独立发行包 tina-multi-agent）
+pip install tina-python[multi-agent]
+
+# 一次装齐所有可选功能（TUI + 多 Agent + MCP）
 pip install tina-python[all]
 
 # 如果需要运行测试
@@ -110,7 +116,7 @@ for chunk in result:
 - [四、MCP 支持 —— 模型上下文协议](#四mcp-支持--模型上下文协议)
 - [五、多模态支持](#五多模态支持)
 - [六、快速开发工具](#六快速开发工具)
-- [6.5 终端界面 TUI（可选扩展）](#65-终端界面-tui可选扩展)
+- [七、拓展包（可选）](#七拓展包可选)
 
 ---
 
@@ -138,7 +144,8 @@ tina 是一个轻量、模块化的 AI 智能体框架，专注于让开发者
 | **MCPClient** | MCP 集成 | 连接 MCP 服务器生态（stdio/SSE） |
 | **ContextManager** | 上下文管理 | 滚动窗口策略，自动截断 |
 | **AgentEvents** | 事件系统 | 贯穿 Agent 生命周期的回调钩子 |
-| **TUI（可选）** | 终端界面 | 测试你写的 Agent 的交互控制台，也可当作自己的 TUI 使用 |
+| **TUI（可选）** | 终端界面 | 独立包 `tina-tui`：测试 Agent 的交互控制台，也可当作自己的 TUI 使用 |
+| **多 Agent（可选）** | 多 Agent 环境 | 独立包 `tina-multi-agent`：消息总线 + Web 调试控制台 |
 
 ---
 
@@ -704,7 +711,7 @@ tina 支持通过 MCP（Model Context Protocol）连接外部工具生态。
 pip install tina-python[mcp]
 ```
 
-> 想一次装齐所有可选功能（TUI + MCP）：`pip install tina-python[all]`
+> 想一次装齐所有可选功能（TUI + 多 Agent + MCP）：`pip install tina-python[all]`
 
 ### 4.2 使用 MCP 客户端
 
@@ -1028,18 +1035,24 @@ print(message)
 # {"role": "user", "content": [{"type": "text", "text": "..."}, {"type": "image_url", ...}]}
 ```
 
-### 6.5 终端界面 TUI（可选扩展）
+---
+
+## 七、拓展包（可选）
 
-`tina` 自带一个基于 [Textual](https://textual.textualize.io/) 的终端界面。它的定位是**可选扩展**：方便你测试自己写的 Agent，也可以直接当作自己的 TUI 来用。核心不依赖它，需要额外安装：
+tina 核心保持轻量：终端界面与多 Agent 环境这两块较大的功能，拆成**独立发行包**，按需安装、独立更新与发布。主包内不再包含它们的实现（仅保留 `tina.utils.*` 兼容转发壳）。
+
+### 7.1 终端界面 TUI（`tina-tui`）
+
+终端界面由配套包 **`tina-tui`**（基于 [Textual](https://textual.textualize.io/)）提供，作为**可选扩展**单独发行：方便你测试自己写的 Agent，也可以直接当作自己的 TUI 来用。核心不依赖它，需要额外安装：
 
 ```bash
-pip install tina-python[tui]
+pip install tina-python[tui]   # 等价于安装 tina-tui
 ```
 
 ```python
 from tina import Agent, Tools
 from tina.llm import BaseAPI
-from tina.utils.tui import run_agent_in_tui
+from tina_tui import run_agent_in_tui
 
 agent = Agent(llm=BaseAPI(), tools=Tools())
 
@@ -1073,10 +1086,39 @@ run_agent_in_tui(agent, max_tokens=32000)
 
 快捷键：`Ctrl+↑/↓` 跳转消息、`Ctrl+Home/End` 首/末条、`Ctrl+R` 折叠思考、`Ctrl+T` 折叠工具与结果、`Ctrl+O` 查看完整工具参数、`Esc` 关闭弹窗/取消确认 / 打断本轮回复。
 
-> 界面是可选的：数据层 `TuiMessageStore`（渲染块列表）和 `TokenCounter`（token 计数）**不依赖 textual**，可以单独导入，用来接入你自己的界面。
+> 界面是可选的：数据层 `TuiMessageStore`（渲染块列表）和 `TokenCounter`（token 计数）在 `tina_tui` 里**不依赖 textual**，可以单独导入，用来接入你自己的界面。
 
 完整说明（安装、指令、快捷键、自建界面）见 [`docs/tui.md`](./docs/tui.md)。
 
+### 7.2 多 Agent 环境（`tina-multi-agent`）
+
+多 Agent 场景由独立发行包 **`tina-multi-agent`** 提供：把多个各自独立的 `Agent`（含 `MultimodalAgent`）注册进一个「环境」，通过消息总线互相通信，并带一个 Web 调试控制台用于观测与介入。
+
+```bash
+pip install tina-python[multi-agent]   # 等价于安装 tina-multi-agent
+```
+
+```python
+from tina import Agent
+from tina.llm import BaseAPI
+from tina_multi_agent import MultiAgentEnvironment, MultiAgentWeb
+
+llm = BaseAPI()
+
+env = MultiAgentEnvironment(name="room")
+env.add_agent(Agent(llm=llm, name="alice", system_prompt="你是 alice"))
+env.add_agent(Agent(llm=llm, name="bob", system_prompt="你是 bob"))
+
+# 带 Web 控制台启动（自动启动环境）：打开 http://127.0.0.1:7077
+MultiAgentWeb(env, port=7077).run()
+```
+
+- 每个 Agent 一个收信队列；外部指令走 `add_user_message`，同伴消息作为带 `name` 的 assistant 消息注入。
+- 支持**回合中途注入**（`before_llm_call`）、打断（`env.interrupt`）、工具确认与权限表。
+- Web 控制台能力、消息总线、`POST /instruction`、`WS /ws` 事件等完整说明见 [`packages/tina-multi-agent/README.md`](./packages/tina-multi-agent/README.md)。
+
+> 兼容提示：旧路径 `tina.utils.multi_agent` 仍可用（主包内保留转发壳）；未安装 `tina-multi-agent` 时会提示安装。
+
 ---
 
 ## 附录
@@ -1098,7 +1140,8 @@ MAX_INPUT=8000
 |------|------|
 | 核心功能 | `httpx`, `python-dotenv` |
 | MCP 支持 | `mcp` |
-| TUI 界面（可选） | `textual` |
+| TUI 界面（可选，`tina-tui`） | `textual` |
+| 多 Agent（可选，`tina-multi-agent`） | `fastapi`, `uvicorn`, `websockets` |
 | 测试 | `pytest`, `pytest-asyncio`, `pytest-cov` |
 
 ### 许可证

tina_python-0.6.8/tina_python.egg-info/PKG-INFO → tina_python-0.7.1/README.md

@@ -1,38 +1,3 @@
-Metadata-Version: 2.4
-Name: tina-python
-Version: 0.6.8
-Summary: tina is in your computer!
-Home-page: https://gitee.com/wang-churi/tina
-Author: 王出日
-Author-email: 王出日 <wangchuri@163.com>
-License: Apache Software License
-Project-URL: Homepage, https://gitee.com/wang-churi/tina
-Project-URL: Repository, https://gitee.com/wang-churi/tina.git
-Project-URL: GitHub, https://github.com/XIMOCY/tina.git
-Classifier: Programming Language :: Python :: 3
-Classifier: License :: OSI Approved :: Apache Software License
-Classifier: Operating System :: OS Independent
-Requires-Python: >=3.10
-Description-Content-Type: text/markdown
-License-File: LICENSE
-Requires-Dist: httpx
-Requires-Dist: python-dotenv
-Provides-Extra: tui
-Requires-Dist: textual>=0.80; extra == "tui"
-Provides-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>=2.0; extra == "all"
-Dynamic: author
-Dynamic: home-page
-Dynamic: license-file
-Dynamic: requires-python
-
 # tina
 
 ![tina logo](logo.svg)
@@ -50,10 +15,13 @@ pip install tina-python
 # 如果需要使用 MCP（模型上下文协议）服务
 pip install tina-python[mcp]
 
-# 如果需要 TUI 终端界面
+# 如果需要 TUI 终端界面（独立发行包 tina-tui）
 pip install tina-python[tui]
 
-# 一次装齐所有可选功能（TUI + MCP）
+# 如果需要多 Agent 环境 + Web 调试控制台（独立发行包 tina-multi-agent）
+pip install tina-python[multi-agent]
+
+# 一次装齐所有可选功能（TUI + 多 Agent + MCP）
 pip install tina-python[all]
 
 # 如果需要运行测试
@@ -110,7 +78,7 @@ for chunk in result:
 - [四、MCP 支持 —— 模型上下文协议](#四mcp-支持--模型上下文协议)
 - [五、多模态支持](#五多模态支持)
 - [六、快速开发工具](#六快速开发工具)
-- [6.5 终端界面 TUI（可选扩展）](#65-终端界面-tui可选扩展)
+- [七、拓展包（可选）](#七拓展包可选)
 
 ---
 
@@ -138,7 +106,8 @@ tina 是一个轻量、模块化的 AI 智能体框架，专注于让开发者
 | **MCPClient** | MCP 集成 | 连接 MCP 服务器生态（stdio/SSE） |
 | **ContextManager** | 上下文管理 | 滚动窗口策略，自动截断 |
 | **AgentEvents** | 事件系统 | 贯穿 Agent 生命周期的回调钩子 |
-| **TUI（可选）** | 终端界面 | 测试你写的 Agent 的交互控制台，也可当作自己的 TUI 使用 |
+| **TUI（可选）** | 终端界面 | 独立包 `tina-tui`：测试 Agent 的交互控制台，也可当作自己的 TUI 使用 |
+| **多 Agent（可选）** | 多 Agent 环境 | 独立包 `tina-multi-agent`：消息总线 + Web 调试控制台 |
 
 ---
 
@@ -704,7 +673,7 @@ tina 支持通过 MCP（Model Context Protocol）连接外部工具生态。
 pip install tina-python[mcp]
 ```
 
-> 想一次装齐所有可选功能（TUI + MCP）：`pip install tina-python[all]`
+> 想一次装齐所有可选功能（TUI + 多 Agent + MCP）：`pip install tina-python[all]`
 
 ### 4.2 使用 MCP 客户端
 
@@ -1028,18 +997,24 @@ print(message)
 # {"role": "user", "content": [{"type": "text", "text": "..."}, {"type": "image_url", ...}]}
 ```
 
-### 6.5 终端界面 TUI（可选扩展）
+---
+
+## 七、拓展包（可选）
+
+tina 核心保持轻量：终端界面与多 Agent 环境这两块较大的功能，拆成**独立发行包**，按需安装、独立更新与发布。主包内不再包含它们的实现（仅保留 `tina.utils.*` 兼容转发壳）。
+
+### 7.1 终端界面 TUI（`tina-tui`）
 
-`tina` 自带一个基于 [Textual](https://textual.textualize.io/) 的终端界面。它的定位是**可选扩展**：方便你测试自己写的 Agent，也可以直接当作自己的 TUI 来用。核心不依赖它，需要额外安装：
+终端界面由配套包 **`tina-tui`**（基于 [Textual](https://textual.textualize.io/)）提供，作为**可选扩展**单独发行：方便你测试自己写的 Agent，也可以直接当作自己的 TUI 来用。核心不依赖它，需要额外安装：
 
 ```bash
-pip install tina-python[tui]
+pip install tina-python[tui]   # 等价于安装 tina-tui
 ```
 
 ```python
 from tina import Agent, Tools
 from tina.llm import BaseAPI
-from tina.utils.tui import run_agent_in_tui
+from tina_tui import run_agent_in_tui
 
 agent = Agent(llm=BaseAPI(), tools=Tools())
 
@@ -1073,10 +1048,39 @@ run_agent_in_tui(agent, max_tokens=32000)
 
 快捷键：`Ctrl+↑/↓` 跳转消息、`Ctrl+Home/End` 首/末条、`Ctrl+R` 折叠思考、`Ctrl+T` 折叠工具与结果、`Ctrl+O` 查看完整工具参数、`Esc` 关闭弹窗/取消确认 / 打断本轮回复。
 
-> 界面是可选的：数据层 `TuiMessageStore`（渲染块列表）和 `TokenCounter`（token 计数）**不依赖 textual**，可以单独导入，用来接入你自己的界面。
+> 界面是可选的：数据层 `TuiMessageStore`（渲染块列表）和 `TokenCounter`（token 计数）在 `tina_tui` 里**不依赖 textual**，可以单独导入，用来接入你自己的界面。
 
 完整说明（安装、指令、快捷键、自建界面）见 [`docs/tui.md`](./docs/tui.md)。
 
+### 7.2 多 Agent 环境（`tina-multi-agent`）
+
+多 Agent 场景由独立发行包 **`tina-multi-agent`** 提供：把多个各自独立的 `Agent`（含 `MultimodalAgent`）注册进一个「环境」，通过消息总线互相通信，并带一个 Web 调试控制台用于观测与介入。
+
+```bash
+pip install tina-python[multi-agent]   # 等价于安装 tina-multi-agent
+```
+
+```python
+from tina import Agent
+from tina.llm import BaseAPI
+from tina_multi_agent import MultiAgentEnvironment, MultiAgentWeb
+
+llm = BaseAPI()
+
+env = MultiAgentEnvironment(name="room")
+env.add_agent(Agent(llm=llm, name="alice", system_prompt="你是 alice"))
+env.add_agent(Agent(llm=llm, name="bob", system_prompt="你是 bob"))
+
+# 带 Web 控制台启动（自动启动环境）：打开 http://127.0.0.1:7077
+MultiAgentWeb(env, port=7077).run()
+```
+
+- 每个 Agent 一个收信队列；外部指令走 `add_user_message`，同伴消息作为带 `name` 的 assistant 消息注入。
+- 支持**回合中途注入**（`before_llm_call`）、打断（`env.interrupt`）、工具确认与权限表。
+- Web 控制台能力、消息总线、`POST /instruction`、`WS /ws` 事件等完整说明见 [`packages/tina-multi-agent/README.md`](./packages/tina-multi-agent/README.md)。
+
+> 兼容提示：旧路径 `tina.utils.multi_agent` 仍可用（主包内保留转发壳）；未安装 `tina-multi-agent` 时会提示安装。
+
 ---
 
 ## 附录
@@ -1098,7 +1102,8 @@ MAX_INPUT=8000
 |------|------|
 | 核心功能 | `httpx`, `python-dotenv` |
 | MCP 支持 | `mcp` |
-| TUI 界面（可选） | `textual` |
+| TUI 界面（可选，`tina-tui`） | `textual` |
+| 多 Agent（可选，`tina-multi-agent`） | `fastapi`, `uvicorn`, `websockets` |
 | 测试 | `pytest`, `pytest-asyncio`, `pytest-cov` |
 
 ### 许可证
@@ -1107,4 +1112,4 @@ Apache License 2.0
 
 ### 贡献
 
-欢迎提交 Issue 和 PR！项目地址：https://github.com/XIMOCY/tina
+欢迎提交 Issue 和 PR！项目地址：https://github.com/XIMOCY/tina

{tina_python-0.6.8 → tina_python-0.7.1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "tina-python"
-version = "0.6.8"
+version = "0.7.1"
 description = "tina is in your computer!"
 readme = { file = "README.md", content-type = "text/markdown" }
 requires-python = ">=3.10"
@@ -29,7 +29,10 @@ GitHub = "https://github.com/XIMOCY/tina.git"
 
 [project.optional-dependencies]
 tui = [
-    "textual>=0.80",
+    "tina-tui>=0.1.0",
+]
+multi-agent = [
+    "tina-multi-agent>=0.1.0",
 ]
 mcp = [
     "mcp>=2.0",
@@ -40,12 +43,14 @@ test = [
     "pytest-cov>=7.0",
 ]
 all = [
-    "textual>=0.80",
+    "tina-tui>=0.1.0",
+    "tina-multi-agent>=0.1.0",
     "mcp>=2.0",
 ]
 
 [tool.pytest.ini_options]
 testpaths = ["test"]
+pythonpath = ["packages/tina-tui", "packages/tina-multi-agent"]
 asyncio_mode = "auto"
 markers = [
     "slow: 需要 LLM 实际调用的测试（默认跳过）",

{tina_python-0.6.8 → tina_python-0.7.1}/setup.py

@@ -2,10 +2,15 @@ from setuptools import setup, find_packages
 
 setup(
     name="tina-python",
-    version="0.6.8",
+    version="0.7.1",
     packages=find_packages(),
     package_data={"tina": ["py.typed"]},
     install_requires=["httpx", "python-dotenv"],
+    extras_require={
+        "tui": ["tina-tui>=0.1.0"],
+        "multi-agent": ["tina-multi-agent>=0.1.0"],
+        "mcp": ["mcp>=2.0"],
+    },
     description="tina is in your computer!",
     long_description=open("README.md", encoding="utf-8").read(),
     long_description_content_type="text/markdown",

{tina_python-0.6.8 → tina_python-0.7.1}/tina/__init__.py

@@ -8,6 +8,7 @@ from tina.agent import (
     AgentState,
     AgentEvents,
 )
+from tina.llm.files_api import FilesAPI
 
 __all__ = [
     "Agent",
@@ -18,5 +19,6 @@ __all__ = [
     "MultimodalAgent",
     "AgentState",
     "AgentEvents",
+    "FilesAPI",
 ]
-__version__ = "0.6.8"
+__version__ = "0.7.1"

{tina_python-0.6.8 → tina_python-0.7.1}/tina/agent/agent.py

@@ -339,6 +339,19 @@ class Agent:
         """
         self.events.add_on_turn_end_handler(func)
 
+    def before_llm_call(self):
+        """
+        在每一次 LLM 调用之前触发（含工具循环的每一轮），不需要参数。
+        这是安全的上下文注入点。
+        """
+        return self.events.before_llm_call()
+
+    def add_before_llm_call_handler(self, func: callable | list[callable]):
+        """
+        在每一次 LLM 调用之前触发（含工具循环的每一轮），不需要参数。
+        """
+        self.events.add_before_llm_call_handler(func)
+
     def _mcp_to_tools(self, MCP):
         """如果传入了MCP，则将MCP的工具集加入到当前的工具集中"""
         try: