pi-session-peek 0.4.0 → 0.4.1

package/CHANGELOG.md

@@ -1,5 +1,10 @@
 # Changelog
 
+## 0.4.1
+
+- `Ctrl+T` shows tool calls in the preview: one dim line per call with the tool name and its main argument (command, path, URL, query…), placed under the reply that made it. Off by default. Tool results are still not stored, and the tool lines are never searched or highlighted.
+- Assistant turns that only call tools (no text) are now kept when parsing, so with `Ctrl+T` on the preview no longer jumps from "let me check" straight to the conclusion. With it off they are skipped as before.
+
 ## 0.4.0
 
 - Search syntax: `"exact phrase"` (whitespace inside the quotes matches any whitespace, including line breaks), `a|b` for either, `-word` to exclude, `name:` / `dir:` (`cwd:`) / `user:` / `ai:` (`assistant:`) to limit a term to one field, and `/regex/` for JavaScript regular expressions. Prefixes stack (`-user:"not now"`), quotes escape everything else, and an invalid regex falls back to plain text.

package/README.md

@@ -12,11 +12,12 @@ Search your [pi](https://pi.dev) session history by what was actually said, read
 
 - Opens a two-pane picker with `/peek` or `/peek <keyword>`: sessions on the left, the full conversation on the right.
 - Renders the conversation with pi's own Markdown renderer, so headings, code blocks with syntax highlighting, tables and lists look the same as in the main transcript.
-- Filters as you type across conversation text, session name and working directory. Tool call arguments and results are excluded, so a keyword only matches sessions that actually discussed it.
+- Filters as you type across conversation text, session name and working directory. Tool call arguments and results are excluded from the search, so a keyword only matches sessions that actually discussed it.
 - Requires every space-separated keyword to match, and shows a snippet around the first hit in the list.
 - Understands `"exact phrases"`, `either|or`, `-exclude`, `name:` / `dir:` / `user:` / `ai:` prefixes and `/regex/`.
 - Limits results to recently active sessions with `@7d`, `@24h`, `@2w` or `@1m`.
 - Highlights every hit in the preview and jumps between them with `Ctrl+N` / `Ctrl+P`.
+- Shows what the assistant actually did with `Ctrl+T`: one dim line per tool call (`⚙ bash  git status`, `⚙ edit  src/query.ts`) under the reply that made it. Off by default.
 - Resumes with `Enter`, forks into a new session with `Ctrl+O`, renames with `Ctrl+R`, deletes with `Ctrl+D`.
 - Toggles between the current directory tree and all projects with `Tab`.
 - Starts straight into the picker with `pi --rp` or `pi --peek=<keyword>`.
@@ -66,6 +67,7 @@ In TUI mode, run `/peek` and start typing. Press `Enter` on a session to continu
 | `Ctrl+U` `Ctrl+F` | Scroll preview by half a page |
 | `Shift+↑` `Shift+↓` | Scroll preview by three lines |
 | `Ctrl+N` `Ctrl+P` | Next / previous hit line outside the current view; the top-right corner shows `hit k/n` |
+| `Ctrl+T` | Show / hide tool calls in the preview. Each call is one line with the tool name and its main argument (command, path, URL, query). Results are never shown. |
 | `Enter` | Resume the session |
 | `Ctrl+O` | Fork the session and open the fork |
 | `Ctrl+R` | Rename. Writes the same `session_info` entry as `/name`. |
@@ -90,7 +92,7 @@ The filter is case-insensitive and matches anywhere in the text. Whitespace sepa
 
 Quotes are the escape hatch: `"-foo"`, `"a|b"`, `"name:x"` and `"/x/"` search for those characters literally. A regex that fails to compile is searched as plain text. Only positive terms are highlighted in the preview, and `name:` / `dir:` terms never touch the conversation, so `name:auth` alone shows the full conversation with no highlights.
 
-The search index holds user and assistant messages, the session name and the working directory. It does not hold tool call arguments or tool results.
+The search index holds user and assistant messages, the session name and the working directory. It does not hold tool call arguments or tool results, and the tool lines shown by `Ctrl+T` are never matched or highlighted.
 
 ## 🌐 Language
 

package/README.zh-CN.md

@@ -12,11 +12,12 @@
 
 - `/peek` 或 `/peek 关键词` 打开左右分栏的选择器：左边是会话列表，右边是完整对话。
 - 右栏用 pi 自己的 Markdown 渲染器画，标题、带语法高亮的代码块、表格、列表和主界面里的对话一个样子。
-- 边打字边过滤，搜的是对话正文、会话名和工作目录。工具调用的参数和结果不进索引，所以只会命中真正讨论过这个词的会话。
+- 边打字边过滤，搜的是对话正文、会话名和工作目录。工具调用的参数和结果不进搜索索引，所以只会命中真正讨论过这个词的会话。
 - 空格分隔多个关键词，全部命中才显示；列表里直接显示第一个命中处的片段。
 - 支持 `"精确短语"`、`a|b` 任一命中、`-排除`、`name:` / `dir:` / `user:` / `ai:` 限定范围，以及 `/正则/`。
 - `@7d`、`@24h`、`@2w`、`@1m` 只看最近活动过的会话。
 - 预览里所有命中都高亮，`Ctrl+N` / `Ctrl+P` 在命中间跳。
+- `Ctrl+T` 显示 AI 实际做了什么：每次工具调用在对应回复下面占一行灰字（`⚙ bash  git status`、`⚙ edit  src/query.ts`）。默认关闭。
 - `Enter` 进入会话，`Ctrl+O` 分叉成新会话，`Ctrl+R` 重命名，`Ctrl+D` 删除。
 - `Tab` 在当前目录树和全部项目之间切换。
 - `pi --rp` 或 `pi --peek=关键词` 启动时直接打开。
@@ -66,6 +67,7 @@ pi 扩展以你的用户权限运行，只装信得过的包。
 | `Ctrl+U` `Ctrl+F` | 预览翻半页 |
 | `Shift+↑` `Shift+↓` | 预览滚三行 |
 | `Ctrl+N` `Ctrl+P` | 跳到当前屏幕外的下一处 / 上一处命中行，右上角显示「命中 k/n」 |
+| `Ctrl+T` | 预览里显示 / 隐藏工具调用。每次调用一行：工具名和主参数（命令、路径、URL、查询词）。不显示结果。 |
 | `Enter` | 进入会话 |
 | `Ctrl+O` | 分叉出新会话并进入 |
 | `Ctrl+R` | 重命名，写入的记录和 `/name` 一样 |
@@ -90,7 +92,7 @@ pi 扩展以你的用户权限运行，只装信得过的包。
 
 引号是万能转义：`"-foo"`、`"a|b"`、`"name:x"`、`"/x/"` 都按字面搜这些字符。正则写错了就当普通文字搜。预览里只高亮正向的词，`name:` / `dir:` 的词不碰对话正文，所以只输入 `name:auth` 时右栏显示完整对话、没有高亮。
 
-索引里有用户和助手的消息、会话名、工作目录。没有工具调用的参数和结果。
+索引里有用户和助手的消息、会话名、工作目录。没有工具调用的参数和结果，`Ctrl+T` 显示的工具行也不参与匹配和高亮。
 
 ## 🌐 界面语言
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-session-peek",
-  "version": "0.4.0",
+  "version": "0.4.1",
   "description": "Pi extension: search session history in a two-pane picker with full conversation preview, then resume or fork.",
   "type": "module",
   "license": "MIT",

package/src/i18n.ts

@@ -32,7 +32,7 @@ const zh = {
   ai: "🤖 AI",
   renamePrefix: "✏ 重命名: ",
   confirmDelete: "⚠ 删除会话 [{desc}]？按 y / Enter 确认，任意其他键取消",
-  footer: "↑↓ 选择  PgUp/Dn·^U/^F·⇧↑↓ 滚动  ^N/^P 命中  Tab 范围  ^D 删除  ^R 改名  ^O 分叉  Enter 进入  Esc/^C 关闭",
+  footer: "↑↓ 选择  PgUp/Dn·^U/^F·⇧↑↓ 滚动  ^N/^P 命中  ^T 工具  Tab 范围  ^D 删除  ^R 改名  ^O 分叉  Enter 进入  Esc/^C 关闭",
   since: "近{n}{unit}",
   unitH: "小时",
   unitD: "天",
@@ -72,7 +72,7 @@ const en: Record<keyof typeof zh, string> = {
   ai: "🤖 AI",
   renamePrefix: "✏ Rename: ",
   confirmDelete: "⚠ Delete session [{desc}]? y / Enter to confirm, any other key to cancel",
-  footer: "↑↓ select  PgUp/Dn·^U/^F·⇧↑↓ scroll  ^N/^P hits  Tab scope  ^D del  ^R rename  ^O fork  Enter open  Esc close",
+  footer: "↑↓ select  PgUp/Dn·^U/^F·⇧↑↓ scroll  ^N/^P hits  ^T tools  Tab scope  ^D del  ^R rename  ^O fork  Enter open  Esc close",
   since: "last {n}{unit}",
   unitH: "h",
   unitD: "d",

package/src/peek-component.ts

@@ -23,7 +23,8 @@ export class PeekComponent implements Component, Focusable {
   private selected = 0;
   private listOffset = 0;
   private previewOffset = 0;
-  private previewKey = ""; // 预览缓存的键（会话 + 关键词 + 宽度），置空强制重建
+  private previewKey = ""; // 预览缓存的键（会话 + 关键词 + 宽度 + 工具开关），置空强制重建
+  private showTools = false; // Ctrl+T：预览里显示每次工具调用的一行摘要
   private previewLines: string[] = [];
   private matchLines: number[] = []; // 预览里含关键词的行（升序），Ctrl+N / Ctrl+P 用
   private rendered = new WeakMap<PeekMsg, { w: number; lines: string[] }>(); // 每条消息渲染好的行，按宽度缓存
@@ -224,6 +225,12 @@ export class PeekComponent implements Component, Focusable {
       this.invalidate();
       return;
     }
+    if (matchesKey(data, Key.ctrl("t"))) {
+      this.showTools = !this.showTools;
+      this.previewKey = "";
+      this.invalidate();
+      return;
+    }
     if (matchesKey(data, Key.ctrl("n"))) {
       this.jumpMatch(1);
       return;
@@ -339,7 +346,7 @@ export class PeekComponent implements Component, Focusable {
   private buildPreview(rw: number): void {
     const t = this.theme;
     const s = this.filtered[this.selected];
-    const key = s ? `${s.path}|${this.getQuery()}|${rw}` : "none";
+    const key = s ? `${s.path}|${this.getQuery()}|${rw}|${this.showTools ? "t" : ""}` : "none";
     if (key === this.previewKey) return;
     this.previewKey = key;
     this.matchLines = [];
@@ -351,9 +358,11 @@ export class PeekComponent implements Component, Focusable {
     }
 
     const lines: string[] = [];
+    // 消息数只算有文字的，纯工具轮次不计
+    const textCount = s.msgs.reduce((n, m) => n + (m.text ? 1 : 0), 0);
     lines.push(
       truncateToWidth(
-        t.fg("dim", `${s.cwd} • ${msg("msgCount", { n: s.msgs.length })}${s.name ? " • " + s.name : ""}`),
+        t.fg("dim", `${s.cwd} • ${msg("msgCount", { n: textCount })}${s.name ? " • " + s.name : ""}`),
         rw,
       ),
     );
@@ -385,26 +394,39 @@ export class PeekComponent implements Component, Focusable {
       return truncateToWidth(label + " " + "─".repeat(Math.max(2, rw - w - 1)), rw);
     };
 
+    let prevRole: PeekMsg["role"] | undefined; // 上一条画出来的消息的角色
     for (const m of msgs) {
+      const tools = this.showTools ? (m.tools ?? []) : [];
+      if (!m.text && !tools.length) continue; // 工具隐藏时，只有工具调用的 AI 轮次整条跳过
       const terms = rt[m.role]; // user: 的词只在用户消息里高亮，ai: 的只在 AI 回复里
       const isMatch = terms.length > 0 && anyMatch(m.text, terms);
-      const head = lines.length;
-      if (m.role === "user") {
+      // 紧跟在 AI 文字后面、只有工具调用的轮次不重复画标签，接在上一条正文下面，看起来是同一轮
+      const continues = m.role === "assistant" && prevRole === "assistant" && !m.text;
+      if (continues) {
+        lines.pop();
+      } else if (m.role === "user") {
         lines.push(
           t.bg("userMessageBg", padEndVisible(t.bold(t.fg("accent", fillLabel(msg("you")))), rw)),
         );
       } else {
         lines.push(t.fg("muted", fillLabel(msg("ai"))));
       }
+      const head = lines.length - 1;
       // 先渲染再高亮：往 markdown 源码里插转义码会把链接、代码块的语法弄坏
       const before = this.matchLines.length;
-      for (const l of this.renderMsg(m, rw)) {
-        if (isMatch && lineHasMatch(l, terms)) this.matchLines.push(lines.length);
-        lines.push(isMatch ? highlight(l, terms, t) : l);
+      if (m.text) {
+        for (const l of this.renderMsg(m, rw)) {
+          if (isMatch && lineHasMatch(l, terms)) this.matchLines.push(lines.length);
+          lines.push(isMatch ? highlight(l, terms, t) : l);
+        }
       }
       // 关键词被折行拆开时哪一行都找不到，退回到消息标题行，别把这条消息漏掉
       if (isMatch && this.matchLines.length === before) this.matchLines.push(head);
+      for (const tool of tools) {
+        lines.push(t.fg("dim", truncateToWidth(` ⚙ ${tool.name}${tool.summary ? "  " + tool.summary : ""}`, rw)));
+      }
       lines.push("");
+      prevRole = m.role;
     }
 
     this.previewLines = lines;

package/src/sessions.ts

@@ -7,9 +7,15 @@ import { join } from "node:path";
 // 读 ~/.pi/agent/sessions 下的会话 JSONL，按 mtime 缓存；重命名和删除也在这里。
 // 搜索不预存小写全文：会话正文只在 msgs 里放一份，匹配时用不区分大小写的正则直接扫（见 query.ts 的 matchesSession）
 
+export interface PeekTool {
+  name: string;
+  summary: string; // 主参数（命令 / 路径 / URL…）压成一行，预览里显示用
+}
+
 export interface PeekMsg {
   role: "user" | "assistant";
-  text: string;
+  text: string; // 只发了工具调用、没写字的 AI 轮次为空串
+  tools?: PeekTool[]; // 这条消息里的工具调用，没有就不带这个键。不进搜索索引
 }
 
 export interface PeekSession {
@@ -55,6 +61,26 @@ function extractText(content: unknown): string {
     .join("\n");
 }
 
+// 工具调用的主参数：按常见键名找第一个字符串，都没有就取第一个字符串参数。不存结果，bash 输出动辄几十 KB
+const TOOL_ARG_KEYS = ["command", "path", "url", "query", "pattern", "file_path"];
+const TOOL_SUMMARY_MAX = 120;
+
+export function toolSummary(args: unknown): string {
+  if (!args || typeof args !== "object") return "";
+  const o = args as Record<string, unknown>;
+  let v = TOOL_ARG_KEYS.map((k) => o[k]).find((x) => typeof x === "string" && x.trim());
+  if (typeof v !== "string") v = Object.values(o).find((x) => typeof x === "string" && (x as string).trim());
+  if (typeof v !== "string") return "";
+  return v.replace(/\s+/g, " ").trim().slice(0, TOOL_SUMMARY_MAX);
+}
+
+function extractTools(content: unknown): PeekTool[] {
+  if (!Array.isArray(content)) return [];
+  return content
+    .filter((c: any) => c?.type === "toolCall" && typeof c.name === "string")
+    .map((c: any) => ({ name: c.name, summary: toolSummary(c.arguments) }));
+}
+
 function parseSession(path: string, raw: string, mtime: number): PeekSession | null {
   let cwd = "";
   let time = "";
@@ -82,12 +108,17 @@ function parseSession(path: string, raw: string, mtime: number): PeekSession | n
       const role = o.message?.role;
       if (role !== "user" && role !== "assistant") continue;
       const text = extractText(o.message?.content).trim();
-      if (text) msgs.push({ role, text });
+      const tools = role === "assistant" ? extractTools(o.message.content) : [];
+      // 只有工具调用的 AI 轮次也留着，否则预览里"我来看看"直接跳到结论，中间做了什么全没了
+      if (tools.length) msgs.push({ role, text, tools });
+      else if (text) msgs.push({ role, text });
     } catch {
     }
   }
 
-  if (!msgs.length) return null;
+  // 一条文字消息都没有的会话不列出来；列表里的首条也只看有文字的
+  const firstText = msgs.find((m) => m.text);
+  if (!firstText) return null;
 
   return {
     path,
@@ -96,7 +127,7 @@ function parseSession(path: string, raw: string, mtime: number): PeekSession | n
     name,
     msgs,
     mtime,
-    first: msgs[0].text.replace(/\s+/g, " ").slice(0, 80),
+    first: firstText.text.replace(/\s+/g, " ").slice(0, 80),
   };
 }