cortx 1.0.0__tar.gz

cortx-1.0.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Cortex Agent Contributors
+
+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.

cortx-1.0.0/PKG-INFO

@@ -0,0 +1,176 @@
+Metadata-Version: 2.4
+Name: cortx
+Version: 1.0.0
+Summary: 安全可控的 AI Agent 运行时框架 — Harness Agent 架构 + Agentic Loop 引擎
+Author: Cortex Agent Contributors
+License: MIT
+Keywords: ai-agent,llm,agent-framework,harness,agentic-loop,mcp,browser-automation
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Classifier: Topic :: Software Development :: Libraries :: Application Frameworks
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: openai>=1.0
+Requires-Dist: httpx>=0.27
+Provides-Extra: dev
+Requires-Dist: pytest>=8; extra == "dev"
+Requires-Dist: pytest-asyncio; extra == "dev"
+Dynamic: license-file
+
+# Cortex Agent
+
+安全可控的 AI Agent 运行时 — **Harness Agent 架构 + Agentic Loop 引擎**
+
+[![Python](https://img.shields.io/badge/python-3.10+-blue.svg)](https://www.python.org/downloads/)
+[![TypeScript](https://img.shields.io/badge/typescript-5.x-blue.svg)](https://www.typescriptlang.org/)
+[![Node](https://img.shields.io/badge/node-24+-green.svg)](https://nodejs.org/)
+[![License](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
+
+> **Cortex** = 大脑皮层。如同大脑皮层负责感知推理、血脑屏障严格过滤、海马体持久记忆 — Cortex Agent 将 Agentic Loop（推理）、PolicyEngine（安全）、Memory（记忆）融为一体。
+
+---
+
+## 双语言实现
+
+| | Python | TypeScript |
+|---|--------|-----------|
+| 位置 | `python/cortex_agent/` | `src/` |
+| 工具数 | 43 | 43 |
+| 安装 | `pip install cortx` | `npm install -g cortx` |
+| CLI 命令 | `ctx` | `ctx` |
+
+> 💡 **PyPI: `pip install cortx`，npm: `npm install -g cortx`。运行只需 `ctx`**
+
+---
+
+## 快速开始
+
+```bash
+# Python (3 字母包名)
+pip install cortx
+ctx
+
+# TypeScript
+npm install -g cortx
+ctx
+ctx                         # 交互 REPL
+ctx -q "hello"              # 单次查询
+ctx --model pro             # 指定模型
+
+# 单次查询
+ctx -q "用 Python 写斐波那契函数"
+```
+
+---
+
+## 设计哲学
+
+```
+┌──────────┐    ┌──────────┐    ┌──────────┐    ┌──────────┐
+│  Think   │ →  │  Guard   │ →  │   Act    │ →  │ Reflect  │
+│ (LLM流式)│    │(Policy)  │    │(Executor)│    │(步数收敛)│
+└──────────┘    └──────────┘    └──────────┘    └──────────┘
+```
+
+| 原则 | 说明 |
+|------|------|
+| **Agent 自主决策** | 不注入行为指令，Agent 从工具结果中自行推理 |
+| **完整中介** | 所有工具调用必经 PolicyEngine 4 级审计 |
+| **Share-nothing 隔离** | 每实例独立 work_dir / executor / observer |
+
+---
+
+## 项目结构
+
+```
+ctx/
+├── python/cortex_agent/        # Python 包
+│   ├── cortex_agent.py          # Agentic Loop 核心引擎
+│   ├── policy.py                # PolicyEngine 安全策略
+│   ├── llm.py                   # LLM Provider (DeepSeek/OpenAI)
+│   ├── tools.py                 # 核心工具 (25)
+│   ├── tools_mcp.py             # MCP 客户端 + 注册表
+│   ├── tools_browser.py         # CDP WebSocket 浏览器
+│   ├── tools_computer.py        # 桌面控制
+│   ├── tools_network.py         # 代理/镜像
+│   ├── tools_rag.py             # RAG 知识检索
+│   ├── main.py                  # CLI 入口
+│   ├── terminal.py              # 流式终端
+│   ├── memory.py                # 记忆/会话
+│   ├── config.py                # 配置加载
+│   └── skills.py                # 技能系统
+│
+├── src/                         # TypeScript 包
+│   ├── core/                    # 核心引擎
+│   ├── tools/                   # 工具模块 (7 文件)
+│   └── cli/                     # CLI 入口
+│
+├── cortex_workspace/            # 运行时工作区
+├── CORTEX.md                    # 项目知识库
+├── pyproject.toml               # Python 包配置
+├── package.json                 # npm 包配置
+└── tsconfig.json                # TypeScript 配置
+```
+
+---
+
+## 43 个工具
+
+| 分类 | 工具 |
+|------|------|
+| **文件** | `list_directory` `read_file` `write_file` `edit_file` `glob` `grep` `diff_files` `file_ops` `read_json` `csv_query` |
+| **执行** | `run_shell_command` `run_python` `execute_sql_query` `python_lint` |
+| **网络** | `web_search` `web_fetch` `http_request` `set_proxy` `unset_proxy` `show_proxy` |
+| **记忆** | `remember_fact` `recall_fact` `forget_fact` `ask_user` |
+| **任务** | `task_create` `task_list` `task_update` |
+| **MCP** | `mcp_list_servers` `mcp_list_tools` `mcp_call_tool` `mcp_registry` `mcp_install` `mcp_quick` |
+| **浏览器** | `browser_navigate` `browser_snapshot` `browser_screenshot` |
+| **桌面** | `computer_screenshot` `computer_click` |
+| **镜像** | `pip_mirror` `npm_mirror` |
+| **RAG** | `search_knowledge` `rebuild_knowledge_index` |
+| **时间** | `get_current_time` |
+
+---
+
+## REPL 命令
+
+| 命令 | 功能 |
+|------|------|
+| `/help` | 显示帮助 |
+| `/context` | 上下文容量 + 缓存命中率 |
+| `/kb` | 查看知识库 CORTEX.md |
+| `/goal [目标]` | 设置/查看持久化目标 |
+| `/plan [描述]` | 进入规划模式 |
+| `/skills` | 列出所有技能 |
+| `/skill <name>` | 调用技能 |
+| `/mode [s\|a\|y]` | 切换权限模式 (Shift+Tab) |
+| `/model [pro]` | 切换模型 |
+| `/tools` | 列出工具 |
+| `/trace` `/audit` | 审计追踪 |
+| `/memory` | 查看记忆 |
+| `/sessions` | 列出会话 |
+| `@filename` | 文件引用 |
+| `/init` | 初始化项目 |
+
+---
+
+## 权限模式
+
+| 模式 | 行为 |
+|------|------|
+| `standard` 🛡️ | SAFE 自动 / WRITE 区内 / SYSTEM 需确认 |
+| `auto-edit` ✏️ | 自动批准编辑 + SYSTEM 放行 |
+| `yolo` ⚠️ | 全部放行 (CI/CD) |
+
+---
+
+## License
+
+MIT

cortx-1.0.0/README.md

@@ -0,0 +1,150 @@
+# Cortex Agent
+
+安全可控的 AI Agent 运行时 — **Harness Agent 架构 + Agentic Loop 引擎**
+
+[![Python](https://img.shields.io/badge/python-3.10+-blue.svg)](https://www.python.org/downloads/)
+[![TypeScript](https://img.shields.io/badge/typescript-5.x-blue.svg)](https://www.typescriptlang.org/)
+[![Node](https://img.shields.io/badge/node-24+-green.svg)](https://nodejs.org/)
+[![License](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
+
+> **Cortex** = 大脑皮层。如同大脑皮层负责感知推理、血脑屏障严格过滤、海马体持久记忆 — Cortex Agent 将 Agentic Loop（推理）、PolicyEngine（安全）、Memory（记忆）融为一体。
+
+---
+
+## 双语言实现
+
+| | Python | TypeScript |
+|---|--------|-----------|
+| 位置 | `python/cortex_agent/` | `src/` |
+| 工具数 | 43 | 43 |
+| 安装 | `pip install cortx` | `npm install -g cortx` |
+| CLI 命令 | `ctx` | `ctx` |
+
+> 💡 **PyPI: `pip install cortx`，npm: `npm install -g cortx`。运行只需 `ctx`**
+
+---
+
+## 快速开始
+
+```bash
+# Python (3 字母包名)
+pip install cortx
+ctx
+
+# TypeScript
+npm install -g cortx
+ctx
+ctx                         # 交互 REPL
+ctx -q "hello"              # 单次查询
+ctx --model pro             # 指定模型
+
+# 单次查询
+ctx -q "用 Python 写斐波那契函数"
+```
+
+---
+
+## 设计哲学
+
+```
+┌──────────┐    ┌──────────┐    ┌──────────┐    ┌──────────┐
+│  Think   │ →  │  Guard   │ →  │   Act    │ →  │ Reflect  │
+│ (LLM流式)│    │(Policy)  │    │(Executor)│    │(步数收敛)│
+└──────────┘    └──────────┘    └──────────┘    └──────────┘
+```
+
+| 原则 | 说明 |
+|------|------|
+| **Agent 自主决策** | 不注入行为指令，Agent 从工具结果中自行推理 |
+| **完整中介** | 所有工具调用必经 PolicyEngine 4 级审计 |
+| **Share-nothing 隔离** | 每实例独立 work_dir / executor / observer |
+
+---
+
+## 项目结构
+
+```
+ctx/
+├── python/cortex_agent/        # Python 包
+│   ├── cortex_agent.py          # Agentic Loop 核心引擎
+│   ├── policy.py                # PolicyEngine 安全策略
+│   ├── llm.py                   # LLM Provider (DeepSeek/OpenAI)
+│   ├── tools.py                 # 核心工具 (25)
+│   ├── tools_mcp.py             # MCP 客户端 + 注册表
+│   ├── tools_browser.py         # CDP WebSocket 浏览器
+│   ├── tools_computer.py        # 桌面控制
+│   ├── tools_network.py         # 代理/镜像
+│   ├── tools_rag.py             # RAG 知识检索
+│   ├── main.py                  # CLI 入口
+│   ├── terminal.py              # 流式终端
+│   ├── memory.py                # 记忆/会话
+│   ├── config.py                # 配置加载
+│   └── skills.py                # 技能系统
+│
+├── src/                         # TypeScript 包
+│   ├── core/                    # 核心引擎
+│   ├── tools/                   # 工具模块 (7 文件)
+│   └── cli/                     # CLI 入口
+│
+├── cortex_workspace/            # 运行时工作区
+├── CORTEX.md                    # 项目知识库
+├── pyproject.toml               # Python 包配置
+├── package.json                 # npm 包配置
+└── tsconfig.json                # TypeScript 配置
+```
+
+---
+
+## 43 个工具
+
+| 分类 | 工具 |
+|------|------|
+| **文件** | `list_directory` `read_file` `write_file` `edit_file` `glob` `grep` `diff_files` `file_ops` `read_json` `csv_query` |
+| **执行** | `run_shell_command` `run_python` `execute_sql_query` `python_lint` |
+| **网络** | `web_search` `web_fetch` `http_request` `set_proxy` `unset_proxy` `show_proxy` |
+| **记忆** | `remember_fact` `recall_fact` `forget_fact` `ask_user` |
+| **任务** | `task_create` `task_list` `task_update` |
+| **MCP** | `mcp_list_servers` `mcp_list_tools` `mcp_call_tool` `mcp_registry` `mcp_install` `mcp_quick` |
+| **浏览器** | `browser_navigate` `browser_snapshot` `browser_screenshot` |
+| **桌面** | `computer_screenshot` `computer_click` |
+| **镜像** | `pip_mirror` `npm_mirror` |
+| **RAG** | `search_knowledge` `rebuild_knowledge_index` |
+| **时间** | `get_current_time` |
+
+---
+
+## REPL 命令
+
+| 命令 | 功能 |
+|------|------|
+| `/help` | 显示帮助 |
+| `/context` | 上下文容量 + 缓存命中率 |
+| `/kb` | 查看知识库 CORTEX.md |
+| `/goal [目标]` | 设置/查看持久化目标 |
+| `/plan [描述]` | 进入规划模式 |
+| `/skills` | 列出所有技能 |
+| `/skill <name>` | 调用技能 |
+| `/mode [s\|a\|y]` | 切换权限模式 (Shift+Tab) |
+| `/model [pro]` | 切换模型 |
+| `/tools` | 列出工具 |
+| `/trace` `/audit` | 审计追踪 |
+| `/memory` | 查看记忆 |
+| `/sessions` | 列出会话 |
+| `@filename` | 文件引用 |
+| `/init` | 初始化项目 |
+
+---
+
+## 权限模式
+
+| 模式 | 行为 |
+|------|------|
+| `standard` 🛡️ | SAFE 自动 / WRITE 区内 / SYSTEM 需确认 |
+| `auto-edit` ✏️ | 自动批准编辑 + SYSTEM 放行 |
+| `yolo` ⚠️ | 全部放行 (CI/CD) |
+
+---
+
+## License
+
+MIT

cortx-1.0.0/pyproject.toml

@@ -0,0 +1,42 @@
+[build-system]
+requires = ["setuptools>=75", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "cortx"
+version = "1.0.0"
+description = "安全可控的 AI Agent 运行时框架 — Harness Agent 架构 + Agentic Loop 引擎"
+readme = "README.md"
+license = {text = "MIT"}
+authors = [
+    {name = "Cortex Agent Contributors"}
+]
+keywords = ["ai-agent", "llm", "agent-framework", "harness", "agentic-loop", "mcp", "browser-automation"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: Scientific/Engineering :: Artificial Intelligence",
+    "Topic :: Software Development :: Libraries :: Application Frameworks",
+]
+requires-python = ">=3.10"
+dependencies = [
+    "openai>=1.0",
+    "httpx>=0.27",
+]
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=8",
+    "pytest-asyncio",
+]
+
+[project.scripts]
+ctx = "cortex_agent.main:main"
+
+[tool.setuptools.packages.find]
+where = ["python"]

cortx-1.0.0/python/cortex_agent/__init__.py

@@ -0,0 +1,11 @@
+"""
+Cortex Agent — Python Package
+══════════════════════════════════
+
+Harness Agent 架构 + Agentic Loop 运行时
+"""
+
+from .cortex_agent import CortexAgent, AgentConfig, LLMProvider, registry
+from .policy import PolicyEngine
+
+__version__ = '1.0.0'

cortx-1.0.0/python/cortex_agent/config.py

@@ -0,0 +1,163 @@
+"""
+配置加载器 — 从 settings.json 读取配置，合并到 AgentConfig
+
+加载优先级（从低到高）:
+  1. 代码默认值 (AgentConfig dataclass defaults)
+  2. settings.json（项目级: {cwd}/.cortex/settings.json）
+  3. settings.json（用户级: ~/.cortex/settings.json）
+  4. 环境变量 (CORTEX_API_KEY, CORTEX_MODEL, etc.)
+  5. CLI 参数
+
+settings.json 结构:
+{
+  "model": "flash",
+  "provider": "deepseek",
+  "providers": {
+    "deepseek": {
+      "api_key": "sk-...",
+      "base_url": "https://api.deepseek.com/v1",
+      "models": { "flash": "deepseek-v4-flash", "pro": "deepseek-v4-pro" }
+    },
+    "openai": {
+      "api_key": "sk-...",
+      "base_url": "https://api.openai.com/v1",
+      "models": { "gpt4": "gpt-4o", "gpt4m": "gpt-4o-mini" }
+    }
+  },
+  "max_steps": 10,
+  "work_dir": "./cortex_workspace",
+  "loop_timeout": 120,
+  "think_timeout": 60,
+  "auto_extract_memory": true,
+  "memory_enabled": true,
+  "sessions_enabled": true
+}
+"""
+
+import os, json
+from typing import Optional
+
+
+def _find_upwards(filename: str, start: str = None) -> Optional[str]:
+    """从 start 向上搜索 filename，返回完整路径或 None。"""
+    d = os.path.abspath(start or os.getcwd())
+    while True:
+        candidate = os.path.join(d, filename)
+        if os.path.isfile(candidate):
+            return candidate
+        parent = os.path.dirname(d)
+        if parent == d:
+            return None
+        d = parent
+
+
+def load_settings(project_dir: str = None) -> dict:
+    """加载合并后的设置字典。用户级覆盖项目级。"""
+    merged = {}
+
+    # 1. 项目级
+    proj = _find_upwards(".cortex/settings.json", project_dir or os.getcwd())
+    if proj:
+        try:
+            with open(proj, "r", encoding="utf-8") as f:
+                merged.update(json.load(f))
+        except Exception:
+            pass
+
+    # 2. 用户级 (~)
+    user = os.path.join(os.path.expanduser("~"), ".cortex", "settings.json")
+    if os.path.isfile(user):
+        try:
+            with open(user, "r", encoding="utf-8") as f:
+                merged.update(json.load(f))
+        except Exception:
+            pass
+
+    # 3. 环境变量覆盖
+    if os.environ.get("CORTEX_API_KEY"):
+        merged.setdefault("providers", {})
+        provider = merged.get("provider", "deepseek")
+        merged["providers"].setdefault(provider, {})
+        merged["providers"][provider]["api_key"] = os.environ["CORTEX_API_KEY"]
+    if os.environ.get("CORTEX_MODEL"):
+        merged["model"] = os.environ["CORTEX_MODEL"]
+
+    return merged
+
+
+def apply_to_config(config, settings: dict):
+    """将 settings dict 应用到 AgentConfig 对象。"""
+    from .cortex_agent import LLMProvider
+
+    # Provider 注册
+    LLMProvider.setup(
+        providers=settings.get("providers"),
+        active=settings.get("provider", "deepseek"),
+    )
+
+    # API key：先取当前 provider 的 api_key，再取 settings 顶层，再取 config 已有值
+    active_provider = LLMProvider.provider_name()
+    providers = settings.get("providers", {})
+    provider_cfg = providers.get(active_provider, {})
+    api_key = provider_cfg.get("api_key", "") or settings.get("api_key", "") or config.api_key
+    config.api_key = api_key
+
+    # 简单字段
+    for key in ("model", "max_steps", "tool_timeout", "system_prompt",
+                "max_context_msgs", "loop_timeout", "think_timeout",
+                "work_dir", "memory_dir", "sessions_dir", "skills_dir",
+                "memory_enabled", "sessions_enabled", "auto_extract_memory",
+                "permission_mode", "permission_remember", "workspace_only",
+                "context_limit"):
+        if key in settings:
+            setattr(config, key, settings[key])
+
+
+def create_default_settings(path: str) -> dict:
+    """在 path 路径创建默认 settings.json。返回写入的 dict。"""
+    default = {
+        "model": "pro",
+        "provider": "deepseek",
+        "providers": {
+            "deepseek": {
+                "api_key": "",
+                "base_url": "https://api.deepseek.com/v1",
+                "models": {"flash": "deepseek-v4-flash", "pro": "deepseek-v4-pro"},
+            }
+        },
+        "max_steps": 10,
+        "loop_timeout": 120,
+        "think_timeout": 60,
+        "auto_extract_memory": True,
+        "memory_enabled": True,
+        "sessions_enabled": True,
+        "permission_mode": "standard",
+        "permission_remember": True,
+        "workspace_only": False,
+        "context_limit": 1000000,
+        "mcpServers": {
+            "playwright": {
+                "command": "npx",
+                "args": ["-y", "@playwright/mcp@latest"],
+                "description": "浏览器自动化（Microsoft 官方）"
+            },
+            "fetch": {
+                "command": "python",
+                "args": ["-m", "mcp_server_fetch"],
+                "description": "HTTP 抓取 + HTML→Markdown"
+            },
+            "sqlite": {
+                "command": "npx",
+                "args": ["-y", "@modelcontextprotocol/server-sqlite"],
+                "description": "SQLite 数据库查询"
+            },
+            "context7": {
+                "url": "https://mcp.context7.com/mcp",
+                "description": "实时库/框架文档查询"
+            }
+        }
+    }
+    os.makedirs(os.path.dirname(path), exist_ok=True)
+    with open(path, "w", encoding="utf-8") as f:
+        json.dump(default, f, ensure_ascii=False, indent=2)
+    return default