@muzi3/herdr 0.3.1 → 0.3.3

package/README.md

@@ -30,7 +30,7 @@ extensions/
 
 每个扩展目录的入口都叫 `index.ts`，与 pi 自己的目录式扩展约定一致：扩展目录内可以再放内部模块，`pi.extensions` 只指向入口，不会误加载旁支文件。
 
-`herdr-agent-state/index.ts` 的目录名与 herdr 集成注入的文件同名，对齐上游时可以直接对比。内容分两段：官方集成正文（一直到文件末尾之前）与之后的「本包新增」段落。本包对官方正文只有**一处**改动：官方 `export default` 开头插入一行 `registerBlockedReporting(pi);` —— 该 default export 就是本扩展的唯一入口，blocked 上报只能挂在那里。重新同步上游时（`HERDR_INTEGRATION_VERSION` 从 8 往上升）重取注入文件替换官方正文并补回那一行；`diff` 应只有三处新增、零删除，漏帖那一行会被 `tests/herdr-agent-state.test.ts` 拦下。
+`herdr-agent-state/index.ts` 的目录名与 herdr 集成注入的文件同名，对齐上游时可以直接对比。内容分两段：官方集成正文（一直到文件末尾之前）与之后的「本包新增」段落。本包对官方正文只有**一处**改动：官方 `export default` 开头插入一行 `registerBlockedReporting(pi);` —— 该 default export 就是本扩展的唯一入口，blocked 上报只能挂在那里。重新同步上游时（`HERDR_INTEGRATION_VERSION` 从 9 往上升）重取注入文件替换官方正文并补回那一行；`diff` 应只有三处新增、零删除，漏帖那一行会被 `tests/herdr-agent-state.test.ts` 拦下。
 
 ## 来源与许可
 

package/extensions/herdr-agent-state/index.ts

@@ -2,14 +2,14 @@
 // managed by herdr; reinstalling or updating the integration overwrites this file.
 // add custom hooks/plugins beside this file instead of editing it.
 // HERDR_INTEGRATION_ID=pi
-// HERDR_INTEGRATION_VERSION=8
+// HERDR_INTEGRATION_VERSION=9
 // @ts-nocheck
 //
 // ---------------------------------------------------------------------------
 // 以下为本包（@muzi3/herdr）的说明，不属于 herdr 官方正文：
 //
 // 1. 本文件上方内容是 herdr 官方 pi 集成正文的副本，保留是为了将来能直接与上游重新同步：
-//    上游 `HERDR_INTEGRATION_VERSION` 从当前的 8 往上升时，重取 `herdr integration install pi`
+//    上游 `HERDR_INTEGRATION_VERSION` 从当前的 9 往上升时，重取 `herdr integration install pi`
 //    注入的文件并替换本文件的官方段落即可（文件末尾的「本包新增」段落不受影响）。
 //    本包对官方段落只有**一处**改动：`export default` 开头插入一行
 //    `registerBlockedReporting(pi);`（带「本包新增」标记）。因为官方的 default export 就是本
@@ -27,6 +27,7 @@
 // ---------------------------------------------------------------------------
 
 import net from "node:net";
+import path from "node:path";
 
 const HERDR_ENV = process.env.HERDR_ENV;
 const socketPath = process.env.HERDR_SOCKET_PATH;
@@ -67,11 +68,11 @@ function sendRequestAttempt(request: unknown, timeoutMs: number): Promise<boolea
   });
 }
 
-async function sendRequest(request: unknown): Promise<void> {
+async function sendRequest(request: unknown): Promise<boolean> {
   if (await sendRequestAttempt(request, 500)) {
-    return;
+    return true;
   }
-  await sendRequestAttempt(request, 1500);
+  return sendRequestAttempt(request, 1500);
 }
 
 type AgentState = "working" | "blocked" | "idle";
@@ -95,7 +96,10 @@ function updateSessionRef(ctx: any): void {
   try {
     const file = ctx?.sessionManager?.getSessionFile?.();
     currentAgentSessionPath =
-      typeof file === "string" && file.startsWith("/") ? file : undefined;
+      typeof file === "string" &&
+      (path.posix.isAbsolute(file) || path.win32.isAbsolute(file))
+        ? file
+        : undefined;
   } catch {
     currentAgentSessionPath = undefined;
   }
@@ -165,6 +169,7 @@ function sendState(state: AgentState, message?: string, seq = nextReportSeq()):
 
 let sendInFlight = false;
 let queuedState: QueuedState | undefined;
+let retryTimer: ReturnType<typeof setTimeout> | undefined;
 
 function queueState(state: AgentState, message?: string): void {
   queuedState = { state, message, seq: nextReportSeq() };
@@ -173,6 +178,17 @@ function queueState(state: AgentState, message?: string): void {
   }
 }
 
+function scheduleStateRetry(): void {
+  if (retryTimer) {
+    return;
+  }
+  retryTimer = setTimeout(() => {
+    retryTimer = undefined;
+    void drainStateQueue();
+  }, 1000);
+  retryTimer.unref?.();
+}
+
 async function drainStateQueue(): Promise<void> {
   if (sendInFlight) {
     return;
@@ -183,11 +199,18 @@ async function drainStateQueue(): Promise<void> {
     while (queuedState) {
       const next = queuedState;
       queuedState = undefined;
-      await sendState(next.state, next.message, next.seq);
+      if (await sendState(next.state, next.message, next.seq)) {
+        continue;
+      }
+      if (!queuedState || queuedState.seq < next.seq) {
+        queuedState = next;
+      }
+      scheduleStateRetry();
+      break;
     }
   } finally {
     sendInFlight = false;
-    if (queuedState) {
+    if (queuedState && !retryTimer) {
       void drainStateQueue();
     }
   }
@@ -358,6 +381,7 @@ export function registerBlockedReporting(pi) {
 	let raised = false;
 	let raisedLabel: string | undefined;
 	let askUser: { header?: string; question?: string } | undefined;
+	let turnActive = false;
 
 	function lower(): void {
 		if (!raised) return;
@@ -381,6 +405,10 @@ export function registerBlockedReporting(pi) {
 
 	pi.on("ui_prompt_start", (event) => {
 		if (!rootSession) return;
+		// 只有回合内的弹窗才意味着「agent 卡住等人回话」。回合外的 custom 多半是装饰性
+		// overlay（例如 prompt-nav 在每个 session_start 挂的非捕获导航条），用户不需要回答；
+		// 把它当 blocked 会让 pane 一开机就永久红点。
+		if (!turnActive) return;
 		// custom 提示（ask_user_question 走这条）的 title 是空的，用问题内容补 label。
 		raise(event.kind === "custom" ? (askUser?.header ?? askUser?.question) : event.title);
 	});
@@ -396,14 +424,28 @@ export function registerBlockedReporting(pi) {
 		// reload 会同时重载集成与本扩展，两侧计数一起归零。
 		if (ctx?.mode !== "tui") return;
 		rootSession = true;
-		raised = false;
-		raisedLabel = undefined;
+		turnActive = ctx?.isIdle?.() === false;
+		// 上一会话遗留的 raise 必须先显式降掉：官方段落只认计数，直接清 raised 会把
+		// blockedCount 永久留在 1，之后所有状态都被 blocked 压住（重启/换会话也治不好）。
+		lower();
 		askUser = undefined;
 	});
 
+	pi.on("agent_start", () => {
+		turnActive = true;
+	});
+
+	pi.on("agent_settled", () => {
+		turnActive = false;
+		// 等人回答时回合不会 settle，所以回合结束就不会有真问题待答；顺手清掉漏掉的 raise，
+		// 避免 pane 在回合结束后继续顶着红点。
+		lower();
+	});
+
 	pi.on("session_shutdown", () => {
 		lower();
 		rootSession = false;
+		turnActive = false;
 		askUser = undefined;
 	});
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@muzi3/herdr",
-  "version": "0.3.1",
+  "version": "0.3.3",
   "description": "Herdr for pi: three independent extensions (agent + blocked state reporting, /pi-hot-restart, and the herdr_overview / herdr_read / herdr_wait / herdr_prompt / herdr_run / herdr_create / herdr_agent_start / herdr_close manager tools aligned with dsh's herdr-tools plugin) plus the herdr-guide skill.",
   "keywords": [
     "pi-package",