pi-harness-runtime 1.1.147 → 1.1.148

package/packages/notification/dist/adapters/telegram-adapter.js

@@ -0,0 +1,251 @@
+/**
+ * Telegram Adapter — RFC-0022
+ *
+ * Sends notifications via Telegram Bot API.
+ */
+import { BaseChannelAdapter } from "../base-adapter.js";
+export class TelegramAdapter extends BaseChannelAdapter {
+    id = "telegram";
+    type = "telegram";
+    _botUsername;
+    _callbackHandler;
+    _webhookSecret;
+    constructor(config) {
+        super({ id: "telegram", type: "telegram", enabled: true, config });
+    }
+    /**
+     * Register a callback handler for inline keyboard button clicks
+     */
+    setCallbackHandler(handler) {
+        this._callbackHandler = handler;
+    }
+    /**
+     * Set webhook secret for verification
+     */
+    setWebhookSecret(secret) {
+        this._webhookSecret = secret;
+    }
+    get botUsername() {
+        return this._botUsername;
+    }
+    async initialize() {
+        try {
+            const cfg = this.config.config;
+            const response = await fetch(`https://api.telegram.org/bot${cfg.botToken}/getMe`);
+            if (!response.ok)
+                return false;
+            const data = (await response.json());
+            if (data.ok && data.result?.username) {
+                this._botUsername = data.result.username;
+            }
+            return data.ok;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Send a message with optional inline keyboard buttons
+     */
+    async send(payload) {
+        try {
+            const cfg = this.config.config;
+            const message = this.formatMessage(payload);
+            // Build request body
+            const body = {
+                chat_id: cfg.chatId,
+                text: message,
+                parse_mode: cfg.parseMode ?? "MarkdownV2",
+            };
+            // Add inline keyboard if enabled and buttons are configured
+            if (cfg.enableInlineKeyboard && (cfg.actionButtons?.length ?? 0) > 0) {
+                body.reply_markup = this.buildInlineKeyboard(cfg.actionButtons);
+            }
+            const response = await fetch(`https://api.telegram.org/bot${cfg.botToken}/sendMessage`, {
+                method: "POST",
+                headers: { "Content-Type": "application/json" },
+                body: JSON.stringify(body),
+            });
+            if (!response.ok) {
+                const error = await response.text();
+                return {
+                    success: false,
+                    channel: this.id,
+                    error: `Telegram API error: ${error}`,
+                };
+            }
+            return { success: true, channel: this.id };
+        }
+        catch (error) {
+            return {
+                success: false,
+                channel: this.id,
+                error: String(error),
+            };
+        }
+    }
+    /**
+     * Build inline keyboard markup from button configuration
+     */
+    buildInlineKeyboard(buttons) {
+        // Group buttons into rows of up to 3 buttons each (Telegram limit)
+        const ROW_SIZE = 3;
+        const rows = [];
+        for (let i = 0; i < buttons.length; i += ROW_SIZE) {
+            const row = buttons.slice(i, i + ROW_SIZE).map((btn) => ({
+                text: btn.text,
+                ...(btn.url ? { url: btn.url } : { callback_data: btn.callbackData }),
+            }));
+            rows.push(row);
+        }
+        return { inline_keyboard: rows };
+    }
+    /**
+     * Process incoming webhook update from Telegram
+     */
+    async handleWebhookUpdate(update) {
+        // Verify secret token if set
+        if (this._webhookSecret) {
+            const secretToken = update.secret_token;
+            if (secretToken !== this._webhookSecret) {
+                console.error("[TelegramAdapter] Invalid webhook secret");
+                return;
+            }
+        }
+        // Handle callback query (button click)
+        const callbackQuery = update.callback_query;
+        if (callbackQuery && this._callbackHandler) {
+            const query = this.parseCallbackQuery(callbackQuery);
+            if (query) {
+                await this._callbackHandler(query.data, query);
+                await this.answerCallbackQuery(query.id);
+            }
+        }
+        // Handle regular messages (future: user can type commands)
+        const message = update.message;
+        if (message) {
+            console.log("[TelegramAdapter] Received message:", message.text);
+        }
+    }
+    /**
+     * Parse callback query from webhook update
+     */
+    parseCallbackQuery(raw) {
+        try {
+            const from = raw.from;
+            const message = raw.message;
+            const chat = message?.chat;
+            return {
+                id: String(raw.id),
+                from: {
+                    id: Number(from?.id),
+                    is_bot: Boolean(from?.is_bot),
+                    first_name: String(from?.first_name ?? ""),
+                    username: from?.username ? String(from.username) : undefined,
+                },
+                chat_instance: String(raw.chat_instance ?? ""),
+                data: String(raw.data ?? ""),
+                message: message
+                    ? {
+                        chat: { id: Number(chat?.id) },
+                        message_id: Number(message?.message_id),
+                    }
+                    : undefined,
+            };
+        }
+        catch {
+            console.error("[TelegramAdapter] Failed to parse callback query");
+            return null;
+        }
+    }
+    /**
+     * Answer a callback query to remove loading state
+     */
+    async answerCallbackQuery(callbackQueryId) {
+        try {
+            const cfg = this.config.config;
+            await fetch(`https://api.telegram.org/bot${cfg.botToken}/answerCallbackQuery`, {
+                method: "POST",
+                headers: { "Content-Type": "application/json" },
+                body: JSON.stringify({ callback_query_id: callbackQueryId }),
+            });
+        }
+        catch (error) {
+            console.error("[TelegramAdapter] Failed to answer callback query:", error);
+        }
+    }
+    /**
+     * Setup webhook for receiving updates
+     */
+    async setupWebhook(webhookUrl) {
+        try {
+            const cfg = this.config.config;
+            const response = await fetch(`https://api.telegram.org/bot${cfg.botToken}/setWebhook`, {
+                method: "POST",
+                headers: { "Content-Type": "application/json" },
+                body: JSON.stringify({
+                    url: webhookUrl,
+                    secret_token: this._webhookSecret,
+                }),
+            });
+            if (!response.ok) {
+                console.error("[TelegramAdapter] Webhook setup failed:", await response.text());
+                return false;
+            }
+            console.log(`[TelegramAdapter] Webhook set to: ${webhookUrl}`);
+            return true;
+        }
+        catch (error) {
+            console.error("[TelegramAdapter] Webhook setup error:", error);
+            return false;
+        }
+    }
+    /**
+     * Get current webhook info
+     */
+    async getWebhookInfo() {
+        try {
+            const cfg = this.config.config;
+            const response = await fetch(`https://api.telegram.org/bot${cfg.botToken}/getWebhookInfo`);
+            if (!response.ok)
+                return null;
+            return (await response.json());
+        }
+        catch {
+            return null;
+        }
+    }
+    formatMessage(payload) {
+        const emoji = this.getEmoji(payload.event);
+        const title = `${emoji} ${payload.title}`;
+        const lines = [title, "", payload.message];
+        if (payload.details?.taskTitle) {
+            lines.push("", `Task: ${payload.details.taskTitle}`);
+        }
+        if (payload.details?.jobId) {
+            lines.push(`Job: ${payload.details.jobId}`);
+        }
+        if (payload.details?.error) {
+            lines.push("", `Error: ${payload.details.error}`);
+        }
+        return lines.filter(Boolean).join("\n");
+    }
+    getEmoji(event) {
+        const map = {
+            JobStarted: "🚀",
+            TaskCompleted: "✅",
+            TaskFailed: "❌",
+            QuotaPaused: "⏸️",
+            ResumeScheduled: "▶️",
+            ContextCompacted: "📦",
+            OutputLimitContinued: "🔄",
+            E2EFailed: "🧪",
+            HumanReviewNeeded: "👤",
+            ReadyForClient: "🎉",
+            JobCancelled: "🚫",
+            Error: "⚠️",
+        };
+        return map[event] ?? "📢";
+    }
+}
+//# sourceMappingURL=telegram-adapter.js.map

package/packages/notification/dist/adapters/telegram-adapter.js.map

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

package/packages/notification/dist/adapters/webhook-adapter.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Webhook Adapter — RFC-0022
+ *
+ * Sends notifications to a generic webhook endpoint.
+ */
+import type { NotificationPayload, NotificationResult, WebhookConfig } from "../types.js";
+import { BaseChannelAdapter } from "../base-adapter.js";
+export declare class WebhookAdapter extends BaseChannelAdapter {
+    readonly id = "webhook";
+    readonly type = "webhook";
+    constructor(config: WebhookConfig);
+    initialize(): Promise<boolean>;
+    send(payload: NotificationPayload): Promise<NotificationResult>;
+}
+//# sourceMappingURL=webhook-adapter.d.ts.map

package/packages/notification/dist/adapters/webhook-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"webhook-adapter.d.ts","sourceRoot":"","sources":["../../src/adapters/webhook-adapter.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EACX,mBAAmB,EACnB,kBAAkB,EAClB,aAAa,EACb,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAExD,qBAAa,cAAe,SAAQ,kBAAkB;IACrD,QAAQ,CAAC,EAAE,aAAa;IACxB,QAAQ,CAAC,IAAI,aAAa;IAE1B,YAAY,MAAM,EAAE,aAAa,EAEhC;IAEK,UAAU,IAAI,OAAO,CAAC,OAAO,CAAC,CAOnC;IAEK,IAAI,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CA2CpE;CACD"}

package/packages/notification/dist/adapters/webhook-adapter.js

@@ -0,0 +1,64 @@
+/**
+ * Webhook Adapter — RFC-0022
+ *
+ * Sends notifications to a generic webhook endpoint.
+ */
+import { BaseChannelAdapter } from "../base-adapter.js";
+export class WebhookAdapter extends BaseChannelAdapter {
+    id = "webhook";
+    type = "webhook";
+    constructor(config) {
+        super({ id: "webhook", type: "webhook", enabled: true, config });
+    }
+    async initialize() {
+        try {
+            const cfg = this.config.config;
+            return Boolean(cfg.url && cfg.url.startsWith("http"));
+        }
+        catch {
+            return false;
+        }
+    }
+    async send(payload) {
+        try {
+            const cfg = this.config.config;
+            const headers = {
+                "Content-Type": "application/json",
+                ...(cfg.headers ?? {}),
+            };
+            // Add auth token if configured
+            if (cfg.authToken) {
+                headers["Authorization"] = `Bearer ${cfg.authToken}`;
+            }
+            const response = await fetch(cfg.url, {
+                method: cfg.method ?? "POST",
+                headers,
+                body: JSON.stringify({
+                    event: payload.event,
+                    jobId: payload.jobId,
+                    timestamp: payload.timestamp,
+                    title: payload.title,
+                    message: payload.message,
+                    details: payload.details,
+                }),
+            });
+            if (!response.ok) {
+                const error = await response.text();
+                return {
+                    success: false,
+                    channel: this.id,
+                    error: `Webhook error ${response.status}: ${error}`,
+                };
+            }
+            return { success: true, channel: this.id };
+        }
+        catch (error) {
+            return {
+                success: false,
+                channel: this.id,
+                error: String(error),
+            };
+        }
+    }
+}
+//# sourceMappingURL=webhook-adapter.js.map

package/packages/notification/dist/adapters/webhook-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"webhook-adapter.js","sourceRoot":"","sources":["../../src/adapters/webhook-adapter.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAOH,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAExD,MAAM,OAAO,cAAe,SAAQ,kBAAkB;IAC5C,EAAE,GAAG,SAAS,CAAC;IACf,IAAI,GAAG,SAAS,CAAC;IAE1B,YAAY,MAAqB;QAChC,KAAK,CAAC,EAAE,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;IAClE,CAAC;IAED,KAAK,CAAC,UAAU;QACf,IAAI,CAAC;YACJ,MAAM,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC,MAAuB,CAAC;YAChD,OAAO,OAAO,CAAC,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC;QACvD,CAAC;QAAC,MAAM,CAAC;YACR,OAAO,KAAK,CAAC;QACd,CAAC;IACF,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,OAA4B;QACtC,IAAI,CAAC;YACJ,MAAM,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC,MAAuB,CAAC;YAChD,MAAM,OAAO,GAA2B;gBACvC,cAAc,EAAE,kBAAkB;gBAClC,GAAG,CAAC,GAAG,CAAC,OAAO,IAAI,EAAE,CAAC;aACtB,CAAC;YAEF,+BAA+B;YAC/B,IAAI,GAAG,CAAC,SAAS,EAAE,CAAC;gBACnB,OAAO,CAAC,eAAe,CAAC,GAAG,UAAU,GAAG,CAAC,SAAS,EAAE,CAAC;YACtD,CAAC;YAED,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE;gBACrC,MAAM,EAAE,GAAG,CAAC,MAAM,IAAI,MAAM;gBAC5B,OAAO;gBACP,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;oBACpB,KAAK,EAAE,OAAO,CAAC,KAAK;oBACpB,KAAK,EAAE,OAAO,CAAC,KAAK;oBACpB,SAAS,EAAE,OAAO,CAAC,SAAS;oBAC5B,KAAK,EAAE,OAAO,CAAC,KAAK;oBACpB,OAAO,EAAE,OAAO,CAAC,OAAO;oBACxB,OAAO,EAAE,OAAO,CAAC,OAAO;iBACxB,CAAC;aACF,CAAC,CAAC;YAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;gBAClB,MAAM,KAAK,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;gBACpC,OAAO;oBACN,OAAO,EAAE,KAAK;oBACd,OAAO,EAAE,IAAI,CAAC,EAAE;oBAChB,KAAK,EAAE,iBAAiB,QAAQ,CAAC,MAAM,KAAK,KAAK,EAAE;iBACnD,CAAC;YACH,CAAC;YAED,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC;QAC5C,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YAChB,OAAO;gBACN,OAAO,EAAE,KAAK;gBACd,OAAO,EAAE,IAAI,CAAC,EAAE;gBAChB,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC;aACpB,CAAC;QACH,CAAC;IACF,CAAC;CACD"}

package/packages/notification/dist/base-adapter.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Notification Base Adapter — RFC-0022
+ *
+ * Abstract base class for all notification channel adapters.
+ */
+import type { NotificationPayload, NotificationChannelConfig, NotificationResult } from "./types.js";
+export interface ChannelAdapter {
+    readonly id: string;
+    readonly type: string;
+    /**
+     * Initialize the adapter (e.g., verify credentials)
+     */
+    initialize(): Promise<boolean>;
+    /**
+     * Send a notification
+     */
+    send(payload: NotificationPayload): Promise<NotificationResult>;
+    /**
+     * Check if the adapter is properly configured
+     */
+    isConfigured(): boolean;
+}
+export declare abstract class BaseChannelAdapter implements ChannelAdapter {
+    protected config: NotificationChannelConfig;
+    abstract readonly id: string;
+    abstract readonly type: string;
+    constructor(config: NotificationChannelConfig);
+    abstract initialize(): Promise<boolean>;
+    abstract send(payload: NotificationPayload): Promise<NotificationResult>;
+    isConfigured(): boolean;
+    /**
+     * Redact sensitive data from payload before sending
+     */
+    protected redact(payload: NotificationPayload, patterns: RegExp[]): NotificationPayload;
+}
+//# sourceMappingURL=base-adapter.d.ts.map

package/packages/notification/dist/base-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-adapter.d.ts","sourceRoot":"","sources":["../src/base-adapter.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EACX,mBAAmB,EACnB,yBAAyB,EACzB,kBAAkB,EAClB,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,cAAc;IAC9B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB;;OAEG;IACH,UAAU,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IAE/B;;OAEG;IACH,IAAI,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC;IAEhE;;OAEG;IACH,YAAY,IAAI,OAAO,CAAC;CACxB;AAED,8BAAsB,kBAAmB,YAAW,cAAc;IAIrD,SAAS,CAAC,MAAM,EAAE,yBAAyB;IAHvD,QAAQ,CAAC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAE/B,YAAsB,MAAM,EAAE,yBAAyB,EAAI;IAE3D,QAAQ,CAAC,UAAU,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IACxC,QAAQ,CAAC,IAAI,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC;IAEzE,YAAY,IAAI,OAAO,CAEtB;IAED;;OAEG;IACH,SAAS,CAAC,MAAM,CACf,OAAO,EAAE,mBAAmB,EAC5B,QAAQ,EAAE,MAAM,EAAE,GAChB,mBAAmB,CAsBrB;CACD"}

package/packages/notification/dist/base-adapter.js

@@ -0,0 +1,39 @@
+/**
+ * Notification Base Adapter — RFC-0022
+ *
+ * Abstract base class for all notification channel adapters.
+ */
+export class BaseChannelAdapter {
+    config;
+    constructor(config) {
+        this.config = config;
+    }
+    isConfigured() {
+        return this.config.enabled;
+    }
+    /**
+     * Redact sensitive data from payload before sending
+     */
+    redact(payload, patterns) {
+        if (patterns.length === 0)
+            return payload;
+        const redacted = [];
+        const details = payload.details ? { ...payload.details } : {};
+        for (const [key, value] of Object.entries(details)) {
+            const valStr = String(value);
+            for (const pattern of patterns) {
+                if (pattern.test(valStr)) {
+                    redacted.push(key);
+                    details[key] = "[REDACTED]";
+                    break;
+                }
+            }
+        }
+        return {
+            ...payload,
+            details,
+            redacted: redacted.length > 0 ? redacted : undefined,
+        };
+    }
+}
+//# sourceMappingURL=base-adapter.js.map

package/packages/notification/dist/base-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-adapter.js","sourceRoot":"","sources":["../src/base-adapter.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AA4BH,MAAM,OAAgB,kBAAkB;IAIjB,MAAM;IAA5B,YAAsB,MAAiC;sBAAjC,MAAM;IAA8B,CAAC;IAK3D,YAAY;QACX,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC;IAC5B,CAAC;IAED;;OAEG;IACO,MAAM,CACf,OAA4B,EAC5B,QAAkB;QAElB,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,OAAO,CAAC;QAE1C,MAAM,QAAQ,GAAa,EAAE,CAAC;QAC9B,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAE9D,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;YACpD,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;YAC7B,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;gBAChC,IAAI,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;oBAC1B,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;oBAClB,OAAmC,CAAC,GAAG,CAAC,GAAG,YAAY,CAAC;oBACzD,MAAM;gBACP,CAAC;YACF,CAAC;QACF,CAAC;QAED,OAAO;YACN,GAAG,OAAO;YACV,OAAO;YACP,QAAQ,EAAE,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS;SACpD,CAAC;IACH,CAAC;CACD"}

package/packages/notification/dist/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Notification Center (RFC-0029)
+ *
+ * Unified notification system for the harness runtime.
+ */
+export * from "./notification-center.js";
+export * from "./base-adapter.js";
+export * from "./types.js";
+export * from "./telegram-webhook-handler.js";
+export { LineAdapter } from "./adapters/line-adapter.js";
+export { TelegramAdapter } from "./adapters/telegram-adapter.js";
+//# sourceMappingURL=index.d.ts.map

package/packages/notification/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,0BAA0B,CAAC;AACzC,cAAc,mBAAmB,CAAC;AAClC,cAAc,YAAY,CAAC;AAC3B,cAAc,+BAA+B,CAAC;AAC9C,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AACzD,OAAO,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC"}

package/packages/notification/dist/index.js

@@ -0,0 +1,12 @@
+/**
+ * Notification Center (RFC-0029)
+ *
+ * Unified notification system for the harness runtime.
+ */
+export * from "./notification-center.js";
+export * from "./base-adapter.js";
+export * from "./types.js";
+export * from "./telegram-webhook-handler.js";
+export { LineAdapter } from "./adapters/line-adapter.js";
+export { TelegramAdapter } from "./adapters/telegram-adapter.js";
+//# sourceMappingURL=index.js.map

package/packages/notification/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,0BAA0B,CAAC;AACzC,cAAc,mBAAmB,CAAC;AAClC,cAAc,YAAY,CAAC;AAC3B,cAAc,+BAA+B,CAAC;AAC9C,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AACzD,OAAO,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC"}

package/packages/notification/dist/notification-center.d.ts

@@ -0,0 +1,89 @@
+/**
+ * Notification Center — RFC-0022
+ *
+ * Main orchestration class for sending notifications across multiple channels.
+ *
+ * Security Rules (RFC-0022):
+ * - Do not send raw cookies, passwords, provider tokens
+ * - Redact sensitive data before sending
+ * - Notification failure does not crash runtime
+ */
+import type { NotificationEvent, NotificationConfig, NotificationChannelConfig, NotificationResult, NotificationContext, TelegramCallbackHandler } from "./types.js";
+import { TelegramAdapter } from "./adapters/telegram-adapter.js";
+export declare class NotificationCenter {
+    private adapters;
+    private redactPatterns;
+    constructor(config?: NotificationConfig);
+    /**
+     * Register a new adapter
+     */
+    registerAdapter(config: NotificationChannelConfig): boolean;
+    /**
+     * Initialize all registered adapters
+     */
+    initialize(): Promise<void>;
+    /**
+     * Send a notification to all configured channels
+     */
+    notify(event: NotificationEvent, context: NotificationContext): Promise<NotificationResult[]>;
+    /**
+     * Send notification to a specific channel
+     */
+    notifyChannel(channelId: string, event: NotificationEvent, context: NotificationContext): Promise<NotificationResult>;
+    /**
+     * Check if any notifications are configured
+     */
+    hasChannels(): boolean;
+    /**
+     * List all configured channels
+     */
+    listChannels(): string[];
+    /**
+     * Get Telegram bot username if configured
+     */
+    getTelegramBotUsername(): string | undefined;
+    /**
+     * Get Telegram adapter for advanced operations (webhook setup, etc.)
+     */
+    getTelegramAdapter(): TelegramAdapter | undefined;
+    /**
+     * Set callback handler for Telegram inline keyboard button clicks
+     */
+    setTelegramCallbackHandler(handler: TelegramCallbackHandler): void;
+    /**
+     * Set webhook secret for Telegram updates verification
+     */
+    setTelegramWebhookSecret(secret: string): void;
+    /**
+     * Setup Telegram webhook for receiving updates
+     */
+    setupTelegramWebhook(webhookUrl: string): Promise<boolean>;
+    /**
+     * Send notification with interactive Yes/No buttons
+     */
+    notifyWithApproval(event: NotificationEvent, context: NotificationContext, options?: {
+        /** Custom button labels */
+        approveLabel?: string;
+        rejectLabel?: string;
+        /** Additional details for the message */
+        additionalDetails?: Record<string, unknown>;
+    }): Promise<NotificationResult[]>;
+    /**
+     * Send interactive notification with custom buttons
+     */
+    notifyWithButtons(event: NotificationEvent, context: NotificationContext, buttons: Array<{
+        text: string;
+        action: string;
+        targetId: string;
+        url?: string;
+    }>, options?: {
+        /** Additional details for the message */
+        additionalDetails?: Record<string, unknown>;
+    }): Promise<NotificationResult[]>;
+    private createAdapter;
+    private buildPayload;
+    private getEventContent;
+    private redact;
+    private getDefaultRedactPatterns;
+}
+//# sourceMappingURL=notification-center.d.ts.map

package/packages/notification/dist/notification-center.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"notification-center.d.ts","sourceRoot":"","sources":["../src/notification-center.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAEX,iBAAiB,EAEjB,kBAAkB,EAClB,yBAAyB,EACzB,kBAAkB,EAClB,mBAAmB,EACnB,uBAAuB,EAEvB,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AAOjE,qBAAa,kBAAkB;IAC9B,OAAO,CAAC,QAAQ,CAA0C;IAC1D,OAAO,CAAC,cAAc,CAAW;IAEjC,YAAY,MAAM,CAAC,EAAE,kBAAkB,EAWtC;IAED;;OAEG;IACH,eAAe,CAAC,MAAM,EAAE,yBAAyB,GAAG,OAAO,CAa1D;IAED;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAgBhC;IAED;;OAEG;IACG,MAAM,CACX,KAAK,EAAE,iBAAiB,EACxB,OAAO,EAAE,mBAAmB,GAC1B,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAwB/B;IAED;;OAEG;IACG,aAAa,CAClB,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,iBAAiB,EACxB,OAAO,EAAE,mBAAmB,GAC1B,OAAO,CAAC,kBAAkB,CAAC,CAY7B;IAED;;OAEG;IACH,WAAW,IAAI,OAAO,CAErB;IAED;;OAEG;IACH,YAAY,IAAI,MAAM,EAAE,CAEvB;IAED;;OAEG;IACH,sBAAsB,IAAI,MAAM,GAAG,SAAS,CAM3C;IAED;;OAEG;IACH,kBAAkB,IAAI,eAAe,GAAG,SAAS,CAMhD;IAED;;OAEG;IACH,0BAA0B,CAAC,OAAO,EAAE,uBAAuB,GAAG,IAAI,CAKjE;IAED;;OAEG;IACH,wBAAwB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAK7C;IAED;;OAEG;IACG,oBAAoB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAM/D;IAED;;OAEG;IACG,kBAAkB,CACvB,KAAK,EAAE,iBAAiB,EACxB,OAAO,EAAE,mBAAmB,EAC5B,OAAO,CAAC,EAAE;QACT,2BAA2B;QAC3B,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,yCAAyC;QACzC,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KAC5C,GACC,OAAO,CAAC,kBAAkB,EAAE,CAAC,CA8B/B;IAED;;OAEG;IACG,iBAAiB,CACtB,KAAK,EAAE,iBAAiB,EACxB,OAAO,EAAE,mBAAmB,EAC5B,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,EAChF,OAAO,CAAC,EAAE;QACT,yCAAyC;QACzC,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KAC5C,GACC,OAAO,CAAC,kBAAkB,EAAE,CAAC,CA0B/B;IAID,OAAO,CAAC,aAAa;IA6BrB,OAAO,CAAC,YAAY;IA+BpB,OAAO,CAAC,eAAe;IA2EvB,OAAO,CAAC,MAAM;IAed,OAAO,CAAC,wBAAwB;CAWhC"}