langchain-agentx-python 0.7.6__tar.gz → 0.7.8__tar.gz

{langchain-agentx-python-0.7.6 → langchain-agentx-python-0.7.8}/PKG-INFO

@@ -1,482 +1,482 @@
-Metadata-Version: 2.1
-Name: langchain-agentx-python
-Version: 0.7.6
-Summary: LangChain/LangGraph-based agent utilities for CodeBaseX.
-Author-email: GoodMood2008 <GoodMood2008@users.noreply.github.com>
-License:                                  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
-        
-           APPENDIX: How to apply the Apache License to your work.
-        
-              To apply the Apache License to your work, attach the following
-              boilerplate notice, with the fields enclosed by brackets "[]"
-              replaced with your own identifying information. (Don't include
-              the brackets!)  The text should be enclosed in the appropriate
-              comment syntax for the file format. We also recommend that a
-              file or class name and description of purpose be included on the
-              same "printed page" as the copyright notice for easier
-              identification within third-party archives.
-        
-           Copyright [yyyy] [name of copyright owner]
-        
-           Licensed under the Apache License, Version 2.0 (the "License");
-           you may not use this file except in compliance with the License.
-           You may obtain a copy of the License at
-        
-               http://www.apache.org/licenses/LICENSE-2.0
-        
-           Unless required by applicable law or agreed to in writing, software
-           distributed under the License is distributed on an "AS IS" BASIS,
-           WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-           See the License for the specific language governing permissions and
-           limitations under the License.
-        
-Project-URL: Homepage, https://github.com/GoodMood2008/langchain_agentx_python
-Project-URL: Source, https://github.com/GoodMood2008/langchain_agentx_python
-Project-URL: Bug Tracker, https://github.com/GoodMood2008/langchain_agentx_python/issues
-Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3 :: Only
-Classifier: Programming Language :: Python :: 3.11
-Classifier: License :: OSI Approved :: Apache Software License
-Classifier: Operating System :: OS Independent
-Requires-Python: >=3.11
-Description-Content-Type: text/markdown
-Provides-Extra: dev
-License-File: LICENSE
-
-# langchain-agentx-python
-
-`langchain-agentx-python` 是一组基于 LangChain / LangGraph 的”代码智能体”工具函数，帮助你在自己的项目里快速集成：
-
-- OpenCode 风格的 LangGraph Agent（代码理解、重构、分析）
-- 上下文感知中间件、性能监控等基础设施
-- 完整的工具运行时系统和权限管理
-
-## 安装
-
-发布到 PyPI 后，你可以直接通过 pip 安装：
-
-```bash
-pip install langchain-agentx-python
-```
-
-## 快速上手
-
-```python
-from langchain_agentx import create_loop_agent
-
-# 这里省略 LangChain / LangGraph 相关模型与工具配置
-agent = create_loop_agent(...)
-```
-
-具体的能力和使用方式可以参考源码中的 docstring 以及各模块下的 `README.md`。
-
-## 发布新版本流程
-
-> **重要特性**：本项目的构建脚本会**自动排除所有测试文件**，生成纯净的生产包。当前有 140+ 个测试文件在构建时会被自动过滤，确保发布的包轻量、干净。
->
-> 以下命令默认在项目根目录并已激活 Python 虚拟环境。
-
-### 📋 发布前检查清单
-
-- [ ] 代码已提交到 Git 仓库
-- [ ] 版本号已更新（`pyproject.toml`）
-- [ ] 工作区干净（`git status` 检查）
-- [ ] 已安装构建工具（首次需要）
-
-### 🚀 快速发布（推荐使用专用构建脚本）
-
-#### Step 1: 准备版本号
-
-编辑 `pyproject.toml`，修改版本号：
-
-```toml
-[project]
-name = "langchain-agentx-python"
-version = "0.1.0"  # 当前版本为 0.1，发布建议改为 0.1.0
-```
-
-#### Step 2: 提交代码更改
-
-```bash
-# 检查状态
-git status
-
-# 提交所有更改
-git add .
-git commit -m "release: prepare for version 0.1.0"
-git push
-```
-
-#### Step 3: 使用专用构建脚本生成纯净包
-
-```bash
-# 使用项目专用构建脚本（自动排除测试文件）
-bash script/build-wheel.sh
-```
-
-**构建脚本特性**：
-- ✅ 自动排除 140+ 个测试文件
-- ✅ 排除 `__pycache__`、`.pytest_cache` 等
-- ✅ 验证 wheel 包内容安全性
-- ✅ 生成到 `_build/dist/` 目录
-
-构建成功后会看到：
-
-```
-== Wheel content check (no test_* files) ==
-wheel: langchain_agentx_python-0.1.0-py3-none-any.whl
-py files: 456
-bad test-like files: 0
-wheel check ok
-```
-
-#### Step 4: 验证构建产物
-
-```bash
-# 查看生成的文件
-ls -lh _build/dist/
-
-# 应该看到：
-# langchain_agentx_python-0.1.0-py3-none-any.whl
-```
-
-#### Step 5: 本地测试安装（推荐）
-
-```bash
-# 创建临时测试环境
-python -m venv test_env
-source test_env/bin/activate  # Linux/macOS
-# 或 test_env\Scripts\activate  # Windows
-
-# 安装构建的包
-python -m pip install _build/dist/*.whl
-
-# 验证导入
-python -c "from langchain_agentx import create_loop_agent; print('SDK 安装成功')"
-
-# 清理测试环境
-deactivate
-rm -rf test_env
-```
-
-#### Step 6: 发布到 PyPI
-
-**首次发布需要配置 PyPI 凭证**：
-
-1. 注册 PyPI 账号：https://pypi.org/account/register/
-2. 启用双重认证（2FA）
-3. 生成 API Token：https://pypi.org/manage/account/token/
-4. 创建 `~/.pypirc` 配置文件：
-
-```bash
-cat > ~/.pypirc <<'EOF'
-[distutils]
-index-servers =
-    pypi
-    testpypi
-
-[pypi]
-username = __token__
-password = pypi-xxxx你的API_TOKENxxxx
-
-[testpypi]
-username = __token__
-password = pypi-xxxx你的TestPyPI_TOKENxxxx
-EOF
-```
-
-**发布到 TestPyPI（推荐先测试）**：
-
-```bash
-# 上传到测试仓库
-python -m twine upload --repository testpypi _build/dist/*
-
-# 测试安装
-python -m pip install --index-url https://test.pypi.org/simple/ langchain-agentx-python==0.1.0
-```
-
-**发布到正式 PyPI**：
-
-```bash
-# 上传到正式仓库
-python -m twine upload _build/dist/*
-
-# 验证发布
-python -m pip install langchain-agentx-python==0.1.0
-```
-
-#### Step 7: 打标签并推送（可选但推荐）
-
-```bash
-# 创建版本标签
-git tag v0.1.0
-
-# 推送标签到远程
-git push --tags
-```
-
-### 📦 备用方法：使用标准构建工具
-
-如果专用构建脚本不可用，可以使用标准方法：
-
-```bash
-# 安装构建工具
-python -m pip install -U build twine
-
-# 清理旧构建
-rm -rf dist/ build/ *.egg-info
-
-# 构建分发包
-python -m build
-
-# 查看产物
-ls -lh dist/
-
-# 发布
-python -m twine upload dist/*
-```
-
-### ⚠️ 注意事项
-
-1. **版本号格式**：建议使用语义化版本，如 `0.1.0`、`0.2.0` 等
-2. **测试文件排除**：专用构建脚本会自动排除所有测试文件，标准方法需要手动配置
-3. **PyPI 名称**：包名在 PyPI 上显示为 `langchain-agentx-python`
-4. **版本冲突**：如果版本号已存在，上传会失败，需要更新版本号
-
-### 🔄 下次发布
-
-下次发布时，只需重复上述步骤：
-
-1. 更新 `pyproject.toml` 版本号
-2. 提交代码：`git commit && git push`
-3. 构建包：`bash script/build-wheel.sh`
-4. 发布：`python -m twine upload _build/dist/*`
-5. 打标签：`git tag && git push --tags`
-
-## 核心功能
-
-### Agent Loop 系统
-- OpenCode 风格的 LangGraph Agent 实现
-- finish_reason 驱动的主动退出机制
-- 完全兼容 LangChain 生态
-
-### 工具运行时系统
-- 跨平台工具执行（Bash、Glob、Grep、Read 等）
-- 权限管理和安全控制
-- 工具状态隔离和会话管理
-
-### 中间件和钩子系统
-- 上下文感知的中间件
-- before/after 钩子系统
-- 性能监控和事件追踪
-
-### 配置和工作空间管理
-- 统一的工作空间配置
-- Agent Home 目录管理
-- 跨平台路径处理
-
-## 文档
-
-- **工程指南**：`CLAUDE.md`
-- **架构文档**：`docs/architecture/`
-- **设计文档**：`docs/design-docs/`
-- **开发指南**：`docs/guides/`
-
-## 开发
-
-### 运行测试
-
-```bash
-# 安装开发依赖
-pip install -e “.[dev]”
-
-# 运行测试
-pytest langchain_agentx/
-```
-
-### 代码规范
-
-所有代码遵循项目编码规范：`docs/guides/coding-style-guide.html`
-
-## 贡献
-
-欢迎提交 Issue 和 Pull Request！
-
-## 许可证
-
-Apache License 2.0
+Metadata-Version: 2.1
+Name: langchain-agentx-python
+Version: 0.7.8
+Summary: LangChain/LangGraph-based agent utilities for CodeBaseX.
+Author-email: GoodMood2008 <GoodMood2008@users.noreply.github.com>
+License:                                  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
+        
+           APPENDIX: How to apply the Apache License to your work.
+        
+              To apply the Apache License to your work, attach the following
+              boilerplate notice, with the fields enclosed by brackets "[]"
+              replaced with your own identifying information. (Don't include
+              the brackets!)  The text should be enclosed in the appropriate
+              comment syntax for the file format. We also recommend that a
+              file or class name and description of purpose be included on the
+              same "printed page" as the copyright notice for easier
+              identification within third-party archives.
+        
+           Copyright [yyyy] [name of copyright owner]
+        
+           Licensed under the Apache License, Version 2.0 (the "License");
+           you may not use this file except in compliance with the License.
+           You may obtain a copy of the License at
+        
+               http://www.apache.org/licenses/LICENSE-2.0
+        
+           Unless required by applicable law or agreed to in writing, software
+           distributed under the License is distributed on an "AS IS" BASIS,
+           WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+           See the License for the specific language governing permissions and
+           limitations under the License.
+        
+Project-URL: Homepage, https://github.com/GoodMood2008/langchain_agentx_python
+Project-URL: Source, https://github.com/GoodMood2008/langchain_agentx_python
+Project-URL: Bug Tracker, https://github.com/GoodMood2008/langchain_agentx_python/issues
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.11
+Classifier: License :: OSI Approved :: Apache Software License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+Provides-Extra: dev
+License-File: LICENSE
+
+# langchain-agentx-python
+
+`langchain-agentx-python` 是一组基于 LangChain / LangGraph 的”代码智能体”工具函数，帮助你在自己的项目里快速集成：
+
+- OpenCode 风格的 LangGraph Agent（代码理解、重构、分析）
+- 上下文感知中间件、性能监控等基础设施
+- 完整的工具运行时系统和权限管理
+
+## 安装
+
+发布到 PyPI 后，你可以直接通过 pip 安装：
+
+```bash
+pip install langchain-agentx-python
+```
+
+## 快速上手
+
+```python
+from langchain_agentx import create_loop_agent
+
+# 这里省略 LangChain / LangGraph 相关模型与工具配置
+agent = create_loop_agent(...)
+```
+
+具体的能力和使用方式可以参考源码中的 docstring 以及各模块下的 `README.md`。
+
+## 发布新版本流程
+
+> **重要特性**：本项目的构建脚本会**自动排除所有测试文件**，生成纯净的生产包。当前有 140+ 个测试文件在构建时会被自动过滤，确保发布的包轻量、干净。
+>
+> 以下命令默认在项目根目录并已激活 Python 虚拟环境。
+
+### 📋 发布前检查清单
+
+- [ ] 代码已提交到 Git 仓库
+- [ ] 版本号已更新（`pyproject.toml`）
+- [ ] 工作区干净（`git status` 检查）
+- [ ] 已安装构建工具（首次需要）
+
+### 🚀 快速发布（推荐使用专用构建脚本）
+
+#### Step 1: 准备版本号
+
+编辑 `pyproject.toml`，修改版本号：
+
+```toml
+[project]
+name = "langchain-agentx-python"
+version = "0.1.0"  # 当前版本为 0.1，发布建议改为 0.1.0
+```
+
+#### Step 2: 提交代码更改
+
+```bash
+# 检查状态
+git status
+
+# 提交所有更改
+git add .
+git commit -m "release: prepare for version 0.1.0"
+git push
+```
+
+#### Step 3: 使用专用构建脚本生成纯净包
+
+```bash
+# 使用项目专用构建脚本（自动排除测试文件）
+bash script/build-wheel.sh
+```
+
+**构建脚本特性**：
+- ✅ 自动排除 140+ 个测试文件
+- ✅ 排除 `__pycache__`、`.pytest_cache` 等
+- ✅ 验证 wheel 包内容安全性
+- ✅ 生成到 `_build/dist/` 目录
+
+构建成功后会看到：
+
+```
+== Wheel content check (no test_* files) ==
+wheel: langchain_agentx_python-0.1.0-py3-none-any.whl
+py files: 456
+bad test-like files: 0
+wheel check ok
+```
+
+#### Step 4: 验证构建产物
+
+```bash
+# 查看生成的文件
+ls -lh _build/dist/
+
+# 应该看到：
+# langchain_agentx_python-0.1.0-py3-none-any.whl
+```
+
+#### Step 5: 本地测试安装（推荐）
+
+```bash
+# 创建临时测试环境
+python -m venv test_env
+source test_env/bin/activate  # Linux/macOS
+# 或 test_env\Scripts\activate  # Windows
+
+# 安装构建的包
+python -m pip install _build/dist/*.whl
+
+# 验证导入
+python -c "from langchain_agentx import create_loop_agent; print('SDK 安装成功')"
+
+# 清理测试环境
+deactivate
+rm -rf test_env
+```
+
+#### Step 6: 发布到 PyPI
+
+**首次发布需要配置 PyPI 凭证**：
+
+1. 注册 PyPI 账号：https://pypi.org/account/register/
+2. 启用双重认证（2FA）
+3. 生成 API Token：https://pypi.org/manage/account/token/
+4. 创建 `~/.pypirc` 配置文件：
+
+```bash
+cat > ~/.pypirc <<'EOF'
+[distutils]
+index-servers =
+    pypi
+    testpypi
+
+[pypi]
+username = __token__
+password = pypi-xxxx你的API_TOKENxxxx
+
+[testpypi]
+username = __token__
+password = pypi-xxxx你的TestPyPI_TOKENxxxx
+EOF
+```
+
+**发布到 TestPyPI（推荐先测试）**：
+
+```bash
+# 上传到测试仓库
+python -m twine upload --repository testpypi _build/dist/*
+
+# 测试安装
+python -m pip install --index-url https://test.pypi.org/simple/ langchain-agentx-python==0.1.0
+```
+
+**发布到正式 PyPI**：
+
+```bash
+# 上传到正式仓库
+python -m twine upload _build/dist/*
+
+# 验证发布
+python -m pip install langchain-agentx-python==0.1.0
+```
+
+#### Step 7: 打标签并推送（可选但推荐）
+
+```bash
+# 创建版本标签
+git tag v0.1.0
+
+# 推送标签到远程
+git push --tags
+```
+
+### 📦 备用方法：使用标准构建工具
+
+如果专用构建脚本不可用，可以使用标准方法：
+
+```bash
+# 安装构建工具
+python -m pip install -U build twine
+
+# 清理旧构建
+rm -rf dist/ build/ *.egg-info
+
+# 构建分发包
+python -m build
+
+# 查看产物
+ls -lh dist/
+
+# 发布
+python -m twine upload dist/*
+```
+
+### ⚠️ 注意事项
+
+1. **版本号格式**：建议使用语义化版本，如 `0.1.0`、`0.2.0` 等
+2. **测试文件排除**：专用构建脚本会自动排除所有测试文件，标准方法需要手动配置
+3. **PyPI 名称**：包名在 PyPI 上显示为 `langchain-agentx-python`
+4. **版本冲突**：如果版本号已存在，上传会失败，需要更新版本号
+
+### 🔄 下次发布
+
+下次发布时，只需重复上述步骤：
+
+1. 更新 `pyproject.toml` 版本号
+2. 提交代码：`git commit && git push`
+3. 构建包：`bash script/build-wheel.sh`
+4. 发布：`python -m twine upload _build/dist/*`
+5. 打标签：`git tag && git push --tags`
+
+## 核心功能
+
+### Agent Loop 系统
+- OpenCode 风格的 LangGraph Agent 实现
+- finish_reason 驱动的主动退出机制
+- 完全兼容 LangChain 生态
+
+### 工具运行时系统
+- 跨平台工具执行（Bash、Glob、Grep、Read 等）
+- 权限管理和安全控制
+- 工具状态隔离和会话管理
+
+### 中间件和钩子系统
+- 上下文感知的中间件
+- before/after 钩子系统
+- 性能监控和事件追踪
+
+### 配置和工作空间管理
+- 统一的工作空间配置
+- Agent Home 目录管理
+- 跨平台路径处理
+
+## 文档
+
+- **工程指南**：`CLAUDE.md`
+- **架构文档**：`docs/architecture/`
+- **设计文档**：`docs/design-docs/`
+- **开发指南**：`docs/guides/`
+
+## 开发
+
+### 运行测试
+
+```bash
+# 安装开发依赖
+pip install -e “.[dev]”
+
+# 运行测试
+pytest langchain_agentx/
+```
+
+### 代码规范
+
+所有代码遵循项目编码规范：`docs/guides/coding-style-guide.html`
+
+## 贡献
+
+欢迎提交 Issue 和 Pull Request！
+
+## 许可证
+
+Apache License 2.0