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

{tina_python-0.7.0/tina_python.egg-info → tina_python-0.7.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: tina-python
-Version: 0.7.0
+Version: 0.7.1
 Summary: tina is in your computer!
 Home-page: https://gitee.com/wang-churi/tina
 Author: 王出日
@@ -53,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]
 
 # 如果需要运行测试
@@ -113,7 +116,7 @@ for chunk in result:
 - [四、MCP 支持 —— 模型上下文协议](#四mcp-支持--模型上下文协议)
 - [五、多模态支持](#五多模态支持)
 - [六、快速开发工具](#六快速开发工具)
-- [6.5 终端界面 TUI（可选扩展）](#65-终端界面-tui可选扩展)
+- [七、拓展包（可选）](#七拓展包可选)
 
 ---
 
@@ -141,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 调试控制台 |
 
 ---
 
@@ -707,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 客户端
 
@@ -1031,7 +1035,13 @@ print(message)
 # {"role": "user", "content": [{"type": "text", "text": "..."}, {"type": "image_url", ...}]}
 ```
 
-### 6.5 终端界面 TUI（可选扩展）
+---
+
+## 七、拓展包（可选）
+
+tina 核心保持轻量：终端界面与多 Agent 环境这两块较大的功能，拆成**独立发行包**，按需安装、独立更新与发布。主包内不再包含它们的实现（仅保留 `tina.utils.*` 兼容转发壳）。
+
+### 7.1 终端界面 TUI（`tina-tui`）
 
 终端界面由配套包 **`tina-tui`**（基于 [Textual](https://textual.textualize.io/)）提供，作为**可选扩展**单独发行：方便你测试自己写的 Agent，也可以直接当作自己的 TUI 来用。核心不依赖它，需要额外安装：
 
@@ -1080,6 +1090,35 @@ run_agent_in_tui(agent, max_tokens=32000)
 
 完整说明（安装、指令、快捷键、自建界面）见 [`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` 时会提示安装。
+
 ---
 
 ## 附录
@@ -1101,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.7.0 → tina_python-0.7.1}/README.md

@@ -15,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]
 
 # 如果需要运行测试
@@ -75,7 +78,7 @@ for chunk in result:
 - [四、MCP 支持 —— 模型上下文协议](#四mcp-支持--模型上下文协议)
 - [五、多模态支持](#五多模态支持)
 - [六、快速开发工具](#六快速开发工具)
-- [6.5 终端界面 TUI（可选扩展）](#65-终端界面-tui可选扩展)
+- [七、拓展包（可选）](#七拓展包可选)
 
 ---
 
@@ -103,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 调试控制台 |
 
 ---
 
@@ -669,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 客户端
 
@@ -993,7 +997,13 @@ print(message)
 # {"role": "user", "content": [{"type": "text", "text": "..."}, {"type": "image_url", ...}]}
 ```
 
-### 6.5 终端界面 TUI（可选扩展）
+---
+
+## 七、拓展包（可选）
+
+tina 核心保持轻量：终端界面与多 Agent 环境这两块较大的功能，拆成**独立发行包**，按需安装、独立更新与发布。主包内不再包含它们的实现（仅保留 `tina.utils.*` 兼容转发壳）。
+
+### 7.1 终端界面 TUI（`tina-tui`）
 
 终端界面由配套包 **`tina-tui`**（基于 [Textual](https://textual.textualize.io/)）提供，作为**可选扩展**单独发行：方便你测试自己写的 Agent，也可以直接当作自己的 TUI 来用。核心不依赖它，需要额外安装：
 
@@ -1042,6 +1052,35 @@ run_agent_in_tui(agent, max_tokens=32000)
 
 完整说明（安装、指令、快捷键、自建界面）见 [`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` 时会提示安装。
+
 ---
 
 ## 附录
@@ -1063,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` |
 
 ### 许可证

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

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

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

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

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

@@ -21,4 +21,4 @@ __all__ = [
     "AgentEvents",
     "FilesAPI",
 ]
-__version__ = "0.7.0"
+__version__ = "0.7.1"

{tina_python-0.7.0 → tina_python-0.7.1/tina_python.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: tina-python
-Version: 0.7.0
+Version: 0.7.1
 Summary: tina is in your computer!
 Home-page: https://gitee.com/wang-churi/tina
 Author: 王出日
@@ -53,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]
 
 # 如果需要运行测试
@@ -113,7 +116,7 @@ for chunk in result:
 - [四、MCP 支持 —— 模型上下文协议](#四mcp-支持--模型上下文协议)
 - [五、多模态支持](#五多模态支持)
 - [六、快速开发工具](#六快速开发工具)
-- [6.5 终端界面 TUI（可选扩展）](#65-终端界面-tui可选扩展)
+- [七、拓展包（可选）](#七拓展包可选)
 
 ---
 
@@ -141,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 调试控制台 |
 
 ---
 
@@ -707,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 客户端
 
@@ -1031,7 +1035,13 @@ print(message)
 # {"role": "user", "content": [{"type": "text", "text": "..."}, {"type": "image_url", ...}]}
 ```
 
-### 6.5 终端界面 TUI（可选扩展）
+---
+
+## 七、拓展包（可选）
+
+tina 核心保持轻量：终端界面与多 Agent 环境这两块较大的功能，拆成**独立发行包**，按需安装、独立更新与发布。主包内不再包含它们的实现（仅保留 `tina.utils.*` 兼容转发壳）。
+
+### 7.1 终端界面 TUI（`tina-tui`）
 
 终端界面由配套包 **`tina-tui`**（基于 [Textual](https://textual.textualize.io/)）提供，作为**可选扩展**单独发行：方便你测试自己写的 Agent，也可以直接当作自己的 TUI 来用。核心不依赖它，需要额外安装：
 
@@ -1080,6 +1090,35 @@ run_agent_in_tui(agent, max_tokens=32000)
 
 完整说明（安装、指令、快捷键、自建界面）见 [`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` 时会提示安装。
+
 ---
 
 ## 附录
@@ -1101,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` |
 
 ### 许可证