@jsayubi/ccgram 1.1.0 → 1.2.0

package/.env.example

@@ -16,4 +16,7 @@ TELEGRAM_CHAT_ID=
 # Suppress Telegram notifications when actively at terminal (seconds, default: 300)
 # ACTIVE_THRESHOLD_SECONDS=300
 
+# Injection backend: tmux (default), ghostty, or pty
+# INJECTION_MODE=ghostty
+
 # For advanced options (email relay, LINE, webhooks), see .env.full-example

package/README.md

@@ -2,7 +2,7 @@
 
 # CCGram
 
-**Control Claude Code from Telegram — approve permissions, answer questions, and manage AI sessions from your phone.**
+**Control Claude Code from Telegram — approve permissions, answer questions, resume sessions, and manage AI coding agents from your phone.**
 
 [![CI](https://github.com/jsayubi/ccgram/actions/workflows/ci.yml/badge.svg)](https://github.com/jsayubi/ccgram/actions/workflows/ci.yml)
 [![npm version](https://img.shields.io/npm/v/@jsayubi/ccgram)](https://www.npmjs.com/package/@jsayubi/ccgram)
@@ -13,7 +13,7 @@
 
 ---
 
-CCGram is a self-hosted Telegram bot that bridges Claude Code to your phone. When Claude needs a permission, has a question, or finishes a task — you get a Telegram message with inline buttons to respond. You never need to be at your keyboard.
+CCGram is a self-hosted Telegram bot that bridges Claude Code to your phone. When Claude needs a permission, has a question, or finishes a task — you get a Telegram message with inline buttons to respond. Resume past conversations, start new sessions, and manage multiple AI coding agents — all without being at your keyboard.
 
 ```
 Claude Code  →  ccgram hooks  →  Telegram bot  →  📱 your phone
@@ -28,6 +28,7 @@ Claude Code  →  ccgram hooks  →  Telegram bot  →  📱 your phone
 - **Smart notifications** — Task completions, session start/end, and subagent activity — silent when you're at your terminal, instant when you're away
 - **Remote command routing** — Send any command to any Claude session from Telegram
 - **Session management** — List, switch between, and interrupt active sessions
+- **Resume conversations** — `/resume` reads your full Claude Code session history with conversation snippets — pick up any past conversation in one tap
 - **Project launcher** — Start Claude in any project directory with `/new myproject`
 - **Smart routing** — Prefix matching, default workspace, reply-to routing
 - **Typing indicator** — See when the bot is waiting for Claude to respond
@@ -63,14 +64,22 @@ CCGram integrates with [Claude Code hooks](https://docs.anthropic.com/en/docs/cl
 
 | Hook | Event | What it does |
 |------|-------|-------------|
-| `permission-hook.js` | `PermissionRequest` | Sends a permission dialog with Allow / Deny / Always buttons. Blocks Claude until you respond. |
-| `question-notify.js` | `PreToolUse` (AskUserQuestion) | Sends Claude's question with selectable options. Your tap injects the selection via tmux/PTY. |
+| `permission-hook.js` | `PermissionRequest` | Sends a permission dialog with Allow / Deny / Always / Defer buttons. Blocks Claude until you respond. |
+| `question-notify.js` | `PreToolUse` (AskUserQuestion) | Sends Claude's question with selectable options. Returns answer directly via `updatedInput` — works with any terminal. |
 | `enhanced-hook-notify.js completed` | `Stop` | Notifies you when Claude finishes a task, including the last response text. |
 | `enhanced-hook-notify.js waiting` | `Notification` | Notifies you when Claude is waiting for input. |
 | `user-prompt-hook.js` | `UserPromptSubmit` | Tracks terminal activity so notifications are suppressed when you're actively working. |
 | `enhanced-hook-notify.js session-start` | `SessionStart` | Notifies you when a new Claude session starts. |
-| `enhanced-hook-notify.js session-end` | `SessionEnd` | Notifies you when a Claude session ends, with the final response. |
+| `enhanced-hook-notify.js session-end` | `SessionEnd` | Notifies you when a Claude session ends. |
 | `enhanced-hook-notify.js subagent-done` | `SubagentStop` | Notifies you when a subagent task completes. |
+| `permission-denied-notify.js` | `PermissionDenied` | Notifies when auto mode blocks a tool. Retry button lets you override. |
+| `enhanced-hook-notify.js stop-failure` | `StopFailure` | Notifies you on API errors (rate limits, network issues). |
+| `enhanced-hook-notify.js post-compact` | `PostCompact` | Notifies when context compaction completes, with token savings. |
+| `pre-compact-notify.js` | `PreCompact` | Warns before compaction starts. Block button lets you preserve context. |
+| `elicitation-notify.js` | `Elicitation` | Forwards MCP server input requests to Telegram. Reply with your answer. |
+| `enhanced-hook-notify.js task-created` | `TaskCreated` | Notifies when Claude creates a new task. |
+| `enhanced-hook-notify.js cwd-changed` | `CwdChanged` | Notifies when Claude changes working directory. |
+| `enhanced-hook-notify.js instructions-loaded` | `InstructionsLoaded` | Notifies when CLAUDE.md or rules are loaded. |
 
 > **Smart suppression** — all notifications (including permissions) are automatically silenced when you've sent a message to Claude within the last 5 minutes. The moment you step away, Telegram takes over. Telegram-injected commands always get their response back to Telegram regardless.
 
@@ -90,11 +99,11 @@ Claude requests permission
 
 ```
 Claude asks a question (AskUserQuestion)
-  → Claude shows question UI in terminal
   → question-notify sends options to Telegram
   → you tap an option
-  → bot injects arrow keys + Enter via tmux or PTY
-  → Claude's question UI captures the keystrokes
+  → bot writes response file with your selection
+  → hook returns answer via updatedInput to Claude
+  → Claude receives answer directly (works with any terminal!)
 ```
 
 ## Bot Commands
@@ -113,9 +122,12 @@ Claude asks a question (AskUserQuestion)
 | Command | Description |
 |---------|-------------|
 | `/<workspace> <command>` | Send a command to a specific Claude session |
-| `/status [workspace]` | Show the last 20 lines of tmux pane output |
+| `/status [workspace]` | Show the last 20 lines of output (includes rate limit info if available) |
 | `/stop [workspace]` | Send Ctrl+C to interrupt the running prompt |
 | `/compact [workspace]` | Run `/compact` and wait for it to complete |
+| `/effort [workspace] low\|medium\|high` | Set Claude's thinking effort level |
+| `/model [workspace] <model>` | Switch Claude model (sonnet, opus, haiku) |
+| `/link <prompt>` | Generate a deep link to open Claude Code with your prompt |
 
 ### Project launcher
 
@@ -126,6 +138,22 @@ Claude asks a question (AskUserQuestion)
 
 The `/new` command searches your configured `PROJECT_DIRS`, finds exact or prefix-matched directories, creates a tmux session (or PTY session if tmux is unavailable), starts Claude, and sets it as the default workspace.
 
+### Resume past conversations
+
+| Command | Description |
+|---------|-------------|
+| `/resume` | Show projects with past Claude sessions |
+| `/resume myproject` | Jump straight to session picker for that project |
+
+The `/resume` command reads directly from Claude Code's session storage (`~/.claude/projects/`), giving you access to your full conversation history — not just sessions started through the bot.
+
+Each session shows a snippet of the first message for easy identification. Sessions are sorted by last activity.
+
+**Active session protection:**
+- If a session appears to be running in a terminal (JSONL file modified within 5 min), you get a warning before resuming to prevent dual-instance conflicts
+- If a PTY session is running, you're warned that it will be terminated (PTY sessions can't be reattached)
+- tmux sessions switch seamlessly — the bot injects `/exit` + `claude --resume` inline, keeping your terminal connected
+
 ### Smart routing
 
 **Prefix matching** — workspace names can be abbreviated. `/ass hello` routes to `assistant` if it's unique. Ambiguous prefixes show a list to choose from.
@@ -235,7 +263,7 @@ node dist/workspace-telegram-bot.js
 ```bash
 npm run build          # Compile TypeScript → dist/
 npm run build:watch    # Watch mode
-npm test               # Run 57 tests (vitest)
+npm test               # Run 84 tests (vitest)
 ```
 
 **Note:** Claude Code hooks run from `~/.ccgram/dist/`, not the repo's `dist/`. After changing hook scripts during development, sync them:
@@ -276,8 +304,9 @@ cli.ts                         # ccgram CLI entry point
 ```
 test/
 ├── prompt-bridge.test.js     # 15 tests — IPC write/read/update/clean/expiry
-├── workspace-router.test.js  # 28 tests — session map, prefix matching, defaults, reply-to
-└── callback-parser.test.js   # 14 tests — all callback_data formats
+├── workspace-router.test.js  # 38 tests — session map, prefix matching, defaults, reply-to, session history
+├── callback-parser.test.js   # 23 tests — all callback_data formats (perm, opt, new, rp, rs, rc)
+└── active-check.test.js      #  8 tests — terminal activity detection, thresholds
 ```
 
 Tests use isolated temp directories and run with `npm test` (vitest, no configuration needed).
@@ -303,6 +332,9 @@ All notifications — including permission requests — are suppressed automatic
 **Can I use it with multiple projects at once?**
 Yes. Each Claude session maps to a named tmux or PTY session. Use `/sessions` to see all active sessions, or `/use <workspace>` to set a default for plain text routing.
 
+**Can I resume a conversation I started in the terminal?**
+Yes. `/resume` reads from Claude Code's own session storage, so it sees every conversation — not just ones started through the bot. If the session is still running in your terminal, you'll get a warning before resuming to prevent conflicts.
+
 **Do I need tmux?**
 No. When tmux is not detected, CCGram automatically falls back to headless PTY sessions powered by [`node-pty`](https://github.com/microsoft/node-pty). No configuration required — it activates on its own.
 
@@ -331,7 +363,7 @@ MIT — see [LICENSE](LICENSE).
 
 <div align="center">
 
-Built for developers who let Claude Code run overnight and want to stay in control from anywhere.
+Built for developers who run Claude Code unattended — approve permissions, resume conversations, and manage AI coding agents from anywhere.
 
 [Report a bug](https://github.com/jsayubi/ccgram/issues) · [Request a feature](https://github.com/jsayubi/ccgram/issues)
 

package/dist/elicitation-notify.d.ts

@@ -0,0 +1,20 @@
+#!/usr/bin/env node
+/**
+ * Elicitation Notify — Called by Claude Code's Elicitation hook.
+ *
+ * BLOCKING mode: Forwards MCP server input requests to Telegram, polls for
+ * user responses (one per form field), then outputs the answer via stdout.
+ *
+ * Stdin JSON: { mcp_server_name, requested_schema, cwd, session_id, ... }
+ *   requested_schema: JSON Schema object with `properties` describing form fields
+ *
+ * Stdout: {
+ *   hookSpecificOutput: {
+ *     hookEventName: "Elicitation",
+ *     action: "accept" | "decline" | "cancel",
+ *     content: { <fieldName>: <value> }   // required when action === "accept"
+ *   }
+ * }
+ */
+export {};
+//# sourceMappingURL=elicitation-notify.d.ts.map

package/dist/elicitation-notify.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"elicitation-notify.d.ts","sourceRoot":"","sources":["../elicitation-notify.ts"],"names":[],"mappings":";AAEA;;;;;;;;;;;;;;;;GAgBG"}

package/dist/elicitation-notify.js

@@ -0,0 +1,241 @@
+#!/usr/bin/env node
+"use strict";
+/**
+ * Elicitation Notify — Called by Claude Code's Elicitation hook.
+ *
+ * BLOCKING mode: Forwards MCP server input requests to Telegram, polls for
+ * user responses (one per form field), then outputs the answer via stdout.
+ *
+ * Stdin JSON: { mcp_server_name, requested_schema, cwd, session_id, ... }
+ *   requested_schema: JSON Schema object with `properties` describing form fields
+ *
+ * Stdout: {
+ *   hookSpecificOutput: {
+ *     hookEventName: "Elicitation",
+ *     action: "accept" | "decline" | "cancel",
+ *     content: { <fieldName>: <value> }   // required when action === "accept"
+ *   }
+ * }
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const path_1 = __importDefault(require("path"));
+const paths_1 = require("./src/utils/paths");
+require('dotenv').config({ path: path_1.default.join(paths_1.PROJECT_ROOT, '.env'), quiet: true });
+const fs_1 = __importDefault(require("fs"));
+const https_1 = __importDefault(require("https"));
+const workspace_router_1 = require("./workspace-router");
+const prompt_bridge_1 = require("./prompt-bridge");
+const active_check_1 = require("./src/utils/active-check");
+const BOT_TOKEN = process.env.TELEGRAM_BOT_TOKEN;
+const CHAT_ID = process.env.TELEGRAM_CHAT_ID;
+// Polling configuration
+const POLL_INTERVAL_MS = 500;
+const POLL_TIMEOUT_MS = 120000; // 2 minutes for user input
+// ── Main ────────────────────────────────────────────────────────
+async function main() {
+    const raw = await readStdin();
+    // Skip Telegram notification if user is at terminal AND this wasn't Telegram-injected
+    const typingActivePath = path_1.default.join(paths_1.PROJECT_ROOT, 'src/data', 'typing-active');
+    const isTelegramInjected = fs_1.default.existsSync(typingActivePath);
+    if (!isTelegramInjected && (0, active_check_1.isUserActiveAtTerminal)()) {
+        return;
+    }
+    let payload;
+    try {
+        payload = JSON.parse(raw);
+    }
+    catch {
+        return;
+    }
+    // Payload uses `mcp_server_name` (newer) — fall back to `mcp_server` for safety
+    const mcpServer = payload.mcp_server_name || payload.mcp_server || 'Unknown MCP';
+    const schema = payload.requested_schema || {};
+    const properties = schema.properties || {};
+    const fieldNames = Object.keys(properties);
+    const cwd = payload.cwd || process.cwd();
+    const workspace = (0, workspace_router_1.extractWorkspaceName)(cwd);
+    // If the schema has no fields, decline — we can't build a meaningful response.
+    if (fieldNames.length === 0) {
+        emitDecline();
+        return;
+    }
+    // Prompt the user one field at a time. Any field that doesn't get an answer
+    // (timeout) cancels the whole elicitation.
+    const content = {};
+    for (let i = 0; i < fieldNames.length; i++) {
+        const fieldName = fieldNames[i];
+        const prop = properties[fieldName];
+        const promptId = (0, prompt_bridge_1.generatePromptId)();
+        let messageText = `\u{1F50C} *MCP Input Required* — ${escapeMarkdown(workspace)}\n\n`;
+        messageText += `*Server:* \`${escapeMarkdown(mcpServer)}\`\n`;
+        if (fieldNames.length > 1) {
+            messageText += `*Field ${i + 1} of ${fieldNames.length}:* \`${escapeMarkdown(fieldName)}\`\n\n`;
+        }
+        else {
+            messageText += `*Field:* \`${escapeMarkdown(fieldName)}\`\n\n`;
+        }
+        if (prop.description) {
+            messageText += `${escapeMarkdown(prop.description)}\n\n`;
+        }
+        if (prop.enum && prop.enum.length > 0) {
+            messageText += `_Allowed values:_ ${prop.enum.map(v => `\`${escapeMarkdown(v)}\``).join(', ')}\n\n`;
+        }
+        messageText += `_Reply to this message with your answer_`;
+        (0, prompt_bridge_1.writePending)(promptId, {
+            type: 'elicitation',
+            workspace,
+            mcpServer,
+            fieldName,
+        });
+        try {
+            const result = await sendTelegram(messageText);
+            if (result && result.message_id) {
+                (0, workspace_router_1.trackNotificationMessage)(result.message_id, workspace, 'elicitation');
+            }
+        }
+        catch (err) {
+            process.stderr.write(`[elicitation-notify] Telegram send failed: ${err.message}\n`);
+            (0, prompt_bridge_1.cleanPrompt)(promptId);
+            emitCancel();
+            return;
+        }
+        const response = await pollForResponse(promptId);
+        (0, prompt_bridge_1.cleanPrompt)(promptId);
+        if (!response || typeof response.textAnswer !== 'string') {
+            // Timeout or missing answer — cancel the whole elicitation
+            emitCancel();
+            return;
+        }
+        content[fieldName] = response.textAnswer;
+    }
+    const output = {
+        hookSpecificOutput: {
+            hookEventName: 'Elicitation',
+            action: 'accept',
+            content,
+        },
+    };
+    process.stdout.write(JSON.stringify(output) + '\n');
+}
+function emitDecline() {
+    const output = {
+        hookSpecificOutput: {
+            hookEventName: 'Elicitation',
+            action: 'decline',
+        },
+    };
+    process.stdout.write(JSON.stringify(output) + '\n');
+}
+function emitCancel() {
+    const output = {
+        hookSpecificOutput: {
+            hookEventName: 'Elicitation',
+            action: 'cancel',
+        },
+    };
+    process.stdout.write(JSON.stringify(output) + '\n');
+}
+// ── Polling ─────────────────────────────────────────────────────
+function pollForResponse(promptId) {
+    return new Promise((resolve) => {
+        const responseFile = path_1.default.join(prompt_bridge_1.PROMPTS_DIR, `response-${promptId}.json`);
+        const startTime = Date.now();
+        const interval = setInterval(() => {
+            if (Date.now() - startTime > POLL_TIMEOUT_MS) {
+                clearInterval(interval);
+                process.stderr.write(`[elicitation-notify] Timed out waiting for response\n`);
+                resolve(null);
+                return;
+            }
+            try {
+                if (fs_1.default.existsSync(responseFile)) {
+                    const raw = fs_1.default.readFileSync(responseFile, 'utf8');
+                    const data = JSON.parse(raw);
+                    clearInterval(interval);
+                    resolve(data);
+                }
+            }
+            catch {
+                // File not ready yet or parse error — keep polling
+            }
+        }, POLL_INTERVAL_MS);
+    });
+}
+// ── Telegram ────────────────────────────────────────────────────
+function sendTelegram(text) {
+    return new Promise((resolve, reject) => {
+        const body = JSON.stringify({
+            chat_id: CHAT_ID,
+            text,
+            parse_mode: 'Markdown',
+        });
+        const options = {
+            hostname: 'api.telegram.org',
+            path: `/bot${BOT_TOKEN}/sendMessage`,
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+                'Content-Length': Buffer.byteLength(body),
+            },
+            timeout: 5000,
+        };
+        const req = https_1.default.request(options, (res) => {
+            let data = '';
+            res.on('data', (chunk) => { data += chunk; });
+            res.on('end', () => {
+                if (res.statusCode >= 200 && res.statusCode < 300) {
+                    try {
+                        const parsed = JSON.parse(data);
+                        resolve(parsed.result || null);
+                    }
+                    catch {
+                        resolve(null);
+                    }
+                }
+                else {
+                    reject(new Error(`Telegram API ${res.statusCode}: ${data}`));
+                }
+            });
+        });
+        req.on('error', reject);
+        req.on('timeout', () => {
+            req.destroy();
+            reject(new Error('Telegram request timed out'));
+        });
+        req.write(body);
+        req.end();
+    });
+}
+// ── Helpers ──────────────────────────────────────────────────────
+function readStdin() {
+    return new Promise((resolve) => {
+        let data = '';
+        let resolved = false;
+        process.stdin.setEncoding('utf8');
+        process.stdin.on('data', (chunk) => { data += chunk; });
+        process.stdin.on('end', () => {
+            if (!resolved) {
+                resolved = true;
+                resolve(data);
+            }
+        });
+        setTimeout(() => {
+            if (!resolved) {
+                resolved = true;
+                process.stdin.destroy();
+                resolve(data || '{}');
+            }
+        }, 500);
+    });
+}
+function escapeMarkdown(text) {
+    return text.replace(/([_*`\[])/g, '\\$1');
+}
+// ── Run ─────────────────────────────────────────────────────────
+main().catch((err) => {
+    process.stderr.write(`[elicitation-notify] Fatal: ${err.message}\n`);
+});
+//# sourceMappingURL=elicitation-notify.js.map

package/dist/elicitation-notify.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"elicitation-notify.js","sourceRoot":"","sources":["../elicitation-notify.ts"],"names":[],"mappings":"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"}

package/dist/enhanced-hook-notify.d.ts

@@ -3,7 +3,9 @@
  * Enhanced Hook Notifier — called by Claude Code hooks.
  *
  * Handles: Stop (completed), Notification (waiting), SessionStart,
- *          SessionEnd, SubagentStop (subagent-done).
+ *          SessionEnd, SubagentStop (subagent-done), StopFailure (stop-failure),
+ *          PostCompact (post-compact), TaskCreated (task-created),
+ *          CwdChanged (cwd-changed), InstructionsLoaded (instructions-loaded).
  *
  * Usage (in ~/.claude/settings.json hooks):
  *   node /path/to/ccgram/dist/enhanced-hook-notify.js completed
@@ -11,6 +13,11 @@
  *   node /path/to/ccgram/dist/enhanced-hook-notify.js session-start
  *   node /path/to/ccgram/dist/enhanced-hook-notify.js session-end
  *   node /path/to/ccgram/dist/enhanced-hook-notify.js subagent-done
+ *   node /path/to/ccgram/dist/enhanced-hook-notify.js stop-failure
+ *   node /path/to/ccgram/dist/enhanced-hook-notify.js post-compact
+ *   node /path/to/ccgram/dist/enhanced-hook-notify.js task-created
+ *   node /path/to/ccgram/dist/enhanced-hook-notify.js cwd-changed
+ *   node /path/to/ccgram/dist/enhanced-hook-notify.js instructions-loaded
  */
 export {};
 //# sourceMappingURL=enhanced-hook-notify.d.ts.map

package/dist/enhanced-hook-notify.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"enhanced-hook-notify.d.ts","sourceRoot":"","sources":["../enhanced-hook-notify.ts"],"names":[],"mappings":";AAEA;;;;;;;;;;;;GAYG"}
+{"version":3,"file":"enhanced-hook-notify.d.ts","sourceRoot":"","sources":["../enhanced-hook-notify.ts"],"names":[],"mappings":";AAEA;;;;;;;;;;;;;;;;;;;GAmBG"}

package/dist/enhanced-hook-notify.js

@@ -4,7 +4,9 @@
  * Enhanced Hook Notifier — called by Claude Code hooks.
  *
  * Handles: Stop (completed), Notification (waiting), SessionStart,
- *          SessionEnd, SubagentStop (subagent-done).
+ *          SessionEnd, SubagentStop (subagent-done), StopFailure (stop-failure),
+ *          PostCompact (post-compact), TaskCreated (task-created),
+ *          CwdChanged (cwd-changed), InstructionsLoaded (instructions-loaded).
  *
  * Usage (in ~/.claude/settings.json hooks):
  *   node /path/to/ccgram/dist/enhanced-hook-notify.js completed
@@ -12,6 +14,11 @@
  *   node /path/to/ccgram/dist/enhanced-hook-notify.js session-start
  *   node /path/to/ccgram/dist/enhanced-hook-notify.js session-end
  *   node /path/to/ccgram/dist/enhanced-hook-notify.js subagent-done
+ *   node /path/to/ccgram/dist/enhanced-hook-notify.js stop-failure
+ *   node /path/to/ccgram/dist/enhanced-hook-notify.js post-compact
+ *   node /path/to/ccgram/dist/enhanced-hook-notify.js task-created
+ *   node /path/to/ccgram/dist/enhanced-hook-notify.js cwd-changed
+ *   node /path/to/ccgram/dist/enhanced-hook-notify.js instructions-loaded
  */
 var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
@@ -37,6 +44,12 @@ const STATUS_CONFIG = {
     'session-start': { icon: '\u{1F7E2}', label: 'Session started', alwaysNotify: false, upsertSession: true },
     'session-end': { icon: '\u{1F534}', label: 'Session ended', alwaysNotify: false, upsertSession: false },
     'subagent-done': { icon: '\u{1F916}', label: 'Subagent finished', alwaysNotify: false, upsertSession: true },
+    // Phase 2 hook events
+    'stop-failure': { icon: '\u26A0\uFE0F', label: 'API error', alwaysNotify: true, upsertSession: true },
+    'post-compact': { icon: '\u{1F4E6}', label: 'Context compacted', alwaysNotify: false, upsertSession: true },
+    'task-created': { icon: '\u{1F4CB}', label: 'Task created', alwaysNotify: false, upsertSession: true },
+    'cwd-changed': { icon: '\u{1F4C2}', label: 'Directory changed', alwaysNotify: false, upsertSession: true },
+    'instructions-loaded': { icon: '\u{1F4D6}', label: 'Instructions loaded', alwaysNotify: false, upsertSession: false },
 };
 // ── Main ────────────────────────────────────────────────────────
 async function main() {
@@ -50,23 +63,38 @@ async function main() {
     }
     const cwd = payload.cwd || process.env.CLAUDE_CWD || process.cwd();
     const workspace = (0, workspace_router_1.extractWorkspaceName)(cwd);
+    const sessionTitle = payload.session_title || null; // v2.1.94+
     const tmuxSession = detectSessionName(cwd);
     const sessionId = payload.session_id || null;
     const config = STATUS_CONFIG[STATUS_ARG] ?? STATUS_CONFIG['waiting'];
+    // Extract rate limit info from payload (Claude Code v2.1.80+)
+    const rateLimit = extractRateLimitInfo(payload);
     // Update session map (skip for session-end — session is over)
     if (config.upsertSession) {
         try {
+            const sessionType = process.env.TMUX ? 'tmux'
+                : process.env.TERM_PROGRAM === 'ghostty' ? 'ghostty'
+                    : undefined;
             (0, workspace_router_1.upsertSession)({
                 cwd,
                 tmuxSession: tmuxSession || `claude-${workspace}`,
                 status: STATUS_ARG,
                 sessionId,
+                sessionType,
+                rateLimit,
             });
         }
         catch (err) {
             logger.error(`Failed to update session map: ${err.message}`);
         }
     }
+    else if (rateLimit) {
+        // Even for session-end, update rate limit if present
+        try {
+            (0, workspace_router_1.updateSessionRateLimit)(workspace, rateLimit);
+        }
+        catch { }
+    }
     // If the bot injected this command from Telegram, typing-active exists — always notify
     // so the response goes back to Telegram regardless of terminal activity.
     const typingActivePath = path_1.default.join(paths_1.PROJECT_ROOT, 'src/data', 'typing-active');
@@ -90,9 +118,62 @@ async function main() {
             catch { }
             return;
         }
-        let message = `${config.icon} ${config.label} in <b>${escapeHtml(workspace)}</b>`;
-        // Append Claude's last response text (skip for session-start — nothing said yet)
-        if (STATUS_ARG !== 'session-start') {
+        // Include session title if available (v2.1.94+)
+        const titleSuffix = sessionTitle ? ` (${escapeHtml(sessionTitle)})` : '';
+        let message = `${config.icon} ${config.label} in <b>${escapeHtml(workspace)}</b>${titleSuffix}`;
+        // Status-specific message additions
+        if (STATUS_ARG === 'stop-failure') {
+            // Include error details from StopFailure hook
+            const errorType = payload.error_type;
+            const errorMessage = payload.error_message;
+            if (errorType || errorMessage) {
+                message += `\n\n<b>Error:</b> ${escapeHtml(errorType || 'Unknown')}`;
+                if (errorMessage) {
+                    message += `\n${escapeHtml(errorMessage)}`;
+                }
+            }
+        }
+        else if (STATUS_ARG === 'post-compact') {
+            // Include compaction stats if available
+            const beforeTokens = payload.tokens_before;
+            const afterTokens = payload.tokens_after;
+            if (beforeTokens && afterTokens) {
+                const saved = beforeTokens - afterTokens;
+                const percent = Math.round((saved / beforeTokens) * 100);
+                message += `\n\n<i>${beforeTokens.toLocaleString()} → ${afterTokens.toLocaleString()} tokens (${percent}% saved)</i>`;
+            }
+        }
+        else if (STATUS_ARG === 'task-created') {
+            // Include task description
+            const taskDescription = payload.task_description;
+            const taskId = payload.task_id;
+            if (taskDescription) {
+                message += `\n\n${escapeHtml(taskDescription)}`;
+            }
+            if (taskId) {
+                message += `\n<i>ID: ${escapeHtml(taskId)}</i>`;
+            }
+        }
+        else if (STATUS_ARG === 'cwd-changed') {
+            // Include old and new directory
+            const oldCwd = payload.old_cwd;
+            const newCwd = payload.new_cwd;
+            if (oldCwd && newCwd) {
+                const oldWorkspace = (0, workspace_router_1.extractWorkspaceName)(oldCwd);
+                const newWorkspace = (0, workspace_router_1.extractWorkspaceName)(newCwd);
+                message += `\n\n<i>${escapeHtml(oldWorkspace || oldCwd)} → ${escapeHtml(newWorkspace || newCwd)}</i>`;
+            }
+        }
+        else if (STATUS_ARG === 'instructions-loaded') {
+            // Include instructions file path
+            const instructionsPath = payload.instructions_path;
+            if (instructionsPath) {
+                message += `\n\n<i>${escapeHtml(instructionsPath)}</i>`;
+            }
+        }
+        // Append Claude's last response text (skip for session-start and simple notifications)
+        const skipResponseText = ['session-start', 'post-compact', 'task-created', 'cwd-changed', 'instructions-loaded'];
+        if (!skipResponseText.includes(STATUS_ARG)) {
             const responseText = getResponseText(payload);
             if (responseText) {
                 const truncated = responseText.length > 3500
@@ -200,6 +281,34 @@ function sendTelegram(text, parseMode = 'Markdown') {
     });
 }
 // ── Helpers ──────────────────────────────────────────────────────
+/**
+ * Extract rate limit info from hook payload (Claude Code v2.1.80+).
+ * Rate limits may appear in statusline data or direct payload fields.
+ */
+function extractRateLimitInfo(payload) {
+    // Try direct rate_limits field
+    const rateLimits = payload.rate_limits;
+    if (rateLimits) {
+        return {
+            remaining: rateLimits.remaining,
+            limit: rateLimits.limit,
+            resetsAt: rateLimits.resets_at,
+            updatedAt: Date.now(),
+        };
+    }
+    // Try statusline object (may contain rate limit info)
+    const statusline = payload.statusline;
+    if (statusline?.rate_limits) {
+        const sl = statusline.rate_limits;
+        return {
+            remaining: sl.remaining,
+            limit: sl.limit,
+            resetsAt: sl.resets_at,
+            updatedAt: Date.now(),
+        };
+    }
+    return undefined;
+}
 function extractLastResponse(transcriptPath) {
     const data = fs_1.default.readFileSync(transcriptPath, 'utf8').trimEnd();
     const lines = data.split('\n');
@@ -248,7 +357,12 @@ function detectSessionName(cwd) {
         }
         catch { }
     }
-    // 2. Derive from CWD — sanitize so it matches PTY handle key format
+    // 2. Ghostty — derive from CWD (same sanitization as tmux-less path)
+    if (process.env.TERM_PROGRAM === 'ghostty') {
+        const raw = (0, workspace_router_1.extractWorkspaceName)(cwd);
+        return raw ? raw.replace(/[.:\s]/g, '-') : null;
+    }
+    // 3. Derive from CWD — sanitize so it matches PTY handle key format
     const raw = (0, workspace_router_1.extractWorkspaceName)(cwd);
     if (!raw)
         return null;