@hk_net/pi-timestamp 0.1.9 → 0.1.10

package/CHANGELOG.md

@@ -0,0 +1,10 @@
+# Changelog
+
+## 0.1.10 - 2026-08-23
+
+### Changed
+
+- Mark Pi's host-provided SDK packages as optional wildcard peers so npm does not install a redundant Pi SDK dependency tree.
+- Verify development and tests against Pi SDK 0.84.2 while retaining runtime compatibility with Pi 0.84.1 and newer.
+- Measure completion through `agent_settled` so automatic retries, compaction recovery, and queued continuations produce one complete task duration.
+- Document that the individual package and GitHub bundle must not be installed together.

package/README.md

@@ -1,6 +1,6 @@
 # pi-timestamp
 
-Shows timestamps for user input and agent completion timing. Requires pi `>=0.84.1`.
+Shows timestamps for user input and agent completion timing. Requires Pi 0.84.1 or newer (tested with the current Pi 0.84.2 release).
 
 ## What it does
 
@@ -16,6 +16,8 @@ Timestamps appear inline in the **chat display**, similar to Pi's built-in tool
 
 ## Installation
 
+> **Avoid duplicate installation.** Install this npm package or the GitHub bundle, not both. Loading both copies can duplicate timestamps and runtime summaries.
+
 ```bash
 pi install npm:@hk_net/pi-timestamp
 ```
@@ -29,7 +31,7 @@ cp packages/pi-timestamp/timestamp.ts ~/.pi/agent/extensions/timestamp.ts
 
 ## Duration measurement
 
-Captured from `agent_start` (when the model starts processing) to `agent_end` (when all tool calls and model processing are done).
+Captured from the first `agent_start` to `agent_settled`, so automatic retries, compaction recovery, tool calls, and queued continuations are included in one complete task duration.
 
 ## Issues and feedback
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hk_net/pi-timestamp",
-  "version": "0.1.9",
+  "version": "0.1.10",
   "description": "Pi extension that shows timestamps for user input and agent completion timing",
   "type": "module",
   "private": false,
@@ -23,11 +23,23 @@
   "homepage": "https://github.com/hknet/pi-extensions/tree/main/packages/pi-timestamp#readme",
   "files": [
     "timestamp.ts",
-    "README.md"
+    "README.md",
+    "CHANGELOG.md"
   ],
+  "engines": {
+    "node": ">=22.19.0"
+  },
   "peerDependencies": {
-    "@earendil-works/pi-coding-agent": ">=0.84.1",
-    "@earendil-works/pi-tui": ">=0.84.1"
+    "@earendil-works/pi-coding-agent": "*",
+    "@earendil-works/pi-tui": "*"
+  },
+  "peerDependenciesMeta": {
+    "@earendil-works/pi-coding-agent": {
+      "optional": true
+    },
+    "@earendil-works/pi-tui": {
+      "optional": true
+    }
   },
   "pi": {
     "extensions": [

package/timestamp.ts

@@ -128,23 +128,17 @@ export function formatRuntimeDuration(ms: number): string {
     return parts.filter((part): part is string => part !== undefined).join(" ");
 }
 
-function isTimeoutErrorMessage(message: string | undefined): boolean {
-    return /timed? out|timeout/i.test(message ?? "");
-}
-
 export default function (pi: ExtensionAPI) {
     let taskStartTime: number | undefined;
-    let waitingForRetryAfterTimeout = false;
 
     function notifyAccent(ctx: ExtensionContext, message: string): void {
         ctx.ui.notify(ctx.ui.theme.fg("accent", message), "info");
     }
 
-    // Track when the agent starts processing. If Pi is auto-retrying after a timeout,
-    // keep the original start time so the eventual completion covers the full task.
+    // Track the complete run. Automatic retries and compaction recovery can emit
+    // additional agent_start events before agent_settled, so retain the first start.
     pi.on("agent_start", async () => {
-        if (waitingForRetryAfterTimeout) return;
-        taskStartTime = Date.now();
+        taskStartTime ??= Date.now();
     });
 
     // Show "Sent HH:MM:SS" after each user message.
@@ -153,33 +147,17 @@ export default function (pi: ExtensionAPI) {
     pi.on("message_end", async (event, ctx) => {
         if (event.message.role !== "user") return;
 
-        if (waitingForRetryAfterTimeout) {
-            taskStartTime = undefined;
-            waitingForRetryAfterTimeout = false;
-        }
-
         const ts = event.message.timestamp;
         if (!ts) return;
 
         ctx.ui.notify(`Sent ${formatTime(ts)}`, "info");
     });
 
-    // Show completion timing after the whole task finishes. If Pi ended this agent loop
-    // with a timeout error and will likely auto-retry, wait for the later completion.
-    pi.on("agent_end", async (event, ctx) => {
-        const lastAssistantMessage = [...event.messages].reverse().find((message) => message.role === "assistant");
-        if (
-            lastAssistantMessage?.role === "assistant" &&
-            lastAssistantMessage.stopReason === "error" &&
-            isTimeoutErrorMessage(lastAssistantMessage.errorMessage)
-        ) {
-            waitingForRetryAfterTimeout = true;
-            return;
-        }
-
+    // Show completion timing only after retries, compaction recovery, and queued
+    // continuations have fully settled.
+    pi.on("agent_settled", async (_event, ctx) => {
         const startTime = taskStartTime;
         taskStartTime = undefined;
-        waitingForRetryAfterTimeout = false;
 
         if (startTime === undefined) return;