@muzi3/herdr 0.3.1 → 0.3.2

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();
     }
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@muzi3/herdr",
-  "version": "0.3.1",
+  "version": "0.3.2",
   "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",