pi-ui-extension 1.1.10 → 1.2.0

package/README.md

@@ -34,9 +34,18 @@ The `SESSIONS` panel provides quick access to recent sessions:
 - Click a session to switch to it.
 - Rename a non-current session.
 - Delete a non-current session.
-- Use the `⊗` action to remove all other sessions.
+- Use `⊗` to move other unpinned sessions to trash while keeping the current and pinned sessions.
 - Click `SESSIONS ↻` to refresh the session list.
 
+**Advanced Sessions management (v1.2.0+)**: click `≡` on the Sessions header or run `/sessions-manager`.
+
+- Browse all saved sessions for the current project in **8-item pages**, with previous/next navigation and refresh.
+- Search session titles or IDs case-insensitively, and sort by latest update, oldest update, message count, or title.
+- Switch, rename, pin/unpin, or move an individual session to trash. Deletions require confirmation and the active session cannot be deleted.
+- Pinned sessions (`★`) appear first, including in the five-session quick sidebar. Pins persist as IDs (no session content) in `pi-ui-extension/session-pins.json` under Pi's agent directory.
+- Each session row has a quick pin button: `☆` means unpinned and `★` means pinned; clicking it toggles pinning without opening the manager. The existing `✎` rename and `×` delete controls are unchanged. On narrow sidebars, the pin action hides to preserve the existing controls.
+- The `⊗` bulk cleanup now **protects both the active session and all pinned sessions**. Explicit single-session deletion still requires confirmation.
+
 To avoid corrupting active agent state, switching, renaming, deleting, and bulk cleanup are only allowed while Pi is idle. The current session cannot be deleted.
 
 ### 3. Resource shortcuts
@@ -100,7 +109,22 @@ For tool definitions, the extension prefers the observable provider-request tool
 
 Modes can be changed directly with mouse clicks.
 
-When Fabric takes ownership of tool rendering, the panel remains visible for usage statistics but the local mode selector is hidden and replaced with `View controlled by Fabric`. This avoids conflicting display control.
+Tool View uses Pi's official `pi.registerToolRenderer()` hook for the built-in tools (`read`, `bash`, `edit`, `write`, `grep`, `find`, and `ls`) **and the built-in `codemode` tool**. It never replaces tool definitions or execution functions. Other tools retain their own renderers.
+
+For **Codemode** specifically:
+
+- **Normal** retains Pi's native script, nested-call, and output rendering (including its own expand/collapse behavior).
+- **Compact** uses a two-line, status-colored summary with Chinese labels: a highlighted Codemode title and script line count, followed by grouped execution status, nested-call counts, output size, and duration. It omits script source, nested-call arguments, and actual output, even if the row is expanded or execution fails. On narrow terminals it keeps each part to one row and prioritizes status and failures over less important metrics.
+- **Hidden** removes the Codemode transcript row, including expanded and failed results, without stopping execution or removing Tool/MCP usage accounting.
+
+Example Compact output:
+
+```text
+▸ codemode  8 行代码
+✓ 已完成  │  1 次调用 · 1 成功  │  59 行输出 · 85ms
+```
+
+Changing the Tool View mode also updates previously rendered tool rows in the current session. Other third-party tools are unaffected.
 
 ### 6. Tool / MCP usage statistics
 
@@ -165,7 +189,7 @@ Example configuration:
 To pin a specific version:
 
 ```bash
-pi install npm:pi-ui-extension@1.1.10
+pi install npm:pi-ui-extension@1.2.0
 ```
 
 or:
@@ -173,7 +197,7 @@ or:
 ```json
 {
   "packages": [
-    "npm:pi-ui-extension@1.1.10"
+    "npm:pi-ui-extension@1.2.0"
   ]
 }
 ```
@@ -201,7 +225,7 @@ Configuration form:
 Pin to a Git tag:
 
 ```bash
-pi install git:github.com/1993yihuan/pi-ui-extension@v1.1.10
+pi install git:github.com/1993yihuan/pi-ui-extension@v1.2.0
 ```
 
 ### Temporary local-source testing
@@ -300,7 +324,7 @@ npm run typecheck
 npm test
 ```
 
-The test suite covers the main behavior of Sidebar, CTX, Session management, Tool View, MCP resources, Fabric detection, mouse scrolling, and resize handling.
+The test suite covers Sidebar, CTX, Session management, official Tool View renderers, MCP resources, mouse scrolling, and resize handling.
 
 During development, Pi can load the local source directory directly:
 
@@ -325,7 +349,6 @@ pi-ui-extension/
 │   ├── session/             # Session list and actions
 │   ├── sidebar/             # Sidebar layout, scrolling, resize
 │   ├── tool-view/           # Tool View modes and usage statistics
-│   ├── fabric-detection.ts  # Fabric ownership detection
 │   └── index.ts             # Pi Extension entry point
 ├── .github/workflows/
 │   ├── ci.yml               # Automatic checks on push / PR
@@ -376,24 +399,26 @@ Checkout
 → npm pack --dry-run
 → npm Trusted Publishing (OIDC)
 → npm publish
-→ verify npm Registry visibility (with retries)
+→ verify npm Registry visibility (up to ~10 minutes of retries)
 → GitHub Release
 ```
 
 npm publishing uses GitHub Actions OIDC Trusted Publishing, so no long-lived `NPM_TOKEN` is required in the repository.
 
+Because npm can accept a publication before the new version becomes searchable, the release workflow waits up to approximately 10 minutes for registry indexing. If that verification times out, check the package on npm before retrying: a successful publish cannot be repeated for the same version.
+
 ## Compatibility and design principles
 
 - Does not modify Pi Core.
 - `@earendil-works/pi-coding-agent` and `@earendil-works/pi-tui` are host-provided peer dependencies to avoid duplicate runtime instances.
-- Fabric ownership is detected explicitly to avoid conflicting Tool View controls.
+- Tool View changes only how built-in tool calls are rendered, using Pi's public renderer resolver rather than overriding their implementations.
 - Session and resource operations use Pi public APIs wherever possible.
 - Context composition is clearly presented as an estimate, not provider-exact token accounting.
 - Fullscreen sidebar behavior degrades safely when fullscreen layout is unavailable.
 
 ## Requirements
 
-- Pi Coding Agent
+- Pi Coding Agent with the official `registerToolRenderer()` API (tested with `@earendil-works/pi-coding-agent@1.1.0`)
 - Node.js `>= 22.19.0` (use a Node version supported by your Pi installation)
 - CI validates Node.js 22.19.0 and 24; releases use Node.js 24
 

package/README.zh-CN.md

@@ -34,9 +34,19 @@ Sidebar 支持鼠标交互、滚轮滚动和终端尺寸变化。终端高度不
 - 点击会话切换到对应 Session。
 - 重命名非当前 Session。
 - 删除非当前 Session。
-- 使用右上角 `⊗` 清理除当前 Session 外的其他会话。
+- 使用右上角 `⊗` 清理其他未置顶会话（保留当前和置顶 Session）。
 - 点击 `SESSIONS ↻` 刷新会话列表。
 
+**Sessions 高级管理（v1.2.0 起）**：点击标题右侧的 `≡`，或输入 `/sessions-manager` 打开完整会话管理器。
+
+- 全量浏览当前项目的历史 Session，**每页 8 条**，可向前 / 向后翻页和手动刷新。
+- 按会话标题或 Session ID 搜索（不区分大小写），支持最近更新、最早更新、消息数量和标题排序。
+- 单独查看会话操作：切换、重命名、置顶 / 取消置顶、移到回收站。删除前有确认，当前 Session 不允许删除。
+- 置顶会话始终优先排序，并使用 `★` 标记，优先显示在 Sidebar 的最近 5 条会话中。
+- Sidebar 每条会话右侧新增快捷置顶按钮：`☆` 表示未置顶，`★` 表示已置顶，点击立即切换；与 `✎` 重命名、`×` 删除互不影响。Sidebar 较窄时优先保留原有操作按钮。
+- 置顶 ID 持久保存在 Pi 的 agent 目录下 `pi-ui-extension/session-pins.json`，不保存会话内容。
+- 使用 `⊗` 批量清理时，**保留当前会话及所有置顶会话**；显式删除单条置顶会话仍需确认。
+
 为避免正在执行中的 Agent 状态被破坏，会话切换、重命名、删除和批量清理只会在 Pi 空闲时执行；当前正在使用的 Session 不允许删除。
 
 ### 3. 资源快速查看
@@ -100,7 +110,22 @@ Composition 会将当前可观测上下文拆分为：
 
 可以直接使用鼠标点击模式进行切换。
 
-当 Fabric 接管工具展示行为时，扩展会保留 Tool View 面板和调用统计，但不再显示本地模式选择器，并提示 `View controlled by Fabric`，避免与 Fabric 的展示逻辑互相抢占。
+Tool View 使用 Pi 官方的 `pi.registerToolRenderer()` 接口管理内置工具（`read`、`bash`、`edit`、`write`、`grep`、`find` 和 `ls`）**以及内置 `codemode` 工具**的展示，不再重注册工具定义或接管工具执行逻辑。其他 Tool 保留其自身的渲染方式。
+
+对于 **Codemode**：
+
+- **Normal**：保留 Pi 原生的脚本、子工具调用、输出详情，以及原生展开 / 收起行为。
+- **Compact**：采用带有状态颜色的双行摘要。第一行突出 Codemode 和代码行数；第二行将状态、子调用统计、输出规模与耗时分组展示，并统一使用中文单位。即使展开或执行失败，也不会展示完整代码、子调用参数或真实输出；终端宽度不足时优先保留状态、失败信息和调用次数，避免摘要自动换成多行。
+- **Hidden**：隐藏 Codemode 工具记录（包括展开和失败结果），但不影响实际执行或 Tool / MCP 调用统计。
+
+Compact 效果示例：
+
+```text
+▸ codemode  8 行代码
+✓ 已完成  │  1 次调用 · 1 成功  │  59 行输出 · 85ms
+```
+
+切换 Tool View 模式也会更新当前会话中已经展示的历史工具记录；其他第三方工具保持原有渲染方式。
 
 ### 6. Tool / MCP 调用统计
 
@@ -165,7 +190,7 @@ Pi 会安装 package，并将声明写入个人配置：
 如果希望固定版本：
 
 ```bash
-pi install npm:pi-ui-extension@1.1.10
+pi install npm:pi-ui-extension@1.2.0
 ```
 
 或者：
@@ -173,7 +198,7 @@ pi install npm:pi-ui-extension@1.1.10
 ```json
 {
   "packages": [
-    "npm:pi-ui-extension@1.1.10"
+    "npm:pi-ui-extension@1.2.0"
   ]
 }
 ```
@@ -201,7 +226,7 @@ pi install git:github.com/1993yihuan/pi-ui-extension
 固定到 Git tag：
 
 ```bash
-pi install git:github.com/1993yihuan/pi-ui-extension@v1.1.10
+pi install git:github.com/1993yihuan/pi-ui-extension@v1.2.0
 ```
 
 ### 临时加载本地源码
@@ -300,7 +325,7 @@ npm run typecheck
 npm test
 ```
 
-当前自动化测试覆盖 Sidebar、CTX、Session、Tool View、MCP resource、Fabric detection、鼠标滚轮 / resize 等主要行为。
+当前自动化测试覆盖 Sidebar、CTX、Session、官方 Tool Renderer、MCP resource、鼠标滚轮 / resize 等主要行为。
 
 开发时可以直接让 Pi 加载本地目录：
 
@@ -325,7 +350,6 @@ pi-ui-extension/
 │   ├── session/             # Session 列表与操作
 │   ├── sidebar/             # Sidebar 布局、滚动和 resize
 │   ├── tool-view/           # Tool View 模式与调用统计
-│   ├── fabric-detection.ts  # Fabric 工具接管检测
 │   └── index.ts             # Pi Extension 入口
 ├── .github/workflows/
 │   ├── ci.yml               # push / PR 自动检查
@@ -376,24 +400,26 @@ Checkout
 → npm pack --dry-run
 → npm Trusted Publishing (OIDC)
 → npm publish
-→ 重试检查 npm Registry 已可查询新版本
+→ 重试检查 npm Registry 已可查询新版本（最多约 10 分钟）
 → GitHub Release
 ```
 
 npm 发布使用 GitHub Actions OIDC Trusted Publishing，不需要在 GitHub Repository 中保存长期 `NPM_TOKEN`。
 
+npm 可能先接受发布请求，再经过一段时间才能查询到新版本。Release 工作流会等待最多约 10 分钟让 Registry 完成索引。如果检查超时，请先核对 npm 上的实际版本再决定如何处理，避免对已发布的同一个版本重复执行 `npm publish`。
+
 ## 兼容性与设计原则
 
 - 不修改 Pi Core。
 - Pi host 提供的 `@earendil-works/pi-coding-agent` 和 `@earendil-works/pi-tui` 使用 `peerDependencies`，避免产生重复运行时实例。
-- 对 Fabric 做显式检测，避免 Tool View 模式控制发生冲突。
+- Tool View 只通过 Pi 官方 Renderer Resolver 控制内置工具的显示，不覆写工具定义或执行逻辑。
 - Session 与资源操作尽量通过 Pi 已公开 API 完成。
 - Context composition 明确标记为估算值，不冒充 provider 精确 token 统计。
 - fullscreen Sidebar 不可用时安全降级，不影响 Pi 主流程。
 
 ## Requirements
 
-- Pi Coding Agent
+- 支持官方 `registerToolRenderer()` API 的 Pi Coding Agent（已使用 `@earendil-works/pi-coding-agent@1.1.0` 验证）
 - Node.js `>= 22.19.0`（建议使用当前 Pi 支持的 Node 版本）
 - CI 覆盖 Node.js 22.19.0 和 24；发布工作流使用 Node.js 24
 

package/extensions/ctx/README.md

@@ -6,11 +6,11 @@
 
 - approx = 本地可观测文本 UTF-16 长度 / 4，逐消息向上取整；不是模型 tokenizer。已知消息先经公开 SDK `convertToLlm` 转换，再提取文本，因此包含摘要包装、bash 无输出/退出/取消/截断提示；仍按原始角色分类。未知角色安全降级为外层 content 文本，`excludeFromContext` 的 bash 不计入。
 - 六类为 System、Tools、Messages、Tool Results、Summary、Other。百分比分母是已覆盖分类的估算 token 合计，不是模型窗口；pi usage 单独展示，不校准分类。
-- System 使用 ctx.getSystemPrompt() 的可观测字符串；无法取得时 unknown。Tools 通过 pi.getActiveTools()/getAllTools() 仅选取当前启用的工具，逐工具序列化 `{name, description, parameters}`，按 UTF-16 长度 / 4 向上取整后合计，并纳入分类百分比分母。不计 sourceInfo、执行函数及已归入 System 的 promptGuidelines；Fabric 捕获但未直接启用的工具不重复计入。无启用工具为 0；API 不可用、启用工具缺少定义或 schema 无法序列化时保持 unknown，避免显示不完整合计。工具定义在每次现有快照事件刷新时重新读取（包括动态启用/禁用），不在 render 中读取；空闲时注册工具将在下一次快照事件反映。
+- System 使用 ctx.getSystemPrompt() 的可观测字符串；无法取得时 unknown。Tools 通过 pi.getActiveTools()/getAllTools() 仅选取当前启用的工具，逐工具序列化 `{name, description, parameters}`，按 UTF-16 长度 / 4 向上取整后合计，并纳入分类百分比分母。不计 sourceInfo、执行函数及已归入 System 的 promptGuidelines；未直接启用的工具不重复计入。无启用工具为 0；API 不可用、启用工具缺少定义或 schema 无法序列化时保持 unknown，避免显示不完整合计。工具定义在每次现有快照事件刷新时重新读取（包括动态启用/禁用），不在 render 中读取；空闲时注册工具将在下一次快照事件反映。
 - Tools 在 `before_provider_request` 事件后优先统计 provider-specific payload 的 `tools` 字段序列化文本（仍按 UTF-16 长度 / 4 估算）；请求发出前未观察到 payload 时，回退到当前启用工具 schema 的本地估算。它仍不是模型 tokenizer、HTTP 字节数或计费 token，也不包含 headers；如果后续扩展继续改写 payload，面板值可能是本扩展处理时观察到的版本。Images 仅统计图片块数量，不序列化请求或计算未展示的字节数；在 `before_provider_request` 可取得最终 provider payload 时优先统计该 payload，否则统计当前 context 消息；未能观测时显示 `not observed`。
 - context 事件提供调用前的消息快照；session_start/tree/compact、turn_end、agent_settled 使用 buildContextEntries() 重建 compaction-applied active branch。后者显示 active branch，前者显示 context hook。事件之外只读取缓存，不在 render 中扫描历史。
 - Messages 包括 user/assistant 文本、thinking 和 tool call 名称/参数；Tool Results 仅计 content；Summary 包括 compaction/branch summary；Other 包括可发送 custom message 和非排除的用户 bash。
-- Tool Results 按当前快照工具结果文本估算。Fabric 外层 content 只计一次，不遍历内部操作；不读 details、全量 JSONL、沙箱、截断前原始输出或被压缩结果。已返回 content 内的截断提示本身仍属于可发送文本。
+- Tool Results 按当前快照工具结果文本估算。每条 Tool Result 的 content 只计一次，不遍历内部操作；不读 details、全量 JSONL、沙箱、截断前原始输出或被压缩结果。已返回 content 内的截断提示本身仍属于可发送文本。
 
 Composition 的 token 估算使用 `~` 前缀及 K/M 紧凑缩写（四舍五入），百分比保留一位小数。宽度不足时标签与数值拆行；支持的最小侧栏宽 18 可完整显示如 `~100K 100.0%`。
 
@@ -32,4 +32,4 @@ Composition 的 token 估算使用 `~` 前缀及 K/M 紧凑缩写（四舍五入
 
 这是明确标记的本地估算，不宣称最终请求精确统计。后加载扩展仍可能改写 context 或 provider payload；不同 provider 的转换、剔除、包装开销未知。恢复/回合结束时 active branch 可能不同于上次请求经过 context 扩展裁剪后的快照；下一次 context 事件会替换它。模型生成过程中不逐 token 更新分类，最终回合/settled 时更新。只含图片的消息可见文本为零，不代表图片成本为零。
 
-未修改 pi core、Fabric 或全局配置。全屏鼠标/极短终端还应在用户真实终端手工确认。
+未修改 Pi Core 或全局配置。全屏鼠标/极短终端还应在用户真实终端手工确认。

package/extensions/ctx/data.test.ts

@@ -3,8 +3,8 @@ import test from "node:test";
 import { createReadTool, SessionManager } from "@earendil-works/pi-coding-agent";
 import { estimateContext, installContextEstimates, messagesFromContextEntries } from "./data.ts";
 
-const result = (n: number) => ({ role: "toolResult", toolName: "fabric_exec", toolCallId: String(n), content: [{ type: "text", text: "x".repeat(n * 4) }], details: { fullOutput: "x".repeat(100000), operations: [{ toolName: "read" }] } });
-const tool = { name: "fabric_exec", description: "Execute TypeScript", parameters: createReadTool(process.cwd()).parameters };
+const result = (n: number) => ({ role: "toolResult", toolName: "sample_runner", toolCallId: String(n), content: [{ type: "text", text: "x".repeat(n * 4) }], details: { fullOutput: "x".repeat(100000), operations: [{ toolName: "read" }] } });
+const tool = { name: "sample_runner", description: "Execute TypeScript", parameters: createReadTool(process.cwd()).parameters };
 
 test("context estimate keeps tool schemas, summaries, images and active branch semantics", () => {
   const snapshot = estimateContext([{role:"user",content:"abcd"}, result(4), {role:"compactionSummary",summary:"abcd"}], "abcd", "context hook", [tool]);
@@ -16,7 +16,7 @@ test("context estimate keeps tool schemas, summaries, images and active branch s
 
 test("tracker filters active tools, refreshes schemas, caches snapshots and resets", () => {
   const handlers = new Map<string, Function>();
-  let active = ["fabric_exec"];
+  let active = ["sample_runner"];
   let all = [tool];
   const tracker = installContextEstimates({
     on: (name: string, fn: Function) => handlers.set(name, fn),

package/extensions/ctx/tools.test.ts

@@ -3,7 +3,7 @@ import test from "node:test";
 import { createReadTool } from "@earendil-works/pi-coding-agent";
 import { estimateContext, estimateProviderToolsTokens, installContextEstimates } from "./data.ts";
 
-const tool = { name: "fabric_exec", description: "Execute TypeScript", parameters: createReadTool(process.cwd()).parameters };
+const tool = { name: "sample_runner", description: "Execute TypeScript", parameters: createReadTool(process.cwd()).parameters };
 const expected = Math.ceil(JSON.stringify(tool).length / 4);
 const toolsCategory = (snapshot: ReturnType<typeof estimateContext>) => snapshot.categories.find(c => c.name === "Tools")!;
 
@@ -25,7 +25,7 @@ test("Tools counts schema JSON only and contributes to totals and percentages",
 
 test("tracker filters active tools, refreshes dynamic schemas, caches reads and resets", () => {
  const handlers = new Map<string, Function>();
- let active = ["fabric_exec", "fabric_exec"];
+ let active = ["sample_runner", "sample_runner"];
  let all = [tool, {...tool,name:"captured_read",description:"not exposed".repeat(100)}];
  let reads = 0;
  let fail = false;
@@ -44,7 +44,7 @@ test("tracker filters active tools, refreshes dynamic schemas, caches reads and
  assert.ok(toolsCategory(tracker.getSnapshot()).tokens! > expected);
  handlers.get("before_provider_request")!({payload:{tools:[tool]}},ctx);
  assert.equal(toolsCategory(tracker.getSnapshot()).tokens, Math.ceil(JSON.stringify([tool]).length/4));
- all = [{...tool,description:"changed"}]; active = ["fabric_exec"];
+ all = [{...tool,description:"changed"}]; active = ["sample_runner"];
  handlers.get("turn_end")!({},ctx);
  // The last provider payload remains authoritative through active-branch refresh.
  assert.equal(toolsCategory(tracker.getSnapshot()).tokens, Math.ceil(JSON.stringify([tool]).length/4));

package/extensions/index.ts

@@ -8,11 +8,11 @@ import {
   SettingsManager,
   SessionManager,
   type ExtensionAPI,
+  type ExtensionContext,
 } from "@earendil-works/pi-coding-agent";
 import { installContextEstimates } from "./ctx/data.ts";
 import { createActivityTracker, type ActivityTracker } from "./ctx/activity.ts";
 import { installFooter, type FooterController } from "./footer/index.ts";
-import { isFabricFullCodeMode } from "./fabric-detection.ts";
 import { adapterMcpServers, buildMcpStatusSnapshot, describeMcpStatus, type McpStatusSnapshot } from "./mcp/status-center.ts";
 import {
   createDefaultSidebarPanels,
@@ -21,6 +21,7 @@ import {
 import type { ResourceButtonId } from "./session/panel.ts";
 import { installSidebar, type SidebarController } from "./sidebar/index.ts";
 import { deleteSessionFile } from "./session/mutations.ts";
+import { openSessionManager, readSessionPins, sessionsEligibleForClear, sortedSessions, toggleSessionPin } from "./session/manager.ts";
 import type { SessionListItem } from "./session/panel.ts";
 import { installToolViewController } from "./tool-view/controller.ts";
 import type { ToolViewMode } from "./tool-view/types.ts";
@@ -33,6 +34,8 @@ const SESSION_SWITCH_COMMAND = "sidebar-session-switch";
 const SESSION_RENAME_COMMAND = "sidebar-session-rename";
 const SESSION_DELETE_COMMAND = "sidebar-session-delete";
 const SESSION_CLEAR_COMMAND = "sidebar-session-clear-others";
+const SESSION_MANAGER_COMMAND = "sessions-manager";
+const SESSION_PINS_FILE = join(getAgentDir(), "pi-ui-extension", "session-pins.json");
 
 export type ResourceEntry = { name: string; description: string; content?: string };
 
@@ -209,12 +212,8 @@ export async function loadResourceEntries(
  */
 async function clearOtherSessions(
   pi: ExtensionAPI,
-  cwd: string,
-  sessionDir: string,
-  keepId: string,
+  targets: readonly { readonly path: string }[],
 ): Promise<{ readonly deleted: number; readonly failed: number; readonly firstError?: string }> {
-  const sessions = await SessionManager.list(cwd, sessionDir);
-  const targets = sessions.filter((session) => session.id !== keepId);
   let deleted = 0;
   let firstError: string | undefined;
   for (const target of targets) {
@@ -265,6 +264,65 @@ export default async function piUiExtension(pi: ExtensionAPI): Promise<void> {
     }
   };
   let switchRequested = false;
+  let sessionManagerOpen = false;
+  const safeReadPins = (): ReadonlySet<string> => {
+    try { return readSessionPins(SESSION_PINS_FILE); }
+    catch { return new Set(); } // Broken preferences must not hide saved sessions.
+  };
+  const loadSessionRows = async (ctx: ExtensionContext): Promise<readonly SessionListItem[]> => {
+    const currentId = ctx.sessionManager.getSessionId();
+    const pinned = safeReadPins();
+    const sessions = await SessionManager.list(ctx.cwd, ctx.sessionManager.getSessionDir());
+    return sortedSessions(sessions.map((session) => ({
+      id: session.id,
+      title: session.name ?? session.firstMessage,
+      modified: session.modified,
+      messageCount: session.messageCount,
+      current: session.id === currentId,
+      pinned: pinned.has(session.id),
+    })), "recent");
+  };
+  const canManageSessions = (ctx: ExtensionContext): boolean => {
+    if (ctx.isIdle()) return true;
+    ctx.ui.notify("Wait for the current run to finish before managing sessions", "warning");
+    return false;
+  };
+  const selectSession = (ctx: ExtensionContext, session: SessionListItem): void => {
+    if (session.current || switchRequested || !canManageSessions(ctx)) return;
+    switchRequested = true;
+    pi.sendUserMessage(`/${SESSION_SWITCH_COMMAND} ${session.id}`, { expandPromptTemplates: true });
+  };
+  const renameSession = (ctx: ExtensionContext, session: SessionListItem): void => {
+    if (!canManageSessions(ctx)) return;
+    pi.sendUserMessage(`/${SESSION_RENAME_COMMAND} ${session.id}`, { expandPromptTemplates: true });
+  };
+  const deleteSession = (ctx: ExtensionContext, session: SessionListItem): void => {
+    if (session.current) {
+      ctx.ui.notify("Cannot delete the currently active session", "warning");
+      return;
+    }
+    if (!canManageSessions(ctx)) return;
+    pi.sendUserMessage(`/${SESSION_DELETE_COMMAND} ${session.id}`, { expandPromptTemplates: true });
+  };
+  const launchSessionManager = async (ctx: ExtensionContext): Promise<void> => {
+    if (sessionManagerOpen || !canManageSessions(ctx)) return;
+    sessionManagerOpen = true;
+    try {
+      await openSessionManager({
+        ui: ctx.ui,
+        loadSessions: () => loadSessionRows(ctx),
+        togglePin: (id) => toggleSessionPin(SESSION_PINS_FILE, id),
+        onPinChanged: () => refreshSessions(),
+        onSwitch: (session) => selectSession(ctx, session),
+        onRename: (session) => renameSession(ctx, session),
+        onDelete: (session) => deleteSession(ctx, session),
+      });
+    } catch (error) {
+      ctx.ui.notify(`Failed to open Sessions manager: ${error instanceof Error ? error.message : String(error)}`, "error");
+    } finally {
+      sessionManagerOpen = false;
+    }
+  };
   const getMcpServerNames = () => mcpResources.map((server) => server.name);
   const updateMcpStatus = (): void => {
     mcpStatus = buildMcpStatusSnapshot(getAgentDir(), mcpCwd, mcpTrusted, registeredServers, liveMcpServers);
@@ -286,6 +344,11 @@ export default async function piUiExtension(pi: ExtensionAPI): Promise<void> {
     updateMcpStatus();
   });
 
+  pi.registerCommand(SESSION_MANAGER_COMMAND, {
+    description: "Search, sort, page, pin, switch, rename and delete saved sessions",
+    handler: async (_args, ctx) => launchSessionManager(ctx),
+  });
+
   pi.registerCommand(SESSION_RENAME_COMMAND, {
     description: "Rename a saved session selected from the sidebar",
     handler: async (args, ctx) => {
@@ -358,23 +421,24 @@ export default async function piUiExtension(pi: ExtensionAPI): Promise<void> {
   });
 
   pi.registerCommand(SESSION_CLEAR_COMMAND, {
-    description: "Move every saved session except the active one to trash",
+    description: "Move unpinned saved sessions except the active one to trash",
     handler: async (_args, ctx) => {
       try {
         const currentSessionId = ctx.sessionManager.getSessionId();
+        const pinnedIds = readSessionPins(SESSION_PINS_FILE);
         const sessions = await SessionManager.list(ctx.cwd, ctx.sessionManager.getSessionDir());
-        const others = sessions.filter((session) => session.id !== currentSessionId);
+        const others = sessionsEligibleForClear(sessions, currentSessionId, pinnedIds);
         if (others.length === 0) {
-          ctx.ui.notify("No other sessions to clear", "info");
+          ctx.ui.notify("No unpinned sessions to clear", "info");
           return;
         }
         const confirmed = await ctx.ui.confirm(
           "Clear other sessions",
-          `Move ${others.length} other session(s) to trash? The active session is kept.`,
+          `Move ${others.length} unpinned session(s) to trash? The active and pinned sessions are kept.`,
         );
         if (!confirmed) return;
 
-        const result = await clearOtherSessions(pi, ctx.cwd, ctx.sessionManager.getSessionDir(), currentSessionId);
+        const result = await clearOtherSessions(pi, others);
         refreshSessions();
         if (result.failed > 0) {
           ctx.ui.notify(
@@ -524,7 +588,6 @@ export default async function piUiExtension(pi: ExtensionAPI): Promise<void> {
     toolUsage = createToolUsageTracker([], getMcpServerNames);
     toolUsage.resetSession(branch);
     if (ctx.mode !== "tui") return;
-    const showToolViewModeSelector = (): boolean => !isFabricFullCodeMode(pi.getActiveTools());
 
     activity = createActivityTracker(ctx.cwd, refreshContextUi);
     footer = installFooter(
@@ -543,45 +606,20 @@ export default async function piUiExtension(pi: ExtensionAPI): Promise<void> {
           onSelectToolViewMode: (mode): void => {
             void toolView.setMode(mode, ctx);
           },
-          showToolViewModeSelector,
-          loadSessions: async (): Promise<readonly SessionListItem[]> => {
-            const currentSessionId = ctx.sessionManager.getSessionId();
-            const sessions = await SessionManager.list(ctx.cwd, ctx.sessionManager.getSessionDir());
-            return sessions.map((session) => ({
-              id: session.id,
-              title: session.name ?? session.firstMessage,
-              modified: session.modified,
-              messageCount: session.messageCount,
-              current: session.id === currentSessionId,
-            }));
-          },
-          onSelectSession: (session): void => {
-            if (session.current || switchRequested) return;
-            if (!ctx.isIdle()) {
-              ctx.ui.notify("Wait for the current run to finish before switching sessions", "warning");
-              return;
-            }
-            switchRequested = true;
-            pi.sendUserMessage(`/${SESSION_SWITCH_COMMAND} ${session.id}`, { expandPromptTemplates: true });
-          },
-          onRenameSession: (session): void => {
-            if (!ctx.isIdle()) {
-              ctx.ui.notify("Wait for the current run to finish before renaming sessions", "warning");
-              return;
-            }
-            pi.sendUserMessage(`/${SESSION_RENAME_COMMAND} ${session.id}`, { expandPromptTemplates: true });
-          },
-          onDeleteSession: (session): void => {
-            if (session.current) {
-              ctx.ui.notify("Cannot delete the currently active session", "warning");
-              return;
-            }
-            if (!ctx.isIdle()) {
-              ctx.ui.notify("Wait for the current run to finish before deleting sessions", "warning");
-              return;
+          loadSessions: () => loadSessionRows(ctx),
+          onSelectSession: (session): void => selectSession(ctx, session),
+          onRenameSession: (session): void => renameSession(ctx, session),
+          onDeleteSession: (session): void => deleteSession(ctx, session),
+          onTogglePinSession: (session): void => {
+            try {
+              const pinned = toggleSessionPin(SESSION_PINS_FILE, session.id);
+              refreshSessions();
+              ctx.ui.notify(pinned ? "会话已置顶" : "已取消置顶", "info");
+            } catch (error) {
+              ctx.ui.notify(`保存置顶失败：${error instanceof Error ? error.message : String(error)}`, "error");
             }
-            pi.sendUserMessage(`/${SESSION_DELETE_COMMAND} ${session.id}`, { expandPromptTemplates: true });
           },
+          onOpenSessionManager: (): void => { void launchSessionManager(ctx); },
           onDeleteOthers: (): void => {
             if (!ctx.isIdle()) {
               ctx.ui.notify("Wait for the current run to finish before clearing sessions", "warning");

package/extensions/mcp/integration.test.ts

@@ -20,7 +20,7 @@ test("entry wires early/late MCP status into restored and live usage without dou
   };
   const theme: any = { fg: (_: string, text: string) => text, bold: (text: string) => text };
   const pi: any = {
-    registerTool() {}, registerCommand() {}, registerShortcut() {},
+    registerTool() { throw new Error("Tool View must not register tools"); }, registerToolRenderer() {}, registerCommand() {}, registerShortcut() {},
     getCommands: () => [], getActiveTools: () => [], getAllTools: () => [], getThinkingLevel: () => "off",
     getMcpServers: () => registrations,
     on(name: string, fn: any) { handlers.set(name, [...(handlers.get(name) ?? []), fn]); },