pi-ptc-meter 1.0.26 → 1.0.28

package/README.md

@@ -56,9 +56,9 @@ pi install npm:pi-ptc-meter
 
 ## 作用（源码事实）
 
-- `tool_call`：计数 +1（不拦截、不改调用）。
+- `tool_call`：顶层调用计数 +1（codemode 内层调用不另计；不拦截、不改调用）。
 - `turn_end`：记录本轮次数与耗时（不落盘）。
-- `agent_end`：每 run 落盘一行日志。
+- `agent_end`：每 run 落盘一行日志；goal 自动续轮共享同一 run 时，`turn_end` 超阈值即提示一次（每 run 一次），避免回路整段失效。
 - `before_agent_start`：结算上一轮并以 `nextTurn` 尾部消息回灌——计数、耗时、偏差、基线中位、**缓存命中率**（仅当该轮有 usage 数据时出现；< 90% 标「低」）——（`display: false`）。
 
 **注入样例（示意，字段可能随版本增删）**
@@ -75,7 +75,7 @@ PTC 计量：上一轮 9 次工具调用 · 实际 34s · 命中 92% · 预计 8
 ```text
 本轮开工前 ─ 声明「预计 N 次 / 预计 Ns」
         ↓
-tool_call ─ 计数 +1
+tool_call ─ 仅顶层调用计数 +1
         ↓
 turn_end ─ 记录实际次数与耗时 + 解析预计值
         ↓
@@ -163,9 +163,9 @@ Also: log `~/.pi/ptc-meter.jsonl` (1 MiB truncation, tail-preserving); no enviro
 
 ## What it does (source facts)
 
-- `tool_call`: increments a counter (never intercepts or rewrites).
+- `tool_call`: increments the counter for top-level calls only (nested codemode calls are not counted separately; never intercepts or rewrites).
 - `turn_end`: records calls and duration (no disk write).
-- `agent_end`: writes one log line per run.
+- `agent_end`: writes one log line per run.; when goal auto-continuation shares one run, `turn_end` warns once above threshold (once per run) so the loop never goes dark.
 - `before_agent_start`: settles the previous turn and feeds back counts, duration, deviation, the baseline median and the **cache hit rate** (only when that turn reported usage; flagged low below 90%) as a `nextTurn` trailing message (`display: false`).
 
 **Sample injection (illustrative; fields may change between versions)**
@@ -182,7 +182,7 @@ PTC metering: last turn 9 tool calls · 34s actual · 92% cache hit · estimated
 ```text
 before the turn ─ declare: about N calls / Ns
         ↓
-tool_call ─ counter +1
+tool_call ─ top-level call: counter +1
         ↓
 turn_end ─ record actual calls and duration + parse estimate
         ↓

package/index.ts

@@ -66,7 +66,9 @@ function threshold(): number {
 // 轮内计数（反馈回路：随注入回到上下文，见 before_agent_start）
 let callsThisTurn = 0;
 let lastCompletedCalls = -1; // 已完成轮的调用数（agent_end 落盘后置位；before_agent_start 缺席时仍可回灌）
-let injectedThisTurn = false; // 本轮是否已由 before_agent_start 注入（缺席时由 agent_end 补发）
+  let injectedThisTurn = false; // 本轮是否已由 before_agent_start 注入（缺席时由 agent_end 补发）
+  // goal 长跑：agent_end 可能整 run 不触发（续轮不发 user message）→ 超阈值即时补发一次，避免回路整段失效
+  let warnedThisRun = false; // 安全阀是否已在本 run 内提示过
 let lastTurnCalls = -1;
 let lastTurnMs = -1;
 let lastTurnEst: number | null = null;
@@ -268,9 +270,13 @@ export default function ptcMeter(pi: ExtensionAPI) {
     turns = 0;
     turnStartedAt = Date.now();
   });
-  // 计数：不读 event 字段、不返回任何值 —— 这是最安全的形态（该层无 try/catch）。
-  pi.on("tool_call", async () => {
-    try { callsThisTurn++; } catch { /* 静默：计量不该影响调用 */ }
+  // 计数：只计**顶层**调用 —— codemode 的内层 tools.X 也走本 hook（pi 的 _executeNestedToolCall
+  // 显式带 parentToolCallId），计进去会把一次往返记成 N 次（实测 21 次顶层被记成 53）。
+  pi.on("tool_call", async (event) => {
+    try {
+      if ((event as { parentToolCallId?: string } | undefined)?.parentToolCallId) return undefined;
+      callsThisTurn++;
+    } catch { /* 静默：计量不该影响调用 */ }
     return undefined;
   });
 
@@ -295,6 +301,16 @@ export default function ptcMeter(pi: ExtensionAPI) {
         const ec = em ? parseInt(em[1], 10) : 0;
         if (ec > 0 && lastTurnEstCalls === null) lastTurnEstCalls = ec; // 同上：首个声明
       } catch { lastTurnEstCalls = null; }
+      // 安全阀：goal 自动续轮共享同一 run，agent_end 可能迟迟不触发——超阈值即提示一次
+      if (!injectedThisTurn && !warnedThisRun && callsThisTurn >= threshold()) {
+        try {
+          (pi as unknown as { sendMessage?: (m: unknown, o?: unknown) => void }).sendMessage?.(
+            { customType: SECTION_KEY, content: "PTC：本轮已 " + callsThisTurn + " 次（阈值 " + threshold() + "）→ 先合并可并调用，再继续。", display: false },
+            { deliverAs: "nextTurn" },
+          );
+          warnedThisRun = true;
+        } catch { /* 静默 */ }
+      }
     } catch { /* 静默 */ }
   });
 
@@ -314,6 +330,7 @@ export default function ptcMeter(pi: ExtensionAPI) {
       lastCompletedCalls = calls;
       callsThisTurn = 0;
       turnStartedAt = Date.now();
+      warnedThisRun = false;
       // D16：自动续轮下 before_agent_start 可能缺席——本轮未注入过则补发一次尾部回灌，保证反馈不断链（2026-10-17 实证：本轮无任何回灌行）。
       if (!injectedThisTurn && loadConf().inject !== false) {
         lastTurnCalls = calls;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-ptc-meter",
-  "version": "1.0.26",
+  "version": "1.0.28",
   "description": "Measures tool-call batching per turn and feeds the numbers back to the model.",
   "type": "module",
   "license": "MIT",