agent-noti 1.4.0 → 1.4.1

package/README.md

@@ -102,9 +102,11 @@ agent-noti ntfy
 This opens an interactive TUI where you can:
 - Set your ntfy server and topic
 - Toggle which events send push notifications (task complete / approval needed)
-- Set priority level
+- Set priority level and time threshold
 - Send a test notification
 
+The **threshold** setting (in minutes) skips push notifications for quick tasks. For example, set it to `5` and you'll only get pinged if the agent ran for at least 5 minutes. Set to `0` to always notify.
+
 On first run you'll be prompted for a topic name. Subscribe to the same topic in the [ntfy app](https://ntfy.sh) (Android/iOS/web) to receive notifications.
 
 ### Quick test
@@ -123,6 +125,7 @@ Sends a test notification to your configured topic without opening the interacti
 | `ntfy.server` | `https://ntfy.sh` | ntfy server URL |
 | `ntfy.topic` | — | Your topic name (required) |
 | `ntfy.priority` | `default` | `min`, `low`, `default`, `high`, `urgent` |
+| `ntfy.threshold` | `0` | Min minutes before notifying (0 = always) |
 | `ntfy.idle` | `true` | Notify on task complete |
 | `ntfy.input` | `true` | Notify on approval needed |
 
@@ -141,6 +144,7 @@ All settings are stored in `~/.agent-noti/config.json`:
     "server": "https://ntfy.sh",
     "topic": "my-agent-alerts",
     "priority": "default",
+    "threshold": 5,
     "idle": true,
     "input": true
   }

package/bin/cli.mjs

@@ -9,6 +9,7 @@ import { homedir, platform } from "os";
 
 const __dirname = dirname(fileURLToPath(import.meta.url));
 const PLAY_SCRIPT = join(__dirname, "play.mjs");
+const STAMP_SCRIPT = join(__dirname, "stamp.mjs");
 const CODEX_NOTIFY_SCRIPT = join(__dirname, "codex-notify.mjs");
 const SOUNDS_DIR = join(__dirname, "..", "sounds");
 
@@ -98,9 +99,11 @@ function writeConfig(config) {
 function buildClaudeHooks() {
   const idle = { type: "command", command: `node "${PLAY_SCRIPT}" idle` };
   const input = { type: "command", command: `node "${PLAY_SCRIPT}" input` };
+  const stamp = { type: "command", command: `node "${STAMP_SCRIPT}"` };
   return {
     Stop: [{ hooks: [idle], metadata: { id: HOOK_ID } }],
     PermissionRequest: [{ hooks: [input], metadata: { id: HOOK_ID } }],
+    PromptSubmit: [{ hooks: [stamp], metadata: { id: HOOK_ID } }],
   };
 }
 
@@ -631,6 +634,7 @@ function ntfy() {
         server: setup.server,
         topic: setup.topic,
         priority: "default",
+        threshold: 0,
         idle: true,
         input: true,
       };
@@ -641,17 +645,21 @@ function ntfy() {
     const rows = ["idle", "input"];
     let selected = 0;
     let statusMsg = "";
-    const totalLines = 12;
+    const totalLines = 13;
 
     function render(firstTime) {
       if (!firstTime) process.stdout.write(`\x1b[${totalLines}A`);
 
+      const thresh = ntfyConf.threshold ?? 0;
+      const threshLabel = thresh === 0 ? "off (always notify)" : `${thresh} min`;
+
       process.stdout.write("\x1b[2K\n");
       process.stdout.write(`\x1b[2K  \x1b[1mntfy.sh push notifications\x1b[0m\n`);
       process.stdout.write("\x1b[2K\n");
-      process.stdout.write(`\x1b[2K  Server:   \x1b[36m${ntfyConf.server || "https://ntfy.sh"}\x1b[0m\n`);
-      process.stdout.write(`\x1b[2K  Topic:    \x1b[36m${ntfyConf.topic}\x1b[0m\n`);
-      process.stdout.write(`\x1b[2K  Priority: \x1b[36m${ntfyConf.priority || "default"}\x1b[0m\n`);
+      process.stdout.write(`\x1b[2K  Server:    \x1b[36m${ntfyConf.server || "https://ntfy.sh"}\x1b[0m\n`);
+      process.stdout.write(`\x1b[2K  Topic:     \x1b[36m${ntfyConf.topic}\x1b[0m\n`);
+      process.stdout.write(`\x1b[2K  Priority:  \x1b[36m${ntfyConf.priority || "default"}\x1b[0m\n`);
+      process.stdout.write(`\x1b[2K  Threshold: \x1b[36m${threshLabel}\x1b[0m\n`);
       process.stdout.write("\x1b[2K\n");
 
       for (let i = 0; i < rows.length; i++) {
@@ -701,6 +709,13 @@ function ntfy() {
       const newPri = await ntfyPrompt(`Priority [${NTFY_PRIORITIES.join("/")}] (${NTFY_PRIORITIES[priIdx]}): `);
       if (newPri && NTFY_PRIORITIES.includes(newPri)) ntfyConf.priority = newPri;
 
+      const curThresh = ntfyConf.threshold ?? 0;
+      const newThresh = await ntfyPrompt(`Threshold in minutes, 0=off (${curThresh}): `);
+      if (newThresh !== "") {
+        const val = parseInt(newThresh, 10);
+        if (!isNaN(val) && val >= 0) ntfyConf.threshold = val;
+      }
+
       // Re-enter raw mode and re-render
       stdin.setRawMode(true);
       stdin.resume();

package/bin/play.mjs

@@ -13,11 +13,14 @@ import { execFile, exec } from "child_process";
 import { join, dirname } from "path";
 import { fileURLToPath } from "url";
 import { platform, homedir } from "os";
-import { existsSync, readFileSync } from "fs";
+import { existsSync, readFileSync, writeFileSync, mkdirSync } from "fs";
 
 const __dirname = dirname(fileURLToPath(import.meta.url));
 const SOUNDS_DIR = join(__dirname, "..", "sounds");
-const CONFIG_PATH = join(homedir(), ".agent-noti", "config.json");
+const CONFIG_DIR = join(homedir(), ".agent-noti");
+const CONFIG_PATH = join(CONFIG_DIR, "config.json");
+const LAST_PROMPT_PATH = join(CONFIG_DIR, "last-prompt");
+const LAST_EVENT_PATH = join(CONFIG_DIR, "last-event");
 
 const EVENTS = ["idle", "input"];
 
@@ -107,7 +110,33 @@ async function sendNtfy(event, config) {
 
   // Send ntfy push notification for actual events (not --file previews)
   if (EVENTS.includes(arg)) {
-    await sendNtfy(arg, config);
+    const threshold = config.ntfy?.threshold ?? 0; // minutes, 0 = always
+    let shouldSend = true;
+
+    if (threshold > 0) {
+      // Claude Code: PromptSubmit hook writes last-prompt (exact task start)
+      // Codex fallback: use last-event (time since previous event)
+      const tsFile = existsSync(LAST_PROMPT_PATH) ? LAST_PROMPT_PATH : LAST_EVENT_PATH;
+      try {
+        if (existsSync(tsFile)) {
+          const started = parseInt(readFileSync(tsFile, "utf-8"), 10);
+          if (!isNaN(started)) {
+            const elapsed = (Date.now() - started) / 60000;
+            shouldSend = elapsed >= threshold;
+          }
+        }
+      } catch {}
+    }
+
+    if (shouldSend) {
+      await sendNtfy(arg, config);
+    }
+
+    // Write last-event timestamp (Codex fallback for threshold)
+    try {
+      mkdirSync(CONFIG_DIR, { recursive: true });
+      writeFileSync(LAST_EVENT_PATH, String(Date.now()));
+    } catch {}
   }
 
   // Mute check (skip for --file, which is used by picker previews)

package/bin/stamp.mjs

@@ -0,0 +1,13 @@
+#!/usr/bin/env node
+/**
+ * Records the current timestamp to ~/.agent-noti/last-prompt.
+ * Called by the PromptSubmit hook so play.mjs can measure task duration.
+ */
+
+import { writeFileSync, mkdirSync } from "fs";
+import { join } from "path";
+import { homedir } from "os";
+
+const dir = join(homedir(), ".agent-noti");
+mkdirSync(dir, { recursive: true });
+writeFileSync(join(dir, "last-prompt"), String(Date.now()));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agent-noti",
-  "version": "1.4.0",
+  "version": "1.4.1",
   "description": "Audio notifications for Claude Code & Codex — customizable sound themes",
   "bin": {
     "agent-noti": "./bin/cli.mjs"