@gkzhb/pi-ntfy 0.1.0 → 0.1.2

package/README.md

@@ -42,21 +42,26 @@ pi -e ./packages/pi-ntfy
 
 设置 `PI_CODING_AGENT_DIR` 时，改读该隔离 agent 目录下的 `ntfy.json`，与 Pi 自己的配置隔离方式一致。每次通知重新读取文件，修改立即生效。缺失配置时静默禁用。无效配置或投递失败仅在 TUI 显示固定、不含服务详情的 warning，连续失败不会刷屏；成功后重置 warning。
 
-在订阅端订阅对应 topic，在人工主 TUI 中发送一个普通请求并等待结束。正文以“Pi 本轮已结束，等待输入。”开头，标题为“Pi 已完成”。仅追加下述身份元信息，不发送对话文本、工具结果、工作目录或主机名。中文 title 放在 UTF-8 JSON 中，避免 HTTP header 编码问题；priority 为 3，tags 为 `white_check_mark`。POST 至服务根地址；禁止自动跟随重定向，避免凭据转发。
+在订阅端订阅对应 topic，在人工主 TUI 中发送一个普通请求并等待结束。格式与本仓库 Herdr ntfy 插件对齐：标题为 `[主机名] pi 已完成本轮工作`，正文含会话位置、`状态：done` 及最多 300 个 Unicode 字符的“最后回复”摘要。摘要只取本轮最后一条正常停止的 assistant 文字，保留换行、清理控制字符，不读取其他会话或终端正文。中文 title 放在 UTF-8 JSON 中，避免 HTTP header 编码问题；priority 为 3，tags 为 `white_check_mark`，`markdown: true`。POST 至服务根地址；禁止自动跟随重定向，避免凭据转发。
+
+**内容边界改变：启用通知即允许将主机名、终端标签和最后回复的前 300 字符发送到配置的 ntfy 服务。** 摘要可能包含敏感信息，请使用可信服务与私有 topic。不发送完整历史、思考过程、工具调用或工具结果，也不发送 session 文件路径。
 
 ## 通知元信息
 
 元信息放在 ntfy 支持的 `message` 文本内，每项一行，不添加自定义 ntfy JSON 字段：
 
-- `Pi session`：当前 `ctx.sessionManager.getSessionId()` 的原生 Pi 会话 ID，完整保留便于区分多个 Pi / resume；不是 session 文件路径。
-- `Terminal pane`：当前进程 `HERDR_PANE_ID`，仅接受合法窗格 ID。
-- `tuios session`：当前进程 `TUIOS_SESSION` 名称，与 Pi session 不同。
-- `Terminal title`：通过 Herdr 兼容 CLI 查询**当前窗格**的标题；`Terminal tab`：该窗格当前 Tab ID 与可用的 label（tuios 中对应 workspace）。不使用聚焦窗格，不枚举其他会话，忽略可能因窗格移动而过时的 `HERDR_TAB_ID`。
+- `会话`：`tuios get-window <当前 UUID> --session <当前会话> --json` 返回的 `display_name` 或 `title`。
+- `tuios 会话`：当前进程 `TUIOS_SESSION`，与 Pi 会话不同。
+- `tuios 工作区`：当前窗格实际所属的数字工作区及可用名称；名称通过 `tuios list-workspaces` 获取，不使用当前聚焦的工作区。
+- `tuios 窗格`：当前进程 `TUIOS_PANE_ID` 的原生 UUID，不使用 Herdr 的兼容地址或 Tab。
+- `Pi 会话`：当前 `ctx.sessionManager.getSessionId()`，完整保留便于区分多个 Pi / resume；不是文件路径。
 
-使用 tuios 当前支持的 Herdr 兼容 `pane get` / `tab get`（`HERDR_BIN_PATH`，缺省 `herdr`），每次查询最多 750ms、32KiB 输出，不经过 shell。无 tuios/Herdr、CLI 失败、拒绝读取或不匹配 ID 时省略相关信息，仍通知；无终端环境时仅有 Pi session。标题和 label 去控制字符并截断为 120 字符，但可能包含用户自定的敏感文本：启用即允许将这些标签发往所配置的 ntfy topic，勿在终端标题/标签中放凭据或秘密。不会读取任何 pane 对话/agent summary/session 文件，也不会发送整个环境或 CLI 响应。
+只调用原生 `tuios` CLI，不读取 `HERDR_*` 字段或调用 Herdr 兼容接口。每次查询最多 750ms、32KiB 输出，不经过 shell。CLI 不存在、查询失败、拒绝读取或返回不匹配 UUID 时省略可选信息，仍通知；无 tuios 环境时保留 Pi 会话、状态和摘要。工作区列表仅用于匹配当前窗格的工作区名称，不采集其他窗格信息。标题与标签去终端转义、控制字符并截断为 120 字符，不发送完整 CLI 响应或整个环境。
 
 ## 哪些会话会通知
 
+启动时若存在 `BOTMUX` 环境变量（包括空值），整个插件直接禁用，不注册事件处理器，也不读取配置或发送 ntfy 通知。botmux 场景由飞书发送通知，避免重复提醒。
+
 1. 只允许 `ctx.mode === "tui"`，RPC / JSON / print 不通知。`hasUI` 不是主子判断依据，真正的 worker 也可能是 TUI。
 2. **每次拟通知时**同步查询 `pi.events.emit("shepherdr:worker-role:v1", { sessionManager: ctx.sessionManager, reply })`。任一 `true` 响应即跳过；使用当前 session manager，不缓存角色、不依赖扩展加载顺序。
 3. `false` 仅表示 Shepherdr 未将当前会话标记为 worker；无响应是 unknown，**不是已确认主 agent**。为支持独立 Pi，unknown TUI 默认允许通知。

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@gkzhb/pi-ntfy",
-  "version": "0.1.0",
-  "description": "Private-by-default ntfy completion notifications for human Pi TUI sessions.",
+  "version": "0.1.2",
+  "description": "ntfy completion notifications with reply summaries and tuios metadata for human Pi TUI sessions.",
   "type": "module",
   "engines": {
     "node": ">=22.18.0"

package/src/index.ts

@@ -14,32 +14,39 @@ function isWorker(pi: ExtensionAPI, ctx: ExtensionContext): boolean {
 }
 
 export default function ntfy(pi: ExtensionAPI): void {
+  // Botmux sends notifications through Feishu instead.
+  if (process.env.BOTMUX !== undefined) return;
+
   let outcome: "completed" | "aborted" | "error" | undefined;
-  let hasFinalAnswer = false;
+  let finalSummary: string | undefined;
   let warned = false;
 
-  pi.on("agent_start", () => { outcome = undefined; hasFinalAnswer = false; });
+  pi.on("agent_start", () => { outcome = undefined; finalSummary = undefined; });
   // A completed boundary can also mean length, toolUse or an empty/thinking-only
   // stop. pi-retry may continue those in another run after settlement.
   pi.on("agent_end", (event) => {
     const last = event.messages.findLast((message) => message.role === "assistant");
-    hasFinalAnswer = last?.role === "assistant" && last.stopReason === "stop" &&
-      last.content.some((part) => part.type === "text" && part.text.trim().length > 0) &&
-      !last.content.some((part) => part.type === "toolCall");
+    finalSummary = undefined;
+    if (last?.role !== "assistant" || last.stopReason !== "stop" ||
+        last.content.some((part) => part.type === "toolCall")) return;
+    const text = last.content.filter((part) => part.type === "text")
+      .map((part) => part.text).join("\n").replace(/\r\n?/g, "\n")
+      .replace(/[\u0000-\u0008\u000b\u000c\u000e-\u001f\u007f-\u009f]/g, "").trim();
+    if (text) finalSummary = [...text].slice(0, 300).join("").trimEnd();
   });
   // This is observation only: never request another turn or alter the prompt.
   pi.on("agent_before_settle", (event) => { outcome = event.outcome; });
   pi.on("agent_settled", async (event, ctx) => {
-    const completed = outcome === "completed" && hasFinalAnswer;
+    const summary = outcome === "completed" ? finalSummary : undefined;
     outcome = undefined;
-    hasFinalAnswer = false;
-    if (event.aborted || !completed || ctx.mode !== "tui") return;
+    finalSummary = undefined;
+    if (event.aborted || !summary || ctx.mode !== "tui") return;
     try {
       // Query here, not at factory/session_start: worker identity can change.
       if (isWorker(pi, ctx)) return;
       const config = await loadConfig();
       if (!config) return;
-      await publish(config, await metadata(ctx));
+      await publish(config, [...await metadata(ctx), "状态：done", "", "最后回复：", summary]);
       warned = false;
     } catch {
       // Raw errors may contain endpoint, response or credentials. Never forward.

package/src/metadata.ts

@@ -1,4 +1,5 @@
 import { execFile } from "node:child_process";
+import { stripVTControlCharacters } from "node:util";
 import type { ExtensionContext } from "@earendil-works/pi-coding-agent";
 
 function record(value: unknown): value is Record<string, unknown> {
@@ -7,13 +8,13 @@ function record(value: unknown): value is Record<string, unknown> {
 
 function label(value: unknown): string | undefined {
   if (typeof value !== "string") return;
-  const text = value.replace(/[\u0000-\u001f\u007f-\u009f]/g, " ").trim();
+  const text = stripVTControlCharacters(value).replace(/[\u0000-\u001f\u007f-\u009f]/g, " ").trim();
   return text ? [...text].slice(0, 120).join("") : undefined;
 }
 
 async function query(args: string[]): Promise<unknown> {
   return new Promise((resolve) => {
-    execFile(process.env.HERDR_BIN_PATH || "herdr", args, {
+    execFile("tuios", args, {
       encoding: "utf8", timeout: 750, killSignal: "SIGKILL", maxBuffer: 32 * 1024, windowsHide: true,
     }, (error, stdout) => {
       if (error) { resolve(undefined); return; }
@@ -22,36 +23,31 @@ async function query(args: string[]): Promise<unknown> {
   });
 }
 
-// Only our environment and our pane/tab are consulted, never focused-pane/list APIs.
+// Native tuios identity only; never query the focused window or terminal text.
 export async function metadata(ctx: ExtensionContext): Promise<string[]> {
   const lines: string[] = [];
   const sessionId = ctx.sessionManager.getSessionId();
-  // Keep the native ID, including safe CLI-defined IDs, never a session file path.
-  if (sessionId.match(/^[a-zA-Z0-9_.-]{1,128}$/)?.[0] === sessionId) lines.push(`Pi session: ${sessionId}`);
-  const paneId = process.env.HERDR_PANE_ID;
-  if (!paneId || paneId.match(/^w[A-Za-z0-9]+:p[A-Za-z0-9]+$/)?.[0] !== paneId) return lines;
-  lines.push(`Terminal pane: ${paneId}`);
-  const tuiosSession = label(process.env.TUIOS_SESSION);
-  if (tuiosSession) lines.push(`tuios session: ${tuiosSession}`);
-  try {
-    const response = await query(["pane", "get", paneId]);
-    if (!record(response) || !record(response.result)) return lines;
-    const pane = response.result.pane;
-    if (!record(pane) || pane.pane_id !== paneId) return lines;
-    const title = label(pane.terminal_title_stripped ?? pane.terminal_title);
-    if (title) lines.push(`Terminal title: ${title}`);
-    const tabId = pane.tab_id;
-    if (typeof tabId !== "string" || tabId.match(/^w[A-Za-z0-9]+:t[A-Za-z0-9]+$/)?.[0] !== tabId) return lines;
-    // Do not fall back to inherited HERDR_TAB_ID: panes can move.
-    const tabResponse = await query(["tab", "get", tabId]);
-    let tabLabel: string | undefined;
-    if (record(tabResponse) && record(tabResponse.result)) {
-      const tab = tabResponse.result.tab;
-      if (record(tab) && tab.tab_id === tabId) tabLabel = label(tab.label);
+  const piSession = sessionId.match(/^[a-zA-Z0-9_.-]{1,128}$/)?.[0] === sessionId
+    ? `Pi 会话：${sessionId}` : undefined;
+  const pane = process.env.TUIOS_PANE_ID;
+  const session = process.env.TUIOS_SESSION;
+  if (session && label(session)) lines.push(`tuios 会话：${label(session)}`);
+  if (pane && pane.match(/^[0-9a-f]{8}(?:-[0-9a-f]{4}){3}-[0-9a-f]{12}$/i)?.[0] === pane && session) {
+    const window = await query(["get-window", pane, "--session", session, "--json"]);
+    if (record(window) && window.success === true && window.id === pane) {
+      const title = label(window.display_name) ?? label(window.title);
+      if (title) lines.unshift(`会话：${title}`);
+      if (typeof window.workspace === "number" && Number.isSafeInteger(window.workspace) && window.workspace > 0) {
+        const response = await query(["list-workspaces", "--session", session, "--json"]);
+        const workspace = record(response) && response.success === true && Array.isArray(response.workspaces)
+          ? response.workspaces.find((item: unknown) => record(item) && item.workspace === window.workspace)
+          : undefined;
+        const name = record(workspace) ? label(workspace.name) : undefined;
+        lines.push(`tuios 工作区：${name ? `${name} (${window.workspace})` : window.workspace}`);
+      }
     }
-    lines.push(`Terminal tab: ${tabId}${tabLabel ? ` (${tabLabel})` : ""}`);
-  } catch {
-    // Optional metadata must not prevent completion delivery.
+    lines.push(`tuios 窗格：${pane}`);
   }
+  if (piSession) lines.push(piSession);
   return lines;
 }

package/src/publish.ts

@@ -1,3 +1,4 @@
+import { hostname } from "node:os";
 import type { Config } from "./config.ts";
 
 export async function publish(config: Config, details: string[] = []): Promise<void> {
@@ -12,10 +13,11 @@ export async function publish(config: Config, details: string[] = []): Promise<v
       signal: AbortSignal.timeout(config.timeoutMs),
       body: JSON.stringify({
         topic: config.topic,
-        title: "Pi 已完成",
-        message: ["Pi 本轮已结束，等待输入。", ...details].join("\n"),
+        title: `[${hostname()}] pi 已完成本轮工作`,
+        message: details.join("\n"),
         tags: ["white_check_mark"],
         priority: 3,
+        markdown: true,
       }),
     });
   } catch {