synapse-cli-agent 0.1.21__tar.gz → 0.1.22__tar.gz

{synapse_cli_agent-0.1.21 → synapse_cli_agent-0.1.22}/CHANGELOG.md

@@ -7,6 +7,23 @@ The release workflow automatically extracts the matching section as release note
 
 ---
 
+## v0.1.22
+
+### 新增功能
+
+- TUI 恢复会话时改为分页加载：启动只渲染最近 `AGENT_HISTORY_TAIL_TURNS` 轮（默认 20），滚动到 transcript 顶部时异步加载更早历史并保持滚动位置，避免超长会话导致启动卡顿。
+- 新增 `AGENT_HISTORY_TAIL_TURNS` 设置，控制 TUI 启动时初始渲染的最近可见会话轮数（支持环境变量与分层 `settings.json`）。
+
+### 修复
+
+- 修复历史分页异步加载的请求代际竞争：切换/重新加载会话后，旧分页 worker 的回调不再清除当前请求的加载状态或插入过期数据。
+
+### 工程改进
+
+- 直接依赖版本固定到 `uv.lock` 对应版本。
+
+---
+
 ## v0.1.21
 
 ### 新增功能

{synapse_cli_agent-0.1.21 → synapse_cli_agent-0.1.22}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: synapse-cli-agent
-Version: 0.1.21
+Version: 0.1.22
 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
@@ -8,26 +8,26 @@ 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>
 Requires-Python: >=3.12
-Requires-Dist: aiosqlite>=0.20.0
-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.0
-Requires-Dist: pydantic-settings>=2.14.2
-Requires-Dist: python-dotenv>=1.2.2
-Requires-Dist: rich>=15.0.0
+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>=1.0.0
-Requires-Dist: typer>=0.27.0
-Requires-Dist: websockets<16,>=13
-Requires-Dist: zstandard>=0.23.0
+Requires-Dist: termaid==0.7.1
+Requires-Dist: texicode==1.0.3
+Requires-Dist: textual-diff-view==0.1.5
+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'

{synapse_cli_agent-0.1.21 → synapse_cli_agent-0.1.22}/docs/config.md

@@ -70,6 +70,7 @@ Synapse 使用 **Pydantic Settings** 实现分层配置系统。
 | `CHECKPOINT_BACKEND` | `sqlite` | 检查点后端（`sqlite`/`memory`） |
 | `CHECKPOINT_PATH` | `.coding-agent/checkpoints.sqlite` | 检查点存储路径 |
 | `SESSIONS_PATH` | — | 会话元数据路径 |
+| `AGENT_HISTORY_TAIL_TURNS` | `20` | TUI 启动时初始渲染的最近可见会话轮数；滚动到顶部后加载更早历史 |
 
 ### 子代理
 

{synapse_cli_agent-0.1.21 → synapse_cli_agent-0.1.22}/docs/sessions.md

@@ -34,6 +34,17 @@ synapse run "继续刚才的工作" --thread-id <thread_id> -w .
 
 TUI 模式下也可以在界面内浏览和切换历史会话。
 
+### TUI 恢复会话的分页加载
+
+TUI 启动恢复会话时不会一次性渲染整个 transcript，而是只绘制最后
+`history_tail_turns` 轮（默认 20 轮，可在配置中覆盖），避免超长会话
+导致启动卡顿。更早的历史通过滚动分页加载：
+
+- 启动后自动滚动到 transcript 底部，显示最近 N 轮。
+- 滚动到 transcript 顶部时，异步加载更早的一批历史并插入到当前内容上方，
+  滚动位置保持不变，直到加载完整个会话。
+- 切换会话（`/session`）或重新加载后，分页状态随 transcript 一起重置。
+
 ## 导出会话
 
 将对话记录导出为 Markdown：

{synapse_cli_agent-0.1.21 → synapse_cli_agent-0.1.22}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "synapse-cli-agent"
-version = "0.1.21"
+version = "0.1.22"
 description = "Local coding agent built on LangChain Deep Agents (LocalShell, no sandbox)"
 readme = "README.md"
 authors = [
@@ -10,25 +10,25 @@ requires-python = ">=3.12"
 
 dependencies = [
     "synapse-core-tool>=0.1.0,<0.2.0",
-    "aiosqlite>=0.20.0",
-    "deepagents>=0.6.12",
-    "httpx[socks]>=0.28.1",
-    "langchain>=1.3.14",
-    "langchain-anthropic>=1.4.8",
-    "langchain-openai>=1.3.5",
-    "langgraph>=1.2.9",
-    "langgraph-checkpoint-sqlite>=3.1.0",
-    "mcp>=1.28.0",
-    "pydantic-settings>=2.14.2",
-    "python-dotenv>=1.2.2",
-    "rich>=15.0.0",
-    "termaid>=0.7.1",
-    "texicode>=1.0.3",
-    "textual>=1.0.0",
-    "textual-diff-view>=0.1.5",
-    "typer>=0.27.0",
-    "websockets>=13,<16",
-    "zstandard>=0.23.0",
+    "aiosqlite==0.22.1",
+    "deepagents==0.6.12",
+    "httpx[socks]==0.28.1",
+    "langchain==1.3.14",
+    "langchain-anthropic==1.4.8",
+    "langchain-openai==1.3.5",
+    "langgraph==1.2.9",
+    "langgraph-checkpoint-sqlite==3.1.0",
+    "mcp==1.28.1",
+    "pydantic-settings==2.14.2",
+    "python-dotenv==1.2.2",
+    "rich==15.0.0",
+    "termaid==0.7.1",
+    "texicode==1.0.3",
+    "textual==8.2.8",
+    "textual-diff-view==0.1.5",
+    "typer==0.27.0",
+    "websockets==15.0.1",
+    "zstandard==0.25.0",
 ]
 
 [project.urls]

synapse_cli_agent-0.1.22/release_body.md

@@ -0,0 +1,16 @@
+## v0.1.22
+
+### 新增功能
+
+- TUI 恢复会话时改为分页加载：启动只渲染最近 `AGENT_HISTORY_TAIL_TURNS` 轮（默认 20），滚动到 transcript 顶部时异步加载更早历史并保持滚动位置，避免超长会话导致启动卡顿。
+- 新增 `AGENT_HISTORY_TAIL_TURNS` 设置，控制 TUI 启动时初始渲染的最近可见会话轮数（支持环境变量与分层 `settings.json`）。
+
+### 修复
+
+- 修复历史分页异步加载的请求代际竞争：切换/重新加载会话后，旧分页 worker 的回调不再清除当前请求的加载状态或插入过期数据。
+
+### 工程改进
+
+- 直接依赖版本固定到 `uv.lock` 对应版本。
+
+---

{synapse_cli_agent-0.1.21 → synapse_cli_agent-0.1.22}/src/synapse/sessions/transcript.py

@@ -605,6 +605,111 @@ def fold_messages_for_ui(messages: list[Any]) -> list[UiTranscriptEvent]:
     return events
 
 
+@dataclass
+class TranscriptWindow:
+    """A foldable slice of a thread plus the paging boundary.
+
+    Attributes:
+        events: UI events folded from ``messages[start_idx:end_idx]``.
+        start_idx: message index where this window starts.
+        has_more: True when older visible user turns exist before ``start_idx``.
+    """
+
+    events: list[UiTranscriptEvent] = field(default_factory=list)
+    start_idx: int = 0
+    has_more: bool = False
+
+
+def _is_steer_message_noise(msg: Any) -> bool:
+    """True when ``msg`` is model-only steer chrome (never painted)."""
+    try:
+        from synapse.runtime.steer import is_steer_message
+
+        return is_steer_message(msg)
+    except Exception:  # noqa: BLE001
+        return False
+
+
+def turn_start_indexes(messages: list[Any]) -> list[int]:
+    """Indexes of human messages that fold into a visible ``user`` turn.
+
+    Mirrors the filtering inside ``fold_messages_for_ui`` (summarization /
+    steer / context-compaction wrappers never start a visible turn), so the
+    paging boundaries stay aligned with what the TUI actually paints.
+    """
+    out: list[int] = []
+    for i, msg in enumerate(messages or []):
+        if _message_role(msg) not in {"human", "user"}:
+            continue
+        if is_lc_summarization_message(msg):
+            continue
+        if _is_steer_message_noise(msg):
+            continue
+        text = _message_content(msg).strip()
+        if is_context_compact_text(text):
+            continue
+        try:
+            from synapse.runtime.steer import is_steer_message as _is_steer
+
+            if _is_steer(text=text):
+                continue
+        except Exception:  # noqa: BLE001
+            pass
+        if not text and not _message_images(msg):
+            continue
+        out.append(i)
+    return out
+
+
+def fold_tail_window(
+    messages: list[Any],
+    *,
+    tail_turns: int = 20,
+) -> TranscriptWindow:
+    """Fold only the last ``tail_turns`` visible user turns of a thread.
+
+    Used at TUI startup so huge threads paint a bounded window instead of the
+    full transcript; ``has_more`` tells the UI that older turns exist and can
+    be fetched page by page via ``fold_earlier_window``.
+    """
+    starts = turn_start_indexes(messages or [])
+    if not starts:
+        return TranscriptWindow(events=[], start_idx=0, has_more=False)
+    n = min(len(starts), max(1, int(tail_turns)))
+    boundary = starts[len(starts) - n]
+    events = fold_messages_for_ui(messages[boundary:])
+    return TranscriptWindow(
+        events=events,
+        start_idx=boundary,
+        has_more=any(i < boundary for i in starts),
+    )
+
+
+def fold_earlier_window(
+    messages: list[Any],
+    *,
+    before_idx: int,
+    tail_turns: int = 20,
+) -> TranscriptWindow:
+    """Fold up to ``tail_turns`` visible user turns strictly before ``before_idx``.
+
+    Used for scroll-up paging: returns the next older page (the newest page of
+    the history already painted by the UI). ``start_idx`` is the message index
+    where the returned page begins; ``has_more`` indicates older pages remain.
+    """
+    starts = [i for i in turn_start_indexes(messages or []) if i < int(before_idx)]
+    if not starts:
+        return TranscriptWindow(events=[], start_idx=0, has_more=False)
+    n = min(len(starts), max(1, int(tail_turns)))
+    boundary = starts[len(starts) - n]
+    events = fold_messages_for_ui(messages[boundary:int(before_idx)])
+    return TranscriptWindow(
+        events=events,
+        start_idx=boundary,
+        has_more=any(i < boundary for i in starts),
+    )
+
+
 def _looks_error(content: str) -> bool:
     low = (content or "").casefold()
     return low.startswith("error") or "traceback" in low or "exception:" in low

{synapse_cli_agent-0.1.21 → synapse_cli_agent-0.1.22}/src/synapse/settings/schema.py

@@ -264,6 +264,11 @@ class Settings(BaseSettings):
     session_recap_min_turns: int = Field(
         default=3, validation_alias="AGENT_SESSION_RECAP_MIN_TURNS"
     )
+    # TUI transcript restore: number of recent visible turns rendered initially.
+    # Older turns are loaded when the user scrolls to the top.
+    history_tail_turns: int = Field(
+        default=20, ge=1, validation_alias="AGENT_HISTORY_TAIL_TURNS"
+    )
     # DeepSeek V4 thinking / other reasoning models via OpenAI-compatible API
     enable_thinking: bool = Field(default=True, validation_alias="ENABLE_THINKING")
     reasoning_effort: str = Field(default="high", validation_alias="REASONING_EFFORT")