synapse-cli-agent 0.1.26__tar.gz → 0.1.28__tar.gz

{synapse_cli_agent-0.1.26 → synapse_cli_agent-0.1.28}/CHANGELOG.md

@@ -7,6 +7,51 @@ The release workflow automatically extracts the matching section as release note
 
 ---
 
+## v0.1.28
+
+### 新增功能
+
+- TUI 支持终端内 LaTeX 数学公式渲染：transcript 中 display math（`$$...$$`）块经原生 RaTeX 内核渲染为 PNG 图片展示，支持前景/背景色、字号、padding 与 device pixel ratio，无需 Node.js、浏览器或系统 TeX。
+- TUI 图片渲染增强：粘贴图片可在终端内预览（textual-image），transcript 显示图片，点击图片可在模态窗口中放大查看。
+- 会话切换器：Ctrl+Tab 快速切换最近 10 个会话并高亮当前项，冷历史合并进 recents。
+- 项目抽屉（project drawer）绑定 F12 并支持交互，可读性与渲染稳定性改进。
+- 跨项目进程内切换与多会话并发支持（runtime 与 TUI 解耦重构）。
+
+### 修复
+
+- 修复退出死锁，新增退出耗时诊断。
+- 修复会话切换后 turn 轮换内容丢失、replay 终态关闭、断链渲染冻结等问题。
+- 修复事件渲染阻塞输入的问题。
+- 隔离各会话的 model 与 MCP 状态，避免跨会话切换串扰。
+- 修复 goal follow-up 轮次的 reservation/settlement 竞态。
+
+### 工程改进
+
+- runtime 与 TUI 解耦：stream parser 移出 UI 包，工具事件结构化输出并保留工具 item 生命周期。
+- synapse-core-tool 原生扩展新增 `render_math_png`（RaTeX 内核 + 嵌入 KaTeX 字体）。
+
+---
+
+## v0.1.27
+
+### 新增功能
+
+- TUI topbar 实时显示 token 输出速率与首 token 时间（TTFT）。
+- README 重设计并拆分中英文版本，`docs/sessions.md` 同步补充会话说明。
+
+### 修复
+
+- 修复 TUI 控制器拆分后 Esc 取消与 goal 状态未保留的问题（跨控制器保留 goal 取消状态、Esc 时暂停 active goal）。
+- 修复 TUI 旧版 transcript projections 迁移在主线程阻塞的问题，改为在子进程中执行。
+- 修复对话框 modal 屏幕出现第二个滚动条、git changes popover 滚动条重复的问题。
+
+### 工程改进
+
+- `tui.py` 拆分为领域控制器（ChromeController、TranscriptController、SlashController、PromptController、TurnController），完成控制器抽取并修复 Codex usage 线程模型。
+- 限制 TUI session 与工具输出内存占用，降低长会话资源消耗。
+
+---
+
 ## v0.1.26
 
 ### 新增功能

synapse_cli_agent-0.1.28/PKG-INFO

@@ -0,0 +1,401 @@
+Metadata-Version: 2.5
+Name: synapse-cli-agent
+Version: 0.1.28
+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
+Project-URL: Issues, https://github.com/alex8224/synapse-agent/issues
+Project-URL: Changelog, https://github.com/alex8224/synapse-agent/blob/main/CHANGELOG.md
+Author-email: alex8224 <alex8224@gmail.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 the 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
+        
+           Copyright 2025 alex8224
+        
+           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.
+License-File: LICENSE
+Requires-Python: >=3.12
+Requires-Dist: aiosqlite==0.22.1
+Requires-Dist: deepagents==0.6.12
+Requires-Dist: httpx[socks]==0.28.1
+Requires-Dist: langchain-anthropic==1.4.8
+Requires-Dist: langchain-openai==1.3.5
+Requires-Dist: langchain==1.3.14
+Requires-Dist: langgraph-checkpoint-sqlite==3.1.0
+Requires-Dist: langgraph==1.2.9
+Requires-Dist: mcp==1.28.1
+Requires-Dist: pydantic-settings==2.14.2
+Requires-Dist: python-dotenv==1.2.2
+Requires-Dist: rich==15.0.0
+Requires-Dist: synapse-core-tool<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
+Requires-Dist: textual-image==0.13.2
+Requires-Dist: textual-serve==1.1.3
+Requires-Dist: textual==8.2.8
+Requires-Dist: typer==0.27.0
+Requires-Dist: websockets==15.0.1
+Requires-Dist: zstandard==0.25.0
+Provides-Extra: dev
+Requires-Dist: mkdocs-material>=9.7.7; extra == 'dev'
+Requires-Dist: mkdocs>=1.6.1; extra == 'dev'
+Requires-Dist: pytest>=9.1.1; extra == 'dev'
+Requires-Dist: ruff>=0.15.22; extra == 'dev'
+Description-Content-Type: text/markdown
+
+<p align="center">
+  <img src="assets/synapse-logo.svg" alt="Synapse" width="96">
+</p>
+
+<h1 align="center">Synapse</h1>
+
+<p align="center">
+  The open-source coding agent that lives in your terminal — built on <strong>LangChain Deep Agents</strong>. Ask it to fix a test, refactor a module, or carry a goal across turns until it is done.
+</p>
+
+<p align="center">
+  <a href="https://pypi.org/project/synapse-cli-agent/"><img src="https://img.shields.io/pypi/v/synapse-cli-agent?style=for-the-badge&logo=pypi&logoColor=white&label=PyPI" alt="PyPI version"></a>
+  <a href="https://github.com/alex8224/synapse-agent"><img src="https://img.shields.io/badge/GitHub-synapse--agent-181717?style=for-the-badge&logo=github&logoColor=white" alt="GitHub"></a>
+  <a href="LICENSE"><img src="https://img.shields.io/badge/license-Apache%202.0-3da639?style=for-the-badge&logo=apache&logoColor=white" alt="Apache 2.0"></a>
+</p>
+
+<p align="center">
+  <a href="README.md">English</a> ·
+  <a href="README.zh-CN.md">简体中文</a> ·
+  <a href="docs/">Docs</a> ·
+  <a href="CHANGELOG.md">Changelog</a>
+</p>
+
+![Synapse TUI](assets/tui-preview.png)
+
+Synapse is a terminal-first coding-agent runtime. Unlike a one-shot "run this and reply" prompt, it is designed for sessions that last more than a few turns: a responsive TUI that keeps the timeline, tool calls, and context usage visible; token-aware handling of tool output; and persistent goals that keep the agent working until the work is actually done.
+
+## Install
+
+One command, no clone required:
+
+```bash
+uv tool install synapse-cli-agent
+```
+
+Then start the TUI from anywhere:
+
+```bash
+synapse tui -w .
+```
+
+Open a session in any registered project from the global catalog:
+
+```bash
+synapse --session <project_id>:<thread_id>   # global session reference
+synapse --project <ref>                      # project by id prefix, name, or path
+```
+
+Inside the TUI, click the topbar `≡` (or the workspace label) to open the
+floating project drawer: it lists every registered project, groups their
+sessions, marks live runtime status, and lets you switch sessions in place or
+jump to another project (the TUI restarts into that project).
+
+Press `Ctrl+Tab` for a lighter active-session switcher: it lists only sessions
+that are doing work right now (across projects), lets you `Tab` / `Shift+Tab`
+through them and `Enter` to switch — the old session keeps running in the
+background and is never cancelled.  Some terminals never forward `Ctrl+Tab` to
+the app; `Ctrl+O` is a drop-in alternative.
+
+<details>
+<summary><b>Or run from source</b></summary>
+
+```bash
+git clone https://github.com/alex8224/synapse-agent.git
+cd synapse-agent
+uv sync
+
+# Windows venv entry
+.\.venv\Scripts\synapse.exe tui -w .
+
+# Or module entry
+uv run python -m synapse tui -w .
+```
+
+</details>
+
+## Use it
+
+Type it like you would ask a colleague:
+
+- "Fix the failing test in `tests/test_backends.py`"
+- "Refactor this module and add type annotations"
+- "Review the latest commit and suggest improvements"
+- "Keep working on this goal until it is done" (via `/goal`)
+
+Three ways to talk to it:
+
+| Mode | What it does |
+| --- | --- |
+| **TUI** | Full terminal UI: timeline, turn rail, tool groups, context usage, themes |
+| **Chat** | Plain interactive REPL — `synapse chat -w .` |
+| **Run** | One-shot task that prints the answer — `synapse run "summarize this repo" -w .` |
+
+## Why it is built for long sessions
+
+- **Long-running goals** — `/goal <objective>` survives turn boundaries, tracks tokens and elapsed time, and steers the next turn automatically until the goal is completed, paused, blocked, or budget-limited.
+- **Token-aware tool output** — search results, logs, diffs, JSON, and code are classified and compressed before they re-enter the model context; large originals stay recoverable through references.
+- **Managed long context** — automatic summarization and `/compact` keep sessions inside the model window, with occupancy and savings visible in the TUI.
+- **Direct Codex OAuth** — sign in with the Codex-compatible browser flow or import an existing Codex grant. No API key required; tokens refresh automatically.
+- **Your model, your choice** — OpenAI-compatible providers via `models.json` profiles (OpenAI, DeepSeek, local gateways, and more), including a persistent WebSocket mode.
+- **MCP built in** — attach MCP servers and their tools appear in the agent automatically.
+- **Sessions that resume** — SQLite checkpoints, a global project catalog across all your projects, and a lightweight paged transcript so even huge sessions reopen fast.
+- **Memory and skills** — `AGENTS.md` memory plus Agent Skills (`skills/**`) that load only when relevant.
+- **Sub-agents** — built-in `researcher`, `tester`, and `reviewer` roles for parallel delegation.
+- **Approvals when you want them** — optional human-in-the-loop (`--require-approval`) and safety profiles.
+
+## Slash commands
+
+Type `/help` in the TUI for the full reference. The essentials:
+
+| Command | What it does |
+| --- | --- |
+| `/goal <objective>` | Set a long-running goal that auto-continues across turns |
+| `/goal pause` · `/goal resume` · `/goal clear` | Manage the active goal |
+| `/new` · `/switch <id>` · `/sessions` | Create, switch, and list sessions |
+| `/export [md\|json]` | Export the transcript to a file |
+| `/model <provider:model>` | Switch models at runtime |
+| `/fast [on\|off\|status]` | Toggle the Codex Fast tier (OAuth profiles) |
+| `/mcp list` · `/mcp reload` | Manage MCP servers |
+| `/theme <name>` | Switch UI themes |
+| `/compact` | Force context compaction |
+| `/context` | Show context usage stats |
+| `/safety <profile>` | Switch safety profiles |
+| `/approve` · `/reject` | Human-in-the-loop decisions |
+
+## Pick a model
+
+Synapse works with any OpenAI-compatible endpoint. Configure profiles in `~/.synapse/models.json` (or `<workspace>/.synapse/models.json`):
+
+```json
+{
+  "default": "deepseek",
+  "models": {
+    "deepseek": {
+      "model": "openai:deepseek-v4-pro",
+      "api_key": "sk-...",
+      "base_url": "http://127.0.0.1:3000/v1",
+      "thinking": "high"
+    }
+  }
+}
+```
+
+For a zero-config Codex experience, use the OAuth profile — see [Models](docs/models.md).
+
+## Documentation
+
+| | |
+| --- | --- |
+| [Quickstart](docs/quickstart.md) | First run, CLI reference, common workflows |
+| [Configuration](docs/config.md) | Layered settings, environment variables, paths |
+| [Models](docs/models.md) | Provider profiles, OAuth, Fast tier, WebSocket mode |
+| [MCP](docs/mcp.md) | Attaching and managing MCP servers |
+| [Sessions](docs/sessions.md) | Checkpoints, resume, transcript paging |
+| [Skills](docs/skills.md) | Bundled skills and the Agent Skills format |
+| [Permissions](docs/permissions.md) | Read-only mode and approval flows |
+| [Install](docs/install.md) | All installation methods |
+
+## Repository layout
+
+```
+src/synapse/    Agent assembly, commands, runtime, sessions, TUI, integrations
+rust/           Optional native compression cores (PyO3)
+docs/           User documentation
+tests/          Python test suite
+scripts/        Install / release helpers
+```
+
+## License
+
+Apache License 2.0 — see [LICENSE](LICENSE). Third-party dependencies and Rust subcomponents may carry their own licenses; retain the corresponding license and NOTICE files when distributing.

synapse_cli_agent-0.1.28/README.md

@@ -0,0 +1,171 @@
+<p align="center">
+  <img src="assets/synapse-logo.svg" alt="Synapse" width="96">
+</p>
+
+<h1 align="center">Synapse</h1>
+
+<p align="center">
+  The open-source coding agent that lives in your terminal — built on <strong>LangChain Deep Agents</strong>. Ask it to fix a test, refactor a module, or carry a goal across turns until it is done.
+</p>
+
+<p align="center">
+  <a href="https://pypi.org/project/synapse-cli-agent/"><img src="https://img.shields.io/pypi/v/synapse-cli-agent?style=for-the-badge&logo=pypi&logoColor=white&label=PyPI" alt="PyPI version"></a>
+  <a href="https://github.com/alex8224/synapse-agent"><img src="https://img.shields.io/badge/GitHub-synapse--agent-181717?style=for-the-badge&logo=github&logoColor=white" alt="GitHub"></a>
+  <a href="LICENSE"><img src="https://img.shields.io/badge/license-Apache%202.0-3da639?style=for-the-badge&logo=apache&logoColor=white" alt="Apache 2.0"></a>
+</p>
+
+<p align="center">
+  <a href="README.md">English</a> ·
+  <a href="README.zh-CN.md">简体中文</a> ·
+  <a href="docs/">Docs</a> ·
+  <a href="CHANGELOG.md">Changelog</a>
+</p>
+
+![Synapse TUI](assets/tui-preview.png)
+
+Synapse is a terminal-first coding-agent runtime. Unlike a one-shot "run this and reply" prompt, it is designed for sessions that last more than a few turns: a responsive TUI that keeps the timeline, tool calls, and context usage visible; token-aware handling of tool output; and persistent goals that keep the agent working until the work is actually done.
+
+## Install
+
+One command, no clone required:
+
+```bash
+uv tool install synapse-cli-agent
+```
+
+Then start the TUI from anywhere:
+
+```bash
+synapse tui -w .
+```
+
+Open a session in any registered project from the global catalog:
+
+```bash
+synapse --session <project_id>:<thread_id>   # global session reference
+synapse --project <ref>                      # project by id prefix, name, or path
+```
+
+Inside the TUI, click the topbar `≡` (or the workspace label) to open the
+floating project drawer: it lists every registered project, groups their
+sessions, marks live runtime status, and lets you switch sessions in place or
+jump to another project (the TUI restarts into that project).
+
+Press `Ctrl+Tab` for a lighter active-session switcher: it lists only sessions
+that are doing work right now (across projects), lets you `Tab` / `Shift+Tab`
+through them and `Enter` to switch — the old session keeps running in the
+background and is never cancelled.  Some terminals never forward `Ctrl+Tab` to
+the app; `Ctrl+O` is a drop-in alternative.
+
+<details>
+<summary><b>Or run from source</b></summary>
+
+```bash
+git clone https://github.com/alex8224/synapse-agent.git
+cd synapse-agent
+uv sync
+
+# Windows venv entry
+.\.venv\Scripts\synapse.exe tui -w .
+
+# Or module entry
+uv run python -m synapse tui -w .
+```
+
+</details>
+
+## Use it
+
+Type it like you would ask a colleague:
+
+- "Fix the failing test in `tests/test_backends.py`"
+- "Refactor this module and add type annotations"
+- "Review the latest commit and suggest improvements"
+- "Keep working on this goal until it is done" (via `/goal`)
+
+Three ways to talk to it:
+
+| Mode | What it does |
+| --- | --- |
+| **TUI** | Full terminal UI: timeline, turn rail, tool groups, context usage, themes |
+| **Chat** | Plain interactive REPL — `synapse chat -w .` |
+| **Run** | One-shot task that prints the answer — `synapse run "summarize this repo" -w .` |
+
+## Why it is built for long sessions
+
+- **Long-running goals** — `/goal <objective>` survives turn boundaries, tracks tokens and elapsed time, and steers the next turn automatically until the goal is completed, paused, blocked, or budget-limited.
+- **Token-aware tool output** — search results, logs, diffs, JSON, and code are classified and compressed before they re-enter the model context; large originals stay recoverable through references.
+- **Managed long context** — automatic summarization and `/compact` keep sessions inside the model window, with occupancy and savings visible in the TUI.
+- **Direct Codex OAuth** — sign in with the Codex-compatible browser flow or import an existing Codex grant. No API key required; tokens refresh automatically.
+- **Your model, your choice** — OpenAI-compatible providers via `models.json` profiles (OpenAI, DeepSeek, local gateways, and more), including a persistent WebSocket mode.
+- **MCP built in** — attach MCP servers and their tools appear in the agent automatically.
+- **Sessions that resume** — SQLite checkpoints, a global project catalog across all your projects, and a lightweight paged transcript so even huge sessions reopen fast.
+- **Memory and skills** — `AGENTS.md` memory plus Agent Skills (`skills/**`) that load only when relevant.
+- **Sub-agents** — built-in `researcher`, `tester`, and `reviewer` roles for parallel delegation.
+- **Approvals when you want them** — optional human-in-the-loop (`--require-approval`) and safety profiles.
+
+## Slash commands
+
+Type `/help` in the TUI for the full reference. The essentials:
+
+| Command | What it does |
+| --- | --- |
+| `/goal <objective>` | Set a long-running goal that auto-continues across turns |
+| `/goal pause` · `/goal resume` · `/goal clear` | Manage the active goal |
+| `/new` · `/switch <id>` · `/sessions` | Create, switch, and list sessions |
+| `/export [md\|json]` | Export the transcript to a file |
+| `/model <provider:model>` | Switch models at runtime |
+| `/fast [on\|off\|status]` | Toggle the Codex Fast tier (OAuth profiles) |
+| `/mcp list` · `/mcp reload` | Manage MCP servers |
+| `/theme <name>` | Switch UI themes |
+| `/compact` | Force context compaction |
+| `/context` | Show context usage stats |
+| `/safety <profile>` | Switch safety profiles |
+| `/approve` · `/reject` | Human-in-the-loop decisions |
+
+## Pick a model
+
+Synapse works with any OpenAI-compatible endpoint. Configure profiles in `~/.synapse/models.json` (or `<workspace>/.synapse/models.json`):
+
+```json
+{
+  "default": "deepseek",
+  "models": {
+    "deepseek": {
+      "model": "openai:deepseek-v4-pro",
+      "api_key": "sk-...",
+      "base_url": "http://127.0.0.1:3000/v1",
+      "thinking": "high"
+    }
+  }
+}
+```
+
+For a zero-config Codex experience, use the OAuth profile — see [Models](docs/models.md).
+
+## Documentation
+
+| | |
+| --- | --- |
+| [Quickstart](docs/quickstart.md) | First run, CLI reference, common workflows |
+| [Configuration](docs/config.md) | Layered settings, environment variables, paths |
+| [Models](docs/models.md) | Provider profiles, OAuth, Fast tier, WebSocket mode |
+| [MCP](docs/mcp.md) | Attaching and managing MCP servers |
+| [Sessions](docs/sessions.md) | Checkpoints, resume, transcript paging |
+| [Skills](docs/skills.md) | Bundled skills and the Agent Skills format |
+| [Permissions](docs/permissions.md) | Read-only mode and approval flows |
+| [Install](docs/install.md) | All installation methods |
+
+## Repository layout
+
+```
+src/synapse/    Agent assembly, commands, runtime, sessions, TUI, integrations
+rust/           Optional native compression cores (PyO3)
+docs/           User documentation
+tests/          Python test suite
+scripts/        Install / release helpers
+```
+
+## License
+
+Apache License 2.0 — see [LICENSE](LICENSE). Third-party dependencies and Rust subcomponents may carry their own licenses; retain the corresponding license and NOTICE files when distributing.

synapse_cli_agent-0.1.26/README.md → synapse_cli_agent-0.1.28/README.zh-CN.md

@@ -1,5 +1,7 @@
 # Synapse
 
+> **English**: [README.md](README.md)
+
 基于 **LangChain Deep Agents** 的本地 Synapse。
 
 本项目以 [Apache License 2.0](LICENSE) 发布。第三方依赖和 Rust 子组件可能使用各自的许可证；分发时请同时保留相应的许可证与 NOTICE 文件。

synapse_cli_agent-0.1.28/assets/synapse-logo.svg

@@ -0,0 +1,5 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 32 32" role="img" aria-label="Synapse">
+  <rect width="32" height="32" fill="#201e1c"/>
+  <path fill="#dfff57" d="M5 5h9v9H5zM18 5h9v9h-9zM5 18h9v9H5z"/>
+  <path fill="#f8f6f1" d="M18 18h9v9h-9z"/>
+</svg>

{synapse_cli_agent-0.1.26 → synapse_cli_agent-0.1.28}/debug_compact.py

@@ -1,13 +1,12 @@
-"""Debug: why _find_summarization_middleware returns None with deepagents 0.6.12 + langchain 1.3.14."""
-import asyncio
-import inspect
+"""Debug: why _find_summarization_middleware returns None with deepagents
+0.6.12 + langchain 1.3.14."""
+
 import functools
+import inspect
 from collections.abc import Mapping
 
-from langchain_core.language_models.fake_chat_models import FakeListChatModel
-from langchain_core.messages import AIMessage
-
 from deepagents import create_deep_agent
+from langchain_core.language_models.fake_chat_models import FakeListChatModel
 
 from synapse.runtime.context_compact import (
     _find_summarization_middleware,