synapse-cli-agent 0.1.14__tar.gz → 0.1.16__tar.gz

synapse_cli_agent-0.1.16/.github/workflows/native-search-wheels.yml

@@ -0,0 +1,82 @@
+name: Native Search Wheels
+
+on:
+  push:
+    tags:
+      - "synapse-search-core-v*"
+  pull_request:
+    paths:
+      - "rust/synapse-search-core/**"
+      - ".github/workflows/native-search-wheels.yml"
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+jobs:
+  wheel:
+    name: ${{ matrix.target }}
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          - os: windows-latest
+            target: x86_64-pc-windows-msvc
+          # macOS wheels target Apple Silicon only; Intel macOS is unsupported.
+          - os: macos-latest
+            target: aarch64-apple-darwin
+          - os: ubuntu-latest
+            target: x86_64-unknown-linux-gnu
+          - os: ubuntu-24.04-arm
+            target: aarch64-unknown-linux-gnu
+    steps:
+      - uses: actions/checkout@v4
+      - uses: PyO3/maturin-action@v1
+        with:
+          command: build
+          working-directory: rust/synapse-search-core
+          target: ${{ matrix.target }}
+          args: --release --locked --compatibility pypi --out dist
+          manylinux: 2014
+      - uses: actions/upload-artifact@v4
+        with:
+          name: wheel-${{ matrix.target }}
+          path: rust/synapse-search-core/dist/*.whl
+
+  publish:
+    if: startsWith(github.ref, 'refs/tags/synapse-search-core-v')
+    needs: wheel
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+    steps:
+      - uses: actions/download-artifact@v4
+        with:
+          pattern: wheel-*
+          merge-multiple: true
+          path: dist
+      - uses: softprops/action-gh-release@v2
+        with:
+          files: dist/*.whl
+          name: synapse-search-core ${{ github.ref_name }}
+
+  publish-pypi:
+    if: startsWith(github.ref, 'refs/tags/synapse-search-core-v')
+    needs: wheel
+    runs-on: ubuntu-latest
+    environment:
+      name: pypi
+      url: https://pypi.org/p/synapse-search-core
+    permissions:
+      id-token: write
+    steps:
+      - uses: actions/download-artifact@v4
+        with:
+          pattern: wheel-*
+          merge-multiple: true
+          path: dist
+      - name: Publish wheels to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          packages-dir: dist/

{synapse_cli_agent-0.1.14 → synapse_cli_agent-0.1.16}/.gitignore

@@ -4,6 +4,8 @@
 # Python-generated files
 __pycache__/
 *.py[oc]
+*.pyd
+*.pdb
 build/
 dist/
 wheels/

{synapse_cli_agent-0.1.14 → synapse_cli_agent-0.1.16}/AGENTS.md

@@ -1,5 +1,27 @@
 # Synapse 项目协作指南
 
+## 用户信息
+- 姓名：肖前程
+- 年龄：35 岁
+- 职业：Java 程序员
+- 当前学习方向：Agent 应用开发
+- 主语言背景：Java → 正在学习 Python/LangChain Agent 生态
+
+## 用户信息
+- 姓名：肖前程
+- 年龄：35 岁
+- 职业：Java 程序员
+- 当前学习方向：Agent 应用开发
+- 主语言背景：Java → 正在学习 Python/LangChain Agent 生态
+
+## 约定
+- Python 依赖使用 `uv` 管理。
+- 优先小步、可测试的改动。
+- CLI 输出简洁，不使用 emoji。
+- 默认关闭人工审批（自动放行）；除非用户要求，不要自行加审批门槛。
+- Backend 仅使用 `LocalShellBackend`，无远程 sandbox。
+- 对用户回复与模型思考过程使用中文；代码标识符/路径/命令可保留原文。
+
 ## 当前仓库结构
 
 | 路径                               | 主要职责                                                 |

{synapse_cli_agent-0.1.14 → synapse_cli_agent-0.1.16}/CHANGELOG.md

@@ -7,6 +7,31 @@ The release workflow automatically extracts the matching section as release note
 
 ---
 
+## v0.1.16
+
+### 新功能
+
+- 新增必需的 `synapse-search-core` 原生搜索核心，使用 Rust ripgrep crates 提供正则 `grep` 和 `glob`。
+- `grep`/`glob` 改为使用内置原生引擎，不再依赖宿主机 `rg` 或 DeepAgents Python 搜索回退。
+- 原生搜索 wheel 发布到 PyPI，支持 Windows x86_64、Linux x86_64/aarch64 和 macOS Apple Silicon arm64。
+
+### 工程改进
+
+- 保留 Python 后端的工作区路径授权、虚拟路径映射和 `deny_paths` 过滤。
+- 增加原生搜索 wheel 构建与 PyPI Trusted Publishing 工作流，以及对应的后端回归测试和分发文档。
+
+---
+
+## v0.1.15
+
+### 工程改进
+
+- 拆分 TUI transcript、工具组、待办清单、用户消息和 turn rail widget，缩小 `tui.py` 的职责范围。
+- 保留 `synapse.ui.tui` 的既有组件、格式化函数和 timeline 符号兼容导出。
+- 保持动态主题、流式展示、文本选择、复制与 turn rail 交互行为，并覆盖相关 TUI 回归测试。
+
+---
+
 ## v0.1.14
 
 ### 工程改进

{synapse_cli_agent-0.1.14 → synapse_cli_agent-0.1.16}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: synapse-cli-agent
-Version: 0.1.14
+Version: 0.1.16
 Summary: Local coding agent built on LangChain Deep Agents (LocalShell, no sandbox)
 Project-URL: Homepage, https://github.com/alex8224/synapse-agent
 Project-URL: Repository, https://github.com/alex8224/synapse-agent
@@ -19,6 +19,7 @@ Requires-Dist: mcp>=1.28.0
 Requires-Dist: pydantic-settings>=2.14.2
 Requires-Dist: python-dotenv>=1.2.2
 Requires-Dist: rich>=15.0.0
+Requires-Dist: synapse-search-core<0.2.0,>=0.1.0
 Requires-Dist: termaid>=0.7.1
 Requires-Dist: texicode>=1.0.3
 Requires-Dist: textual-diff-view>=0.1.5
@@ -180,7 +181,7 @@ cp .env.example .env
 | `MODEL` | 是 | 模型标识，如 `openai:gpt-4.1`、`openai:deepseek-chat` |
 | `OPENAI_API_KEY` | 是* | OpenAI 兼容 API 密钥 |
 | `OPENAI_BASE_URL` | 否 | 自定义 API 端点（中转/本地服务需填） |
-| `OPENAI_WEBSOCKET` | 否 | 普通 Responses API 使用 WebSocket；默认 `false`（HTTP/SSE） |
+| `OPENAI_WEBSOCKET` | 否 | 普通 Responses API 使用 WebSocket；默认 `false`（HTTP/SSE）。瞬时断流按模型 `max_retries` 重连，耗尽后在尚未输出内容时回退 HTTP/SSE |
 | `ANTHROPIC_API_KEY` | 否 | Anthropic 原生 API 密钥 |
 | `WORKSPACE` | 否 | 工作区路径，默认 `.` |
 | `SHELL_EXECUTABLE` | 否 | Shell 类型，默认 `pwsh`（可选 `cmd`/`bash`） |
@@ -190,6 +191,42 @@ cp .env.example .env
 
 完整变量列表见 `.env.example`。
 
+### OpenAI Codex OAuth（ChatGPT Plus/Pro）
+
+除普通 API Key 外，Synapse 可使用 Codex 的 ChatGPT OAuth 登录。凭据仅保存到用户目录
+`~/.synapse/openai_oauth.json`，不会写入项目配置或显示在终端中。
+
+```bash
+# 浏览器登录；也可加 --no-browser 手动打开终端打印的链接
+synapse auth openai login
+
+# 若本机已通过 Codex CLI 登录，安全导入其现有登录态
+synapse auth openai login --import-codex
+
+synapse auth openai status
+synapse auth openai logout
+```
+
+然后在 `~/.synapse/models.json` 或 `<workspace>/.synapse/models.json` 配置模型：
+
+```json
+{
+  "default": "codex",
+  "models": {
+    "codex": {
+      "model": "openai:gpt-5",
+      "auth": "openai_oauth"
+    }
+  }
+}
+```
+
+OAuth profile 强制使用 Codex backend，不能通过 `base_url` 覆盖。该登录方式不能用于第三方
+OpenAI 兼容网关，也不需要设置 `OPENAI_API_KEY`。浏览器授权回调固定使用
+`http://localhost:1455/auth/callback`；若端口被占用，请关闭占用进程后重试。Synapse 会自动将
+Agent 的 OpenAI `system` 消息转换为 Codex backend 接受的 `developer` 消息，并移除 DeepSeek
+兼容的 `extra_body.thinking` 字段，只发送 Codex 支持的 reasoning 参数，并强制设置 `store: false`。
+
 ### 方式二：models.json（多模型 profiles，推荐）
 
 在 `~/.synapse/` 或 `<workspace>/.synapse/` 下创建 `models.json`。支持多 profile、自定义模型参数（temperature、max_tokens、thinking 等）。
@@ -329,6 +366,8 @@ OpenAI Responses API 同时支持 HTTP/SSE 与普通 LLM WebSocket。profile 中
 |---|---|
 | `api_key` | **推荐**：密钥直接写在 models.json |
 | `api_key_env` | 旧方式：从环境变量读密钥 |
+| `auth` | 认证方式；设为 `openai_oauth` 时使用 `synapse auth openai login` 保存的 Codex OAuth 登录态 |
+| `headers` | 模型级 HTTP 请求头对象；同名头覆盖顶层 `headers`，适用于自定义 `User-Agent` 等请求指纹 |
 | `thinking` / `thinking_level` / `reasoning_effort` | 思考级别：`off\|minimal\|low\|medium\|high\|max` |
 | `enable_thinking` | 兼容旧字段 bool |
 | `temperature` / `max_tokens` / `timeout` 等 | 直接传给 ChatModel |
@@ -336,6 +375,33 @@ OpenAI Responses API 同时支持 HTTP/SSE 与普通 LLM WebSocket。profile 中
 | `model_kwargs` | 请求体 kwargs |
 | `extra_body` | 厂商扩展体（与 thinking 合并） |
 
+### 自定义请求头与请求指纹
+
+参考 `cmd-agent` 的配置方式，`models.json` 顶层 `headers` 会应用到全部 OpenAI 兼容模型；
+模型内 `headers` 按 HTTP 头名称（不区分大小写）覆盖全局值。分层配置的优先级为：
+项目模型 > 用户模型 > 项目全局 > 用户全局。可用于设置 `User-Agent`、客户端标识等请求指纹。
+
+```json
+{
+  "headers": {
+    "User-Agent": "synapse-global/1.0",
+    "X-Client-Channel": "desktop"
+  },
+  "models": {
+    "codex": {
+      "model": "openai:gpt-5",
+      "auth": "openai_oauth",
+      "headers": {
+        "User-Agent": "synapse-codex/1.0"
+      }
+    }
+  }
+}
+```
+
+OAuth 模式中 `ChatGPT-Account-Id`、`originator` 等协议认证头由运行时强制设置，不能被配置覆盖。
+请求头值支持 `${ENV_NAME}` / `$ENV_NAME` 环境变量展开；不要将私密 token 写入项目级配置。
+
 `.env` 仍可读，仅作迁移/CI 兼容，**不推荐**作为常规分发方式。
 
 ## 示例：修复 sample_repo

{synapse_cli_agent-0.1.14 → synapse_cli_agent-0.1.16}/README.md

@@ -145,7 +145,7 @@ cp .env.example .env
 | `MODEL` | 是 | 模型标识，如 `openai:gpt-4.1`、`openai:deepseek-chat` |
 | `OPENAI_API_KEY` | 是* | OpenAI 兼容 API 密钥 |
 | `OPENAI_BASE_URL` | 否 | 自定义 API 端点（中转/本地服务需填） |
-| `OPENAI_WEBSOCKET` | 否 | 普通 Responses API 使用 WebSocket；默认 `false`（HTTP/SSE） |
+| `OPENAI_WEBSOCKET` | 否 | 普通 Responses API 使用 WebSocket；默认 `false`（HTTP/SSE）。瞬时断流按模型 `max_retries` 重连，耗尽后在尚未输出内容时回退 HTTP/SSE |
 | `ANTHROPIC_API_KEY` | 否 | Anthropic 原生 API 密钥 |
 | `WORKSPACE` | 否 | 工作区路径，默认 `.` |
 | `SHELL_EXECUTABLE` | 否 | Shell 类型，默认 `pwsh`（可选 `cmd`/`bash`） |
@@ -155,6 +155,42 @@ cp .env.example .env
 
 完整变量列表见 `.env.example`。
 
+### OpenAI Codex OAuth（ChatGPT Plus/Pro）
+
+除普通 API Key 外，Synapse 可使用 Codex 的 ChatGPT OAuth 登录。凭据仅保存到用户目录
+`~/.synapse/openai_oauth.json`，不会写入项目配置或显示在终端中。
+
+```bash
+# 浏览器登录；也可加 --no-browser 手动打开终端打印的链接
+synapse auth openai login
+
+# 若本机已通过 Codex CLI 登录，安全导入其现有登录态
+synapse auth openai login --import-codex
+
+synapse auth openai status
+synapse auth openai logout
+```
+
+然后在 `~/.synapse/models.json` 或 `<workspace>/.synapse/models.json` 配置模型：
+
+```json
+{
+  "default": "codex",
+  "models": {
+    "codex": {
+      "model": "openai:gpt-5",
+      "auth": "openai_oauth"
+    }
+  }
+}
+```
+
+OAuth profile 强制使用 Codex backend，不能通过 `base_url` 覆盖。该登录方式不能用于第三方
+OpenAI 兼容网关，也不需要设置 `OPENAI_API_KEY`。浏览器授权回调固定使用
+`http://localhost:1455/auth/callback`；若端口被占用，请关闭占用进程后重试。Synapse 会自动将
+Agent 的 OpenAI `system` 消息转换为 Codex backend 接受的 `developer` 消息，并移除 DeepSeek
+兼容的 `extra_body.thinking` 字段，只发送 Codex 支持的 reasoning 参数，并强制设置 `store: false`。
+
 ### 方式二：models.json（多模型 profiles，推荐）
 
 在 `~/.synapse/` 或 `<workspace>/.synapse/` 下创建 `models.json`。支持多 profile、自定义模型参数（temperature、max_tokens、thinking 等）。
@@ -294,6 +330,8 @@ OpenAI Responses API 同时支持 HTTP/SSE 与普通 LLM WebSocket。profile 中
 |---|---|
 | `api_key` | **推荐**：密钥直接写在 models.json |
 | `api_key_env` | 旧方式：从环境变量读密钥 |
+| `auth` | 认证方式；设为 `openai_oauth` 时使用 `synapse auth openai login` 保存的 Codex OAuth 登录态 |
+| `headers` | 模型级 HTTP 请求头对象；同名头覆盖顶层 `headers`，适用于自定义 `User-Agent` 等请求指纹 |
 | `thinking` / `thinking_level` / `reasoning_effort` | 思考级别：`off\|minimal\|low\|medium\|high\|max` |
 | `enable_thinking` | 兼容旧字段 bool |
 | `temperature` / `max_tokens` / `timeout` 等 | 直接传给 ChatModel |
@@ -301,6 +339,33 @@ OpenAI Responses API 同时支持 HTTP/SSE 与普通 LLM WebSocket。profile 中
 | `model_kwargs` | 请求体 kwargs |
 | `extra_body` | 厂商扩展体（与 thinking 合并） |
 
+### 自定义请求头与请求指纹
+
+参考 `cmd-agent` 的配置方式，`models.json` 顶层 `headers` 会应用到全部 OpenAI 兼容模型；
+模型内 `headers` 按 HTTP 头名称（不区分大小写）覆盖全局值。分层配置的优先级为：
+项目模型 > 用户模型 > 项目全局 > 用户全局。可用于设置 `User-Agent`、客户端标识等请求指纹。
+
+```json
+{
+  "headers": {
+    "User-Agent": "synapse-global/1.0",
+    "X-Client-Channel": "desktop"
+  },
+  "models": {
+    "codex": {
+      "model": "openai:gpt-5",
+      "auth": "openai_oauth",
+      "headers": {
+        "User-Agent": "synapse-codex/1.0"
+      }
+    }
+  }
+}
+```
+
+OAuth 模式中 `ChatGPT-Account-Id`、`originator` 等协议认证头由运行时强制设置，不能被配置覆盖。
+请求头值支持 `${ENV_NAME}` / `$ENV_NAME` 环境变量展开；不要将私密 token 写入项目级配置。
+
 `.env` 仍可读，仅作迁移/CI 兼容，**不推荐**作为常规分发方式。
 
 ## 示例：修复 sample_repo