@agentunion/kite 1.4.0 → 1.5.0

package/extensions/services/proxy/agentcp/LICENCE

@@ -0,0 +1,178 @@
+
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+

package/extensions/services/proxy/agentcp/README copy.md

@@ -0,0 +1,85 @@
+```markdown:d:/github_agentcp/samples/hcp/README.md
+# 智能天气助手（HCP）
+
+基于 agentcp 框架开发的智能天气助手，支持自然语言交互和上下文记忆，能够将用户作为外部工具回调获取必要信息。
+
+## 🚀 使用指南
+
+1. **创建agent身份(aid)**
+   - 参考文档：创建身份&读写公私有数据
+
+2. **配置Agent参数**
+   ```python:hcp.py
+   # 修改hcp.py中的agent_id配置项
+   agent_id = "your_agent_id"  # 替换为实际创建的aid
+   ```
+
+3. **配置环境变量**
+   ```bash:.env
+   OPENAI_API_KEY=your_api_key
+   BASE_URL=https://api.openai.com/v1
+   MODEL=gpt-3.5-turbo
+   ```
+
+4. **安装依赖**
+   ```bash
+   pip install openai agentcp python-dotenv
+   ```
+
+5. **启动服务**
+   ```bash
+   python hcp.py
+   ```
+
+## ✨ 核心功能
+
+- 🌦️ 多维度天气查询（当前天气/历史天气/天气预报）
+- 🗣️ 上下文感知的对话管理
+- 🔧 外部工具回调机制（用于获取缺失的位置/时间信息）
+- ⏰ 自动时间推理（支持绝对时间、相对时间和年号纪年）
+
+## 🧩 核心类说明：MCPClient
+
+### 初始化方法
+```python
+def __init__(self):
+    # 初始化 OpenAI 客户端
+    self.client = OpenAI(api_key=os.getenv("OPENAI_API_KEY"))
+    # 创建 AgentCP 实例
+    self.acp = agentcp.AgentCP(app_path)
+    # 消息存储器（按 session_id 隔离）
+    self.message_store = dict()
+```
+
+### 消息管理机制
+```python
+def record_message(self, session_id: str, role: str, content: str):
+    # 记录对话历史（支持 user/assistant/system 三种角色）
+
+def get_messages_for_llm(self, session_id: str, max_messages=20, system_message=None):
+    # 构造符合 OpenAI 格式的对话历史（自动维护最近20条消息）
+```
+
+## 🔄 交互流程
+
+```mermaid
+graph TD
+    A[用户提问] --> B{是否天气相关?}
+    B -->|是| C[检查位置/时间信息]
+    B -->|否| D[简短回答并引导]
+    C --> E{信息完整?}
+    E -->|是| F[生成天气报告]
+    E -->|否| G[调用用户工具获取信息]
+```
+
+## 💬 示例对话
+
+> **用户**：明天天气怎么样  
+> **Agent**：你想查询哪里的天气呢  
+> **用户**：上海  
+> **Agent**：上海的天气晴  
+> **用户**：上海  
+> **Agent**：你是想查询上海什么时候的天气呢
+```
+
+        

package/extensions/services/proxy/agentcp/README.md

@@ -0,0 +1,260 @@
+# AgentCP - 基于ACP协议的Agent标准通信库
+
+## Agent Communication Protocol(智能体通信协议,简称ACP)
+    ACP是一个开放协议,用于解决Agent互相通信协作的问题
+    ACP定义了agent的数据规范、agent之间的通信以及agent之间的授权规范
+    ACP Python SDK
+        ACP Python SDK是一个基于ACP协议的Agent标准通信库，用于解决Agent间的身份认证及通信问题。
+        ACP Python SDK提供了一系列API，用于创建AID、连接入网、构建会话，收发消息等。
+        ACP Python SDK支持多Agent协作，异步消息处理，支持内网穿透，支持Agent访问的负载均衡
+
+## 功能特性
+
+- 🔐 Agent之间采用对等网络通信
+- 🛡️ 基于https安全通信及PKI体系的安全身份认证、连接管理
+- 🔄 异步消息处理，支持全链路流式输入输出
+- 🤖 多 Agent 协作模式支持
+- 📦 简洁易用的 API 设计
+- 📊 支持Agent的高并发场景
+- 📚 支持多种消息类型，包括文本、图片、文件等
+- 🔗 支持内网部署，全网服务
+- 🌐 异构兼容：标准化通信接口支持不同架构的Agent互联
+
+
+## 开始使用 AgentCP 吧！
+## 安装
+
+```bash
+pip install agentcp
+```
+## 快速入门
+
+### 初始化ACP实例
+
+```python
+from agentcp import AgentCP
+
+# 创建 AgentCP 实例
+#   - agent_data_path: agent数据存储路径，必须外部指定,"."为当前目录
+#   - seed_password: 加密种子，用于私有证书加密
+#   - debug: 是否开启调试模式，默认为False
+#   - 注意：日志默认输出在控制台&当前路径下log.txt文件中
+agent_data_path = "."
+acp = AgentCP(agent_data_path,seed_password = "123456",debug=True)
+```
+
+### 创建新身份
+
+```python
+# 创建新身份
+#   - ap: 接入点URL，指定Agent网络的接入点（如："agentunion.cn"）
+#   - name: Agent的身份标识，用于在该接入点上唯一标识该Agent
+#   - 创建身份成功，返回aid对象，创建身份失败，抛出异常，可获取失败原因
+#   - ps:下面两行代码将创建一个临时的aid标识,用于临时演示，实际使用时，需要将name替换为自己的名字，注意不能以guest开头
+#   - 正式的aid标识可以在浏览器中像二级域名一样直接访问
+name = "guest"
+aid = acp.create_aid("agentunion.cn", name)
+```
+### 获取身份列表
+```python
+# 获取身份列表
+list = acp.get_aid_list()
+```
+
+### 加载现有身份
+```python
+#   - load_success: 加载成功返回aid对象,加载失败返回None，详细原因请打开日志查看
+aid = acp.load_aid("yourname.agentunion.cn")
+```
+
+### 设置消息监听器
+#### 方式1：通过装饰器方式
+```python
+#   - msg: 当有消息
+@aid.message_handler()
+async def sync_message_handler(msg):
+    #print(f"收到消息数据: {msg}")
+    return True
+```
+
+#### 方式2：通过方法灵活设置
+```python
+#   - msg: 当有消息
+async def sync_message_handler(msg):
+    #print(f"收到消息数据: {msg}")
+    return True
+aid.add_message_handler(sync_message_handler)
+```
+
+#### 方式3：绑定sesion_id和方法监听器，指定监听某个会话的消息，该消息将不会被其他监听器监听
+```python
+#   - msg: 当有消息
+async def sync_message_handler(msg):
+    #print(f"收到消息数据: {msg}")
+    return True
+aid.add_message_handler(sync_message_handler,session_id = session_id)
+```
+
+### 移除消息监听器
+
+```python
+#   - msg: 当有消息
+async def sync_message_handler(msg):
+    #print(f"收到消息数据: {msg}")
+    return True
+aid.remove_message_handler(sync_message_handler,session_id = session_id)
+```
+
+### 连接到网络
+
+```python
+# aid上线，开始监听消息
+aid.online()
+```
+
+
+### 快速回复消息
+
+```python
+# msg  收到的消息dict
+# message 发送的消息对象或者消息文本
+aid.reply_message(msg,message)
+```
+
+### 快速发送文本消息
+
+```python
+# to_aid = "" 快速给aid发送消息
+# message_content 消息文本
+# asnyc_message_result 快速消息回调
+aid.quick_send_messsage_content(to_aid,message_content,asnyc_message_result)
+```
+
+
+### 快速发送消息
+
+```python
+# to_aid = "" 快速给aid发送消息
+# message 消息对象
+# asnyc_message_result 快速消息回调
+aid.quick_send_messsage(to_aid,message,asnyc_message_result)
+```
+
+
+
+### 创建会话
+
+```python
+# 创建会话
+session_id = aid.create_session(
+    name="",
+    subject=""
+)
+```
+
+
+### 再会话中发送文本消息
+
+```python
+# to_aid_list = [] 指定多人接收处理
+# session_id 会话id
+# llm_content 大模型处理结果 
+aid.send_message_content(to_aid_list, session_id,llm_content)
+```
+
+### 在会话中发送消息
+
+```python
+# 在会话中发送消息
+aid.send_message(
+    session_id=session_id,
+    to_aid_list=["member1.agentunion.cn"],
+    message={"type": "text", "content": "你好！"}
+)
+```
+
+
+
+### 在会话中发送流式消息
+
+```python
+# to_aid_list = [] 指定多人接收处理
+# session_id 会话id
+# llm_content 大模型处理结果 
+# 大模型调用流式response
+#type默认为text/event-stream
+await aid.send_stream_message(to_aid_list, session_id,response,type)
+```
+
+## 核心 API
+
+### `AgentCP` 类
+主要负责信号处理和程序持续运行的控制。
+
+| 方法 | 描述 |
+|------|------|
+| `__init__()` | 初始化信号量和退出钩子函数，可传入app_path |
+| `get_aid_list()` | 获取aid列表，返回aid字符串列表 |
+| `create_aid("ep_point,name")` | 创建aid,返回aid实例|
+| `load_aid(aid_str)` | 加载aid,返回aid实例 |
+| `register_signal_handler(exit_hook_func=None)` | 注册信号处理函数，处理 `SIGTERM` 和 `SIGINT` 信号 |
+| `serve_forever()` | 使程序持续运行，直到关闭标志被设置 |
+| `signal_handle(signum, frame)` | 信号处理函数，设置关闭标志并调用退出钩子函数 |
+
+### `AgentID` 类
+核心的 Agent 身份管理类，提供身份创建、消息处理、会话管理等功能。
+
+#### 连接管理
+| 方法 | 描述 |
+|------|------|
+| `__init__(id, app_path, ca_client, ep_url)` | 初始化 AgentID 实例 |
+| `online()` | 初始化入口点客户端、心跳客户端和会话管理器，并建立连接 |
+| `offline()` | 使 Agent 下线，关闭心跳客户端和入口点客户端 |
+| `get_aid_info()` | 获取 Agent 的基本信息 |
+
+#### 会话管理
+| 方法 | 描述 |
+|------|------|
+| `create_session(name, subject, *, type='public')` | 创建会话，返回会话 ID 或 `None` |
+| `invite_member(session_id, to_aid)` | 邀请成员加入指定会话 |
+| `get_online_status(aids)` | 获取指定 Agent 的在线状态 |
+| `get_conversation_list(aid, main_aid, page, page_size)` | 获取会话列表 |
+
+#### 消息处理
+| 方法 | 描述 |
+|------|------|
+| `add_message_handler(handler: Callable[[dict], Awaitable[None]], session_id: str = "")` | 添加消息监听器 |
+| `send_message(to_aid_list: list, session_id: str, message: Union[AssistantMessageBlock, list[AssistantMessageBlock], dict], ref_msg_id: str = "", message_id: str = "")` | 发送消息 |
+| `async send_stream_message(to_aid_list: list, session_id: str, response: AsyncGenerator[bytes, None], type: str = "text/event-stream", ref_msg_id: str = "")` | 发送流式消息 |
+| `remove_message_handler(handler: typing.Callable[[dict], typing.Awaitable[None]], session_id:str="")` | 移除消息监听器 |
+| `send_message_content(to_aid_list: list, session_id: str, llm_content: str, ref_msg_id: str="", message_id:str="")` | 发送文本消息 |
+| `send_message(to_aid_list: list, sessionId: str, message: Union[AssistantMessageBlock, list[AssistantMessageBlock], dict], ref_msg_id: str="", message_id:str="")` | 发送消息，可以处理不同类型的消息对象 |
+| `async send_stream_message(to_aid_list: list, session_id: str, response, type="text/event-stream", ref_msg_id:str="")` | 发送流式消息 |
+
+#### 其他功能
+| 方法 | 描述 |
+|------|------|
+| `post_public_data(json_path)` | 发送数据到接入点服务器 |
+| `add_friend_agent(aid, name, description, avaUrl)` | 添加好友 Agent |
+| `get_friend_agent_list()` | 获取好友 Agent 列表 |
+| `get_agent_list()` | 获取所有 AgentID 列表 |
+| `get_all_public_data()` | 获取所有 AgentID 的公共数据 |
+| `get_session_member_list(session_id)` | 获取指定会话的成员列表 |
+| `update_aid_info(aid, avaUrl, name, description)` | 更新 Agent 的信息 |
+
+## 微信支持
+如需技术交流或问题咨询，欢迎添加开发者微信：
+
+![WeChat QR Code](assets/images/wechat_qr.png) <!-- 请将二维码图片放在指定路径 -->
+
+📮 问题反馈: 19169495461@163.com
+
+## 许可证
+
+MIT © 2025
+
+---
+
+📮 问题反馈: 19169495461@163.com
+
+        

package/extensions/services/proxy/agentcp/__init__.py

@@ -0,0 +1,16 @@
+# 移除或注释掉原来的导入
+#: code: utf-8
+
+from requests.packages import urllib3
+urllib3.disable_warnings(urllib3.exceptions.InsecureRequestWarning)
+
+from agentcp.utils.proxy_bypass import ensure_no_proxy_for_local_env
+ensure_no_proxy_for_local_env()
+
+from agentcp.agentcp import AgentCP, AgentID
+from agentcp.mermaid import Mermaid
+from agentcp.workflow import Workflow
+
+__version__ = "0.1.96"
+
+__all__ = ["__version__", "AgentCP", "AgentID","Mermaid","Workflow"]

package/extensions/services/proxy/agentcp/agent.py

@@ -0,0 +1,4 @@
+class Agent:
+    def __init__(self, name:str, pomp):
+        self.name = name
+        self.pomp = pomp