@ouija-dev/plugin-notify-telegram 0.1.0

package/dist/config.d.ts

@@ -0,0 +1,50 @@
+export interface TelegramConfig {
+    /** Telegram Bot API token (from BotFather) */
+    botToken: string;
+    /** Telegram chat ID to send notifications to (MK's personal chat) */
+    chatId: string;
+    /** HTML or MarkdownV2. Defaults to HTML — simpler escaping rules. */
+    parseMode: 'HTML' | 'MarkdownV2';
+    /** When true, messages are delivered silently (no phone notification) */
+    disableNotification: boolean;
+    /** Base URL for deep links back to Ouija dashboard */
+    dashboardBaseUrl: string;
+}
+/**
+ * JSON Schema for Ajv validation at plugin load time.
+ * Matches TelegramConfig shape exactly.
+ */
+export declare const telegramConfigSchema: {
+    readonly type: "object";
+    readonly required: readonly ["botToken", "chatId"];
+    readonly properties: {
+        readonly botToken: {
+            readonly type: "string";
+            readonly minLength: 1;
+            readonly description: "Telegram Bot API token (from BotFather)";
+        };
+        readonly chatId: {
+            readonly type: "string";
+            readonly minLength: 1;
+            readonly description: "Target chat ID for notifications";
+        };
+        readonly parseMode: {
+            readonly type: "string";
+            readonly enum: readonly ["HTML", "MarkdownV2"];
+            readonly default: "HTML";
+            readonly description: "Telegram message parse mode";
+        };
+        readonly disableNotification: {
+            readonly type: "boolean";
+            readonly default: false;
+            readonly description: "Send messages silently without phone notification";
+        };
+        readonly dashboardBaseUrl: {
+            readonly type: "string";
+            readonly default: "http://localhost:4000";
+            readonly description: "Base URL for dashboard deep links";
+        };
+    };
+    readonly additionalProperties: false;
+};
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,cAAc;IAC7B,8CAA8C;IAC9C,QAAQ,EAAE,MAAM,CAAC;IACjB,qEAAqE;IACrE,MAAM,EAAE,MAAM,CAAC;IACf,qEAAqE;IACrE,SAAS,EAAE,MAAM,GAAG,YAAY,CAAC;IACjC,yEAAyE;IACzE,mBAAmB,EAAE,OAAO,CAAC;IAC7B,sDAAsD;IACtD,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED;;;GAGG;AACH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgCvB,CAAC"}

package/dist/config.js

@@ -0,0 +1,39 @@
+// ---- Telegram plugin configuration ----
+/**
+ * JSON Schema for Ajv validation at plugin load time.
+ * Matches TelegramConfig shape exactly.
+ */
+export const telegramConfigSchema = {
+    type: 'object',
+    required: ['botToken', 'chatId'],
+    properties: {
+        botToken: {
+            type: 'string',
+            minLength: 1,
+            description: 'Telegram Bot API token (from BotFather)',
+        },
+        chatId: {
+            type: 'string',
+            minLength: 1,
+            description: 'Target chat ID for notifications',
+        },
+        parseMode: {
+            type: 'string',
+            enum: ['HTML', 'MarkdownV2'],
+            default: 'HTML',
+            description: 'Telegram message parse mode',
+        },
+        disableNotification: {
+            type: 'boolean',
+            default: false,
+            description: 'Send messages silently without phone notification',
+        },
+        dashboardBaseUrl: {
+            type: 'string',
+            default: 'http://localhost:4000',
+            description: 'Base URL for dashboard deep links',
+        },
+    },
+    additionalProperties: false,
+};
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,0CAA0C;AAe1C;;;GAGG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,IAAI,EAAE,QAAQ;IACd,QAAQ,EAAE,CAAC,UAAU,EAAE,QAAQ,CAAC;IAChC,UAAU,EAAE;QACV,QAAQ,EAAE;YACR,IAAI,EAAE,QAAQ;YACd,SAAS,EAAE,CAAC;YACZ,WAAW,EAAE,yCAAyC;SACvD;QACD,MAAM,EAAE;YACN,IAAI,EAAE,QAAQ;YACd,SAAS,EAAE,CAAC;YACZ,WAAW,EAAE,kCAAkC;SAChD;QACD,SAAS,EAAE;YACT,IAAI,EAAE,QAAQ;YACd,IAAI,EAAE,CAAC,MAAM,EAAE,YAAY,CAAC;YAC5B,OAAO,EAAE,MAAM;YACf,WAAW,EAAE,6BAA6B;SAC3C;QACD,mBAAmB,EAAE;YACnB,IAAI,EAAE,SAAS;YACf,OAAO,EAAE,KAAK;YACd,WAAW,EAAE,mDAAmD;SACjE;QACD,gBAAgB,EAAE;YAChB,IAAI,EAAE,QAAQ;YACd,OAAO,EAAE,uBAAuB;YAChC,WAAW,EAAE,mCAAmC;SACjD;KACF;IACD,oBAAoB,EAAE,KAAK;CACnB,CAAC"}

package/dist/formatter.d.ts

@@ -0,0 +1,52 @@
+import type { Notification } from '@ouija-dev/types';
+export interface DispatchStartedData {
+    agentName: string;
+    cardTitle: string;
+    cardId: string;
+}
+export interface PrReadyData {
+    prUrl: string;
+    prTitle: string;
+    repoName: string;
+}
+export interface AgentFailedData {
+    agentName: string;
+    errorMessage: string;
+    pipelineId?: string;
+}
+export interface StallDetectedData {
+    agentName: string;
+    stalledMinutes: number;
+    pipelineId?: string;
+}
+/**
+ * Escape HTML special characters for Telegram HTML parse mode.
+ * Telegram HTML requires escaping: & < >
+ */
+export declare function escapeHtml(text: string): string;
+/**
+ * Format any Notification into Telegram HTML text.
+ * Renders: icon + bold title + blank line + body.
+ */
+export declare function formatNotification(notification: Notification): string;
+/**
+ * Agent started working on a card.
+ * "Agent rex-coder started working on Card: Fix login bug"
+ */
+export declare function formatDispatchStarted(data: DispatchStartedData): string;
+/**
+ * Agent opened a PR.
+ * "PR ready for review: [link]" with [View PR] button.
+ */
+export declare function formatPrReady(data: PrReadyData): string;
+/**
+ * Agent failed with an error.
+ * "Agent failed: error message" with [Retry] [View] buttons.
+ */
+export declare function formatAgentFailed(data: AgentFailedData): string;
+/**
+ * Agent stalled — no heartbeat for N minutes.
+ * "Agent stalled — no heartbeat for 5m" with [Retry] [Cancel] buttons.
+ */
+export declare function formatStallDetected(data: StallDetectedData): string;
+//# sourceMappingURL=formatter.d.ts.map

package/dist/formatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatter.d.ts","sourceRoot":"","sources":["../src/formatter.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAqB,MAAM,kBAAkB,CAAC;AAIxE,MAAM,WAAW,mBAAmB;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAID;;;GAGG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAK/C;AAaD;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,YAAY,EAAE,YAAY,GAAG,MAAM,CAUrE;AAID;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,mBAAmB,GAAG,MAAM,CAWvE;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,WAAW,GAAG,MAAM,CAUvD;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,eAAe,GAAG,MAAM,CAU/D;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,iBAAiB,GAAG,MAAM,CASnE"}

package/dist/formatter.js

@@ -0,0 +1,93 @@
+// ---- Notification -> Telegram HTML message formatter ----
+// Uses HTML parse mode throughout — simpler escaping than MarkdownV2.
+// ---- HTML escaping ----
+/**
+ * Escape HTML special characters for Telegram HTML parse mode.
+ * Telegram HTML requires escaping: & < >
+ */
+export function escapeHtml(text) {
+    return text
+        .replace(/&/g, '&amp;')
+        .replace(/</g, '&lt;')
+        .replace(/>/g, '&gt;');
+}
+// ---- Level icons ----
+const LEVEL_ICON = {
+    info: '\u2139\uFE0F', // information
+    warning: '\u26A0\uFE0F', // warning
+    error: '\u274C', // red X
+    success: '\u2705', // green check
+};
+// ---- Generic notification formatter ----
+/**
+ * Format any Notification into Telegram HTML text.
+ * Renders: icon + bold title + blank line + body.
+ */
+export function formatNotification(notification) {
+    const icon = LEVEL_ICON[notification.level];
+    const title = escapeHtml(notification.title);
+    const body = escapeHtml(notification.body);
+    return [
+        `${icon} <b>${title}</b>`,
+        '',
+        body,
+    ].join('\n');
+}
+// ---- Typed pipeline event formatters ----
+/**
+ * Agent started working on a card.
+ * "Agent rex-coder started working on Card: Fix login bug"
+ */
+export function formatDispatchStarted(data) {
+    const agentName = escapeHtml(data.agentName);
+    const cardTitle = escapeHtml(data.cardTitle);
+    const cardId = escapeHtml(data.cardId);
+    return [
+        `\u2139\uFE0F <b>Agent dispatched</b>`,
+        '',
+        `<b>${agentName}</b> started working on Card: <code>${cardId}</code>`,
+        `<i>${cardTitle}</i>`,
+    ].join('\n');
+}
+/**
+ * Agent opened a PR.
+ * "PR ready for review: [link]" with [View PR] button.
+ */
+export function formatPrReady(data) {
+    const prTitle = escapeHtml(data.prTitle);
+    const repoName = escapeHtml(data.repoName);
+    const prUrl = escapeHtml(data.prUrl);
+    return [
+        `\u2705 <b>PR ready for review</b>`,
+        '',
+        `<b>${repoName}</b>: <a href="${prUrl}">${prTitle}</a>`,
+    ].join('\n');
+}
+/**
+ * Agent failed with an error.
+ * "Agent failed: error message" with [Retry] [View] buttons.
+ */
+export function formatAgentFailed(data) {
+    const agentName = escapeHtml(data.agentName);
+    const errorMessage = escapeHtml(data.errorMessage);
+    return [
+        `\u274C <b>Agent failed</b>`,
+        '',
+        `<b>${agentName}</b> encountered an error:`,
+        `<code>${errorMessage}</code>`,
+    ].join('\n');
+}
+/**
+ * Agent stalled — no heartbeat for N minutes.
+ * "Agent stalled — no heartbeat for 5m" with [Retry] [Cancel] buttons.
+ */
+export function formatStallDetected(data) {
+    const agentName = escapeHtml(data.agentName);
+    const minutes = data.stalledMinutes;
+    return [
+        `\u26A0\uFE0F <b>Agent stalled</b>`,
+        '',
+        `<b>${agentName}</b> — no heartbeat for <b>${minutes}m</b>`,
+    ].join('\n');
+}
+//# sourceMappingURL=formatter.js.map

package/dist/formatter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatter.js","sourceRoot":"","sources":["../src/formatter.ts"],"names":[],"mappings":"AAAA,4DAA4D;AAC5D,sEAAsE;AA8BtE,0BAA0B;AAE1B;;;GAGG;AACH,MAAM,UAAU,UAAU,CAAC,IAAY;IACrC,OAAO,IAAI;SACR,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC;SACtB,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC;SACrB,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;AAC3B,CAAC;AAED,wBAAwB;AAExB,MAAM,UAAU,GAAsC;IACpD,IAAI,EAAE,cAAc,EAAK,cAAc;IACvC,OAAO,EAAE,cAAc,EAAE,UAAU;IACnC,KAAK,EAAE,QAAQ,EAAW,QAAQ;IAClC,OAAO,EAAE,QAAQ,EAAS,cAAc;CACzC,CAAC;AAEF,2CAA2C;AAE3C;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAAC,YAA0B;IAC3D,MAAM,IAAI,GAAG,UAAU,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC;IAC5C,MAAM,KAAK,GAAG,UAAU,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC;IAC7C,MAAM,IAAI,GAAG,UAAU,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;IAE3C,OAAO;QACL,GAAG,IAAI,OAAO,KAAK,MAAM;QACzB,EAAE;QACF,IAAI;KACL,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC;AAED,4CAA4C;AAE5C;;;GAGG;AACH,MAAM,UAAU,qBAAqB,CAAC,IAAyB;IAC7D,MAAM,SAAS,GAAG,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAC7C,MAAM,SAAS,GAAG,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAC7C,MAAM,MAAM,GAAG,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAEvC,OAAO;QACL,sCAAsC;QACtC,EAAE;QACF,MAAM,SAAS,uCAAuC,MAAM,SAAS;QACrE,MAAM,SAAS,MAAM;KACtB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,IAAiB;IAC7C,MAAM,OAAO,GAAG,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACzC,MAAM,QAAQ,GAAG,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC3C,MAAM,KAAK,GAAG,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAErC,OAAO;QACL,mCAAmC;QACnC,EAAE;QACF,MAAM,QAAQ,kBAAkB,KAAK,KAAK,OAAO,MAAM;KACxD,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAAC,IAAqB;IACrD,MAAM,SAAS,GAAG,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAC7C,MAAM,YAAY,GAAG,UAAU,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IAEnD,OAAO;QACL,4BAA4B;QAC5B,EAAE;QACF,MAAM,SAAS,4BAA4B;QAC3C,SAAS,YAAY,SAAS;KAC/B,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CAAC,IAAuB;IACzD,MAAM,SAAS,GAAG,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAC7C,MAAM,OAAO,GAAG,IAAI,CAAC,cAAc,CAAC;IAEpC,OAAO;QACL,mCAAmC;QACnC,EAAE;QACF,MAAM,SAAS,8BAA8B,OAAO,OAAO;KAC5D,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,38 @@
+import type { NotificationPlugin, Notification, PluginManifest, PluginContext, PluginHealth } from '@ouija-dev/types';
+import type { TelegramConfig } from './config.js';
+import { TelegramClient } from './telegram-client.js';
+export declare class TelegramNotifyPlugin implements NotificationPlugin<TelegramConfig> {
+    readonly manifest: PluginManifest;
+    private config;
+    private logger;
+    /** Exposed for testing — allows injecting a mock fetch into the underlying client. */
+    client: TelegramClient;
+    /**
+     * LRU-ish idempotency cache: idempotencyKey -> true.
+     * Prevents duplicate sends on retry within a single process lifetime.
+     */
+    private readonly sentCache;
+    init(context: PluginContext<TelegramConfig>): Promise<void>;
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    healthCheck(): Promise<PluginHealth>;
+    /**
+     * Send a notification to the configured Telegram chat.
+     * Idempotent on notification.idempotencyKey — duplicate calls are no-ops.
+     */
+    send(notification: Notification): Promise<void>;
+    /**
+     * Verify the bot token and channel reachability without sending a message.
+     * Calls getMe() which has no side effects.
+     */
+    testConnection(): Promise<{
+        ok: boolean;
+        message?: string;
+    }>;
+}
+export declare const PluginFactory: {
+    manifest: PluginManifest;
+    create: () => TelegramNotifyPlugin;
+};
+export default PluginFactory;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,kBAAkB,EAClB,YAAY,EACZ,cAAc,EACd,aAAa,EACb,YAAY,EACb,MAAM,kBAAkB,CAAC;AAE1B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAElD,OAAO,EAAE,cAAc,EAAoB,MAAM,sBAAsB,CAAC;AAUxE,qBAAa,oBAAqB,YAAW,kBAAkB,CAAC,cAAc,CAAC;IAC7E,QAAQ,CAAC,QAAQ,EAAE,cAAc,CAgB/B;IAEF,OAAO,CAAC,MAAM,CAAkB;IAChC,OAAO,CAAC,MAAM,CAA2B;IACzC,sFAAsF;IACtF,MAAM,EAAG,cAAc,CAAC;IAExB;;;OAGG;IACH,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA2B;IAE/C,IAAI,CAAC,OAAO,EAAE,aAAa,CAAC,cAAc,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAqB3D,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAatB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAKrB,WAAW,IAAI,OAAO,CAAC,YAAY,CAAC;IAkB1C;;;OAGG;IACG,IAAI,CAAC,YAAY,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAmCrD;;;OAGG;IACG,cAAc,IAAI,OAAO,CAAC;QAAE,EAAE,EAAE,OAAO,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAenE;AAID,eAAO,MAAM,aAAa;;kBAEZ,oBAAoB;CACjC,CAAC;AAEF,eAAe,aAAa,CAAC"}

package/dist/index.js

@@ -0,0 +1,151 @@
+// ---- Telegram Notification Plugin ----
+// Implements NotificationPlugin<TelegramConfig>.
+// Zero external SDK dependencies — raw fetch via TelegramClient.
+import { telegramConfigSchema } from './config.js';
+import { TelegramClient, TelegramApiError } from './telegram-client.js';
+import { formatNotification } from './formatter.js';
+import { buildInlineKeyboard } from './keyboard.js';
+// ---- Idempotency cache ----
+const SENT_CACHE_MAX = 1_000;
+// ---- Plugin implementation ----
+export class TelegramNotifyPlugin {
+    manifest = {
+        name: '@ouija-dev/plugin-notify-telegram',
+        version: '0.1.0',
+        type: 'notification',
+        coreApiVersion: '>=1.0.0 <2.0.0',
+        configSchema: telegramConfigSchema,
+        events: {
+            produces: [],
+            consumes: [
+                'notification.send',
+                'agent.work.completed',
+                'agent.work.failed',
+                'agent.work.pr_ready',
+                'agent.work.stalled',
+            ],
+        },
+    };
+    config;
+    logger;
+    /** Exposed for testing — allows injecting a mock fetch into the underlying client. */
+    client;
+    /**
+     * LRU-ish idempotency cache: idempotencyKey -> true.
+     * Prevents duplicate sends on retry within a single process lifetime.
+     */
+    sentCache = new Map();
+    async init(context) {
+        // Apply defaults for optional fields that may be absent in the raw config.
+        // Spread defaults first so caller-provided values always win.
+        const cfg = context.config;
+        this.config = {
+            parseMode: cfg.parseMode ?? 'HTML',
+            disableNotification: cfg.disableNotification ?? false,
+            dashboardBaseUrl: cfg.dashboardBaseUrl ?? 'http://localhost:4000',
+            botToken: cfg.botToken,
+            chatId: cfg.chatId,
+        };
+        this.logger = context.logger;
+        this.client = new TelegramClient(this.config.botToken);
+        this.logger.info('Telegram notification plugin initialised', {
+            chatId: this.config.chatId,
+            parseMode: this.config.parseMode,
+        });
+    }
+    async start() {
+        // Eagerly verify the bot token on startup so misconfiguration surfaces
+        // immediately rather than on the first notification attempt.
+        const result = await this.testConnection();
+        if (!result.ok) {
+            this.logger.warn('Telegram bot token verification failed at startup', {
+                message: result.message,
+            });
+        }
+        else {
+            this.logger.info('Telegram notification plugin started', { bot: result.message });
+        }
+    }
+    async stop() {
+        this.sentCache.clear();
+        this.logger.info('Telegram notification plugin stopped');
+    }
+    async healthCheck() {
+        try {
+            const result = await this.testConnection();
+            const health = { healthy: result.ok };
+            if (result.message !== undefined) {
+                health.message = result.message;
+            }
+            return health;
+        }
+        catch (err) {
+            return {
+                healthy: false,
+                message: `Health check failed: ${err instanceof Error ? err.message : String(err)}`,
+            };
+        }
+    }
+    // ---- NotificationPlugin ----
+    /**
+     * Send a notification to the configured Telegram chat.
+     * Idempotent on notification.idempotencyKey — duplicate calls are no-ops.
+     */
+    async send(notification) {
+        if (this.sentCache.has(notification.idempotencyKey)) {
+            this.logger.info('Duplicate notification skipped', {
+                idempotencyKey: notification.idempotencyKey,
+            });
+            return;
+        }
+        const text = formatNotification(notification);
+        const keyboard = buildInlineKeyboard(notification.actions);
+        const sendOpts = {
+            parseMode: this.config.parseMode,
+            disableNotification: this.config.disableNotification,
+        };
+        if (keyboard !== undefined) {
+            sendOpts.replyMarkup = keyboard;
+        }
+        await this.client.sendMessage(this.config.chatId, text, sendOpts);
+        // Track sent — evict oldest entry when cache is full to bound memory usage.
+        if (this.sentCache.size >= SENT_CACHE_MAX) {
+            const firstKey = this.sentCache.keys().next().value;
+            if (firstKey !== undefined)
+                this.sentCache.delete(firstKey);
+        }
+        this.sentCache.set(notification.idempotencyKey, true);
+        this.logger.info('Notification sent', {
+            title: notification.title,
+            level: notification.level,
+            idempotencyKey: notification.idempotencyKey,
+        });
+    }
+    /**
+     * Verify the bot token and channel reachability without sending a message.
+     * Calls getMe() which has no side effects.
+     */
+    async testConnection() {
+        try {
+            const user = await this.client.getMe();
+            const botName = user.username !== undefined ? `@${user.username}` : user.first_name;
+            return { ok: true, message: `Connected as ${botName}` };
+        }
+        catch (err) {
+            if (err instanceof TelegramApiError) {
+                return { ok: false, message: err.description ?? err.message };
+            }
+            return {
+                ok: false,
+                message: `Connection failed: ${err instanceof Error ? err.message : String(err)}`,
+            };
+        }
+    }
+}
+// ---- Plugin factory (consumed by PluginLoader) ----
+export const PluginFactory = {
+    manifest: new TelegramNotifyPlugin().manifest,
+    create: () => new TelegramNotifyPlugin(),
+};
+export default PluginFactory;
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/keyboard.d.ts

@@ -0,0 +1,11 @@
+import type { NotificationAction } from '@ouija-dev/types';
+import type { TelegramInlineKeyboard, TelegramInlineButton } from './telegram-client.js';
+export type { TelegramInlineKeyboard, TelegramInlineButton };
+/**
+ * Build a Telegram inline keyboard from Notification actions.
+ * Each action becomes a single-button row (max 3 rows for mobile readability).
+ *
+ * Returns undefined when there are no actions — caller omits reply_markup.
+ */
+export declare function buildInlineKeyboard(actions: NotificationAction[] | undefined): TelegramInlineKeyboard | undefined;
+//# sourceMappingURL=keyboard.d.ts.map

package/dist/keyboard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"keyboard.d.ts","sourceRoot":"","sources":["../src/keyboard.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAC3D,OAAO,KAAK,EAAE,sBAAsB,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAEzF,YAAY,EAAE,sBAAsB,EAAE,oBAAoB,EAAE,CAAC;AAE7D;;;;;GAKG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,kBAAkB,EAAE,GAAG,SAAS,GACxC,sBAAsB,GAAG,SAAS,CASpC"}

package/dist/keyboard.js

@@ -0,0 +1,17 @@
+// ---- Inline keyboard builder for Telegram notifications ----
+/**
+ * Build a Telegram inline keyboard from Notification actions.
+ * Each action becomes a single-button row (max 3 rows for mobile readability).
+ *
+ * Returns undefined when there are no actions — caller omits reply_markup.
+ */
+export function buildInlineKeyboard(actions) {
+    if (actions === undefined || actions.length === 0)
+        return undefined;
+    // Cap at 3 rows to keep the message mobile-friendly
+    const rows = actions.slice(0, 3).map((action) => [
+        { text: action.label, url: action.url },
+    ]);
+    return { inline_keyboard: rows };
+}
+//# sourceMappingURL=keyboard.js.map

package/dist/keyboard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"keyboard.js","sourceRoot":"","sources":["../src/keyboard.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAO/D;;;;;GAKG;AACH,MAAM,UAAU,mBAAmB,CACjC,OAAyC;IAEzC,IAAI,OAAO,KAAK,SAAS,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IAEpE,oDAAoD;IACpD,MAAM,IAAI,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,MAAM,EAA0B,EAAE,CAAC;QACvE,EAAE,IAAI,EAAE,MAAM,CAAC,KAAK,EAAE,GAAG,EAAE,MAAM,CAAC,GAAG,EAAE;KACxC,CAAC,CAAC;IAEH,OAAO,EAAE,eAAe,EAAE,IAAI,EAAE,CAAC;AACnC,CAAC"}

package/dist/telegram-client.d.ts

@@ -0,0 +1,67 @@
+export interface TelegramResponse<T = unknown> {
+    ok: boolean;
+    result?: T;
+    description?: string;
+    error_code?: number;
+}
+export interface TelegramUser {
+    id: number;
+    is_bot: boolean;
+    first_name: string;
+    username?: string;
+}
+export interface TelegramMessage {
+    message_id: number;
+    date: number;
+    text?: string;
+}
+export interface TelegramInlineButton {
+    text: string;
+    url: string;
+}
+export interface TelegramInlineKeyboard {
+    inline_keyboard: TelegramInlineButton[][];
+}
+export interface SendMessageOptions {
+    parseMode?: 'HTML' | 'MarkdownV2';
+    disableNotification?: boolean;
+    replyMarkup?: TelegramInlineKeyboard;
+}
+export declare class TelegramApiError extends Error {
+    readonly errorCode?: number | undefined;
+    readonly description?: string | undefined;
+    constructor(message: string, errorCode?: number | undefined, description?: string | undefined);
+}
+export declare class TelegramRateLimitError extends TelegramApiError {
+    readonly retryAfterMs: number;
+    constructor(retryAfterMs: number);
+}
+export declare class TelegramClient {
+    private readonly botToken;
+    private readonly baseUrl;
+    private lastSendTimes;
+    /** Override for testing — allows injecting a mock fetch. */
+    _fetchFn: typeof fetch;
+    constructor(botToken: string);
+    /**
+     * Call a Telegram Bot API method.
+     * Handles 429 rate limit errors and surfaces typed errors.
+     */
+    private call;
+    /**
+     * Send a text message to a chat.
+     * Enforces per-chat rate limiting (30 msg/sec).
+     */
+    sendMessage(chatId: string, text: string, options?: SendMessageOptions): Promise<TelegramMessage>;
+    /**
+     * Call getMe to verify the bot token and retrieve bot info.
+     * Used as a health check — no side effects.
+     */
+    getMe(): Promise<TelegramUser>;
+    /**
+     * Enforce per-chat rate limit: >= MIN_INTERVAL_MS between sends.
+     * Sleeps only the remaining time if a send happened recently.
+     */
+    private enforceRateLimit;
+}
+//# sourceMappingURL=telegram-client.d.ts.map

package/dist/telegram-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"telegram-client.d.ts","sourceRoot":"","sources":["../src/telegram-client.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,gBAAgB,CAAC,CAAC,GAAG,OAAO;IAC3C,EAAE,EAAE,OAAO,CAAC;IACZ,MAAM,CAAC,EAAE,CAAC,CAAC;IACX,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,OAAO,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,eAAe;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,sBAAsB;IACrC,eAAe,EAAE,oBAAoB,EAAE,EAAE,CAAC;CAC3C;AAED,MAAM,WAAW,kBAAkB;IACjC,SAAS,CAAC,EAAE,MAAM,GAAG,YAAY,CAAC;IAClC,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,WAAW,CAAC,EAAE,sBAAsB,CAAC;CACtC;AAWD,qBAAa,gBAAiB,SAAQ,KAAK;aAGvB,SAAS,CAAC,EAAE,MAAM;aAClB,WAAW,CAAC,EAAE,MAAM;gBAFpC,OAAO,EAAE,MAAM,EACC,SAAS,CAAC,EAAE,MAAM,YAAA,EAClB,WAAW,CAAC,EAAE,MAAM,YAAA;CAKvC;AAED,qBAAa,sBAAuB,SAAQ,gBAAgB;aAExC,YAAY,EAAE,MAAM;gBAApB,YAAY,EAAE,MAAM;CAKvC;AAID,qBAAa,cAAc;IAOb,OAAO,CAAC,QAAQ,CAAC,QAAQ;IANrC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,aAAa,CAA6B;IAElD,4DAA4D;IAC5D,QAAQ,EAAE,OAAO,KAAK,CAAqC;gBAE9B,QAAQ,EAAE,MAAM;IAI7C;;;OAGG;YACW,IAAI;IAoClB;;;OAGG;IACG,WAAW,CACf,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,kBAAkB,GAC3B,OAAO,CAAC,eAAe,CAAC;IAyB3B;;;OAGG;IACG,KAAK,IAAI,OAAO,CAAC,YAAY,CAAC;IAIpC;;;OAGG;YACW,gBAAgB;CAS/B"}

package/dist/telegram-client.js

@@ -0,0 +1,113 @@
+// ---- Raw Telegram Bot API client ----
+// No SDK dependency. Uses global fetch (Node 18+).
+// ---- Rate limiting ----
+// Telegram allows 30 messages/second to the same chat.
+// We enforce a minimum 34ms gap between sends to the same chat to stay safely
+// within that limit, and add a short sleep when we receive a 429.
+const MIN_INTERVAL_MS = 34; // ~29 msg/sec, comfortably under the 30/sec limit
+// ---- Error classes ----
+export class TelegramApiError extends Error {
+    errorCode;
+    description;
+    constructor(message, errorCode, description) {
+        super(message);
+        this.errorCode = errorCode;
+        this.description = description;
+        this.name = 'TelegramApiError';
+    }
+}
+export class TelegramRateLimitError extends TelegramApiError {
+    retryAfterMs;
+    constructor(retryAfterMs) {
+        super(`Rate limited — retry after ${retryAfterMs}ms`, 429, 'Too Many Requests');
+        this.retryAfterMs = retryAfterMs;
+        this.name = 'TelegramRateLimitError';
+    }
+}
+// ---- Client ----
+export class TelegramClient {
+    botToken;
+    baseUrl;
+    lastSendTimes = new Map();
+    /** Override for testing — allows injecting a mock fetch. */
+    _fetchFn = globalThis.fetch.bind(globalThis);
+    constructor(botToken) {
+        this.botToken = botToken;
+        this.baseUrl = `https://api.telegram.org/bot${botToken}`;
+    }
+    /**
+     * Call a Telegram Bot API method.
+     * Handles 429 rate limit errors and surfaces typed errors.
+     */
+    async call(method, body) {
+        const url = `${this.baseUrl}/${method}`;
+        // Build RequestInit carefully to satisfy exactOptionalPropertyTypes — no
+        // undefined values in the object literal where the type expects absence.
+        const init = body !== undefined
+            ? {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json' },
+                body: JSON.stringify(body),
+            }
+            : { method: 'GET' };
+        const response = await this._fetchFn(url, init);
+        // Handle Telegram's 429 before parsing JSON — it always includes Retry-After
+        if (response.status === 429) {
+            const retryAfterSec = parseInt(response.headers.get('Retry-After') ?? '1', 10);
+            const retryAfterMs = retryAfterSec * 1000;
+            throw new TelegramRateLimitError(retryAfterMs);
+        }
+        const result = (await response.json());
+        if (!result.ok) {
+            throw new TelegramApiError(`Telegram API error [${method}]: ${result.description ?? 'Unknown error'}`, result.error_code, result.description);
+        }
+        return result.result;
+    }
+    /**
+     * Send a text message to a chat.
+     * Enforces per-chat rate limiting (30 msg/sec).
+     */
+    async sendMessage(chatId, text, options) {
+        await this.enforceRateLimit(chatId);
+        const body = {
+            chat_id: chatId,
+            text,
+        };
+        if (options?.parseMode !== undefined) {
+            body['parse_mode'] = options.parseMode;
+        }
+        if (options?.disableNotification === true) {
+            body['disable_notification'] = true;
+        }
+        if (options?.replyMarkup !== undefined) {
+            body['reply_markup'] = JSON.stringify(options.replyMarkup);
+        }
+        const message = await this.call('sendMessage', body);
+        this.lastSendTimes.set(chatId, Date.now());
+        return message;
+    }
+    /**
+     * Call getMe to verify the bot token and retrieve bot info.
+     * Used as a health check — no side effects.
+     */
+    async getMe() {
+        return this.call('getMe');
+    }
+    /**
+     * Enforce per-chat rate limit: >= MIN_INTERVAL_MS between sends.
+     * Sleeps only the remaining time if a send happened recently.
+     */
+    async enforceRateLimit(chatId) {
+        const last = this.lastSendTimes.get(chatId);
+        if (last !== undefined) {
+            const elapsed = Date.now() - last;
+            if (elapsed < MIN_INTERVAL_MS) {
+                await sleep(MIN_INTERVAL_MS - elapsed);
+            }
+        }
+    }
+}
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+//# sourceMappingURL=telegram-client.js.map

package/dist/telegram-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"telegram-client.js","sourceRoot":"","sources":["../src/telegram-client.ts"],"names":[],"mappings":"AAAA,wCAAwC;AACxC,mDAAmD;AAuCnD,0BAA0B;AAC1B,uDAAuD;AACvD,8EAA8E;AAC9E,kEAAkE;AAElE,MAAM,eAAe,GAAG,EAAE,CAAC,CAAC,kDAAkD;AAE9E,0BAA0B;AAE1B,MAAM,OAAO,gBAAiB,SAAQ,KAAK;IAGvB;IACA;IAHlB,YACE,OAAe,EACC,SAAkB,EAClB,WAAoB;QAEpC,KAAK,CAAC,OAAO,CAAC,CAAC;QAHC,cAAS,GAAT,SAAS,CAAS;QAClB,gBAAW,GAAX,WAAW,CAAS;QAGpC,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC;IACjC,CAAC;CACF;AAED,MAAM,OAAO,sBAAuB,SAAQ,gBAAgB;IAExC;IADlB,YACkB,YAAoB;QAEpC,KAAK,CAAC,8BAA8B,YAAY,IAAI,EAAE,GAAG,EAAE,mBAAmB,CAAC,CAAC;QAFhE,iBAAY,GAAZ,YAAY,CAAQ;QAGpC,IAAI,CAAC,IAAI,GAAG,wBAAwB,CAAC;IACvC,CAAC;CACF;AAED,mBAAmB;AAEnB,MAAM,OAAO,cAAc;IAOI;IANZ,OAAO,CAAS;IACzB,aAAa,GAAG,IAAI,GAAG,EAAkB,CAAC;IAElD,4DAA4D;IAC5D,QAAQ,GAAiB,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IAE3D,YAA6B,QAAgB;QAAhB,aAAQ,GAAR,QAAQ,CAAQ;QAC3C,IAAI,CAAC,OAAO,GAAG,+BAA+B,QAAQ,EAAE,CAAC;IAC3D,CAAC;IAED;;;OAGG;IACK,KAAK,CAAC,IAAI,CAAI,MAAc,EAAE,IAA8B;QAClE,MAAM,GAAG,GAAG,GAAG,IAAI,CAAC,OAAO,IAAI,MAAM,EAAE,CAAC;QAExC,yEAAyE;QACzE,yEAAyE;QACzE,MAAM,IAAI,GACR,IAAI,KAAK,SAAS;YAChB,CAAC,CAAC;gBACE,MAAM,EAAE,MAAM;gBACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;gBAC/C,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;aAC3B;YACH,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;QAExB,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QAEhD,6EAA6E;QAC7E,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;YAC5B,MAAM,aAAa,GAAG,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,IAAI,GAAG,EAAE,EAAE,CAAC,CAAC;YAC/E,MAAM,YAAY,GAAG,aAAa,GAAG,IAAI,CAAC;YAC1C,MAAM,IAAI,sBAAsB,CAAC,YAAY,CAAC,CAAC;QACjD,CAAC;QAED,MAAM,MAAM,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAwB,CAAC;QAE9D,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC;YACf,MAAM,IAAI,gBAAgB,CACxB,uBAAuB,MAAM,MAAM,MAAM,CAAC,WAAW,IAAI,eAAe,EAAE,EAC1E,MAAM,CAAC,UAAU,EACjB,MAAM,CAAC,WAAW,CACnB,CAAC;QACJ,CAAC;QAED,OAAO,MAAM,CAAC,MAAW,CAAC;IAC5B,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,WAAW,CACf,MAAc,EACd,IAAY,EACZ,OAA4B;QAE5B,MAAM,IAAI,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAC;QAEpC,MAAM,IAAI,GAA4B;YACpC,OAAO,EAAE,MAAM;YACf,IAAI;SACL,CAAC;QAEF,IAAI,OAAO,EAAE,SAAS,KAAK,SAAS,EAAE,CAAC;YACrC,IAAI,CAAC,YAAY,CAAC,GAAG,OAAO,CAAC,SAAS,CAAC;QACzC,CAAC;QAED,IAAI,OAAO,EAAE,mBAAmB,KAAK,IAAI,EAAE,CAAC;YAC1C,IAAI,CAAC,sBAAsB,CAAC,GAAG,IAAI,CAAC;QACtC,CAAC;QAED,IAAI,OAAO,EAAE,WAAW,KAAK,SAAS,EAAE,CAAC;YACvC,IAAI,CAAC,cAAc,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;QAC7D,CAAC;QAED,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,IAAI,CAAkB,aAAa,EAAE,IAAI,CAAC,CAAC;QACtE,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;QAC3C,OAAO,OAAO,CAAC;IACjB,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,KAAK;QACT,OAAO,IAAI,CAAC,IAAI,CAAe,OAAO,CAAC,CAAC;IAC1C,CAAC;IAED;;;OAGG;IACK,KAAK,CAAC,gBAAgB,CAAC,MAAc;QAC3C,MAAM,IAAI,GAAG,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAC5C,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;YACvB,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC;YAClC,IAAI,OAAO,GAAG,eAAe,EAAE,CAAC;gBAC9B,MAAM,KAAK,CAAC,eAAe,GAAG,OAAO,CAAC,CAAC;YACzC,CAAC;QACH,CAAC;IACH,CAAC;CACF;AAED,SAAS,KAAK,CAAC,EAAU;IACvB,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;AAC3D,CAAC"}

package/package.json

@@ -0,0 +1,23 @@
+{
+  "name": "@ouija-dev/plugin-notify-telegram",
+  "version": "0.1.0",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": ["dist/", "README.md"],
+  "publishConfig": { "access": "public" },
+  "repository": { "type": "git", "url": "https://github.com/muhammadkh4n/ouija.git" },
+  "scripts": {
+    "build": "tsc",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit"
+  },
+  "dependencies": {
+    "@ouija-dev/types": "*",
+    "@ouija-dev/plugin-sdk": "*"
+  },
+  "devDependencies": {
+    "typescript": "^5.5.0",
+    "vitest": "^3.0.0"
+  }
+}