isage-middleware 0.1.3.1__py3-none-any.whl → 0.2.0.0__py3-none-any.whl

isage_middleware-0.2.0.0.dist-info/METADATA

@@ -0,0 +1,258 @@
+Metadata-Version: 2.4
+Name: isage-middleware
+Version: 0.2.0.0
+Summary: SAGE Middleware - Streaming-Augmented Generative Execution
+Author-email: IntelliStream Team <shuhao_zhang@hust.edu.cn>
+License: MIT
+Project-URL: Homepage, https://github.com/intellistream/SAGE
+Project-URL: Repository, https://github.com/intellistream/SAGE.git
+Project-URL: Documentation, https://intellistream.github.io/SAGE-Pub/
+Project-URL: Issues, https://github.com/intellistream/SAGE/issues
+Keywords: data,api,reasoning,dataflow,llm,ml,middleware,framework,rag,intellistream,ai,sage
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Science/Research
+Classifier: Operating System :: OS Independent
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: System :: Distributed Computing
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: python-jose[cryptography]<4.0.0,>=3.5.0
+Requires-Dist: passlib[argon2]<2.0.0,>=1.7.4
+Requires-Dist: celery<6.0.0,>=5.5.0
+Requires-Dist: flower<3.0.0,>=2.0.0
+Requires-Dist: openai<1.91.0,>=1.52.0
+Requires-Dist: ollama<1.0.0,>=0.5.0
+Requires-Dist: zhipuai<3.0.0,>=2.1.0
+Requires-Dist: cohere<6.0.0,>=5.16.0
+Requires-Dist: anthropic<1.0.0,>=0.25.0
+Requires-Dist: transformers<4.54.0,>=4.52.0
+Requires-Dist: tokenizers<0.24.0,>=0.21.0
+Requires-Dist: faiss-cpu<2.0.0,>=1.7.0
+Requires-Dist: isage-vdb>=0.1.5
+Requires-Dist: isage-tsdb
+Requires-Dist: isage-flow
+Requires-Dist: isage-refiner
+Requires-Dist: isage-libs
+Requires-Dist: bm25s<1.0.0,>=0.2.13
+Requires-Dist: rank-bm25<1.0.0,>=0.2.0
+Requires-Dist: PyStemmer<4.0.0,>=3.0.0
+Requires-Dist: json_repair<1.0.0,>=0.30.0
+Requires-Dist: aiohttp<4.0.0,>=3.12.0
+Requires-Dist: frozenlist<2.0.0,>=1.7.0
+Requires-Dist: feedparser<7.0.0,>=6.0.11
+Requires-Dist: accelerate<2.0.0,>=1.9.0
+Requires-Dist: sentence-transformers<4.0.0,>=3.1.0
+Requires-Dist: InstructorEmbedding<2.0.0,>=1.0.0
+Requires-Dist: huggingface-hub<1.0.0,>=0.34.0
+Requires-Dist: peft<1.0.0,>=0.18.0
+Requires-Dist: scipy<2.0.0,>=1.15.0
+Requires-Dist: llmlingua<1.0.0,>=0.2.0
+Requires-Dist: markdown<4.0.0,>=3.4.4
+Requires-Dist: pymdown-extensions<11.0.0,>=10.2.0
+Provides-Extra: neuromem
+Requires-Dist: isage-neuromem; extra == "neuromem"
+Provides-Extra: sage-deps
+Requires-Dist: isage-common; extra == "sage-deps"
+Requires-Dist: isage-platform; extra == "sage-deps"
+Requires-Dist: isage-kernel; extra == "sage-deps"
+Requires-Dist: isage-libs; extra == "sage-deps"
+Provides-Extra: all
+Requires-Dist: isage-middleware[neuromem,sage-deps]; extra == "all"
+Provides-Extra: sage
+Requires-Dist: isage-common; extra == "sage"
+Provides-Extra: database
+Requires-Dist: sqlalchemy>=2.0.0; extra == "database"
+Requires-Dist: alembic>=1.13.0; extra == "database"
+Requires-Dist: asyncpg>=0.30.0; extra == "database"
+Requires-Dist: pymongo[srv]>=4.8.0; extra == "database"
+Provides-Extra: messagequeue
+Requires-Dist: celery>=5.5.0; extra == "messagequeue"
+Requires-Dist: redis>=4.0.0; extra == "messagequeue"
+Requires-Dist: kafka-python>=2.0.0; extra == "messagequeue"
+Requires-Dist: pika>=1.3.2; extra == "messagequeue"
+Provides-Extra: monitoring
+Requires-Dist: prometheus-client>=0.19.0; extra == "monitoring"
+Requires-Dist: structlog>=23.0.0; extra == "monitoring"
+Requires-Dist: sentry-sdk[fastapi]>=2.18.0; extra == "monitoring"
+Provides-Extra: llm
+Requires-Dist: anthropic>=0.25.0; extra == "llm"
+Requires-Dist: google-generativeai>=0.8.3; extra == "llm"
+Requires-Dist: cohere>=5.16.1; extra == "llm"
+Requires-Dist: langchain>=0.3.18; extra == "llm"
+Requires-Dist: llama-index>=0.11.33; extra == "llm"
+Provides-Extra: docs
+Requires-Dist: sphinx>=7.0.0; extra == "docs"
+Requires-Dist: sphinx-rtd-theme>=1.3.0; extra == "docs"
+Requires-Dist: myst-parser>=2.0.0; extra == "docs"
+Requires-Dist: mkdocs>=1.6.0; extra == "docs"
+Requires-Dist: mkdocs-material>=9.6.0; extra == "docs"
+Requires-Dist: jinja2<4.0.0,>=3.1.0; extra == "docs"
+Requires-Dist: markupsafe>=2.0.1; extra == "docs"
+Requires-Dist: click>=7.0; extra == "docs"
+Requires-Dist: packaging>=20.5; extra == "docs"
+Provides-Extra: testing
+Requires-Dist: pytest>=7.0.0; extra == "testing"
+Requires-Dist: pytest-asyncio>=0.23.0; extra == "testing"
+Requires-Dist: pytest-cov>=4.0.0; extra == "testing"
+Requires-Dist: pytest-benchmark>=4.0.0; extra == "testing"
+Requires-Dist: testcontainers>=3.7.0; extra == "testing"
+Requires-Dist: pytest-mock>=3.10.0; extra == "testing"
+Requires-Dist: pytest-docker>=2.0.0; extra == "testing"
+
+# SAGE Middleware（中间件）
+
+## 📋 Overview
+
+用于构建带有 AI 能力的流式数据应用的中间件层，集成了多家大模型提供商、异步任务、鉴权以及高性能的数据处理组件。
+
+## ✨ Key Features
+
+- 🤖 AI 接入：OpenAI / Anthropic / Cohere / Ollama / 智谱 等
+- 🔎 检索与向量：RAG、BM25、FAISS 等
+- � 任务调度：Celery 异步任务
+- 🔐 安全鉴权：JWT、密码学工具
+- ⚙️ 核心组件：
+  - `sage_db`：数据库/向量存储相关组件（含 C/C++ 扩展）
+  - `sage_flow`：高性能向量流处理（可能包含扩展或独立子模块）
+
+## 🚀 Installation
+
+```bash
+pip install isage-middleware
+
+# 可选：VLLM 支持（需要 CUDA）
+pip install isage-common[vllm]
+
+# 可选：与完整 SAGE 框架集成
+pip install isage-middleware[sage]
+```
+
+## 📖 Quick Start
+
+```python
+from sage.middleware.api.client import APIClient
+from sage.middleware.auth.jwt import JWTManager
+
+client = APIClient()
+jwt_manager = JWTManager()
+
+resp = client.chat_completion(
+    provider="openai",
+    messages=[{"role": "user", "content": "Hello!"}],
+)
+print(resp)
+```
+
+## 配置示例
+
+```yaml
+# config.yaml
+middleware:
+  auth:
+    secret_key: "your-secret-key"  # pragma: allowlist secret
+    algorithm: "HS256"
+  providers:
+    openai:
+      api_key: "sk-..."  # pragma: allowlist secret
+      base_url: "https://api.openai.com/v1"
+```
+
+## 开发与本地安装
+
+```bash
+git clone https://github.com/intellistream/SAGE.git
+cd SAGE/packages/sage-middleware
+pip install -e .
+```
+
+> 说明：中间件组件（sage_db/sage_flow/sage_tsdb 等）现已随源码直接提供或通过 pip 依赖分发，无需初始化任何子模块。
+
+## 新增中间件组件的规范（重要）
+
+当你添加新的中间件组件（例如 `sage_foo`）时，请务必在 `setup.py` 中接入其构建逻辑，这样在安装 `isage-middleware` 时会自动构建/准备该组件。
+
+建议遵循以下约定：
+
+### 1. 目录结构
+
+- `src/sage/middleware/components/sage_foo/`
+  - `__init__.py`（Python 包）
+  - （如包含 C/C++ 部分）`cmake/`、`build.sh`、`CMakeLists.txt`
+  - 其他源码/资源文件
+
+### 2. C++ 扩展与依赖要求
+
+如果组件包含 C/C++ 扩展，**必须**遵守以下依赖约束，以与现有 `sage_db`、`sage_flow` 保持一致：
+
+> **注意**: 以下代码示例中的 `SAGE_COMMON_DEPS_FILE` 等变量是 CMake 环境变量，非占位符。
+
+1. **共享依赖入口：**
+
+   - 在 `CMakeLists.txt` 中优先加载共享依赖脚本（通过环境变量）：
+     ```cmake
+     set(_sage_foo_shared_deps FALSE)
+     # Check if shared deps file is defined
+     if(DEFINED SAGE_COMMON_DEPS_FILE AND EXISTS "$ENV(SAGE_COMMON_DEPS_FILE)")
+         include("$ENV(SAGE_COMMON_DEPS_FILE)")
+         set(_sage_foo_shared_deps TRUE)
+     endif()
+     ```
+   - 共享脚本会提供 `pybind11::module`、统一的可见性编译选项、以及全部 gperftools 配置变量。
+
+1. **本地回退脚本：**
+
+   - 请在组件目录的 `cmake/` 下提供 `pybind11_dependency.cmake` 和（如需要）`gperftools.cmake`，用于在独立构建或共享脚本缺失时下载依赖。
+   - 在 `CMakeLists.txt` 中检测 `_sage_foo_shared_deps`，若为 `FALSE` 再加载本地脚本：
+     ```cmake
+     if(NOT _sage_foo_shared_deps)
+         include(cmake/pybind11_dependency.cmake)
+     endif()
+     ```
+
+1. **gperftools 约定：**
+
+   - 新增扩展应暴露 `ENABLE_GPERFTOOLS` 选项，并默认遵循 `SAGE_ENABLE_GPERFTOOLS` 环境变量。
+   - 只有在确认找到 `SAGE_GPERFTOOLS_LIBS`（或本地回退脚本成功解析）时才链接 gperftools；否则务必禁用该选项并给出清晰日志。
+
+1. **环境变量约定：**
+
+   - 共享脚本会设置 `SAGE_COMMON_COMPILE_OPTIONS`、`SAGE_COMMON_COMPILE_DEFINITIONS` 等变量，请在目标上引用，避免重复配置。
+   - 新扩展若需要自定义变量，务必提供合理的默认值，并允许通过环境变量覆写。
+
+1. **打包要求：**
+
+   - `pyproject.toml` 中需包含 `"sage.middleware.components.sage_foo" = ["cmake/*.cmake"]` 等条目，保证 CMake
+     脚本在发布包内。
+   - 如扩展存在 Python 侧绑定（`python/` 目录），确保 `pyproject.toml` 中的 `package-data` 同步更新。
+
+### 3. 构建脚本
+
+- 如果组件需要编译或额外准备工作，请提供标准的 `build.sh`，支持无交互执行：
+  - `bash build.sh --install-deps`
+- `build.sh` 应读取相关环境变量（如依赖文件路径、gperftools 开关等），并在调用 `cmake` 时透传（参考 `sage_db`、`sage_flow`）。
+
+### 4. 在 `setup.py` 中接入
+
+- 在自定义的 `build_ext` 流程中：
+  - 新增 `build_sage_foo()` 方法（参照现有 `build_sage_db()` / `build_sage_flow()`）。
+  - 使用统一的 `_shared_env()` 帮助函数为子进程注入共享依赖环境。
+  - 在 `run()` 中调用 `self.build_sage_foo()`，并保证失败不阻断安装（打印清晰日志即可）。
+
+### 5. 环境变量开关（可选）
+
+- 通过设置 `SAGE_SKIP_C_EXTENSIONS=1` 可以跳过所有扩展构建（调试纯 Python 逻辑时常用）。
+
+### 6. CI 与子模块提示
+
+- CI 会递归检出子模块并按 `setup.py` 的逻辑尝试构建。
+- 中间件组件不再通过 Git submodule 分发；请不要在 CI 或本地执行子模块初始化命令。
+
+## 贡献
+
+欢迎提交 PR！请先阅读仓库根目录的 [CONTRIBUTING.md](../../CONTRIBUTING.md)。
+
+## 📄 License
+
+MIT License - see [LICENSE](../../LICENSE) for details.

isage_middleware-0.2.0.0.dist-info/RECORD

@@ -0,0 +1,186 @@
+sage/middleware/__init__.py,sha256=0VLtoshNFWRzLHvE_wVq3DuYXwQrzyBJ9yfMa3Vaj-A,1972
+sage/middleware/__init__.pyc,sha256=wJsgqjrrkvHHlpDb7cothVETsjfE1piUlfbO2A_iEZ0,2192
+sage/middleware/_version.py,sha256=rPX3HOAxFqxBXp7l7ijXcfkVddjGINBiy0DZYpQ8Ga4,177
+sage/middleware/_version.pyc,sha256=To0NxV7hEj4-1zoguG1mmauu_QY1kjhQeUp-2t7Q1vw,381
+sage/middleware/py.typed,sha256=42WLrVlzpn7jMsIIEdXWWE5YOGnCHXrlnm5sbY6TFmQ,96
+sage/middleware/__pycache__/__init__.cpython-311.pyc,sha256=eZBugrpi5ZmdWSw_KyVIeu0Bwt2goiusSE7X3NIc0w4,2174
+sage/middleware/__pycache__/_version.cpython-311.pyc,sha256=A3j7ZGuBDNctTaXUQ0ToVjBOLGSF7K48Afqa4IBYr6A,361
+sage/middleware/components/__init__.py,sha256=Yu2o7GjYeLXG2RRsyso6aMmfEHWZeyYTYQ3UEMvaeAM,643
+sage/middleware/components/__init__.pyc,sha256=vE19mf8iGwoVP8dLdLbMsDDe6SXor8pEFKfleEl3vDY,731
+sage/middleware/components/extensions_compat.pyc,sha256=uXtuzspxiNVLW6VhaaWlb42WCjenB1r1s8ytBgvbByk,4792
+sage/middleware/components/__pycache__/__init__.cpython-311.pyc,sha256=rouz_-WHBVhjVQ1-jCRB-WWftB_yhXtUvQEfzZQOl6A,713
+sage/middleware/components/__pycache__/extensions_compat.cpython-311.pyc,sha256=43SjWrblm4oHghnTzVlu8Ds907wcfMFx04RNzQHdpAc,4774
+sage/middleware/components/sage_db/__init__.py,sha256=rA1z9DGqYgxCY9UiRyRDrMLQxaGCHJTN0ySr7GEWMr0,3130
+sage/middleware/components/sage_db/__init__.pyc,sha256=nXHgdOGC9VDOfl0RSjzBykYcgckVVhuNk7QE6gL4ApE,2845
+sage/middleware/components/sage_db/backend.pyc,sha256=Db3eQS8UrXJnBxTOKYapNxF7CT5168ybdvBLNqNPkVE,6076
+sage/middleware/components/sage_db/service.pyc,sha256=LxCjGd2fgD_2JQlkqvunDW2IFCaUeNLMt1eXxjPMZSI,713
+sage/middleware/components/sage_db/__pycache__/__init__.cpython-311.pyc,sha256=DuOAzFNLlkdMwjzOzX0IZ1VMGlxxmkxVxHK3jsa2rRc,2827
+sage/middleware/components/sage_db/__pycache__/backend.cpython-311.pyc,sha256=_Lh70MfZQUQZPzO1sAOw_NGYDxTzsfK_ZrJwlU8qdGU,6058
+sage/middleware/components/sage_flow/__init__.py,sha256=vs6wj9g5I5OArMgwnlFW_E4GXMshY0p54HL3r8lsmTY,2016
+sage/middleware/components/sage_flow/__init__.pyc,sha256=9ZcSpEgHzxmUQ6V-5rrw1mQBTrwBYwHQn0U7WW5Ltww,1840
+sage/middleware/components/sage_flow/service.pyc,sha256=x95qegmyiloh6_ME7Q0lkmfUI3Qu_QC_YWokTXZVnGs,599
+sage/middleware/components/sage_flow/__pycache__/__init__.cpython-311.pyc,sha256=mTH47erxwISANbD15zRq_Ls8y2cdGLC8HoWajUGnrSk,1822
+sage/middleware/components/sage_flow/examples/basic_service.pyc,sha256=i8utTEQFMlk9JdsEUPtQbdLf7hRlDaNgMFkfg0qvTng,3511
+sage/middleware/components/sage_flow/python/__init__.py,sha256=5hEJGXJSj9Dpo9n2VX5egr-e7dxgzgnMAUkVwtELde0,457
+sage/middleware/components/sage_flow/python/__init__.pyc,sha256=kqYwMYW8UsJ9EQV7J4PO7kU5FKi4-f6npYcw4pxIUYw,558
+sage/middleware/components/sage_flow/python/sage_flow.pyc,sha256=OU_TkBuADsJnBq1ddRSvraN7xiQmuQehpkRZyGKd8BE,817
+sage/middleware/components/sage_flow/python/__pycache__/__init__.cpython-311.pyc,sha256=yhqTr71gsThBwXRXxUtzE05zC1PxZjgNJdcsxQmkl5o,540
+sage/middleware/components/sage_flow/python/__pycache__/sage_flow.cpython-311.pyc,sha256=aS7bwcykza1X0DIk2kjnm2Ztv0QRZ77gSzkHDYm8_H4,799
+sage/middleware/components/sage_flow/python/micro_service/__init__.py,sha256=gMNyW3GRLBIrP3qiAaKjAX_yLfBpcrFbW9rDVtqs-9Q,118
+sage/middleware/components/sage_flow/python/micro_service/__init__.pyc,sha256=WtLz7y4h7NNcVamhi4o1Hv1huxE1EIhsz4CSShzjT4s,340
+sage/middleware/components/sage_flow/python/micro_service/sage_flow_service.pyc,sha256=xp9w9YNV3gR954bAOknkqjWjKHZpDSsShRS4HPdGLYE,5361
+sage/middleware/components/sage_flow/python/micro_service/__pycache__/__init__.cpython-311.pyc,sha256=hlbtMfYgebH7ZcfnNUiF6JNTmcnD0Zi0DfmFYb7d_iM,322
+sage/middleware/components/sage_flow/python/micro_service/__pycache__/sage_flow_service.cpython-311.pyc,sha256=OtFb73kWVYUEOCJSQxg6FJFm2COFdR1Pid4jkTMsgAU,5343
+sage/middleware/components/sage_mem/__init__.py,sha256=0Vb2ZKzRo82danMZJl2Nxh7krj5mKZUCcLrY_UEk4MM,2903
+sage/middleware/components/sage_mem/__init__.pyc,sha256=awqn49zGC8yiT1pX7_9EYn6CLQZq90xifjHIEnuhGh0,2702
+sage/middleware/components/sage_mem/__pycache__/__init__.cpython-311.pyc,sha256=pYoOF7AHyeT_t6NU2WaNxh-nyXYp-DBhH2dtpXpBj7c,2684
+sage/middleware/components/sage_refiner/__init__.py,sha256=94XJR3UOPiMIpg6Rzg4NAx0ZGXoxihYRVtfHcfiHgV0,2788
+sage/middleware/components/sage_refiner/__init__.pyc,sha256=mx3DjUK3YzsRtw7WuiY34WJfb9wB5ZXLyaMRfY_TxTE,2440
+sage/middleware/components/sage_refiner/__pycache__/__init__.cpython-311.pyc,sha256=lF4BxXhtlENmYX7EOPd-qABU7D_tB4NIvupWYMdsWRs,2422
+sage/middleware/components/sage_refiner/examples/basic_usage.pyc,sha256=2yw4LGf-_diD_G9f2bUuOJtvAt3xf87c_4izQbOeVHw,8406
+sage/middleware/components/sage_refiner/examples/context_service_demo.pyc,sha256=BJq7FUNb0UWtMnmGaucBLwyDs892t_x4xCcF24BGsh0,7881
+sage/middleware/components/sage_refiner/examples/rag_integration.pyc,sha256=mkbTrOeCyfGz4gNwCKvLRAHtoYdRFFj627a6FhxFBzQ,4575
+sage/middleware/components/sage_refiner/python/__init__.py,sha256=oPA6YuzmEnFMeVgb7uvO6cfSESfOUb9D3Yd7FtxK3MA,928
+sage/middleware/components/sage_refiner/python/__init__.pyc,sha256=eHf1fMVelfEQ79W8zKr84OyXodN9c6FnLwoAboeW-o8,1158
+sage/middleware/components/sage_refiner/python/adapter.pyc,sha256=MKpi3-EfMsfYF8PJjD5bM0Ic6GFFyXnZM37vOp-uYb0,6265
+sage/middleware/components/sage_refiner/python/context_service.pyc,sha256=YANIBTb5yncC0bcCOaV-0k8Y7SRc7T-EIJACTbaw_rs,9076
+sage/middleware/components/sage_refiner/python/service.pyc,sha256=-dOlkaUji_gRgAcHLPnIexQ4pvGfVfOh3ZEAYU_gg14,14219
+sage/middleware/components/sage_refiner/python/__pycache__/__init__.cpython-311.pyc,sha256=UuedkSED7rlwl6SuPetkO2ZvdJY8-xM8CQ8Nj25ltlw,1140
+sage/middleware/components/sage_refiner/python/__pycache__/context_service.cpython-311.pyc,sha256=jB40HCfnDc5R9Jy8hD3ZgjGHjbn39TaeLbM55OXWvR8,9058
+sage/middleware/components/sage_refiner/python/__pycache__/service.cpython-311.pyc,sha256=Keawj5JtikpR3OUt-tp_GOe_ETN8VN3Y6m90ianzwvw,14201
+sage/middleware/components/sage_tsdb/__init__.py,sha256=BaY8TthTdkQ7oMWD6flAu_6cqw0CiErDU6t6A8P_2Rc,2081
+sage/middleware/components/sage_tsdb/__init__.pyc,sha256=rcOlKqeR81MM6IYYVG-tIbpq0oynmx7znJqorx0Z1t4,1786
+sage/middleware/components/sage_tsdb/service.pyc,sha256=VEZeyZ3RMttmPf0eMRZHW8rwg_7qYNL2woLbBI1a8-w,668
+sage/middleware/components/sage_tsdb/__pycache__/__init__.cpython-311.pyc,sha256=DMD_8UhG-JLMfagGqmThNFe8zes6lsx4NYt4Ipy0P5g,1768
+sage/middleware/components/sage_tsdb/examples/basic_usage.pyc,sha256=vvJE3GcCXYpdtOy-nEsJZNmTEPCq02O1FJj2v28CW7Q,5398
+sage/middleware/components/sage_tsdb/examples/service_demo.pyc,sha256=nFoc83j-2-0K2TGYSs0stedZP9xceru5IVBPiuvppPA,5208
+sage/middleware/components/sage_tsdb/examples/stream_join_demo.pyc,sha256=BS7WWS3BL9UB-fPdstpiPb-GGfpIWCEDWiQy0M6EgIo,7183
+sage/middleware/components/sage_tsdb/python/__init__.py,sha256=umH2E_KItHaRMG0pLzUhuEWhIWZYaLmYe1K3al3qKIY,553
+sage/middleware/components/sage_tsdb/python/__init__.pyc,sha256=EcIpW3jC0PplPdur1FZBRZ146ynfN05DpolCL8ZIyGM,727
+sage/middleware/components/sage_tsdb/python/_sage_tsdb.cpython-311-x86_64-linux-gnu.so,sha256=ByymWCsL0jetuIxgorQg8OqAD-nUzczSLj3X0TatTLk,315752
+sage/middleware/components/sage_tsdb/python/_sage_tsdb.pyi,sha256=jatBiI4eInV5z_g8aaqlKyXcz37-NV5dfTLtLsTSmXU,502
+sage/middleware/components/sage_tsdb/python/libsage_tsdb_algorithms.so,sha256=lwW7HwzCjagxcdU806IIgJjmLS4UIhbTlMI4PCvdyBE,162520
+sage/middleware/components/sage_tsdb/python/libsage_tsdb_core.so,sha256=5hGlwggKePmZ9EfSMRqbC--Wjwcv4wk5obnBN3eP5AY,561832
+sage/middleware/components/sage_tsdb/python/sage_tsdb.pyc,sha256=SgdwApweoH9AgsLVCGIQigAZOLRHcoLohE8YQJKQ6zA,22392
+sage/middleware/components/sage_tsdb/python/__pycache__/__init__.cpython-311.pyc,sha256=n5X26bu50bQOsSHr7x9fCXIKbAp4lEb2Yco-qvJJfBM,709
+sage/middleware/components/sage_tsdb/python/__pycache__/sage_tsdb.cpython-311.pyc,sha256=YdAgIdfjiUm3IgY1UKyxUpTTFpRHnoY9znqYiKQ-CBI,22374
+sage/middleware/components/sage_tsdb/python/algorithms/__init__.py,sha256=miozMiOag6xpJ0-g3zSMgnyAV9vXSqwtWAPNhdjh2K4,443
+sage/middleware/components/sage_tsdb/python/algorithms/__init__.pyc,sha256=PlmfBtPb0lE6o6r843s2i3Sj3tMpL-COO5-X3oDp6VY,733
+sage/middleware/components/sage_tsdb/python/algorithms/base.pyc,sha256=piTa03rpgS_IqKHu1K_92T7mFM2M9ZB_9IntqDuVTDg,2252
+sage/middleware/components/sage_tsdb/python/algorithms/out_of_order_join.pyc,sha256=-k6Rn0zw-lebCEPO5y6on0R_nZaquQaMazIvpokhc_E,11988
+sage/middleware/components/sage_tsdb/python/algorithms/window_aggregator.pyc,sha256=7LIf9XBTyZNhTgw4jmHD4Om9llukrtMm7IPY4dcBNDI,12930
+sage/middleware/components/sage_tsdb/python/algorithms/__pycache__/__init__.cpython-311.pyc,sha256=A6nQQAVI8_qCSPSFMky7eWMV-ufcojfh82WjVY7wK6c,715
+sage/middleware/components/sage_tsdb/python/algorithms/__pycache__/base.cpython-311.pyc,sha256=SWmCwCDWFCYzUijqsXKBFoL5Q6TfmkhccYQ8SL4vZ7M,2234
+sage/middleware/components/sage_tsdb/python/algorithms/__pycache__/out_of_order_join.cpython-311.pyc,sha256=vJF7ZY4ucRNxF5mX4x9sANrkqOEfRHSYG4kIUDcoyeI,11970
+sage/middleware/components/sage_tsdb/python/algorithms/__pycache__/window_aggregator.cpython-311.pyc,sha256=Gc339u0L-wEY90oeK7DEFBJgQp5PjLreINjyQADlef8,12912
+sage/middleware/components/sage_tsdb/python/micro_service/__init__.py,sha256=NPeT85nf9EHX4Feb2ITuAPRwp4NfcBOhbl0xiCekul4,169
+sage/middleware/components/sage_tsdb/python/micro_service/__init__.pyc,sha256=-E1DChDXN4EtRCTvHVTEqqQ2wBTG6YrJmNyTsnUtfBE,451
+sage/middleware/components/sage_tsdb/python/micro_service/sage_tsdb_service.pyc,sha256=zEaJbchcL0mJy5rrVENHN1sSRiDD8HPEOJRB6m3ot8Q,13233
+sage/middleware/components/sage_tsdb/python/micro_service/__pycache__/__init__.cpython-311.pyc,sha256=G1YZsihiHsB05wJA0QBofOgWCDViEydrM0BNn_oDu7g,433
+sage/middleware/components/sage_tsdb/python/micro_service/__pycache__/sage_tsdb_service.cpython-311.pyc,sha256=tng9VWeQC9-dWALEp14opKTZH8c_lg6pFT9P260gJXw,13215
+sage/middleware/operators/__init__.py,sha256=RvegH1DA47eGy0aaODGdOwd0Z-mQvdryZ_nQt7Mk6IY,1013
+sage/middleware/operators/__init__.pyc,sha256=HO4CqBklsMMytuCJnOeJumxExu65YssL7AwzxIAWcRY,1291
+sage/middleware/operators/__pycache__/__init__.cpython-311.pyc,sha256=HLOD1QZXF4ZAuHbiOI-UCsBYDf3k6bC9X1HnHgc6f4Y,1273
+sage/middleware/operators/agent/__init__.py,sha256=HrdVHkQh3naLdpsEEzYafNbC69RDRjJkbElRHgEA9H4,173
+sage/middleware/operators/agent/__init__.pyc,sha256=CxRTVQmHDcRc1eVfoetH1o9VUwt_4z-QxE6IV2oz74E,436
+sage/middleware/operators/agent/runtime.pyc,sha256=NRoREA2Asl1aQM62lZFabt4aFCVh5eDfmmYdXuWLXco,12903
+sage/middleware/operators/agent/__pycache__/__init__.cpython-311.pyc,sha256=2iRqXG8YBJRBmcqG0NxjBe2CiSuoPaggIxpqLxdjEmc,418
+sage/middleware/operators/agent/__pycache__/runtime.cpython-311.pyc,sha256=OW73HYF_lK6fNNLQ6JLWh6OtpgBUdPILusYjRNVLBSA,12885
+sage/middleware/operators/agent/planning/__init__.py,sha256=-b6-ti_HI8wfHvSTAurwMXXX8ARG0RL0_AfIPnizrJE,219
+sage/middleware/operators/agent/planning/__init__.pyc,sha256=o62g5Z8KMeAyhIeWLrtu8t-9uGAky9PU7ieC1nvs67k,481
+sage/middleware/operators/agent/planning/llm_adapter.pyc,sha256=X5BsIDWhjje5mTlEeQX8NCzXYWAbUR7QusEmUXCeCjY,2060
+sage/middleware/operators/agent/planning/planner_adapter.pyc,sha256=4lgymb9C56pq0gRv-eBLWlIPAXISfhYjk5gZtp8ZyGk,3520
+sage/middleware/operators/agent/planning/router.pyc,sha256=oJ2Lcmz-yTkWIrb5AvpQWOqQNcxzHmygW5IjTI9MxmM,5671
+sage/middleware/operators/agent/planning/__pycache__/__init__.cpython-311.pyc,sha256=r3KFW7fUTOBdHlj_Klu4tPOIVgTReLDA4fbmFVitBzg,463
+sage/middleware/operators/agent/planning/__pycache__/llm_adapter.cpython-311.pyc,sha256=8U4zI3cSaSdxx-4gJxeOTXc_n8Y1aIebu1-owVCpuO0,2042
+sage/middleware/operators/agent/planning/__pycache__/planner_adapter.cpython-311.pyc,sha256=tqkJRKsiCr97ZwCaphUuemGOEwPnpahsUjHXOMrHB7Q,3502
+sage/middleware/operators/agent/planning/__pycache__/router.cpython-311.pyc,sha256=1JWDOc3SvVTqbpANG8yOuFeOz0bdcoQtWMNUa9A_Qc4,5653
+sage/middleware/operators/agentic/__init__.py,sha256=x6T04j4D3kmAzaERiHkXWHfWdGa_1c34c_yAeXmziHI,625
+sage/middleware/operators/agentic/__init__.pyc,sha256=SoW3Rj7yNHqvDCDfcXOFwDMoGSYOLCXd6H_s5lHyYms,901
+sage/middleware/operators/agentic/planning_operator.pyc,sha256=U2SroqubxZBgZB36eforB7L369YtqN8yPZ6SnIPZhQI,3152
+sage/middleware/operators/agentic/refined_searcher.pyc,sha256=mC14K6wRuMbADJF3XBnxjw5hv12aBMxTZxPzEEGgNVY,5531
+sage/middleware/operators/agentic/runtime.pyc,sha256=jLIUQ2owxH1Dt3juoEKisUI1wJFImUeHSXPyewZ6mQQ,7151
+sage/middleware/operators/agentic/timing_operator.pyc,sha256=BFsQlVThvsgPJoKpwTraPX9JtrKydpOsWaDHUXBEmus,3190
+sage/middleware/operators/agentic/tool_selection_operator.pyc,sha256=Uki040SeWlccQmf8RITE-jH4-QL6N1YJSRES22dyBv8,3467
+sage/middleware/operators/agentic/__pycache__/__init__.cpython-311.pyc,sha256=j3K-WLkFVzN40nHfGWBZGk6Gg5WhettAp-qzk-RriRE,883
+sage/middleware/operators/agentic/__pycache__/planning_operator.cpython-311.pyc,sha256=uDk7-t5OHLENWLUN_F5_x7irPonE-X_54q6_HzM3IWE,3134
+sage/middleware/operators/agentic/__pycache__/refined_searcher.cpython-311.pyc,sha256=WWklyHJWSzuhQnydtoxRLTlan9qLzDLN96fDQN7R3xA,5513
+sage/middleware/operators/agentic/__pycache__/runtime.cpython-311.pyc,sha256=8OyHyZR2w5UsHTzoKIvh2quu7EYnbJeWMN5SSlSKl8I,7133
+sage/middleware/operators/agentic/__pycache__/timing_operator.cpython-311.pyc,sha256=6x-IdHHKzMXPKrQqLKXkH_w_1FqoYgjmY-AuHfMOwWU,3172
+sage/middleware/operators/agentic/__pycache__/tool_selection_operator.cpython-311.pyc,sha256=noVzga3b7K3AO_4qAcRNOQhLHLdPMPkHCKvR8NJUrIs,3449
+sage/middleware/operators/context/__init__.py,sha256=QReFA5qvVeKv3nRsoj8xyJHtvNQVSaAvnqTaXE0Ax4A,660
+sage/middleware/operators/context/__init__.pyc,sha256=fwcUqEZPLv2acYomRVTcYTnk2pxKvhyurSZzNgdsNys,970
+sage/middleware/operators/context/critic_evaluation.pyc,sha256=VJV3LZ_d857Y_5McjSutkk8vMjXSbYcealGRaPxXyg8,1164
+sage/middleware/operators/context/model_context.pyc,sha256=BVzsRpcNeHU1QKr-fPGzG9-TQ14-90a-OWJOLX1BkPg,33538
+sage/middleware/operators/context/quality_label.pyc,sha256=mTINEF-TvmUI81H0EydQ3_ES8thDPqePwbz5haKtAM0,849
+sage/middleware/operators/context/search_query_results.pyc,sha256=iguLjX_1umQqK60egcTIqoivMYQcHTjkoR8jT8vZMJo,4883
+sage/middleware/operators/context/search_result.pyc,sha256=loiMcPry-NnEhdzAD2ptR3Li2yY65OK678VTcvUIjXk,2768
+sage/middleware/operators/context/search_session.pyc,sha256=mbVDbS9V5kQ7ehXplwGtk0oxBKZlOyvusJ8iRsrewhE,6731
+sage/middleware/operators/context/__pycache__/__init__.cpython-311.pyc,sha256=QanYjbIBCgA2djum88T_gWiR9yuc_FQ69kW1K3_DOj4,952
+sage/middleware/operators/context/__pycache__/critic_evaluation.cpython-311.pyc,sha256=O_LVSFcRvsxIeRK11qfGYXl2NO3UWWEMH8CyiMJ1CTI,1146
+sage/middleware/operators/context/__pycache__/model_context.cpython-311.pyc,sha256=2wexSD7iqd9yFnvE_wTVnv6oUSE-h9-SU-2ta4P93bU,33520
+sage/middleware/operators/context/__pycache__/quality_label.cpython-311.pyc,sha256=PXqFEsi_Wg7w_8EOWWDhkQCcABwgyZSVav6Zn7fE6Yw,831
+sage/middleware/operators/context/__pycache__/search_query_results.cpython-311.pyc,sha256=hkPTrJT69Dy4yLrDqQpBmVrZZFIjxwdz6RAYQFUPWDM,4865
+sage/middleware/operators/context/__pycache__/search_result.cpython-311.pyc,sha256=CSyRLZOXotq12TNIdr79FhIfLPdhybFU9lXg3ig_UfM,2750
+sage/middleware/operators/context/__pycache__/search_session.cpython-311.pyc,sha256=UoDikCkO3rDBVtmnTzkLYlUQxEwN8iPRCGioEG3ttp0,6713
+sage/middleware/operators/filters/__init__.py,sha256=k5V5EMjWNXxi7XkKfnuv6IK9MTOZRM3QOnPHulGbzfI,689
+sage/middleware/operators/filters/__init__.pyc,sha256=fqUAu59-2W19E1AJwro8m52YhbNZoc-FDflpwTb_5i4,900
+sage/middleware/operators/filters/context_sink.pyc,sha256=sFvphjxj4jTNpqn_u2PyuaMmzZXl7odtvC9xNjILLyA,21537
+sage/middleware/operators/filters/context_source.pyc,sha256=dmpJGGDsWH-OlF6hOERfauKt8Vx3jFHiPNstqFB8Xt8,19683
+sage/middleware/operators/filters/evaluate_filter.pyc,sha256=aPJgU5AodhSwk9FJP4_yjqzumUQe3l_HvcNVnEZ_o04,3704
+sage/middleware/operators/filters/tool_filter.pyc,sha256=l6jUiZvNU8eSnsA-2pvbauf3xTQ-G9dQwG2pgBYiIxg,4060
+sage/middleware/operators/filters/__pycache__/__init__.cpython-311.pyc,sha256=whaYFs32f3X-n0kefdJMgmIKDtXrENnKBnLh3AxPmCM,882
+sage/middleware/operators/filters/__pycache__/context_sink.cpython-311.pyc,sha256=nchmnhqu2rU5qS_-Z06myYiOmXjHI2v5_nkk4m5idJI,21519
+sage/middleware/operators/filters/__pycache__/context_source.cpython-311.pyc,sha256=Wv8p48Lmg7jVZImyLMHm009Q3US2NEhjMkd6egG2jD0,19665
+sage/middleware/operators/filters/__pycache__/evaluate_filter.cpython-311.pyc,sha256=-SCht63H-nmmF8ensUVWWmP73Iu9biJTnmNFrJc3vV4,3686
+sage/middleware/operators/filters/__pycache__/tool_filter.cpython-311.pyc,sha256=6e4OSjcJgfOtc8GfDvwt4mA3sYaz7J6Gxr55Z9o7sF4,4042
+sage/middleware/operators/llm/__init__.py,sha256=NGexj-0eZ-HGCP4b28iGi9ezjdBM-AWUmfxhY9FHHlU,240
+sage/middleware/operators/llm/__init__.pyc,sha256=z0gQ3mb2G3bJAba3Rp3U7Qe7IX-wG9QfRQAnYw75O8w,507
+sage/middleware/operators/llm/vllm_generator.pyc,sha256=9iFXK19n2hJ_BPanwO1Hfel4up5UFkbxBz70NdvB8oI,6703
+sage/middleware/operators/llm/__pycache__/__init__.cpython-311.pyc,sha256=CRzeXZtikKX2zJkt_NMpTJidD5Pvhbm1uUf3wTu28Eo,489
+sage/middleware/operators/llm/__pycache__/vllm_generator.cpython-311.pyc,sha256=TeQJJWmnyBTNaxjOvMPm9WC8PeCIISRhD25T9pPWZfA,6685
+sage/middleware/operators/rag/__init__.py,sha256=bfeHq7yaWjDTzX8-M90t5RXffmIBrZYyOoZTuHYAGCw,5667
+sage/middleware/operators/rag/__init__.pyc,sha256=sF-0BIDur382VvsRh9Y0RMlv0fL2MSr2lJ0jjoU7sSg,4531
+sage/middleware/operators/rag/arxiv.pyc,sha256=ddBCx2zCj6y5GMmFZM_rFBsdU62peYht4RQ4QeH1a_U,16793
+sage/middleware/operators/rag/chunk.pyc,sha256=a2XUZ-CfOZmPsSgBl--iT8L6dO2IdRoy5e1HjkCMBTc,657
+sage/middleware/operators/rag/document_loaders.pyc,sha256=gg2Wz_p0QMyc7HxQ4VHN2ZXng6bhBftz3yI04i48FOM,761
+sage/middleware/operators/rag/evaluate.pyc,sha256=dx9VTPJWlLNQUouJEpofiQX6NS6Lzmx0e1uZ8IOIPII,35888
+sage/middleware/operators/rag/generator.pyc,sha256=0nrNI_seD3WYrOaXHFC15o1SsfYcm2ZE7IosqQPisPc,10720
+sage/middleware/operators/rag/pipeline.pyc,sha256=Bp7vIj1Jq1rPZKpi1WkfxDBIAlC4r8I06Men5vhk-NE,1993
+sage/middleware/operators/rag/profiler.pyc,sha256=9YejdME58vZ_V2XvBR7eZYQVnD8e1VgKTXsNgF8wzBc,3225
+sage/middleware/operators/rag/promptor.pyc,sha256=vZEh-sT9BNxrzzglg8SlvdufugnLONw8B11gVjzu2Yo,16184
+sage/middleware/operators/rag/refiner.pyc,sha256=2-pHZ-kEn74RIewnwTA1kb7liKyopPtWo8oN1d7vBUo,10172
+sage/middleware/operators/rag/reranker.pyc,sha256=TxGAIzkKnQsIdV3Ny0rYAWJcojzlkH4dJMa3bZPgNrY,16850
+sage/middleware/operators/rag/retriever.pyc,sha256=pCF3YRxhDK0_3scmh-MPVwt1n-mwu3f5t3IXXc0NDMg,60435
+sage/middleware/operators/rag/searcher.pyc,sha256=3_PjVHbP9Xo7WAZguLdAV1iMlmIRxNdu5BFhY2vSMqc,2579
+sage/middleware/operators/rag/types.pyc,sha256=NAyTj1pkwcAGRfg0cOdic1jx7dAkTf4pL4tTno4lxV8,772
+sage/middleware/operators/rag/writer.pyc,sha256=cpUCdqJZcNZjFwBegf9dp6GL0A7i2EKI-ev_pcsyi0I,4226
+sage/middleware/operators/rag/__pycache__/__init__.cpython-311.pyc,sha256=szU_Se4WvvT5ZDboebsjLDm5eE7wVOZNk3M4jHKOeEs,4513
+sage/middleware/operators/rag/__pycache__/generator.cpython-311.pyc,sha256=DPWmQ0Zyw-YCR6qeacUvqThszb7-fRxs6Hy7ePvhVbc,10702
+sage/middleware/operators/rag/index_builder/__init__.py,sha256=dxMXEO_bRb83qNCMLffMqtFoaxY5YMjfP3ZobKX35cc,1631
+sage/middleware/operators/rag/index_builder/__init__.pyc,sha256=7tLiaDRxMH5bFrBlPBCYFDoHwI0KDg48dCw4_alJggw,1937
+sage/middleware/operators/rag/index_builder/builder.pyc,sha256=6_GGmYfzHWuWtl1h0BnzUPBQ-KZr28m1-P8P6sohfMw,16917
+sage/middleware/operators/rag/index_builder/manifest.pyc,sha256=QUCLoT5vd5G_RnhMBiroBPh0BI7yILeCypNC8WeOXSM,4968
+sage/middleware/operators/rag/index_builder/storage.pyc,sha256=odHxH8GPyIEVVBLrAh3Bl6i_jCf7YILlcirttB8ptTc,5439
+sage/middleware/operators/tools/__init__.py,sha256=QYhojM3QqPcOQbdX2g8c2kGpS9H2k4otZGkXnTdRnjs,1005
+sage/middleware/operators/tools/__init__.pyc,sha256=xYakFJn0T0pik5w9e7Ws8h7oIZISSx9cnWZMzPGLI4I,1314
+sage/middleware/operators/tools/arxiv_paper_searcher.pyc,sha256=hAoVKgG1ro72fyKiNY1wA5kaT1xitftK7rQsBw0SQYM,8018
+sage/middleware/operators/tools/arxiv_searcher.pyc,sha256=RYu8ceQhe6s6yhdZfzI_06kFcKTQKkG7mNepH0Hbz4c,6161
+sage/middleware/operators/tools/duckduckgo_searcher.pyc,sha256=dY9Z3P0C9ZOUEprTPNKpomOfiqaFbYBBS4_A0OmQQIk,6493
+sage/middleware/operators/tools/image_captioner.pyc,sha256=NdT0aekRPuuGJPURT-JbqbxcEYJtUlPLHcIa7ooo044,5315
+sage/middleware/operators/tools/nature_news_fetcher.pyc,sha256=wDYrhb1dMACsAT0jxWvjm7nopD4l0CogKX2NtFAFdo4,11086
+sage/middleware/operators/tools/searcher_tool.pyc,sha256=VDqYOzHSEOK6R5yDdkLRNKE5Ck0p2UVXXjraJGXDPKA,23173
+sage/middleware/operators/tools/text_detector.pyc,sha256=hNNLxFrdDhrzkD50BvIQmHcYBSONSZ1U4nofs6MNimk,8327
+sage/middleware/operators/tools/url_text_extractor.pyc,sha256=cDgmhEBiPFjpNwIN9HmX5BggQlFrjUz4d2ZVJeTEebM,4837
+sage/middleware/operators/tools/__pycache__/__init__.cpython-311.pyc,sha256=YTOK5ZXphxAFk-uYNT7dGwZE-fGIJuZXl7_rjGTjua8,1296
+sage/middleware/operators/tools/__pycache__/arxiv_paper_searcher.cpython-311.pyc,sha256=kopIf92e4x5wWsmDFpIXb5-07X7-lkOTRsK2lsDeni8,8000
+sage/middleware/operators/tools/__pycache__/arxiv_searcher.cpython-311.pyc,sha256=cU-E_CmrCssb-TZPK2DDqu3csH5aptodT_tCfn0gnGc,6143
+sage/middleware/operators/tools/__pycache__/image_captioner.cpython-311.pyc,sha256=QKk1BJckxkgLZri0DMeuaHoTMwKx9payo-Ah7i_yvlc,5297
+sage/middleware/operators/tools/__pycache__/nature_news_fetcher.cpython-311.pyc,sha256=wGqrzg1pecMG6-hjYvJ5cDCI9XEj3hUSnt4TLFbb9KA,11068
+sage/middleware/operators/tools/__pycache__/searcher_tool.cpython-311.pyc,sha256=-CRpMoqmXGhBn5AXJA4vH9rR1alhdcL7i22l2l8Ihl0,23155
+sage/middleware/operators/tools/__pycache__/text_detector.cpython-311.pyc,sha256=mXFc20oMUVTkoh4zvltcV5WijGf1sxjBAk4cxcWA32c,8309
+sage/middleware/operators/tools/__pycache__/url_text_extractor.cpython-311.pyc,sha256=__bitVBibTWwFw_jFCEyDglULkqJZkIMEVnUFvderyw,4819
+isage_middleware-0.2.0.0.dist-info/METADATA,sha256=sS5hGYZkhfWom7iC167YJ5qVuN_oWjwh1TTNutkp6GA,10151
+isage_middleware-0.2.0.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+isage_middleware-0.2.0.0.dist-info/top_level.txt,sha256=hibFyzQHiLOMK68qL1OWsNKaXOmSXqZjeLTBem6Yy7I,5
+isage_middleware-0.2.0.0.dist-info/RECORD,,

sage/middleware/__init__.py

@@ -1,56 +1,59 @@
 """
-SAGE - Streaming-Augmented Generative Execution
+SAGE Middleware - 中间件和领域算子层
+
+Layer: L4 (Domain Components)
+Dependencies: sage.libs (L3), sage.kernel (L3), sage.platform (L2), sage.common (L1)
+
+提供：
+- 领域算子：
+  * RAG operators: 检索增强生成 (pipeline, retriever, generator, profiler, document_loaders)
+  * RAG backends: 向量数据库集成 (Milvus, Chroma)
+  * LLM operators: 大语言模型算子
+  * LLM clients: LLM服务客户端 (OpenAI, HuggingFace)
+  * Tool operators: 领域工具 (arxiv_searcher, image_captioner, nature_news等)
+  * Filters: 业务过滤器 (tool_filter, evaluate_filter, context_source/sink)
+- 业务上下文：Agent/RAG workflow 上下文管理 (ModelContext, SearchSession等)
+- 中间件组件：
+  * sage_db: 数据库抽象
+  * sage_mem: 内存管理和缓存
+  * sage_refiner: 数据精炼工具 (仅保留service层，算法已下移到sage.libs.context.compression)
+  * sage_flow: 工作流编排
+  * sage_tsdb: 时序数据库
+
+Architecture:
+- L4 层提供领域特定的功能组件
+- 依赖 L1-L3 的基础设施、核心引擎和通用算法
+- 为 L5 (应用层) 提供可复用的领域组件
+- 包含各种中间件和高级算子实现
+
+子模块：
+- operators/: 领域算子
+  * rag/: RAG operators + backends (Milvus, Chroma)
+  * llm/: LLM operators + clients (OpenAI, HuggingFace)
+  * tools/: 领域特定工具
+  * filters/: 业务过滤器
+- context/: Agent/RAG业务上下文 (从sage.libs迁移)
+- components/: 中间件组件（DB, Memory, Refiner等）
 """
 
-# 动态版本加载
-def _load_version():
-    """从 sage-common 包加载版本信息"""
-    try:
-        # 优先从 sage-common 包加载版本
-        from sage.common._version import __version__
-        return {
-            'version': __version__,
-            'author': 'SAGE Team',
-            'email': 'shuhao_zhang@hust.edu.cn'
-        }
-    except ImportError:
-        # 如果 sage-common 不可用，从项目根目录加载（开发环境）
-        try:
-            from pathlib import Path
-            current_file = Path(__file__).resolve()
-            # 根据当前文件位置计算到项目根目录的层数
-            parts = current_file.parts
-            sage_index = -1
-            for i, part in enumerate(parts):
-                if part == 'SAGE':
-                    sage_index = i
-                    break
-            
-            if sage_index >= 0:
-                root_dir = Path(*parts[:sage_index+1])
-                version_file = root_dir / "_version.py"
-                
-                if version_file.exists():
-                    version_globals = {}
-                    with open(version_file, 'r', encoding='utf-8') as f:
-                        exec(f.read(), version_globals)
-                    return {
-                        'version': version_globals.get('__version__', '0.1.3'),
-                        'author': version_globals.get('__author__', 'SAGE Team'),
-                        'email': version_globals.get('__email__', 'shuhao_zhang@hust.edu.cn')
-                    }
-        except Exception:
-            pass
-    
-    # 最后的默认值
-    return {
-        'version': '0.1.3',
-        'author': 'SAGE Team', 
-        'email': 'shuhao_zhang@hust.edu.cn'
-    }
-
-# 加载信息
-_info = _load_version()
-__version__ = _info['version']
-__author__ = _info['author']
-__email__ = _info['email']
+# 直接从本包的_version模块加载版本信息
+try:
+    from sage.middleware._version import __author__, __email__, __version__
+except ImportError:
+    # 备用硬编码版本
+    __version__ = "0.1.4"
+    __author__ = "IntelliStream Team"
+    __email__ = "shuhao_zhang@hust.edu.cn"
+
+# 导出子模块
+__layer__ = "L4"
+
+from . import components, operators
+
+__all__ = [
+    "__version__",
+    "__author__",
+    "__email__",
+    "operators",
+    "components",
+]

sage/middleware/_version.py

@@ -1,38 +1,6 @@
 """Version information for sage-middleware package."""
 
-import os
-from pathlib import Path
-
-def _get_version():
-    """智能版本获取 - 开发环境从根目录读取，构建环境使用内嵌版本"""
-    try:
-        # 尝试从项目根目录读取版本（开发环境）
-        current_file = Path(__file__).resolve()
-        
-        # 从当前文件的上级目录开始查找（跳过自己所在的目录）
-        search_path = current_file.parent.parent  # 直接从上级目录开始
-        for _ in range(10):  # 最多向上查找10层
-            root_version_file = search_path / "_version.py"
-            if root_version_file.exists():
-                # 确保不是自己，并且检查是否是项目根目录的版本文件
-                if root_version_file != current_file:
-                    try:
-                        with open(root_version_file, 'r', encoding='utf-8') as f:
-                            content = f.read()
-                            # 检查是否是根目录版本文件（以注释开头，包含项目信息）
-                            if content.startswith('"""') and 'SAGE Version Information' in content and '__version__' in content:
-                                version_globals = {}
-                                exec(content, version_globals)
-                                return version_globals.get('__version__', '0.1.3')
-                    except Exception:
-                        pass
-            search_path = search_path.parent
-            
-        # 如果找不到根目录版本文件，使用内嵌的备份版本（构建环境）
-        return "0.1.3"
-        
-    except Exception:
-        # 最终备份版本
-        return "0.1.3"
-
-__version__ = _get_version()
+# 独立硬编码版本
+__version__ = "0.2.0.0"
+__author__ = "IntelliStream Team"
+__email__ = "shuhao_zhang@hust.edu.cn"

sage/middleware/components/__init__.py

@@ -0,0 +1,26 @@
+"""
+SAGE Middleware Components
+
+Core middleware components including databases, flow engines, and other services.
+"""
+
+# Lazy imports to avoid loading heavy dependencies (FAISS, etc.) at module load time
+from . import sage_db, sage_flow, sage_refiner, sage_tsdb
+from .extensions_compat import *  # noqa: F403
+
+# Import sage_mem - it's a namespace package that handles its own lazy loading
+try:
+    from . import sage_mem
+except ImportError:
+    # sage_mem namespace package might not be available
+    sage_mem = None
+
+
+__all__ = [
+    "sage_db",
+    "sage_flow",
+    "sage_mem",
+    "sage_refiner",
+    "sage_tsdb",
+    "extensions_compat",
+]