pi-conversation-timer 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Pi Community Contributor
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,51 @@
+# pi-conversation-timer
+
+> Active task timer and statusline extension for [Pi Coding Agent](https://pi.dev).
+
+`pi-conversation-timer` tracks pure active task execution time across prompt submission to full settlement (`agent_settled`), keeping time static when idle.
+
+## ✨ Features
+
+- **Zero-drift active tracking**: Only counts active work duration while Pi is processing, calling tools, and generating responses. Time stays completely static when waiting for user input.
+- **Whole-task lifecycle accounting**: Accurately tracks the entire duration from prompt submission (`before_agent_start`) to final completion (`agent_settled`), across multiple tool turns and iterations.
+- **Clean integer seconds**: Output format strictly uses integer seconds (e.g. `12s`, `45s`, `1m 20s`, `1h 05m`), avoiding confusing decimals.
+- **Theme-aware statusline**: Native TUI integration using `ctx.ui.setStatus` with current theme coloring.
+- **Detailed statistics command**: `/chat-time` displays complete session metrics including total active time, task counts, and average duration per task.
+
+## 📦 Install
+
+```bash
+pi install npm:pi-conversation-timer
+```
+
+Or install from git:
+
+```bash
+pi install git:github.com/Agonieler/pi-conversation-timer
+```
+
+Restart Pi or run `/reload` after installation.
+
+## 🚀 Usage
+
+Once loaded, the timer appears automatically in the bottom statusline:
+
+- **Idle state**:
+  ```text
+  ⏱ 累计 45s · 上轮 12s
+  ```
+- **Working state**:
+  ```text
+  ⏱ 累计 52s · 工作中 7s
+  ```
+
+### Commands
+
+| Command | Description |
+| --- | --- |
+| `/chat-time` | View detailed active time breakdown and task statistics in a popup |
+| `/dialogue-time` | Alias for `/chat-time` |
+
+## 📄 License
+
+MIT

package/index.ts

@@ -0,0 +1,223 @@
+import type { ExtensionAPI, ExtensionContext } from "@earendil-works/pi-coding-agent";
+
+/**
+ * 格式化毫秒数为人类易读的时间字符串（秒数纯整数，不带小数）
+ * @param ms 毫秒数
+ */
+function formatDuration(ms: number): string {
+  if (ms <= 0) return "0s";
+  const totalSeconds = Math.round(ms / 1000);
+  if (totalSeconds < 60) {
+    return `${totalSeconds}s`;
+  }
+  const sec = totalSeconds % 60;
+  const totalMinutes = Math.floor(totalSeconds / 60);
+  if (totalMinutes < 60) {
+    return `${totalMinutes}m ${sec}s`;
+  }
+  const min = totalMinutes % 60;
+  const hours = Math.floor(totalMinutes / 60);
+  return `${hours}h ${min}m`;
+}
+
+export default function (pi: ExtensionAPI) {
+  let timerHandle: NodeJS.Timeout | null = null;
+  let totalActiveTimeMs = 0; // 累计工作耗时（所有任务从发出到完成的纯工作总耗时）
+  let currentTaskStartTime: number | null = null; // 当前任务启动时间戳（发出任务开始）
+  let lastTaskDuration: number | null = null; // 上轮任务完整耗时（从发出到工作结束）
+  let taskCount = 0; // 任务计数
+  let activeContext: ExtensionContext | null = null;
+
+  /**
+   * 生成状态栏文本
+   */
+  function getStatusText(ctx: ExtensionContext): string {
+    const theme = ctx.ui.theme;
+    const icon = theme ? theme.fg("accent", "⏱") : "⏱";
+
+    // 1. 任务正在进行中（从用户发出任务一直到工作结束）
+    if (currentTaskStartTime !== null) {
+      const taskElapsed = Math.max(0, Date.now() - currentTaskStartTime);
+      const currentTotal = totalActiveTimeMs + taskElapsed;
+      const totalText = theme ? theme.fg("text", ` 累计 ${formatDuration(currentTotal)}`) : ` 累计 ${formatDuration(currentTotal)}`;
+      const taskInfo = theme ? theme.fg("accent", ` · 工作中 ${formatDuration(taskElapsed)}`) : ` · 工作中 ${formatDuration(taskElapsed)}`;
+      return `${icon}${totalText}${taskInfo}`;
+    }
+
+    // 2. 空闲等待状态（没有活跃任务，时间静止不涨秒）
+    if (taskCount === 0 && totalActiveTimeMs === 0) {
+      const readyText = theme ? theme.fg("dim", " 就绪") : " 就绪";
+      return `${icon}${readyText}`;
+    }
+
+    const totalText = theme ? theme.fg("text", ` 累计 ${formatDuration(totalActiveTimeMs)}`) : ` 累计 ${formatDuration(totalActiveTimeMs)}`;
+    let lastTaskInfo = "";
+    if (lastTaskDuration !== null) {
+      lastTaskInfo = theme ? theme.fg("dim", ` · 上轮 ${formatDuration(lastTaskDuration)}`) : ` · 上轮 ${formatDuration(lastTaskDuration)}`;
+    }
+
+    return `${icon}${totalText}${lastTaskInfo}`;
+  }
+
+  /**
+   * 刷新状态栏显示
+   */
+  function updateStatus(ctx: ExtensionContext) {
+    if (!ctx.hasUI) return;
+    try {
+      const text = getStatusText(ctx);
+      ctx.ui.setStatus("conversation-timer", text);
+    } catch {
+      // 忽略折叠或界面刷新偶发异常
+    }
+  }
+
+  /**
+   * 停止走表定时器
+   */
+  function stopActiveTimer() {
+    if (timerHandle) {
+      clearInterval(timerHandle);
+      timerHandle = null;
+    }
+  }
+
+  /**
+   * 启动任务执行期间的走表定时器（每 500ms 刷新一次界面，展示整数秒变化）
+   */
+  function startActiveTimer(ctx: ExtensionContext) {
+    stopActiveTimer();
+    timerHandle = setInterval(() => {
+      if (activeContext) {
+        updateStatus(activeContext);
+      }
+    }, 500);
+  }
+
+  /**
+   * 当用户发出任务，AI 开始介入工作时调用
+   */
+  function handleTaskStart(ctx: ExtensionContext) {
+    activeContext = ctx;
+    if (currentTaskStartTime === null) {
+      currentTaskStartTime = Date.now();
+      taskCount++;
+      updateStatus(ctx);
+      startActiveTimer(ctx);
+    }
+  }
+
+  /**
+   * 当整个任务的所有轮次、工具调用、重试全部彻底完成时调用
+   */
+  function handleTaskSettled(ctx: ExtensionContext) {
+    activeContext = ctx;
+    stopActiveTimer();
+
+    if (currentTaskStartTime !== null) {
+      const duration = Date.now() - currentTaskStartTime;
+      totalActiveTimeMs += duration;
+      lastTaskDuration = duration;
+      currentTaskStartTime = null;
+    }
+
+    // 刷新为静止状态，等待下一次任务发出
+    updateStatus(ctx);
+  }
+
+  // 会话启动或恢复
+  pi.on("session_start", async (_event, ctx) => {
+    activeContext = ctx;
+    stopActiveTimer();
+    totalActiveTimeMs = 0;
+    taskCount = 0;
+    lastTaskDuration = null;
+    currentTaskStartTime = null;
+
+    // 尝试从历史消息中恢复交互耗时
+    try {
+      const entries = ctx.sessionManager?.getEntries?.() ?? [];
+      let lastUserTs: number | null = null;
+      for (const entry of entries) {
+        if ((entry as any).type === "message") {
+          const msg = (entry as any).message;
+          if (msg?.role === "user" && typeof msg.timestamp === "number") {
+            lastUserTs = msg.timestamp;
+          } else if (msg?.role === "assistant" && typeof msg.timestamp === "number" && lastUserTs !== null) {
+            const duration = Math.max(0, msg.timestamp - lastUserTs);
+            totalActiveTimeMs += duration;
+            lastTaskDuration = duration;
+            taskCount++;
+            lastUserTs = null;
+          }
+        }
+      }
+    } catch {
+      // 默认从 0 开始
+    }
+
+    updateStatus(ctx);
+  });
+
+  // 用户发出提示词/任务提交
+  pi.on("before_agent_start", async (_event, ctx) => {
+    handleTaskStart(ctx);
+  });
+
+  // 代理工作循环启动
+  pi.on("agent_start", async (_event, ctx) => {
+    handleTaskStart(ctx);
+  });
+
+  // 任务彻底结束（包括所有中间步骤、工具执行与重试）
+  pi.on("agent_settled", async (_event, ctx) => {
+    handleTaskSettled(ctx);
+  });
+
+  // 会话关闭或重置
+  pi.on("session_shutdown", async (_event, ctx) => {
+    stopActiveTimer();
+    if (ctx && ctx.hasUI) {
+      try {
+        ctx.ui.setStatus("conversation-timer", undefined);
+      } catch {
+        // ignore
+      }
+    }
+    activeContext = null;
+    currentTaskStartTime = null;
+  });
+
+  // 注册详细耗时查询命令
+  const showTimeHandler = async (_args: string, ctx: ExtensionContext) => {
+    const lines = [
+      `⏱ 对话任务纯工作耗时统计:`,
+      `• 累计工作时长: ${formatDuration(totalActiveTimeMs)}`,
+      `• 任务总次数: ${taskCount} 次`,
+    ];
+
+    if (taskCount > 0) {
+      const avg = Math.round(totalActiveTimeMs / taskCount);
+      lines.push(`• 平均每轮耗时: ${formatDuration(avg)}`);
+    }
+
+    if (currentTaskStartTime !== null) {
+      const currentElapsed = Math.max(0, Date.now() - currentTaskStartTime);
+      lines.push(`• 当前任务状态: 正在工作中 (${formatDuration(currentElapsed)})`);
+    } else if (lastTaskDuration !== null) {
+      lines.push(`• 上轮任务耗时: ${formatDuration(lastTaskDuration)} (从发出任务到工作全部结束)`);
+    }
+
+    ctx.ui.notify(lines.join("\n"), "info");
+  };
+
+  pi.registerCommand("chat-time", {
+    description: "显示发出任务到工作结束的纯工作耗时统计",
+    handler: showTimeHandler,
+  });
+
+  pi.registerCommand("dialogue-time", {
+    description: "显示发出任务到工作结束的纯工作耗时统计 (别名)",
+    handler: showTimeHandler,
+  });
+}

package/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "pi-conversation-timer",
+  "version": "1.0.0",
+  "description": "Active task timer extension for Pi coding agent",
+  "author": "Agonieler",
+  "license": "MIT",
+  "type": "module",
+  "main": "./index.ts",
+  "files": [
+    "index.ts",
+    "README.md",
+    "LICENSE"
+  ],
+  "keywords": [
+    "pi-package",
+    "pi-extension",
+    "pi",
+    "timer",
+    "statusline"
+  ],
+  "pi": {
+    "extensions": [
+      "./index.ts"
+    ]
+  },
+  "peerDependencies": {
+    "@earendil-works/pi-coding-agent": ">=0.80.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Agonieler/pi-conversation-timer.git"
+  },
+  "homepage": "https://github.com/Agonieler/pi-conversation-timer#readme",
+  "bugs": {
+    "url": "https://github.com/Agonieler/pi-conversation-timer/issues"
+  }
+}