claude-notification-plugin 1.0.13 → 1.0.15

package/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2025 Michael Makarov
-
-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.
+MIT License
+
+Copyright (c) 2025 Michael Makarov
+
+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

@@ -1,116 +1,121 @@
-# claude-notification-plugin
-
-Notifications for Claude Code task completion. Sends alerts to Telegram and Windows when Claude finishes working.
-
-## Features
-
-- Windows desktop notifications (toast)
-- Telegram bot messages
-- Sound alert
-- Voice announcement (TTS)
-- Skips short tasks (< 15s by default)
-- Granular per-channel enable/disable (globally and per-project)
-
-## Install
-
-```bash
-npm install -g claude-notification-plugin
-claude-notify-install
-```
-
-The installer will:
-1. Ask for Telegram bot credentials (optional)
-2. Create config at `~/.claude/notifier.config.json`
-3. Register hooks in `~/.claude/settings.json`
-
-## Configuration
-
-Config file: `~/.claude/notifier.config.json`
-
-```json
-{
-  "telegram": {
-    "enabled": true,
-    "token": "YOUR_BOT_TOKEN",
-    "chatId": "YOUR_CHAT_ID",
-    "deleteAfterHours": 24
-  },
-  "windowsNotification": {
-    "enabled": true
-  },
-  "sound": {
-    "enabled": true,
-    "file": "C:/Windows/Media/notify.wav"
-  },
-  "voice": {
-    "enabled": true
-  },
-  "minSeconds": 15
-}
-```
-
-Each channel has an `enabled` flag (`true`/`false`) for global control.
-
-`deleteAfterHours` — auto-delete old Telegram messages after the specified number of hours (default: `24`, set `0` to disable).
-
-Environment variables `TELEGRAM_TOKEN` and `TELEGRAM_CHAT_ID` override config file values.
-
-### Per-channel environment variables
-
-These env vars override the global config per channel (`"1"` = on, `"0"` = off):
-
-| Variable                 | Channel                    |
-|--------------------------|----------------------------|
-| `CLAUDE_NOTIFY_TELEGRAM` | Telegram messages          |
-| `CLAUDE_NOTIFY_WINDOWS`  | Windows toast notifications|
-| `CLAUDE_NOTIFY_SOUND`    | Sound alert                |
-| `CLAUDE_NOTIFY_VOICE`    | Voice announcement (TTS)   |
-
-### Per-project configuration
-
-Add to `.claude/settings.local.json` in the project root to control channels per project:
-
-```json
-{
-  "env": {
-    "DISABLE_CLAUDE_NOTIFIER": 0,
-    "CLAUDE_NOTIFY_TELEGRAM": 1,
-    "CLAUDE_NOTIFY_WINDOWS": 1,
-    "CLAUDE_NOTIFY_SOUND": 1,
-    "CLAUDE_NOTIFY_VOICE": 1
-  }
-}
-```
-
-To disable all notifications for a project:
-
-```json
-{
-  "env": {
-    "DISABLE_CLAUDE_NOTIFIER": "1"
-  }
-}
-```
-
-## Telegram Setup
-
-1. Open Telegram, find **@BotFather**
-2. Send `/newbot`, follow prompts, pick a name
-3. Copy the bot token (format: `123456789:ABCdef...`)
-4. **Send any message to your new bot**
-5. Open `https://api.telegram.org/bot<YOUR_TOKEN>/getUpdates`
-6. Find `"chat":{"id":123456789}` in the response — that's your Chat ID
-7. Run `claude-notify-install` and enter the token and chat ID
-
-Alternative for Chat ID: add **@userinfobot** to a chat and it will reply with the ID.
-
-## Uninstall
-
-```bash
-claude-notify-uninstall
-npm uninstall -g claude-notification-plugin
-```
-
-## License
-
-MIT
+# claude-notification-plugin
+
+Notifications for Claude Code task completion. Sends alerts to Telegram and Windows when Claude finishes working.
+
+## Features
+
+- Windows desktop notifications (toast)
+- Telegram bot messages
+- Sound alert
+- Voice announcement (TTS)
+- Separate notifications for task completion and waiting-for-input events
+- Skips short tasks (< 15s by default)
+- Granular per-channel enable/disable (globally and per-project)
+
+## Install
+
+```bash
+npm install -g claude-notification-plugin
+claude-notify-install
+```
+
+The installer will:
+1. Ask for Telegram bot credentials (optional)
+2. Create config at `~/.claude/notifier.config.json`
+3. Register hooks in `~/.claude/settings.json`
+
+## Configuration
+
+Config file: `~/.claude/notifier.config.json`
+
+```json
+{
+  "telegram": {
+    "enabled": true,
+    "token": "YOUR_BOT_TOKEN",
+    "chatId": "YOUR_CHAT_ID",
+    "deleteAfterHours": 24
+  },
+  "windowsNotification": {
+    "enabled": true
+  },
+  "sound": {
+    "enabled": true,
+    "file": "C:/Windows/Media/notify.wav"
+  },
+  "voice": {
+    "enabled": true
+  },
+  "minSeconds": 15,
+  "notifyOnWaiting": true
+}
+```
+
+Each channel has an `enabled` flag (`true`/`false`) for global control.
+
+`deleteAfterHours` — auto-delete old Telegram messages after the specified number of hours (default: `24`, set `0` to disable).
+
+`notifyOnWaiting` — send notifications when Claude is waiting for user input, e.g. permission prompts (default: `true`, set `false` to disable).
+
+Environment variables `TELEGRAM_TOKEN` and `TELEGRAM_CHAT_ID` override config file values.
+
+### Per-channel environment variables
+
+These env vars override the global config per channel (`"1"` = on, `"0"` = off):
+
+| Variable                 | Channel                    |
+|--------------------------|----------------------------|
+| `CLAUDE_NOTIFY_TELEGRAM` | Telegram messages          |
+| `CLAUDE_NOTIFY_WINDOWS`  | Windows toast notifications|
+| `CLAUDE_NOTIFY_SOUND`    | Sound alert                |
+| `CLAUDE_NOTIFY_VOICE`    | Voice announcement (TTS)   |
+| `CLAUDE_NOTIFY_WAITING`  | Waiting-for-input events   |
+
+### Per-project configuration
+
+Add to `.claude/settings.local.json` in the project root to control channels per project:
+
+```json
+{
+  "env": {
+    "DISABLE_CLAUDE_NOTIFIER": 0,
+    "CLAUDE_NOTIFY_TELEGRAM": 1,
+    "CLAUDE_NOTIFY_WINDOWS": 1,
+    "CLAUDE_NOTIFY_SOUND": 1,
+    "CLAUDE_NOTIFY_VOICE": 1
+  }
+}
+```
+
+To disable all notifications for a project:
+
+```json
+{
+  "env": {
+    "DISABLE_CLAUDE_NOTIFIER": "1"
+  }
+}
+```
+
+## Telegram Setup
+
+1. Open Telegram, find **@BotFather**
+2. Send `/newbot`, follow prompts, pick a name
+3. Copy the bot token (format: `123456789:ABCdef...`)
+4. **Send any message to your new bot**
+5. Open `https://api.telegram.org/bot<YOUR_TOKEN>/getUpdates`
+6. Find `"chat":{"id":123456789}` in the response — that's your Chat ID
+7. Run `claude-notify-install` and enter the token and chat ID
+
+Alternative for Chat ID: add **@userinfobot** to a chat and it will reply with the ID.
+
+## Uninstall
+
+```bash
+claude-notify-uninstall
+npm uninstall -g claude-notification-plugin
+```
+
+## License
+
+MIT

package/bin/install.js

@@ -1,178 +1,178 @@
-#!/usr/bin/env node
-
-import fs from 'fs';
-import os from 'os';
-import path from 'path';
-import readline from 'readline';
-
-const home = os.homedir();
-const claudeDir = path.join(home, '.claude');
-const configPath = path.join(claudeDir, 'notifier.config.json');
-const settingsPath = path.join(claudeDir, 'settings.json');
-
-const HOOK_COMMAND = 'claude-notifier';
-
-// ----------------------
-// HELPERS
-// ----------------------
-
-function ask (rl, question) {
-  return new Promise((resolve) => {
-    rl.question(question, (answer) => resolve(answer.trim()));
-  });
-}
-
-async function fetchChatId (token) {
-  const url = `https://api.telegram.org/bot${token}/getUpdates`;
-
-  try {
-    const res = await fetch(url);
-    const data = await res.json();
-
-    if (!data.ok || !data.result?.length) {
-      return null;
-    }
-
-    const msg = data.result[data.result.length - 1].message;
-    if (msg?.chat?.id) {
-      return String(msg.chat.id);
-    }
-  } catch {
-    // silent fail
-  }
-
-  return null;
-}
-
-function addHook (settings, event) {
-  if (!settings.hooks[event]) {
-    settings.hooks[event] = [];
-  }
-
-  const exists = settings.hooks[event].some((matcher) =>
-    matcher.hooks?.some((h) => h.command?.includes(HOOK_COMMAND)),
-  );
-
-  if (!exists) {
-    settings.hooks[event].push({
-      hooks: [
-        {
-          type: 'command',
-          command: HOOK_COMMAND,
-        },
-      ],
-    });
-  }
-}
-
-// ----------------------
-// MAIN
-// ----------------------
-
-async function main () {
-  const rl = readline.createInterface({
-    input: process.stdin,
-    output: process.stdout,
-  });
-
-  console.log('');
-  console.log('Claude Notification Plugin - Setup');
-  console.log('==================================');
-  console.log('');
-
-  // Telegram setup
-  let token = '';
-  let chatId = '';
-
-  const useTelegram = await ask(rl, 'Configure Telegram? (y/N): ');
-
-  if (useTelegram.toLowerCase() === 'y') {
-    token = await ask(rl, 'Bot Token: ');
-
-    if (token) {
-      console.log('');
-      console.log('Send any message to your bot in Telegram, then press Enter.');
-      await ask(rl, '');
-
-      console.log('Fetching Chat ID...');
-      chatId = await fetchChatId(token);
-
-      if (chatId) {
-        console.log('Chat ID detected: ' + chatId);
-      } else {
-        console.log('Could not detect Chat ID automatically.');
-        chatId = await ask(rl, 'Enter Chat ID manually: ');
-      }
-    }
-  }
-
-  rl.close();
-
-  // Create config
-  fs.mkdirSync(claudeDir, { recursive: true });
-
-  const config = {
-    telegram: {
-      enabled: true,
-      token,
-      chatId,
-      deleteAfterHours: 24,
-    },
-    windowsNotification: {
-      enabled: true,
-    },
-    sound: {
-      enabled: true,
-      file: 'C:/Windows/Media/notify.wav',
-    },
-    voice: {
-      enabled: true,
-    },
-    minSeconds: 15,
-  };
-
-  fs.writeFileSync(configPath, JSON.stringify(config, null, 2));
-
-  // Patch settings.json
-  let settings = {};
-
-  if (fs.existsSync(settingsPath)) {
-    try {
-      settings = JSON.parse(fs.readFileSync(settingsPath, 'utf-8'));
-    } catch {
-      settings = {};
-    }
-  }
-
-  settings.hooks = settings.hooks || {};
-
-  addHook(settings, 'UserPromptSubmit');
-  addHook(settings, 'Stop');
-  addHook(settings, 'Notification');
-
-  fs.writeFileSync(settingsPath, JSON.stringify(settings, null, 2));
-
-  // Output
-  console.log('');
-  console.log('Installed!');
-  console.log('');
-  console.log('Hooks registered:');
-  console.log('  - UserPromptSubmit (start timer)');
-  console.log('  - Stop (task finished)');
-  console.log('  - Notification (waiting for input)');
-  console.log('');
-  console.log('Config: ' + configPath);
-
-  if (token) {
-    console.log('Telegram: configured');
-  } else {
-    console.log('Telegram: skipped (edit config later)');
-  }
-
-  console.log('');
-  console.log('To disable per project, add to .claude/settings.local.json:');
-  console.log('  { "env": { "DISABLE_CLAUDE_NOTIFIER": "1" } }');
-  console.log('');
-}
-
-main().then(() => 0);
+#!/usr/bin/env node
+
+import fs from 'fs';
+import os from 'os';
+import path from 'path';
+import readline from 'readline';
+
+const home = os.homedir();
+const claudeDir = path.join(home, '.claude');
+const configPath = path.join(claudeDir, 'notifier.config.json');
+const settingsPath = path.join(claudeDir, 'settings.json');
+
+const HOOK_COMMAND = 'claude-notifier';
+
+// ----------------------
+// HELPERS
+// ----------------------
+
+function ask (rl, question) {
+  return new Promise((resolve) => {
+    rl.question(question, (answer) => resolve(answer.trim()));
+  });
+}
+
+async function fetchChatId (token) {
+  const url = `https://api.telegram.org/bot${token}/getUpdates`;
+
+  try {
+    const res = await fetch(url);
+    const data = await res.json();
+
+    if (!data.ok || !data.result?.length) {
+      return null;
+    }
+
+    const msg = data.result[data.result.length - 1].message;
+    if (msg?.chat?.id) {
+      return String(msg.chat.id);
+    }
+  } catch {
+    // silent fail
+  }
+
+  return null;
+}
+
+function addHook (settings, event) {
+  if (!settings.hooks[event]) {
+    settings.hooks[event] = [];
+  }
+
+  const exists = settings.hooks[event].some((matcher) =>
+    matcher.hooks?.some((h) => h.command?.includes(HOOK_COMMAND)),
+  );
+
+  if (!exists) {
+    settings.hooks[event].push({
+      hooks: [
+        {
+          type: 'command',
+          command: HOOK_COMMAND,
+        },
+      ],
+    });
+  }
+}
+
+// ----------------------
+// MAIN
+// ----------------------
+
+async function main () {
+  const rl = readline.createInterface({
+    input: process.stdin,
+    output: process.stdout,
+  });
+
+  console.log('');
+  console.log('Claude Notification Plugin - Setup');
+  console.log('==================================');
+  console.log('');
+
+  // Telegram setup
+  let token = '';
+  let chatId = '';
+
+  const useTelegram = await ask(rl, 'Configure Telegram? (y/N): ');
+
+  if (useTelegram.toLowerCase() === 'y') {
+    token = await ask(rl, 'Bot Token: ');
+
+    if (token) {
+      console.log('');
+      console.log('Send any message to your bot in Telegram, then press Enter.');
+      await ask(rl, '');
+
+      console.log('Fetching Chat ID...');
+      chatId = await fetchChatId(token);
+
+      if (chatId) {
+        console.log('Chat ID detected: ' + chatId);
+      } else {
+        console.log('Could not detect Chat ID automatically.');
+        chatId = await ask(rl, 'Enter Chat ID manually: ');
+      }
+    }
+  }
+
+  rl.close();
+
+  // Create config
+  fs.mkdirSync(claudeDir, { recursive: true });
+
+  const config = {
+    telegram: {
+      enabled: true,
+      token,
+      chatId,
+      deleteAfterHours: 24,
+    },
+    windowsNotification: {
+      enabled: true,
+    },
+    sound: {
+      enabled: true,
+      file: 'C:/Windows/Media/notify.wav',
+    },
+    voice: {
+      enabled: true,
+    },
+    minSeconds: 15,
+  };
+
+  fs.writeFileSync(configPath, JSON.stringify(config, null, 2));
+
+  // Patch settings.json
+  let settings = {};
+
+  if (fs.existsSync(settingsPath)) {
+    try {
+      settings = JSON.parse(fs.readFileSync(settingsPath, 'utf-8'));
+    } catch {
+      settings = {};
+    }
+  }
+
+  settings.hooks = settings.hooks || {};
+
+  addHook(settings, 'UserPromptSubmit');
+  addHook(settings, 'Stop');
+  addHook(settings, 'Notification');
+
+  fs.writeFileSync(settingsPath, JSON.stringify(settings, null, 2));
+
+  // Output
+  console.log('');
+  console.log('Installed!');
+  console.log('');
+  console.log('Hooks registered:');
+  console.log('  - UserPromptSubmit (start timer)');
+  console.log('  - Stop (task finished)');
+  console.log('  - Notification (waiting for input)');
+  console.log('');
+  console.log('Config: ' + configPath);
+
+  if (token) {
+    console.log('Telegram: configured');
+  } else {
+    console.log('Telegram: skipped (edit config later)');
+  }
+
+  console.log('');
+  console.log('To disable per project, add to .claude/settings.local.json:');
+  console.log('  { "env": { "DISABLE_CLAUDE_NOTIFIER": "1" } }');
+  console.log('');
+}
+
+main().then(() => 0);