telegram-claude-mcp 1.6.0 → 1.6.1

package/README.md

@@ -35,29 +35,29 @@ Create directory `~/.claude/hooks/` and add these scripts:
 **~/.claude/hooks/permission-hook.sh**
 ```bash
 #!/bin/bash
+# Set SESSION_NAME env var to target a specific session (for multi-session setups)
 SESSION_DIR="/tmp/telegram-claude-sessions"
 
-find_active_session() {
-  local latest_file=""
-  local latest_time=0
+find_session() {
+  if [ -n "$SESSION_NAME" ]; then
+    local f="$SESSION_DIR/${SESSION_NAME}.info"
+    [ -f "$f" ] && { local p=$(jq -r '.pid // empty' "$f" 2>/dev/null); [ -n "$p" ] && kill -0 "$p" 2>/dev/null && echo "$f"; return; }
+    return
+  fi
+  local latest="" latest_time=0
   [ -d "$SESSION_DIR" ] || return
-  for info_file in "$SESSION_DIR"/*.info; do
-    [ -e "$info_file" ] || continue
-    local pid
-    pid=$(jq -r '.pid // empty' "$info_file" 2>/dev/null)
-    if [ -n "$pid" ] && kill -0 "$pid" 2>/dev/null; then
-      local file_time
-      file_time=$(stat -f %m "$info_file" 2>/dev/null || stat -c %Y "$info_file" 2>/dev/null)
-      if [ "$file_time" -gt "$latest_time" ]; then
-        latest_time=$file_time
-        latest_file=$info_file
-      fi
-    fi
+  for f in "$SESSION_DIR"/*.info; do
+    [ -e "$f" ] || continue
+    local p=$(jq -r '.pid // empty' "$f" 2>/dev/null)
+    [ -n "$p" ] && kill -0 "$p" 2>/dev/null && {
+      local t=$(stat -f %m "$f" 2>/dev/null || stat -c %Y "$f" 2>/dev/null)
+      [ "$t" -gt "$latest_time" ] && { latest_time=$t; latest=$f; }
+    }
   done
-  echo "$latest_file"
+  echo "$latest"
 }
 
-INFO_FILE=$(find_active_session)
+INFO_FILE=$(find_session)
 [ -z "$INFO_FILE" ] || [ ! -f "$INFO_FILE" ] && exit 0
 
 HOOK_PORT=$(jq -r '.port' "$INFO_FILE")
@@ -78,33 +78,33 @@ RESPONSE=$(curl -s -X POST "$HOOK_URL" -H "Content-Type: application/json" -d "$
 **~/.claude/hooks/stop-hook.sh**
 ```bash
 #!/bin/bash
+# Set SESSION_NAME env var to target a specific session (for multi-session setups)
 SESSION_DIR="/tmp/telegram-claude-sessions"
 
-find_active_session() {
-  local latest_file=""
-  local latest_time=0
+find_session() {
+  if [ -n "$SESSION_NAME" ]; then
+    local f="$SESSION_DIR/${SESSION_NAME}.info"
+    [ -f "$f" ] && { local p=$(jq -r '.pid // empty' "$f" 2>/dev/null); [ -n "$p" ] && kill -0 "$p" 2>/dev/null && echo "$f"; return; }
+    return
+  fi
+  local latest="" latest_time=0
   [ -d "$SESSION_DIR" ] || return
-  for info_file in "$SESSION_DIR"/*.info; do
-    [ -e "$info_file" ] || continue
-    local pid
-    pid=$(jq -r '.pid // empty' "$info_file" 2>/dev/null)
-    if [ -n "$pid" ] && kill -0 "$pid" 2>/dev/null; then
-      local file_time
-      file_time=$(stat -f %m "$info_file" 2>/dev/null || stat -c %Y "$info_file" 2>/dev/null)
-      if [ "$file_time" -gt "$latest_time" ]; then
-        latest_time=$file_time
-        latest_file=$info_file
-      fi
-    fi
+  for f in "$SESSION_DIR"/*.info; do
+    [ -e "$f" ] || continue
+    local p=$(jq -r '.pid // empty' "$f" 2>/dev/null)
+    [ -n "$p" ] && kill -0 "$p" 2>/dev/null && {
+      local t=$(stat -f %m "$f" 2>/dev/null || stat -c %Y "$f" 2>/dev/null)
+      [ "$t" -gt "$latest_time" ] && { latest_time=$t; latest=$f; }
+    }
   done
-  echo "$latest_file"
+  echo "$latest"
 }
 
 INPUT=$(cat)
 STOP_HOOK_ACTIVE=$(echo "$INPUT" | jq -r '.stop_hook_active // false')
 [ "$STOP_HOOK_ACTIVE" = "true" ] && exit 0
 
-INFO_FILE=$(find_active_session)
+INFO_FILE=$(find_session)
 [ -z "$INFO_FILE" ] || [ ! -f "$INFO_FILE" ] && exit 0
 
 HOOK_PORT=$(jq -r '.port' "$INFO_FILE")
@@ -124,29 +124,29 @@ fi
 **~/.claude/hooks/notify-hook.sh**
 ```bash
 #!/bin/bash
+# Set SESSION_NAME env var to target a specific session (for multi-session setups)
 SESSION_DIR="/tmp/telegram-claude-sessions"
 
-find_active_session() {
-  local latest_file=""
-  local latest_time=0
+find_session() {
+  if [ -n "$SESSION_NAME" ]; then
+    local f="$SESSION_DIR/${SESSION_NAME}.info"
+    [ -f "$f" ] && { local p=$(jq -r '.pid // empty' "$f" 2>/dev/null); [ -n "$p" ] && kill -0 "$p" 2>/dev/null && echo "$f"; return; }
+    return
+  fi
+  local latest="" latest_time=0
   [ -d "$SESSION_DIR" ] || return
-  for info_file in "$SESSION_DIR"/*.info; do
-    [ -e "$info_file" ] || continue
-    local pid
-    pid=$(jq -r '.pid // empty' "$info_file" 2>/dev/null)
-    if [ -n "$pid" ] && kill -0 "$pid" 2>/dev/null; then
-      local file_time
-      file_time=$(stat -f %m "$info_file" 2>/dev/null || stat -c %Y "$info_file" 2>/dev/null)
-      if [ "$file_time" -gt "$latest_time" ]; then
-        latest_time=$file_time
-        latest_file=$info_file
-      fi
-    fi
+  for f in "$SESSION_DIR"/*.info; do
+    [ -e "$f" ] || continue
+    local p=$(jq -r '.pid // empty' "$f" 2>/dev/null)
+    [ -n "$p" ] && kill -0 "$p" 2>/dev/null && {
+      local t=$(stat -f %m "$f" 2>/dev/null || stat -c %Y "$f" 2>/dev/null)
+      [ "$t" -gt "$latest_time" ] && { latest_time=$t; latest=$f; }
+    }
   done
-  echo "$latest_file"
+  echo "$latest"
 }
 
-INFO_FILE=$(find_active_session)
+INFO_FILE=$(find_session)
 [ -z "$INFO_FILE" ] || [ ! -f "$INFO_FILE" ] && exit 0
 
 HOOK_PORT=$(jq -r '.port' "$INFO_FILE")
@@ -175,19 +175,19 @@ Add to `~/.claude/settings.json`:
     "PermissionRequest": [
       {
         "matcher": "*",
-        "hooks": [{ "type": "command", "command": "~/.claude/hooks/permission-hook.sh" }]
+        "hooks": [{ "type": "command", "command": "SESSION_NAME=default ~/.claude/hooks/permission-hook.sh" }]
       }
     ],
     "Stop": [
       {
         "matcher": "*",
-        "hooks": [{ "type": "command", "command": "~/.claude/hooks/stop-hook.sh" }]
+        "hooks": [{ "type": "command", "command": "SESSION_NAME=default ~/.claude/hooks/stop-hook.sh" }]
       }
     ],
     "Notification": [
       {
         "matcher": "*",
-        "hooks": [{ "type": "command", "command": "~/.claude/hooks/notify-hook.sh" }]
+        "hooks": [{ "type": "command", "command": "SESSION_NAME=default ~/.claude/hooks/notify-hook.sh" }]
       }
     ]
   },
@@ -205,6 +205,8 @@ Add to `~/.claude/settings.json`:
 }
 ```
 
+**Important:** The `SESSION_NAME` in hook commands must match the `SESSION_NAME` in the MCP server env.
+
 ### 3. Create Telegram Bot
 
 1. Open Telegram and message [@BotFather](https://t.me/BotFather)
@@ -257,17 +259,84 @@ Claude Code                    Hook Scripts                 telegram-claude-mcp
 
 ## Multiple Sessions
 
-Run multiple Claude instances with different session names:
+Run multiple Claude Code instances (e.g., `~/.claude` and `~/.claude-personal`) with proper message routing.
+
+### Why This Matters
 
+Without proper configuration, hooks from one Claude session might route to another session's MCP server. The `SESSION_NAME` environment variable ensures each session connects to its own MCP server.
+
+### Configuration
+
+Each Claude config needs a unique `SESSION_NAME` in **both** the MCP server env and the hook commands.
+
+**~/.claude/settings.json** (main):
 ```json
 {
-  "env": {
-    "SESSION_NAME": "project-a"
+  "hooks": {
+    "PermissionRequest": [{
+      "matcher": "*",
+      "hooks": [{ "type": "command", "command": "SESSION_NAME=main ~/.claude/hooks/permission-hook.sh" }]
+    }],
+    "Stop": [{
+      "matcher": "*",
+      "hooks": [{ "type": "command", "command": "SESSION_NAME=main ~/.claude/hooks/stop-hook.sh" }]
+    }],
+    "Notification": [{
+      "matcher": "*",
+      "hooks": [{ "type": "command", "command": "SESSION_NAME=main ~/.claude/hooks/notify-hook.sh" }]
+    }]
+  },
+  "mcpServers": {
+    "telegram": {
+      "command": "npx",
+      "args": ["-y", "telegram-claude-mcp"],
+      "env": {
+        "TELEGRAM_BOT_TOKEN": "YOUR_BOT_TOKEN",
+        "TELEGRAM_CHAT_ID": "YOUR_CHAT_ID",
+        "SESSION_NAME": "main"
+      }
+    }
   }
 }
 ```
 
-Messages are tagged with `[project-a]` so you know which instance sent them.
+**~/.claude-personal/settings.json** (personal):
+```json
+{
+  "hooks": {
+    "PermissionRequest": [{
+      "matcher": "*",
+      "hooks": [{ "type": "command", "command": "SESSION_NAME=personal ~/.claude/hooks/permission-hook.sh" }]
+    }],
+    "Stop": [{
+      "matcher": "*",
+      "hooks": [{ "type": "command", "command": "SESSION_NAME=personal ~/.claude/hooks/stop-hook.sh" }]
+    }],
+    "Notification": [{
+      "matcher": "*",
+      "hooks": [{ "type": "command", "command": "SESSION_NAME=personal ~/.claude/hooks/notify-hook.sh" }]
+    }]
+  },
+  "mcpServers": {
+    "telegram": {
+      "command": "npx",
+      "args": ["-y", "telegram-claude-mcp"],
+      "env": {
+        "TELEGRAM_BOT_TOKEN": "YOUR_BOT_TOKEN",
+        "TELEGRAM_CHAT_ID": "YOUR_CHAT_ID",
+        "SESSION_NAME": "personal"
+      }
+    }
+  }
+}
+```
+
+### Key Points
+
+- **SESSION_NAME must match** - The env var in hook commands must match the MCP server's SESSION_NAME
+- **Share hook scripts** - All configs can use the same hook scripts in `~/.claude/hooks/`
+- **Message tagging** - Messages are tagged with `[main]` or `[personal]` so you know the source
+- **Separate ports** - Each MCP server auto-discovers an available port
 
 ## Troubleshooting
 

package/bin/setup.js

@@ -97,19 +97,31 @@ RESPONSE=$(curl -s -X POST "$HOOK_URL" \\
 const STOP_HOOK = `#!/bin/bash
 #
 # Claude Code Interactive Stop Hook - sends stop notification and waits for reply
+# Set SESSION_NAME env var to target a specific session (for multi-session setups)
 #
 
 SESSION_DIR="/tmp/telegram-claude-sessions"
 
-find_active_session() {
+find_session() {
+  if [ -n "$SESSION_NAME" ]; then
+    local specific_file="$SESSION_DIR/\${SESSION_NAME}.info"
+    if [ -f "$specific_file" ]; then
+      local pid
+      pid=$(jq -r '.pid // empty' "$specific_file" 2>/dev/null)
+      if [ -n "$pid" ] && kill -0 "$pid" 2>/dev/null; then
+        echo "$specific_file"
+        return
+      fi
+    fi
+    return
+  fi
+
   local latest_file=""
   local latest_time=0
-
   [ -d "$SESSION_DIR" ] || return
 
   for info_file in "$SESSION_DIR"/*.info; do
     [ -e "$info_file" ] || continue
-
     local pid
     pid=$(jq -r '.pid // empty' "$info_file" 2>/dev/null)
     if [ -n "$pid" ] && kill -0 "$pid" 2>/dev/null; then
@@ -121,22 +133,16 @@ find_active_session() {
       fi
     fi
   done
-
   echo "$latest_file"
 }
 
 INPUT=$(cat)
 
 STOP_HOOK_ACTIVE=$(echo "$INPUT" | jq -r '.stop_hook_active // false')
-if [ "$STOP_HOOK_ACTIVE" = "true" ]; then
-  exit 0
-fi
-
-INFO_FILE=$(find_active_session)
+[ "$STOP_HOOK_ACTIVE" = "true" ] && exit 0
 
-if [ -z "$INFO_FILE" ] || [ ! -f "$INFO_FILE" ]; then
-  exit 0
-fi
+INFO_FILE=$(find_session)
+[ -z "$INFO_FILE" ] || [ ! -f "$INFO_FILE" ] && exit 0
 
 HOOK_PORT=$(jq -r '.port' "$INFO_FILE")
 HOOK_HOST=$(jq -r '.host // "localhost"' "$INFO_FILE")
@@ -156,29 +162,38 @@ RESPONSE=$(curl -s -X POST "$HOOK_URL" \\
 if [ $? -eq 0 ]; then
   DECISION=$(echo "$RESPONSE" | jq -r '.decision // empty')
   REASON=$(echo "$RESPONSE" | jq -r '.reason // empty')
-
-  if [ "$DECISION" = "block" ] && [ -n "$REASON" ]; then
-    echo "$RESPONSE"
-  fi
+  [ "$DECISION" = "block" ] && [ -n "$REASON" ] && echo "$RESPONSE"
 fi
 `;
 
 const NOTIFY_HOOK = `#!/bin/bash
 #
 # Claude Code Notification Hook - sends notifications to Telegram
+# Set SESSION_NAME env var to target a specific session (for multi-session setups)
 #
 
 SESSION_DIR="/tmp/telegram-claude-sessions"
 
-find_active_session() {
+find_session() {
+  if [ -n "$SESSION_NAME" ]; then
+    local specific_file="$SESSION_DIR/\${SESSION_NAME}.info"
+    if [ -f "$specific_file" ]; then
+      local pid
+      pid=$(jq -r '.pid // empty' "$specific_file" 2>/dev/null)
+      if [ -n "$pid" ] && kill -0 "$pid" 2>/dev/null; then
+        echo "$specific_file"
+        return
+      fi
+    fi
+    return
+  fi
+
   local latest_file=""
   local latest_time=0
-
   [ -d "$SESSION_DIR" ] || return
 
   for info_file in "$SESSION_DIR"/*.info; do
     [ -e "$info_file" ] || continue
-
     local pid
     pid=$(jq -r '.pid // empty' "$info_file" 2>/dev/null)
     if [ -n "$pid" ] && kill -0 "$pid" 2>/dev/null; then
@@ -190,15 +205,11 @@ find_active_session() {
       fi
     fi
   done
-
   echo "$latest_file"
 }
 
-INFO_FILE=$(find_active_session)
-
-if [ -z "$INFO_FILE" ] || [ ! -f "$INFO_FILE" ]; then
-  exit 0
-fi
+INFO_FILE=$(find_session)
+[ -z "$INFO_FILE" ] || [ ! -f "$INFO_FILE" ] && exit 0
 
 HOOK_PORT=$(jq -r '.port' "$INFO_FILE")
 HOOK_HOST=$(jq -r '.host // "localhost"' "$INFO_FILE")
@@ -218,42 +229,46 @@ curl -s -X POST "$HOOK_URL" \\
   --max-time 10 > /dev/null 2>&1
 `;
 
-// Hooks configuration for Claude settings
-const HOOKS_CONFIG = {
-  PermissionRequest: [
-    {
-      matcher: '*',
-      hooks: [
-        {
-          type: 'command',
-          command: '~/.claude/hooks/permission-hook.sh'
-        }
-      ]
-    }
-  ],
-  Stop: [
-    {
-      matcher: '*',
-      hooks: [
-        {
-          type: 'command',
-          command: '~/.claude/hooks/stop-hook.sh'
-        }
-      ]
-    }
-  ],
-  Notification: [
-    {
-      matcher: '*',
-      hooks: [
-        {
-          type: 'command',
-          command: '~/.claude/hooks/notify-hook.sh'
-        }
-      ]
-    }
-  ]
-};
+// Generate hooks configuration for Claude settings
+// sessionName parameter enables multi-session support
+function generateHooksConfig(sessionName = 'default') {
+  const envPrefix = `SESSION_NAME=${sessionName}`;
+  return {
+    PermissionRequest: [
+      {
+        matcher: '*',
+        hooks: [
+          {
+            type: 'command',
+            command: `${envPrefix} ~/.claude/hooks/permission-hook.sh`
+          }
+        ]
+      }
+    ],
+    Stop: [
+      {
+        matcher: '*',
+        hooks: [
+          {
+            type: 'command',
+            command: `${envPrefix} ~/.claude/hooks/stop-hook.sh`
+          }
+        ]
+      }
+    ],
+    Notification: [
+      {
+        matcher: '*',
+        hooks: [
+          {
+            type: 'command',
+            command: `${envPrefix} ~/.claude/hooks/notify-hook.sh`
+          }
+        ]
+      }
+    ]
+  };
+}
 
 function setup() {
   console.log('\n📱 telegram-claude-mcp Setup\n');
@@ -291,8 +306,8 @@ function setup() {
     }
   }
 
-  // Merge hooks config
-  settings.hooks = { ...settings.hooks, ...HOOKS_CONFIG };
+  // Merge hooks config (default session)
+  settings.hooks = { ...settings.hooks, ...generateHooksConfig('default') };
 
   // Add MCP server config if not present
   if (!settings.mcpServers) {
@@ -337,6 +352,18 @@ function setup() {
   console.log('4. Restart Claude Code\n');
 
   console.log('─'.repeat(50));
+  console.log('\n📋 Multi-Session Setup (optional):\n');
+  console.log('If you have multiple Claude configs (e.g., ~/.claude and ~/.claude-personal),');
+  console.log('each needs its own SESSION_NAME to avoid message routing conflicts.\n');
+  console.log('For each additional config, update its settings.json:');
+  console.log('  1. Change SESSION_NAME in mcpServers.telegram.env');
+  console.log('  2. Update hook commands to use that SESSION_NAME:\n');
+  console.log('     "command": "SESSION_NAME=personal ~/.claude/hooks/permission-hook.sh"\n');
+  console.log('Example for ~/.claude-personal/settings.json:');
+  console.log('  SESSION_NAME: "personal" (in mcpServers.telegram.env)');
+  console.log('  Hook commands: "SESSION_NAME=personal ~/.claude/hooks/..."');
+
+  console.log('\n' + '─'.repeat(50));
   console.log('\n✨ Setup complete! Configure your bot token and chat ID to finish.\n');
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "telegram-claude-mcp",
-  "version": "1.6.0",
+  "version": "1.6.1",
   "description": "MCP server that lets Claude message you on Telegram with hooks support",
   "author": "Geravant",
   "license": "MIT",

package/src/telegram.ts

@@ -351,8 +351,7 @@ export class TelegramManager {
               if (entry.type === 'assistant' && entry.message?.content) {
                 const textContent = entry.message.content.find((c: any) => c.type === 'text');
                 if (textContent?.text) {
-                  lastMessage = textContent.text.slice(0, 500);
-                  if (textContent.text.length > 500) lastMessage += '...';
+                  lastMessage = this.truncateMiddle(textContent.text, 600);
                   break;
                 }
               }
@@ -476,6 +475,24 @@ export class TelegramManager {
     });
   }
 
+  /**
+   * Truncate text by removing the middle, keeping beginning and end
+   * This is useful because Claude's questions are usually at the end
+   */
+  private truncateMiddle(text: string, maxLength: number): string {
+    if (text.length <= maxLength) return text;
+
+    // Keep more at the end (where questions usually are)
+    const startLength = Math.floor(maxLength * 0.3); // 30% from start
+    const endLength = Math.floor(maxLength * 0.6);   // 60% from end
+    // ~10% for the ellipsis marker
+
+    const start = text.slice(0, startLength);
+    const end = text.slice(-endLength);
+
+    return `${start}\n\n[...truncated...]\n\n${end}`;
+  }
+
   /**
    * Format tool input for display
    */