wagent-framework 1.4.1__tar.gz

wagent_framework-1.4.1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 LuckyStar2456
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

wagent_framework-1.4.1/PKG-INFO

@@ -0,0 +1,319 @@
+Metadata-Version: 2.4
+Name: wagent-framework
+Version: 1.4.1
+Summary: Python enterprise agent framework with AOP, IOC, and sandbox security
+Home-page: https://github.com/LuckyStar2456/W-Agent-FrameWork
+Author: LuckyStar2456
+Author-email: lucky_star_2456@example.com
+License: MIT
+Project-URL: Bug Reports, https://github.com/LuckyStar2456/W-Agent-FrameWork/issues
+Project-URL: Source, https://github.com/LuckyStar2456/W-Agent-FrameWork
+Keywords: agent framework AOP IOC sandbox
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Libraries :: Application Frameworks
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: pydantic
+Requires-Dist: structlog
+Requires-Dist: cryptography
+Requires-Dist: msgpack
+Requires-Dist: zstandard
+Requires-Dist: pyjwt
+Requires-Dist: asgiref
+Requires-Dist: redis
+Provides-Extra: fastapi
+Requires-Dist: fastapi; extra == "fastapi"
+Requires-Dist: uvicorn; extra == "fastapi"
+Provides-Extra: langchain
+Requires-Dist: langchain; extra == "langchain"
+Provides-Extra: wasm
+Requires-Dist: wasmer; extra == "wasm"
+Provides-Extra: opentelemetry
+Requires-Dist: opentelemetry-api; extra == "opentelemetry"
+Requires-Dist: opentelemetry-sdk; extra == "opentelemetry"
+Requires-Dist: opentelemetry-exporter-otlp; extra == "opentelemetry"
+Provides-Extra: testing
+Requires-Dist: pytest; extra == "testing"
+Requires-Dist: pytest-asyncio; extra == "testing"
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: keywords
+Dynamic: license
+Dynamic: license-file
+Dynamic: project-url
+Dynamic: provides-extra
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+# W-Agent v1.4.0
+
+[English](./README_EN.md) | 简体中文
+
+Python 企业级智能体框架，完整技术架构方案。
+
+[![Python Version](https://img.shields.io/badge/python-3.9+-blue.svg)](https://www.python.org/)
+[![License](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
+[![Stars](https://img.shields.io/github/stars/LuckyStar2456/W-Agent-FrameWork?style=social)](https://github.com/LuckyStar2456/W-Agent-FrameWork)
+
+## 📚 目录
+
+- [功能特性](#-功能特性)
+- [快速开始](#-快速开始)
+- [项目结构](#-项目结构)
+- [核心模块](#-核心模块)
+- [配置指南](#-配置指南)
+- [示例项目](#-示例项目)
+- [文档](#-文档)
+- [贡献指南](#-贡献指南)
+- [许可证](#-许可证)
+
+## ✨ 功能特性
+
+| 特性 | 描述 |
+|------|------|
+| **AOP 面向切面编程** | 支持 AspectJ 切点表达式（execution、within、@annotation、bean、args） |
+| **IOC 依赖注入** | 三级缓存、构造器/字段/setter 注入、@Autowired/@Qualifier 注解 |
+| **沙箱安全** | Wasm/nsjail 沙箱、seccomp 过滤、资源限制 |
+| **弹性模式** | 重试（带退避）、断路器（CLOSED/OPEN/HALF_OPEN 状态） |
+| **可观测性** | OpenTelemetry 集成、链路追踪、指标监控 |
+| **RAG 集成** | 向量检索（Redis/内存）、相似度搜索 |
+| **配置热更新** | 动态配置管理、配置变更事件 |
+
+## 🚀 快速开始
+
+### 安装
+
+```bash
+# 从 PyPI 安装
+pip install wagent-framework
+
+# 安装可选依赖
+pip install wagent-framework[fastapi,langchain,redis,opentelemetry]
+
+# 从源码安装
+pip install -e .
+```
+
+### 创建你的第一个 Agent
+
+```python
+import asyncio
+from w_agent.core.agent import BaseAgent
+from w_agent.container.bean_factory import BeanFactory
+from w_agent.core.decorators import AgentComponent
+
+@AgentComponent(name="hello_agent")
+class HelloAgent(BaseAgent):
+    async def arun(self, prompt: str) -> str:
+        return f"Hello, {prompt}!"
+
+async def main():
+    # 创建 Bean 工厂
+    bean_factory = BeanFactory()
+
+    # 注册 Agent
+    agent = HelloAgent()
+    bean_factory.register_bean("hello_agent", agent)
+
+    # 使用 Agent
+    agent = await bean_factory.get_bean("hello_agent")
+    result = await agent.arun("World")
+    print(result)  # 输出: Hello, World!
+
+asyncio.run(main())
+```
+
+### 使用配置热更新
+
+```python
+import asyncio
+from w_agent.config.dynamic_config import DynamicConfigManager
+
+async def main():
+    config_manager = DynamicConfigManager()
+
+    # 设置配置
+    config_manager.set("api_key", "your-api-key")
+
+    # 绑定配置到属性
+    class MyService:
+        def __init__(self):
+            self.api_key = None
+            config_manager.bind("api_key", self, "api_key")
+
+        async def on_config_change(self, key, new_value, old_value):
+            print(f"Config changed: {key} = {new_value}")
+
+    service = MyService()
+    print(service.api_key)  # 输出: your-api-key
+
+    # 动态更新配置
+    await config_manager.update_batch({"api_key": "new-api-key"})
+    print(service.api_key)  # 输出: new-api-key
+
+asyncio.run(main())
+```
+
+## 📁 项目结构
+
+```
+w_agent/
+├── aop/                    # 面向切面编程
+│   ├── aspects.py          # 切面实现（重试、断路器）
+│   ├── joinpoint.py        # 连接点
+│   ├── pointcut.py         # 切点表达式解析
+│   └── proxy_factory.py    # 代理工厂
+├── config/                 # 配置管理
+│   └── dynamic_config.py   # 动态配置
+├── container/              # 依赖注入容器
+│   ├── bean_factory.py     # Bean 工厂
+│   └── reflection_cache.py # 反射缓存
+├── core/                   # 核心功能
+│   ├── agent.py           # Agent 基类
+│   ├── event_bus.py       # 事件总线
+│   └── decorators.py      # 装饰器
+├── observability/          # 可观测性
+│   ├── tracing.py         # 链路追踪
+│   ├── metrics.py         # 指标监控
+│   └── health.py          # 健康检查
+├── skills/                # 技能系统
+│   └── sandbox/           # 沙箱
+│       ├── wasm_sandbox.py
+│       └── nsjail_sandbox.py
+└── ...
+```
+
+## 🔧 核心模块
+
+### AOP 切面编程
+
+```python
+from w_agent.core.decorators import Retry, CircuitBreaker
+from w_agent.aop.pointcut import AspectJPointcut
+
+# 使用重试装饰器
+@Retry(max_attempts=3, delay=0.1, backoff=2.0)
+async def unreliable_operation():
+    pass
+
+# 使用断路器
+@CircuitBreaker(failure_threshold=5, recovery_timeout=30.0)
+async def protected_operation():
+    pass
+```
+
+### 依赖注入
+
+```python
+from w_agent.core.decorators import Autowired, Qualifier, ServiceComponent
+
+@ServiceComponent(name="user_service")
+class UserService:
+    @Qualifier(name="redis_client")
+    def set_cache(self, cache_client):
+        self.cache = cache_client
+```
+
+### 事件总线
+
+```python
+from w_agent.core.event_bus import EventBus, Event
+
+event_bus = EventBus()
+
+@event_bus.on("user.created")
+async def on_user_created(event):
+    print(f"User created: {event.payload}")
+
+await event_bus.emit(Event("user.created", {"user_id": 123}))
+```
+
+## ⚙️ 配置指南
+
+### 可配置项一览
+
+| 配置项 | 类型 | 默认值 | 描述 |
+|--------|------|--------|------|
+| `logging.level` | string | "INFO" | 日志级别 |
+| `container.scan_paths` | list | ["."] | 组件扫描路径 |
+| `sandbox.enabled` | bool | true | 是否启用沙箱 |
+| `resilience.retry.max_attempts` | int | 3 | 最大重试次数 |
+| `distributed.lock.redis.url` | string | "redis://localhost:6379" | Redis 连接 URL |
+
+### 配置文件
+
+创建 `config.json`：
+
+```json
+{
+  "logging": {
+    "level": "INFO",
+    "format": "json"
+  },
+  "container": {
+    "scan_paths": ["src"],
+    "skip_paths": ["__pycache__", ".git"]
+  }
+}
+```
+
+### 环境变量
+
+```bash
+export W_AGENT_LOGGING_LEVEL=DEBUG
+export W_AGENT_CONTAINER_SCAN_PATHS=src,components
+```
+
+## 📖 示例项目
+
+查看 [chat-agent](./chat-agent/) 目录获取完整的聊天智能体示例项目，包含：
+
+- Agent 实现
+- Skill 系统
+- RAG 检索增强
+- Redis/MySQL 集成
+- OpenTelemetry 可观测性
+
+## 📄 文档
+
+- [架构设计文档](./docs/architecture.md)
+- [API 文档](./docs/api.md)
+- [使用指南](./docs/guide.md)
+
+## 🤝 贡献指南
+
+欢迎提交 Issue 和 Pull Request！
+
+1. Fork 本仓库
+2. 创建特性分支 (`git checkout -b feature/amazing-feature`)
+3. 提交更改 (`git commit -m 'Add amazing feature'`)
+4. 推送分支 (`git push origin feature/amazing-feature`)
+5. 创建 Pull Request
+
+## 📄 许可证
+
+本项目采用 [MIT 许可证](LICENSE)。
+
+---
+
+如果这个项目对你有帮助，请给我们一个 ⭐！
+
+## 📦 PyPI 包
+
+- **包名**: `wagent-framework`
+- **版本**: 1.4.0
+- **安装**: `pip install wagent-framework`
+- **PyPI 地址**: [https://pypi.org/project/wagent-framework/](https://pypi.org/project/wagent-framework/)

wagent_framework-1.4.1/README.md

@@ -0,0 +1,259 @@
+# W-Agent v1.4.0
+
+[English](./README_EN.md) | 简体中文
+
+Python 企业级智能体框架，完整技术架构方案。
+
+[![Python Version](https://img.shields.io/badge/python-3.9+-blue.svg)](https://www.python.org/)
+[![License](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
+[![Stars](https://img.shields.io/github/stars/LuckyStar2456/W-Agent-FrameWork?style=social)](https://github.com/LuckyStar2456/W-Agent-FrameWork)
+
+## 📚 目录
+
+- [功能特性](#-功能特性)
+- [快速开始](#-快速开始)
+- [项目结构](#-项目结构)
+- [核心模块](#-核心模块)
+- [配置指南](#-配置指南)
+- [示例项目](#-示例项目)
+- [文档](#-文档)
+- [贡献指南](#-贡献指南)
+- [许可证](#-许可证)
+
+## ✨ 功能特性
+
+| 特性 | 描述 |
+|------|------|
+| **AOP 面向切面编程** | 支持 AspectJ 切点表达式（execution、within、@annotation、bean、args） |
+| **IOC 依赖注入** | 三级缓存、构造器/字段/setter 注入、@Autowired/@Qualifier 注解 |
+| **沙箱安全** | Wasm/nsjail 沙箱、seccomp 过滤、资源限制 |
+| **弹性模式** | 重试（带退避）、断路器（CLOSED/OPEN/HALF_OPEN 状态） |
+| **可观测性** | OpenTelemetry 集成、链路追踪、指标监控 |
+| **RAG 集成** | 向量检索（Redis/内存）、相似度搜索 |
+| **配置热更新** | 动态配置管理、配置变更事件 |
+
+## 🚀 快速开始
+
+### 安装
+
+```bash
+# 从 PyPI 安装
+pip install wagent-framework
+
+# 安装可选依赖
+pip install wagent-framework[fastapi,langchain,redis,opentelemetry]
+
+# 从源码安装
+pip install -e .
+```
+
+### 创建你的第一个 Agent
+
+```python
+import asyncio
+from w_agent.core.agent import BaseAgent
+from w_agent.container.bean_factory import BeanFactory
+from w_agent.core.decorators import AgentComponent
+
+@AgentComponent(name="hello_agent")
+class HelloAgent(BaseAgent):
+    async def arun(self, prompt: str) -> str:
+        return f"Hello, {prompt}!"
+
+async def main():
+    # 创建 Bean 工厂
+    bean_factory = BeanFactory()
+
+    # 注册 Agent
+    agent = HelloAgent()
+    bean_factory.register_bean("hello_agent", agent)
+
+    # 使用 Agent
+    agent = await bean_factory.get_bean("hello_agent")
+    result = await agent.arun("World")
+    print(result)  # 输出: Hello, World!
+
+asyncio.run(main())
+```
+
+### 使用配置热更新
+
+```python
+import asyncio
+from w_agent.config.dynamic_config import DynamicConfigManager
+
+async def main():
+    config_manager = DynamicConfigManager()
+
+    # 设置配置
+    config_manager.set("api_key", "your-api-key")
+
+    # 绑定配置到属性
+    class MyService:
+        def __init__(self):
+            self.api_key = None
+            config_manager.bind("api_key", self, "api_key")
+
+        async def on_config_change(self, key, new_value, old_value):
+            print(f"Config changed: {key} = {new_value}")
+
+    service = MyService()
+    print(service.api_key)  # 输出: your-api-key
+
+    # 动态更新配置
+    await config_manager.update_batch({"api_key": "new-api-key"})
+    print(service.api_key)  # 输出: new-api-key
+
+asyncio.run(main())
+```
+
+## 📁 项目结构
+
+```
+w_agent/
+├── aop/                    # 面向切面编程
+│   ├── aspects.py          # 切面实现（重试、断路器）
+│   ├── joinpoint.py        # 连接点
+│   ├── pointcut.py         # 切点表达式解析
+│   └── proxy_factory.py    # 代理工厂
+├── config/                 # 配置管理
+│   └── dynamic_config.py   # 动态配置
+├── container/              # 依赖注入容器
+│   ├── bean_factory.py     # Bean 工厂
+│   └── reflection_cache.py # 反射缓存
+├── core/                   # 核心功能
+│   ├── agent.py           # Agent 基类
+│   ├── event_bus.py       # 事件总线
+│   └── decorators.py      # 装饰器
+├── observability/          # 可观测性
+│   ├── tracing.py         # 链路追踪
+│   ├── metrics.py         # 指标监控
+│   └── health.py          # 健康检查
+├── skills/                # 技能系统
+│   └── sandbox/           # 沙箱
+│       ├── wasm_sandbox.py
+│       └── nsjail_sandbox.py
+└── ...
+```
+
+## 🔧 核心模块
+
+### AOP 切面编程
+
+```python
+from w_agent.core.decorators import Retry, CircuitBreaker
+from w_agent.aop.pointcut import AspectJPointcut
+
+# 使用重试装饰器
+@Retry(max_attempts=3, delay=0.1, backoff=2.0)
+async def unreliable_operation():
+    pass
+
+# 使用断路器
+@CircuitBreaker(failure_threshold=5, recovery_timeout=30.0)
+async def protected_operation():
+    pass
+```
+
+### 依赖注入
+
+```python
+from w_agent.core.decorators import Autowired, Qualifier, ServiceComponent
+
+@ServiceComponent(name="user_service")
+class UserService:
+    @Qualifier(name="redis_client")
+    def set_cache(self, cache_client):
+        self.cache = cache_client
+```
+
+### 事件总线
+
+```python
+from w_agent.core.event_bus import EventBus, Event
+
+event_bus = EventBus()
+
+@event_bus.on("user.created")
+async def on_user_created(event):
+    print(f"User created: {event.payload}")
+
+await event_bus.emit(Event("user.created", {"user_id": 123}))
+```
+
+## ⚙️ 配置指南
+
+### 可配置项一览
+
+| 配置项 | 类型 | 默认值 | 描述 |
+|--------|------|--------|------|
+| `logging.level` | string | "INFO" | 日志级别 |
+| `container.scan_paths` | list | ["."] | 组件扫描路径 |
+| `sandbox.enabled` | bool | true | 是否启用沙箱 |
+| `resilience.retry.max_attempts` | int | 3 | 最大重试次数 |
+| `distributed.lock.redis.url` | string | "redis://localhost:6379" | Redis 连接 URL |
+
+### 配置文件
+
+创建 `config.json`：
+
+```json
+{
+  "logging": {
+    "level": "INFO",
+    "format": "json"
+  },
+  "container": {
+    "scan_paths": ["src"],
+    "skip_paths": ["__pycache__", ".git"]
+  }
+}
+```
+
+### 环境变量
+
+```bash
+export W_AGENT_LOGGING_LEVEL=DEBUG
+export W_AGENT_CONTAINER_SCAN_PATHS=src,components
+```
+
+## 📖 示例项目
+
+查看 [chat-agent](./chat-agent/) 目录获取完整的聊天智能体示例项目，包含：
+
+- Agent 实现
+- Skill 系统
+- RAG 检索增强
+- Redis/MySQL 集成
+- OpenTelemetry 可观测性
+
+## 📄 文档
+
+- [架构设计文档](./docs/architecture.md)
+- [API 文档](./docs/api.md)
+- [使用指南](./docs/guide.md)
+
+## 🤝 贡献指南
+
+欢迎提交 Issue 和 Pull Request！
+
+1. Fork 本仓库
+2. 创建特性分支 (`git checkout -b feature/amazing-feature`)
+3. 提交更改 (`git commit -m 'Add amazing feature'`)
+4. 推送分支 (`git push origin feature/amazing-feature`)
+5. 创建 Pull Request
+
+## 📄 许可证
+
+本项目采用 [MIT 许可证](LICENSE)。
+
+---
+
+如果这个项目对你有帮助，请给我们一个 ⭐！
+
+## 📦 PyPI 包
+
+- **包名**: `wagent-framework`
+- **版本**: 1.4.0
+- **安装**: `pip install wagent-framework`
+- **PyPI 地址**: [https://pypi.org/project/wagent-framework/](https://pypi.org/project/wagent-framework/)

wagent_framework-1.4.1/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

wagent_framework-1.4.1/setup.py

@@ -0,0 +1,59 @@
+from setuptools import setup, find_packages
+import os
+
+# 读取README.md作为长描述
+here = os.path.abspath(os.path.dirname(__file__))
+with open(os.path.join(here, 'README.md'), 'r', encoding='utf-8') as f:
+    long_description = f.read()
+
+setup(
+    name="wagent-framework",
+    version="1.4.1",
+    description="Python enterprise agent framework with AOP, IOC, and sandbox security",
+    long_description=long_description,
+    long_description_content_type="text/markdown",
+    url="https://github.com/LuckyStar2456/W-Agent-FrameWork",
+    author="LuckyStar2456",
+    author_email="lucky_star_2456@example.com",
+    license="MIT",
+    packages=find_packages(),
+    install_requires=[
+        "pydantic",
+        "structlog",
+        "cryptography",
+        "msgpack",
+        "zstandard",
+        "pyjwt",
+        "asgiref",
+        "redis"
+    ],
+    extras_require={
+        "fastapi": ["fastapi", "uvicorn"],
+        "langchain": ["langchain"],
+        "wasm": ["wasmer"],
+        "opentelemetry": ["opentelemetry-api", "opentelemetry-sdk", "opentelemetry-exporter-otlp"],
+        "testing": ["pytest", "pytest-asyncio"]
+    },
+    entry_points={
+        "console_scripts": [
+            "w-agent=w_agent.cli:main"
+        ]
+    },
+    classifiers=[
+        "Development Status :: 4 - Beta",
+        "Intended Audience :: Developers",
+        "License :: OSI Approved :: MIT License",
+        "Programming Language :: Python :: 3.9",
+        "Programming Language :: Python :: 3.10",
+        "Programming Language :: Python :: 3.11",
+        "Programming Language :: Python :: 3.12",
+        "Topic :: Software Development :: Libraries :: Application Frameworks",
+        "Topic :: Software Development :: Libraries :: Python Modules"
+    ],
+    python_requires=">=3.9",
+    keywords="agent framework AOP IOC sandbox",
+    project_urls={
+        "Bug Reports": "https://github.com/LuckyStar2456/W-Agent-FrameWork/issues",
+        "Source": "https://github.com/LuckyStar2456/W-Agent-FrameWork",
+    },
+)

wagent_framework-1.4.1/tests/test.py

@@ -0,0 +1,8 @@
+#!/usr/bin/env python3
+"""
+测试脚本，用于沙箱测试
+"""
+
+def execute(params):
+    """执行函数"""
+    return f"Executed with params: {params}"