claude-pager 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Seb Bassompierre / KASEI LABS
+
+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,207 @@
+# claude-pager
+
+Relay notifications and responses between Claude Code CLI sessions and your phone. When Claude needs your input (permission prompt, idle question) and you're away from the terminal, `claude-pager` sends a notification to your phone and types your response back into the correct tmux pane.
+
+## How it works
+
+```
+┌─────────────┐    hook → HTTP     ┌──────────────┐   Telegram / ntfy   ┌──────────┐
+│ Claude Code  │ ────────────────► │ claude-pager  │ ──────────────────► │  Phone   │
+│ (N instances)│                   │   daemon      │ ◄────────────────── │  (reply) │
+└─────────────┘                   └──────┬───────┘                     └──────────┘
+                                         │ tmux send-keys
+                                         ▼
+                                  ┌──────────────┐
+                                  │ Right terminal│
+                                  └──────────────┘
+```
+
+1. Claude Code hooks fire when an instance needs user input
+2. The hook enriches the event (tool name, last assistant message) and sends it to the daemon
+3. The daemon dispatches a notification to your phone via Telegram or ntfy
+4. You respond — tap Allow/Deny, type a message, or send a voice note
+5. The daemon matches the response to the right session and injects it via `tmux send-keys`
+
+## Features
+
+- **Multi-session** — run N Claude Code instances in tmux, responses route to the correct pane
+- **Telegram** — inline keyboards (Allow/Deny), reply-to-message routing, voice transcription (Whisper)
+- **ntfy** — self-hosted or ntfy.sh, mobile push notifications
+- **Session recovery** — `claude-pager recover` detects existing Claude sessions in tmux
+- **Smart routing** — `#id response` for explicit targeting, auto-route for single session, session picker for ambiguous cases
+- **Fallback by project** — if a session UUID is no longer registered, matches by `cwd` (project directory)
+
+## Requirements
+
+- Node.js >= 20
+- tmux
+- Linux (macOS support planned)
+- A Telegram bot or ntfy server for notifications
+
+## Installation
+
+```bash
+npm install -g claude-pager
+```
+
+## Setup
+
+Interactive configuration — creates `~/.claude-pager/config.json` and installs Claude Code hooks in `~/.claude/settings.json`:
+
+```bash
+claude-pager setup
+```
+
+The setup wizard lets you choose between **Telegram** and **ntfy** as notification channel, and verifies the connection.
+
+### Telegram
+
+You need a Telegram bot token (from [@BotFather](https://t.me/BotFather)) and a chat ID. The setup command walks you through obtaining both.
+
+### ntfy
+
+Point to your ntfy server (self-hosted or `https://ntfy.sh`) with a topic and optional authentication (user/password or token).
+
+## Usage
+
+### Start the daemon
+
+```bash
+# Foreground (for testing)
+claude-pager start
+
+# As a systemd user service (recommended)
+cat > ~/.config/systemd/user/claude-pager.service << 'EOF'
+[Unit]
+Description=Claude Code Relay Daemon
+After=network-online.target
+Wants=network-online.target
+
+[Service]
+Type=simple
+ExecStart=%h/.local/bin/claude-pager start
+ExecStop=%h/.local/bin/claude-pager stop
+Restart=on-failure
+RestartSec=5
+Environment=NODE_ENV=production
+
+[Install]
+WantedBy=default.target
+EOF
+# If claude-pager is installed via nvm, adjust ExecStart path:
+#   ExecStart=/home/you/.nvm/versions/node/v22.x.x/bin/claude-pager start
+systemctl --user daemon-reload
+systemctl --user enable --now claude-pager
+```
+
+### Launch Claude Code in tmux
+
+```bash
+claude-pager run              # opens a new tmux session with claude
+claude-pager run --resume     # pass args through to claude
+```
+
+Or just run `claude` directly inside tmux — the `SessionStart` hook registers the session automatically.
+
+### Recover existing sessions
+
+If you already have Claude Code running in tmux panes:
+
+```bash
+claude-pager recover
+```
+
+### Other commands
+
+```bash
+claude-pager status           # daemon status + health check
+claude-pager pending          # list pending questions
+claude-pager stop             # stop the daemon
+```
+
+## Responding to notifications
+
+### Telegram
+
+- **Permission prompts** — tap the inline **Allow** or **Deny** button
+- **Idle prompts** — reply to the notification message with your answer
+- **Voice** — send a voice message, it gets transcribed and injected
+- **Free messages** — send a message without replying; if one session is active it goes there, otherwise a session picker appears
+
+### ntfy
+
+- Reply with `#<id> <response>` to target a specific notification
+- If only one question is pending, any reply routes to it
+- `allow` / `deny` auto-route to the most recent permission prompt
+
+## Configuration
+
+`~/.claude-pager/config.json`:
+
+```json
+{
+  "port": 17380,
+  "channel": {
+    "type": "telegram",
+    "telegram": {
+      "botToken": "123456:ABC...",
+      "chatId": 12345678
+    }
+  },
+  "injector": "auto"
+}
+```
+
+| Key | Default | Description |
+|-----|---------|-------------|
+| `port` | `17380` | Daemon HTTP port (localhost only) |
+| `channel.type` | `"ntfy"` | `"ntfy"` or `"telegram"` |
+| `injector` | `"auto"` | `"auto"`, `"tmux"`, or `"xdotool"` |
+
+The hook port can be overridden with `CLAUDE_PAGER_PORT` environment variable.
+
+## Architecture
+
+Strategy + Factory pattern for pluggable components:
+
+```
+src/
+├── channels/          # Notification channels (ntfy, telegram)
+│   ├── channel.ts     # ChannelProvider interface
+│   └── factory.ts
+├── injectors/         # Terminal input injection (tmux, xdotool)
+│   ├── injector.ts    # InputInjector interface
+│   └── factory.ts
+├── daemon/            # HTTP server + response routing
+│   ├── server.ts      # Fastify routes with JSON Schema validation
+│   └── handlers.ts    # Channel listener logic (routing, picker)
+├── sessions/          # Session tracking + pending question store
+├── hooks/             # Claude Code hook entry point
+├── utils/             # Shared utilities (html, json, validation)
+├── cli/               # Commander CLI
+└── voice/             # Telegram voice transcription (Whisper)
+```
+
+See `docs/ARCHITECTURE.md` for the detailed flow.
+
+## Security
+
+- HTTP API binds to `127.0.0.1` only — no network exposure
+- Input validation with Fastify JSON Schema + custom validators (`isValidEventType`, `isValidSessionId`)
+- No shell injection — all child processes use `execFileSync` with argument arrays
+- No code content in notifications — only tool names, project names, and question types
+- Memory-bounded maps (capped at 500-1000 entries)
+- Safe JSON parsing with fallbacks for corrupted files
+
+## Development
+
+```bash
+npm run build          # TypeScript compilation
+npm test               # Run all tests (node:test)
+npm run lint           # ESLint with typescript-eslint
+npm run dev            # Dev mode (tsx watch)
+```
+
+## License
+
+MIT

package/dist/channels/channel.d.ts

@@ -0,0 +1,27 @@
+import type { RelayEvent } from '../types.js';
+export interface NotificationResult {
+    messageId?: string;
+    success: boolean;
+    error?: string;
+}
+export interface FreeMessage {
+    text: string;
+    sessionId?: string;
+    replyCallback: (text: string) => Promise<void>;
+}
+export interface ChannelListeners {
+    onResponse: (rawText: string) => void | Promise<void>;
+    onFreeMessage?: (msg: FreeMessage) => void | Promise<void>;
+}
+export interface ChannelProvider {
+    readonly name: string;
+    send(event: RelayEvent, shortId: string): Promise<NotificationResult>;
+    sendRaw?(text: string): Promise<void>;
+    sendSessionPicker?(text: string, sessions: Array<{
+        id: string;
+        label: string;
+    }>): Promise<number | undefined>;
+    startListening(listeners: ChannelListeners): void;
+    stopListening(): void;
+}
+//# sourceMappingURL=channel.d.ts.map

package/dist/channels/channel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"channel.d.ts","sourceRoot":"","sources":["../../src/channels/channel.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE9C,MAAM,WAAW,kBAAkB;IACjC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CAChD;AAED,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACtD,aAAa,CAAC,EAAE,CAAC,GAAG,EAAE,WAAW,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5D;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB,IAAI,CAAC,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC;IAEtE,OAAO,CAAC,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEtC,iBAAiB,CAAC,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;IAE9G,cAAc,CAAC,SAAS,EAAE,gBAAgB,GAAG,IAAI,CAAC;IAElD,aAAa,IAAI,IAAI,CAAC;CACvB"}

package/dist/channels/channel.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=channel.js.map

package/dist/channels/channel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"channel.js","sourceRoot":"","sources":["../../src/channels/channel.ts"],"names":[],"mappings":""}

package/dist/channels/factory.d.ts

@@ -0,0 +1,4 @@
+import type { ChannelConfig } from '../types.js';
+import type { ChannelProvider } from './channel.js';
+export declare function createChannel(config: ChannelConfig): ChannelProvider;
+//# sourceMappingURL=factory.d.ts.map

package/dist/channels/factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../src/channels/factory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAIpD,wBAAgB,aAAa,CAAC,MAAM,EAAE,aAAa,GAAG,eAAe,CAepE"}

package/dist/channels/factory.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createChannel = createChannel;
+const provider_js_1 = require("./ntfy/provider.js");
+const provider_js_2 = require("./telegram/provider.js");
+function createChannel(config) {
+    switch (config.type) {
+        case 'ntfy':
+            if (!config.ntfy) {
+                throw new Error('ntfy configuration is required when channel type is "ntfy"');
+            }
+            return new provider_js_1.NtfyProvider(config.ntfy);
+        case 'telegram':
+            if (!config.telegram) {
+                throw new Error('telegram configuration is required when channel type is "telegram"');
+            }
+            return new provider_js_2.TelegramProvider(config.telegram);
+        default:
+            throw new Error(`Unknown channel type: ${config.type}`);
+    }
+}
+//# sourceMappingURL=factory.js.map

package/dist/channels/factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.js","sourceRoot":"","sources":["../../src/channels/factory.ts"],"names":[],"mappings":";;AAKA,sCAeC;AAlBD,oDAAkD;AAClD,wDAA0D;AAE1D,SAAgB,aAAa,CAAC,MAAqB;IACjD,QAAQ,MAAM,CAAC,IAAI,EAAE,CAAC;QACpB,KAAK,MAAM;YACT,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;gBACjB,MAAM,IAAI,KAAK,CAAC,4DAA4D,CAAC,CAAC;YAChF,CAAC;YACD,OAAO,IAAI,0BAAY,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QACvC,KAAK,UAAU;YACb,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC;gBACrB,MAAM,IAAI,KAAK,CAAC,oEAAoE,CAAC,CAAC;YACxF,CAAC;YACD,OAAO,IAAI,8BAAgB,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QAC/C;YACE,MAAM,IAAI,KAAK,CAAC,yBAAyB,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;IAC5D,CAAC;AACH,CAAC"}

package/dist/channels/ntfy/__tests__/provider.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=provider.test.d.ts.map

package/dist/channels/ntfy/__tests__/provider.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.test.d.ts","sourceRoot":"","sources":["../../../../src/channels/ntfy/__tests__/provider.test.ts"],"names":[],"mappings":""}

package/dist/channels/ntfy/__tests__/provider.test.js

@@ -0,0 +1,29 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const node_test_1 = require("node:test");
+const strict_1 = __importDefault(require("node:assert/strict"));
+const provider_js_1 = require("../provider.js");
+(0, node_test_1.describe)('NtfyProvider', () => {
+    (0, node_test_1.describe)('send', () => {
+        (0, node_test_1.it)('should report error when server is unreachable', async () => {
+            const provider = new provider_js_1.NtfyProvider({
+                server: 'http://127.0.0.1:19999',
+                topic: 'test',
+            });
+            const result = await provider.send({
+                id: 'evt-1',
+                sessionId: 'sess-1',
+                type: 'permission_prompt',
+                message: 'Allow Bash(git status)?',
+                project: '/home/user/dev/myproject',
+                timestamp: Date.now(),
+            }, '1');
+            strict_1.default.equal(result.success, false);
+            strict_1.default.ok(result.error);
+        });
+    });
+});
+//# sourceMappingURL=provider.test.js.map

package/dist/channels/ntfy/__tests__/provider.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.test.js","sourceRoot":"","sources":["../../../../src/channels/ntfy/__tests__/provider.test.ts"],"names":[],"mappings":";;;;;AAAA,yCAAyC;AACzC,gEAAwC;AACxC,gDAA8C;AAE9C,IAAA,oBAAQ,EAAC,cAAc,EAAE,GAAG,EAAE;IAC5B,IAAA,oBAAQ,EAAC,MAAM,EAAE,GAAG,EAAE;QACpB,IAAA,cAAE,EAAC,gDAAgD,EAAE,KAAK,IAAI,EAAE;YAC9D,MAAM,QAAQ,GAAG,IAAI,0BAAY,CAAC;gBAChC,MAAM,EAAE,wBAAwB;gBAChC,KAAK,EAAE,MAAM;aACd,CAAC,CAAC;YAEH,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,IAAI,CAChC;gBACE,EAAE,EAAE,OAAO;gBACX,SAAS,EAAE,QAAQ;gBACnB,IAAI,EAAE,mBAAmB;gBACzB,OAAO,EAAE,yBAAyB;gBAClC,OAAO,EAAE,0BAA0B;gBACnC,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;aACtB,EACD,GAAG,CACJ,CAAC;YAEF,gBAAM,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;YACpC,gBAAM,CAAC,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAC1B,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/channels/ntfy/provider.d.ts

@@ -0,0 +1,17 @@
+import type { ChannelProvider, ChannelListeners, NotificationResult } from '../channel.js';
+import type { NtfyConfig, RelayEvent } from '../../types.js';
+export declare class NtfyProvider implements ChannelProvider {
+    readonly name = "ntfy";
+    private abortController;
+    private readonly config;
+    private processedIds;
+    constructor(config: NtfyConfig);
+    private get topicUrl();
+    private authHeaders;
+    send(event: RelayEvent, shortId: string): Promise<NotificationResult>;
+    startListening(listeners: ChannelListeners): void;
+    private poll;
+    private capSet;
+    stopListening(): void;
+}
+//# sourceMappingURL=provider.d.ts.map

package/dist/channels/ntfy/provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../../../src/channels/ntfy/provider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAC3F,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAE7D,qBAAa,YAAa,YAAW,eAAe;IAClD,QAAQ,CAAC,IAAI,UAAU;IACvB,OAAO,CAAC,eAAe,CAAgC;IACvD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAa;IACpC,OAAO,CAAC,YAAY,CAAqB;gBAE7B,MAAM,EAAE,UAAU;IAI9B,OAAO,KAAK,QAAQ,GAEnB;IAED,OAAO,CAAC,WAAW;IAWb,IAAI,CAAC,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAiD3E,cAAc,CAAC,SAAS,EAAE,gBAAgB,GAAG,IAAI;YAMnC,IAAI;IAsDlB,OAAO,CAAC,MAAM;IAOd,aAAa,IAAI,IAAI;CAItB"}

package/dist/channels/ntfy/provider.js

@@ -0,0 +1,142 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NtfyProvider = void 0;
+class NtfyProvider {
+    name = 'ntfy';
+    abortController = null;
+    config;
+    processedIds = new Set();
+    constructor(config) {
+        this.config = config;
+    }
+    get topicUrl() {
+        return `${this.config.server}/${this.config.topic}`;
+    }
+    authHeaders() {
+        if (this.config.token) {
+            return { Authorization: `Bearer ${this.config.token}` };
+        }
+        if (this.config.user && this.config.password) {
+            const encoded = Buffer.from(`${this.config.user}:${this.config.password}`).toString('base64');
+            return { Authorization: `Basic ${encoded}` };
+        }
+        return {};
+    }
+    async send(event, shortId) {
+        const projectName = event.project.split('/').pop() || event.project;
+        const title = `Claude Code - ${projectName}`;
+        const isPermission = event.type === 'permission_prompt';
+        const tag = isPermission ? 'robot,lock' : 'robot,question';
+        const hint = isPermission ? 'Reply: allow / deny' : 'Reply with your answer';
+        const headers = {
+            'Content-Type': 'text/plain',
+            Title: title,
+            Priority: isPermission ? 'high' : 'default',
+            Tags: tag,
+            ...this.authHeaders(),
+        };
+        let body = `#${shortId} ${event.message}`;
+        if (event.toolName) {
+            body += `\n${event.toolName}`;
+            if (event.toolInput) {
+                const input = event.toolInput.length > 200 ? event.toolInput.slice(0, 200) + '...' : event.toolInput;
+                body += `(${input})`;
+            }
+        }
+        body += `\n\n${hint}`;
+        try {
+            const res = await fetch(this.topicUrl, {
+                method: 'POST',
+                headers,
+                body,
+            });
+            if (!res.ok) {
+                const text = await res.text();
+                return { success: false, error: `ntfy responded ${res.status}: ${text}` };
+            }
+            const data = (await res.json());
+            if (data.id) {
+                this.capSet(this.processedIds, 1000);
+                this.processedIds.add(data.id);
+            }
+            return { success: true, messageId: data.id };
+        }
+        catch (err) {
+            return { success: false, error: String(err) };
+        }
+    }
+    startListening(listeners) {
+        this.stopListening();
+        this.abortController = new AbortController();
+        this.poll(listeners.onResponse);
+    }
+    async poll(onResponse) {
+        const signal = this.abortController.signal;
+        let pollCount = 0;
+        while (!signal.aborted) {
+            try {
+                pollCount++;
+                if (pollCount % 2 === 0)
+                    console.log(`[ntfy] poll #${pollCount}`);
+                const url = `${this.topicUrl}/json?poll=1&since=30s`;
+                const res = await fetch(url, {
+                    headers: this.authHeaders(),
+                    signal,
+                });
+                if (res.ok) {
+                    const text = await res.text();
+                    for (const line of text.split('\n').filter(Boolean)) {
+                        try {
+                            const msg = JSON.parse(line);
+                            if (msg.event !== 'message' || !msg.message)
+                                continue;
+                            if (msg.id && this.processedIds.has(msg.id))
+                                continue;
+                            if (msg.id) {
+                                this.capSet(this.processedIds, 1000);
+                                this.processedIds.add(msg.id);
+                            }
+                            if (/^#\d+ .+\n\nReply[ :]/.test(msg.message))
+                                continue;
+                            console.log(`[ntfy] received response: "${msg.message}"`);
+                            try {
+                                await Promise.resolve(onResponse(msg.message));
+                            }
+                            catch (cbErr) {
+                                console.error('[ntfy] callback error:', cbErr);
+                            }
+                        }
+                        catch {
+                            console.debug('[ntfy] skipping malformed line:', line.slice(0, 80));
+                        }
+                    }
+                }
+            }
+            catch (err) {
+                if (signal.aborted)
+                    return;
+                console.error('[ntfy] poll error:', err);
+            }
+            // Simple sleep that resolves on abort instead of rejecting
+            if (signal.aborted)
+                return;
+            await new Promise(resolve => {
+                const timer = setTimeout(resolve, 5000);
+                signal.addEventListener('abort', () => { clearTimeout(timer); resolve(); }, { once: true });
+            });
+        }
+    }
+    capSet(set, max) {
+        if (set.size >= max) {
+            const first = set.values().next().value;
+            if (first !== undefined)
+                set.delete(first);
+        }
+    }
+    stopListening() {
+        this.abortController?.abort();
+        this.abortController = null;
+    }
+}
+exports.NtfyProvider = NtfyProvider;
+//# sourceMappingURL=provider.js.map

package/dist/channels/ntfy/provider.js.map

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

package/dist/channels/telegram/provider.d.ts

@@ -0,0 +1,27 @@
+import type { ChannelProvider, ChannelListeners, NotificationResult } from '../channel.js';
+import type { TelegramConfig, RelayEvent } from '../../types.js';
+export declare class TelegramProvider implements ChannelProvider {
+    readonly name = "telegram";
+    private abortController;
+    private readonly config;
+    private lastUpdateId;
+    private messageToEvent;
+    private messageToSession;
+    constructor(config: TelegramConfig);
+    private apiUrl;
+    send(event: RelayEvent, shortId: string): Promise<NotificationResult>;
+    sendRaw(text: string): Promise<void>;
+    sendSessionPicker(text: string, sessions: Array<{
+        id: string;
+        label: string;
+    }>): Promise<number | undefined>;
+    startListening(listeners: ChannelListeners): void;
+    private poll;
+    private handleCallback;
+    private handleVoice;
+    private handleFreeMessage;
+    private handleReply;
+    private capMap;
+    stopListening(): void;
+}
+//# sourceMappingURL=provider.d.ts.map

package/dist/channels/telegram/provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../../../src/channels/telegram/provider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,gBAAgB,EAAE,kBAAkB,EAAe,MAAM,eAAe,CAAC;AACxG,OAAO,KAAK,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AA2BjE,qBAAa,gBAAiB,YAAW,eAAe;IACtD,QAAQ,CAAC,IAAI,cAAc;IAC3B,OAAO,CAAC,eAAe,CAAgC;IACvD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAiB;IACxC,OAAO,CAAC,YAAY,CAAK;IAEzB,OAAO,CAAC,cAAc,CAA6B;IAEnD,OAAO,CAAC,gBAAgB,CAA6B;gBAEzC,MAAM,EAAE,cAAc;IAIlC,OAAO,CAAC,MAAM;IAIR,IAAI,CAAC,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC;IA8DrE,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAapC,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IA0BlH,cAAc,CAAC,SAAS,EAAE,gBAAgB,GAAG,IAAI;YAMnC,IAAI;YA6CJ,cAAc;YAwEd,WAAW;YAYX,iBAAiB;YAmBjB,WAAW;IA2CzB,OAAO,CAAC,MAAM;IAOd,aAAa,IAAI,IAAI;CAItB"}