@overlordai/server 1.0.1

package/dist/notifier/notification-consumer.js

@@ -0,0 +1,186 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var NotificationConsumer_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NotificationConsumer = exports.ADAPTER_REGISTRY_TOKEN = exports.NOTIFICATION_QUEUE_NAME = void 0;
+const common_1 = require("@nestjs/common");
+const bullmq_1 = require("bullmq");
+const protocol_1 = require("@overlordai/protocol");
+const notification_repository_1 = require("../database/repositories/notification.repository");
+const task_repository_1 = require("../database/repositories/task.repository");
+const task_log_batcher_1 = require("../dispatcher/task-log-batcher");
+const template_service_1 = require("./template.service");
+/** Name of the BullMQ notification queue. */
+exports.NOTIFICATION_QUEUE_NAME = 'notification';
+/** DI token for the adapter registry. */
+exports.ADAPTER_REGISTRY_TOKEN = 'ADAPTER_REGISTRY';
+let NotificationConsumer = NotificationConsumer_1 = class NotificationConsumer {
+    notificationRepo;
+    taskRepo;
+    taskLogBatcher;
+    templateService;
+    logger = new common_1.Logger(NotificationConsumer_1.name);
+    worker;
+    /**
+     * Adapter registry is optional — if the adapters module is not yet loaded,
+     * platform notifications gracefully fall back to web (in-app) only.
+     */
+    adapterRegistry = null;
+    constructor(notificationRepo, taskRepo, taskLogBatcher, templateService) {
+        this.notificationRepo = notificationRepo;
+        this.taskRepo = taskRepo;
+        this.taskLogBatcher = taskLogBatcher;
+        this.templateService = templateService;
+    }
+    /** Allow the module to inject the adapter registry after construction. */
+    setAdapterRegistry(registry) {
+        this.adapterRegistry = registry;
+    }
+    async onModuleInit() {
+        const redisUrl = process.env.REDIS_URL || 'redis://localhost:6379';
+        this.worker = new bullmq_1.Worker(exports.NOTIFICATION_QUEUE_NAME, async (job) => this.process(job), {
+            connection: { url: redisUrl, maxRetriesPerRequest: null },
+            concurrency: 1, // SQLite single-writer constraint
+        });
+        this.worker.on('failed', (job, err) => {
+            const taskId = job?.data?.taskId ?? 'unknown';
+            const attempts = job?.attemptsMade ?? 0;
+            this.logger.warn(`Notification job failed for task ${taskId} (attempt ${attempts}): ${err.message}`);
+            // After 3 retries exhausted, write a warning to task_logs.
+            if (job && attempts >= 3) {
+                this.taskLogBatcher.add(job.data.taskId, protocol_1.TaskLogType.WARNING, `Notification delivery failed after ${attempts} attempts: ${err.message}`);
+            }
+        });
+        this.logger.log('NotificationConsumer started');
+    }
+    async onModuleDestroy() {
+        if (this.worker) {
+            await this.worker.close();
+        }
+    }
+    /**
+     * Process a single notification job.
+     */
+    async process(job) {
+        const { taskId, eventType, sourcePlatform, sourceChatId, notificationMsgId, task, extra, } = job.data;
+        this.logger.debug(`Processing notification: task=${taskId} event=${eventType} platform=${sourcePlatform}`);
+        // Build notification content using the template service.
+        const content = this.buildContent(task, eventType, extra);
+        // Route based on source platform.
+        const platform = sourcePlatform?.toLowerCase() ?? protocol_1.Platform.WEB;
+        if (platform === protocol_1.Platform.WEB || !this.adapterRegistry) {
+            // Web source or no adapters available — write to notifications table.
+            await this.handleWebNotification(task, eventType, content.text);
+            return;
+        }
+        // Platform-based delivery via adapter.
+        const adapter = this.adapterRegistry.getAdapter(platform);
+        if (!adapter) {
+            this.logger.warn(`No adapter found for platform "${platform}", falling back to web notification`);
+            await this.handleWebNotification(task, eventType, content.text);
+            return;
+        }
+        try {
+            const adapterMessage = {
+                type: 'card',
+                text: content.text,
+                card: content.card,
+            };
+            if (notificationMsgId) {
+                // Update existing message in-place.
+                await adapter.updateMessage(notificationMsgId, adapterMessage);
+                this.logger.debug(`Updated notification message ${notificationMsgId} for task ${taskId}`);
+            }
+            else if (sourceChatId) {
+                // Send new message.
+                const msgId = await adapter.sendMessage(sourceChatId, adapterMessage);
+                // Store the notificationMsgId on the task for future updates.
+                if (msgId) {
+                    this.storeNotificationMsgId(taskId, task, msgId);
+                }
+                this.logger.debug(`Sent notification for task ${taskId} via ${platform}, msgId=${msgId}`);
+            }
+            else {
+                this.logger.warn(`No chatId available for task ${taskId} on platform ${platform}, falling back to web`);
+                await this.handleWebNotification(task, eventType, content.text);
+            }
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            this.logger.error(`Adapter delivery failed for task ${taskId} on ${platform}: ${message}`);
+            // Re-throw so BullMQ retries.
+            throw err;
+        }
+    }
+    /**
+     * Write an in-app (web) notification to the notifications table.
+     */
+    async handleWebNotification(task, eventType, text) {
+        if (task.developerId == null) {
+            this.logger.debug(`Task ${task.id} has no developerId, skipping web notification`);
+            return;
+        }
+        this.notificationRepo.create({
+            developerId: task.developerId,
+            type: eventType,
+            title: `Task #${task.id} — ${eventType.replace(/_/g, ' ')}`,
+            body: text,
+            resourceType: 'task',
+            resourceId: String(task.id),
+        });
+        this.logger.debug(`Wrote web notification for task ${task.id} developer ${task.developerId}`);
+    }
+    /**
+     * Build the notification content from template service.
+     */
+    buildContent(task, eventType, extra) {
+        if (eventType === 'stage_confirm_required') {
+            const stage = extra.stage ?? task.currentStage ?? '';
+            return this.templateService.buildStageConfirmNotification(task, stage);
+        }
+        if (eventType === 'admin_alert') {
+            return this.templateService.buildAdminAlert(extra.message ?? '', extra.resourceType, extra.resourceId);
+        }
+        return this.templateService.buildTaskNotification(task, eventType, {
+            stage: extra.stage,
+            fromStage: extra.fromStage,
+            toStage: extra.toStage,
+            error: extra.error,
+            reason: extra.reason,
+            stageChanges: extra.stageChanges,
+        });
+    }
+    /**
+     * Persist the notification message ID on the task so subsequent
+     * notifications can update the same message in-place.
+     */
+    storeNotificationMsgId(taskId, task, msgId) {
+        try {
+            this.taskRepo.updateStatus(task.id, task.status, task.revision, {
+                notificationMsgId: msgId,
+            });
+        }
+        catch (err) {
+            // Non-fatal: if the optimistic lock fails, subsequent notifications
+            // will just send a new message instead of updating.
+            this.logger.warn(`Failed to store notificationMsgId for task ${taskId}: ${err instanceof Error ? err.message : String(err)}`);
+        }
+    }
+};
+exports.NotificationConsumer = NotificationConsumer;
+exports.NotificationConsumer = NotificationConsumer = NotificationConsumer_1 = __decorate([
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [notification_repository_1.NotificationRepository,
+        task_repository_1.TaskRepository,
+        task_log_batcher_1.TaskLogBatcher,
+        template_service_1.TemplateService])
+], NotificationConsumer);
+//# sourceMappingURL=notification-consumer.js.map

package/dist/notifier/notification-consumer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"notification-consumer.js","sourceRoot":"","sources":["../../src/notifier/notification-consumer.ts"],"names":[],"mappings":";;;;;;;;;;;;;AAAA,2CAAmF;AACnF,mCAAwD;AACxD,mDAA6D;AAE7D,8FAA0F;AAC1F,8EAA0E;AAC1E,qEAAgE;AAChE,yDAAqD;AAErD,6CAA6C;AAChC,QAAA,uBAAuB,GAAG,cAAc,CAAC;AA6CtD,yCAAyC;AAC5B,QAAA,sBAAsB,GAAG,kBAAkB,CAAC;AAGlD,IAAM,oBAAoB,4BAA1B,MAAM,oBAAoB;IAWZ;IACA;IACA;IACA;IAbF,MAAM,GAAG,IAAI,eAAM,CAAC,sBAAoB,CAAC,IAAI,CAAC,CAAC;IACxD,MAAM,CAAc;IAE5B;;;OAGG;IACK,eAAe,GAA4B,IAAI,CAAC;IAExD,YACmB,gBAAwC,EACxC,QAAwB,EACxB,cAA8B,EAC9B,eAAgC;QAHhC,qBAAgB,GAAhB,gBAAgB,CAAwB;QACxC,aAAQ,GAAR,QAAQ,CAAgB;QACxB,mBAAc,GAAd,cAAc,CAAgB;QAC9B,oBAAe,GAAf,eAAe,CAAiB;IAChD,CAAC;IAEJ,0EAA0E;IAC1E,kBAAkB,CAAC,QAA0B;QAC3C,IAAI,CAAC,eAAe,GAAG,QAAQ,CAAC;IAClC,CAAC;IAED,KAAK,CAAC,YAAY;QAChB,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,SAAS,IAAI,wBAAwB,CAAC;QAEnE,IAAI,CAAC,MAAM,GAAG,IAAI,eAAU,CAC1B,+BAAuB,EACvB,KAAK,EAAE,GAA6B,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAC1D;YACE,UAAU,EAAE,EAAE,GAAG,EAAE,QAAQ,EAAE,oBAAoB,EAAE,IAAI,EAAE;YACzD,WAAW,EAAE,CAAC,EAAE,kCAAkC;SACnD,CACF,CAAC;QAEF,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,QAAQ,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE;YACpC,MAAM,MAAM,GAAG,GAAG,EAAE,IAAI,EAAE,MAAM,IAAI,SAAS,CAAC;YAC9C,MAAM,QAAQ,GAAG,GAAG,EAAE,YAAY,IAAI,CAAC,CAAC;YACxC,IAAI,CAAC,MAAM,CAAC,IAAI,CACd,oCAAoC,MAAM,aAAa,QAAQ,MAAM,GAAG,CAAC,OAAO,EAAE,CACnF,CAAC;YAEF,2DAA2D;YAC3D,IAAI,GAAG,IAAI,QAAQ,IAAI,CAAC,EAAE,CAAC;gBACzB,IAAI,CAAC,cAAc,CAAC,GAAG,CACrB,GAAG,CAAC,IAAI,CAAC,MAAM,EACf,sBAAW,CAAC,OAAO,EACnB,sCAAsC,QAAQ,cAAc,GAAG,CAAC,OAAO,EAAE,CAC1E,CAAC;YACJ,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,8BAA8B,CAAC,CAAC;IAClD,CAAC;IAED,KAAK,CAAC,eAAe;QACnB,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChB,MAAM,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;QAC5B,CAAC;IACH,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,OAAO,CAAC,GAA6B;QACjD,MAAM,EACJ,MAAM,EACN,SAAS,EACT,cAAc,EACd,YAAY,EACZ,iBAAiB,EACjB,IAAI,EACJ,KAAK,GACN,GAAG,GAAG,CAAC,IAAI,CAAC;QAEb,IAAI,CAAC,MAAM,CAAC,KAAK,CACf,iCAAiC,MAAM,UAAU,SAAS,aAAa,cAAc,EAAE,CACxF,CAAC;QAEF,yDAAyD;QACzD,MAAM,OAAO,GAAG,IAAI,CAAC,YAAY,CAAC,IAAI,EAAE,SAAS,EAAE,KAAK,CAAC,CAAC;QAE1D,kCAAkC;QAClC,MAAM,QAAQ,GAAG,cAAc,EAAE,WAAW,EAAE,IAAI,mBAAQ,CAAC,GAAG,CAAC;QAE/D,IAAI,QAAQ,KAAK,mBAAQ,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,eAAe,EAAE,CAAC;YACvD,sEAAsE;YACtE,MAAM,IAAI,CAAC,qBAAqB,CAAC,IAAI,EAAE,SAAS,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;YAChE,OAAO;QACT,CAAC;QAED,uCAAuC;QACvC,MAAM,OAAO,GAAG,IAAI,CAAC,eAAe,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;QAC1D,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,IAAI,CAAC,MAAM,CAAC,IAAI,CACd,kCAAkC,QAAQ,qCAAqC,CAChF,CAAC;YACF,MAAM,IAAI,CAAC,qBAAqB,CAAC,IAAI,EAAE,SAAS,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;YAChE,OAAO;QACT,CAAC;QAED,IAAI,CAAC;YACH,MAAM,cAAc,GAAG;gBACrB,IAAI,EAAE,MAAe;gBACrB,IAAI,EAAE,OAAO,CAAC,IAAI;gBAClB,IAAI,EAAE,OAAO,CAAC,IAAI;aACnB,CAAC;YAEF,IAAI,iBAAiB,EAAE,CAAC;gBACtB,oCAAoC;gBACpC,MAAM,OAAO,CAAC,aAAa,CAAC,iBAAiB,EAAE,cAAc,CAAC,CAAC;gBAC/D,IAAI,CAAC,MAAM,CAAC,KAAK,CACf,gCAAgC,iBAAiB,aAAa,MAAM,EAAE,CACvE,CAAC;YACJ,CAAC;iBAAM,IAAI,YAAY,EAAE,CAAC;gBACxB,oBAAoB;gBACpB,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,WAAW,CAAC,YAAY,EAAE,cAAc,CAAC,CAAC;gBAEtE,8DAA8D;gBAC9D,IAAI,KAAK,EAAE,CAAC;oBACV,IAAI,CAAC,sBAAsB,CAAC,MAAM,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC;gBACnD,CAAC;gBAED,IAAI,CAAC,MAAM,CAAC,KAAK,CACf,8BAA8B,MAAM,QAAQ,QAAQ,WAAW,KAAK,EAAE,CACvE,CAAC;YACJ,CAAC;iBAAM,CAAC;gBACN,IAAI,CAAC,MAAM,CAAC,IAAI,CACd,gCAAgC,MAAM,gBAAgB,QAAQ,uBAAuB,CACtF,CAAC;gBACF,MAAM,IAAI,CAAC,qBAAqB,CAAC,IAAI,EAAE,SAAS,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;YAClE,CAAC;QACH,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACjE,IAAI,CAAC,MAAM,CAAC,KAAK,CACf,oCAAoC,MAAM,OAAO,QAAQ,KAAK,OAAO,EAAE,CACxE,CAAC;YACF,8BAA8B;YAC9B,MAAM,GAAG,CAAC;QACZ,CAAC;IACH,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,qBAAqB,CACjC,IAAU,EACV,SAAiB,EACjB,IAAY;QAEZ,IAAI,IAAI,CAAC,WAAW,IAAI,IAAI,EAAE,CAAC;YAC7B,IAAI,CAAC,MAAM,CAAC,KAAK,CACf,QAAQ,IAAI,CAAC,EAAE,gDAAgD,CAChE,CAAC;YACF,OAAO;QACT,CAAC;QAED,IAAI,CAAC,gBAAgB,CAAC,MAAM,CAAC;YAC3B,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,IAAI,EAAE,SAAS;YACf,KAAK,EAAE,SAAS,IAAI,CAAC,EAAE,MAAM,SAAS,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,EAAE;YAC3D,IAAI,EAAE,IAAI;YACV,YAAY,EAAE,MAAM;YACpB,UAAU,EAAE,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;SAC5B,CAAC,CAAC;QAEH,IAAI,CAAC,MAAM,CAAC,KAAK,CACf,mCAAmC,IAAI,CAAC,EAAE,cAAc,IAAI,CAAC,WAAW,EAAE,CAC3E,CAAC;IACJ,CAAC;IAED;;OAEG;IACK,YAAY,CAClB,IAAU,EACV,SAAiB,EACjB,KAA8B;QAE9B,IAAI,SAAS,KAAK,wBAAwB,EAAE,CAAC;YAC3C,MAAM,KAAK,GAAI,KAAK,CAAC,KAAgB,IAAI,IAAI,CAAC,YAAY,IAAI,EAAE,CAAC;YACjE,OAAO,IAAI,CAAC,eAAe,CAAC,6BAA6B,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QACzE,CAAC;QAED,IAAI,SAAS,KAAK,aAAa,EAAE,CAAC;YAChC,OAAO,IAAI,CAAC,eAAe,CAAC,eAAe,CACxC,KAAK,CAAC,OAAkB,IAAI,EAAE,EAC/B,KAAK,CAAC,YAAkC,EACxC,KAAK,CAAC,UAAgC,CACvC,CAAC;QACJ,CAAC;QAED,OAAO,IAAI,CAAC,eAAe,CAAC,qBAAqB,CAAC,IAAI,EAAE,SAAS,EAAE;YACjE,KAAK,EAAE,KAAK,CAAC,KAA2B;YACxC,SAAS,EAAE,KAAK,CAAC,SAA+B;YAChD,OAAO,EAAE,KAAK,CAAC,OAA6B;YAC5C,KAAK,EAAE,KAAK,CAAC,KAA2B;YACxC,MAAM,EAAE,KAAK,CAAC,MAA4B;YAC1C,YAAY,EAAE,KAAK,CAAC,YAAoC;SACzD,CAAC,CAAC;IACL,CAAC;IAED;;;OAGG;IACK,sBAAsB,CAC5B,MAAc,EACd,IAAU,EACV,KAAa;QAEb,IAAI,CAAC;YACH,IAAI,CAAC,QAAQ,CAAC,YAAY,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,QAAQ,EAAE;gBAC9D,iBAAiB,EAAE,KAAK;aACzB,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,oEAAoE;YACpE,oDAAoD;YACpD,IAAI,CAAC,MAAM,CAAC,IAAI,CACd,8CAA8C,MAAM,KAAK,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAC5G,CAAC;QACJ,CAAC;IACH,CAAC;CACF,CAAA;AA9NY,oDAAoB;+BAApB,oBAAoB;IADhC,IAAA,mBAAU,GAAE;qCAY0B,gDAAsB;QAC9B,gCAAc;QACR,iCAAc;QACb,kCAAe;GAdxC,oBAAoB,CA8NhC"}

package/dist/notifier/notifier.module.d.ts

@@ -0,0 +1,9 @@
+import { type OnModuleInit } from '@nestjs/common';
+import { NotificationConsumer, type IAdapterRegistry } from './notification-consumer';
+export declare class NotifierModule implements OnModuleInit {
+    private readonly consumer;
+    private readonly adapterRegistry?;
+    constructor(consumer: NotificationConsumer, adapterRegistry?: IAdapterRegistry | undefined);
+    onModuleInit(): void;
+}
+//# sourceMappingURL=notifier.module.d.ts.map

package/dist/notifier/notifier.module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"notifier.module.d.ts","sourceRoot":"","sources":["../../src/notifier/notifier.module.ts"],"names":[],"mappings":"AAAA,OAAO,EAAU,KAAK,YAAY,EAAoB,MAAM,gBAAgB,CAAC;AAM7E,OAAO,EACL,oBAAoB,EAEpB,KAAK,gBAAgB,EACtB,MAAM,yBAAyB,CAAC;AAIjC,qBAaa,cAAe,YAAW,YAAY;IAE/C,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAGzB,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAC;gBAHhB,QAAQ,EAAE,oBAAoB,EAG9B,eAAe,CAAC,EAAE,gBAAgB,YAAA;IAGrD,YAAY,IAAI,IAAI;CAMrB"}

package/dist/notifier/notifier.module.js

@@ -0,0 +1,58 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NotifierModule = void 0;
+const common_1 = require("@nestjs/common");
+const notification_repository_1 = require("../database/repositories/notification.repository");
+const task_repository_1 = require("../database/repositories/task.repository");
+const developer_repository_1 = require("../database/repositories/developer.repository");
+const task_log_batcher_1 = require("../dispatcher/task-log-batcher");
+const notifier_service_1 = require("./notifier.service");
+const notification_consumer_1 = require("./notification-consumer");
+const debouncer_1 = require("./debouncer");
+const template_service_1 = require("./template.service");
+let NotifierModule = class NotifierModule {
+    consumer;
+    adapterRegistry;
+    constructor(consumer, adapterRegistry) {
+        this.consumer = consumer;
+        this.adapterRegistry = adapterRegistry;
+    }
+    onModuleInit() {
+        // Wire the adapter registry into the consumer if available.
+        if (this.adapterRegistry) {
+            this.consumer.setAdapterRegistry(this.adapterRegistry);
+        }
+    }
+};
+exports.NotifierModule = NotifierModule;
+exports.NotifierModule = NotifierModule = __decorate([
+    (0, common_1.Module)({
+        providers: [
+            notification_repository_1.NotificationRepository,
+            task_repository_1.TaskRepository,
+            developer_repository_1.DeveloperRepository,
+            task_log_batcher_1.TaskLogBatcher,
+            template_service_1.TemplateService,
+            debouncer_1.NotificationDebouncer,
+            notification_consumer_1.NotificationConsumer,
+            notifier_service_1.NotifierService,
+        ],
+        exports: [notifier_service_1.NotifierService, template_service_1.TemplateService],
+    }),
+    __param(1, (0, common_1.Optional)()),
+    __param(1, (0, common_1.Inject)(notification_consumer_1.ADAPTER_REGISTRY_TOKEN)),
+    __metadata("design:paramtypes", [notification_consumer_1.NotificationConsumer, Object])
+], NotifierModule);
+//# sourceMappingURL=notifier.module.js.map

package/dist/notifier/notifier.module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"notifier.module.js","sourceRoot":"","sources":["../../src/notifier/notifier.module.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;AAAA,2CAA6E;AAC7E,8FAA0F;AAC1F,8EAA0E;AAC1E,wFAAoF;AACpF,qEAAgE;AAChE,yDAAqD;AACrD,mEAIiC;AACjC,2CAAoD;AACpD,yDAAqD;AAe9C,IAAM,cAAc,GAApB,MAAM,cAAc;IAEN;IAGA;IAJnB,YACmB,QAA8B,EAG9B,eAAkC;QAHlC,aAAQ,GAAR,QAAQ,CAAsB;QAG9B,oBAAe,GAAf,eAAe,CAAmB;IAClD,CAAC;IAEJ,YAAY;QACV,4DAA4D;QAC5D,IAAI,IAAI,CAAC,eAAe,EAAE,CAAC;YACzB,IAAI,CAAC,QAAQ,CAAC,kBAAkB,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;QACzD,CAAC;IACH,CAAC;CACF,CAAA;AAdY,wCAAc;yBAAd,cAAc;IAb1B,IAAA,eAAM,EAAC;QACN,SAAS,EAAE;YACT,gDAAsB;YACtB,gCAAc;YACd,0CAAmB;YACnB,iCAAc;YACd,kCAAe;YACf,iCAAqB;YACrB,4CAAoB;YACpB,kCAAe;SAChB;QACD,OAAO,EAAE,CAAC,kCAAe,EAAE,kCAAe,CAAC;KAC5C,CAAC;IAIG,WAAA,IAAA,iBAAQ,GAAE,CAAA;IACV,WAAA,IAAA,eAAM,EAAC,8CAAsB,CAAC,CAAA;qCAFJ,4CAAoB;GAFtC,cAAc,CAc1B"}

package/dist/notifier/notifier.service.d.ts

@@ -0,0 +1,40 @@
+import { OnModuleInit } from '@nestjs/common';
+import type { Task, NotificationRecord, PaginatedResult } from '@overlordai/protocol';
+import { NotificationRepository } from '../database/repositories/notification.repository';
+import { DeveloperRepository } from '../database/repositories/developer.repository';
+import { NotificationDebouncer } from './debouncer';
+export declare class NotifierService implements OnModuleInit {
+    private readonly debouncer;
+    private readonly notificationRepo;
+    private readonly developerRepo;
+    private readonly logger;
+    private queue;
+    constructor(debouncer: NotificationDebouncer, notificationRepo: NotificationRepository, developerRepo: DeveloperRepository);
+    onModuleInit(): Promise<void>;
+    notifyTaskCreated(task: Task): Promise<void>;
+    notifyTaskAssigned(task: Task): Promise<void>;
+    notifyTaskRunning(task: Task, stage: string): Promise<void>;
+    notifyStageChanged(task: Task, fromStage: string, toStage: string): Promise<void>;
+    notifyTaskCompleted(task: Task): Promise<void>;
+    notifyTaskFailed(task: Task, error: string): Promise<void>;
+    notifyTaskCancelled(task: Task): Promise<void>;
+    notifyTaskSuspended(task: Task, reason: string): Promise<void>;
+    notifyTaskResumed(task: Task): Promise<void>;
+    notifyQueueWaitTimeout(task: Task): Promise<void>;
+    notifyStageConfirmRequired(task: Task, stage: string): Promise<void>;
+    notifyAdminAlert(message: string, resourceType?: string, resourceId?: string): Promise<void>;
+    getNotifications(developerId: number, limit: number, cursor?: string): PaginatedResult<NotificationRecord>;
+    markAsRead(notificationId: number, developerId: number): Promise<void>;
+    markAllAsRead(developerId: number): Promise<number>;
+    /**
+     * Enqueue a notification job directly (no debounce).
+     * Used for events that should be delivered immediately (created, completed, failed, etc.).
+     */
+    private enqueueDirect;
+    /**
+     * Enqueue a notification from the debouncer's flush callback.
+     * This fires after the 10s debounce delay with merged data.
+     */
+    private enqueueFromDebounce;
+}
+//# sourceMappingURL=notifier.service.d.ts.map

package/dist/notifier/notifier.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"notifier.service.d.ts","sourceRoot":"","sources":["../../src/notifier/notifier.service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsB,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAGlE,OAAO,KAAK,EAAE,IAAI,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACtF,OAAO,EAAE,sBAAsB,EAAE,MAAM,kDAAkD,CAAC;AAC1F,OAAO,EAAE,mBAAmB,EAAE,MAAM,+CAA+C,CAAC;AACpF,OAAO,EACL,qBAAqB,EAEtB,MAAM,aAAa,CAAC;AAiBrB,qBACa,eAAgB,YAAW,YAAY;IAKhD,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,gBAAgB;IACjC,OAAO,CAAC,QAAQ,CAAC,aAAa;IANhC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAoC;IAC3D,OAAO,CAAC,KAAK,CAAS;gBAGH,SAAS,EAAE,qBAAqB,EAChC,gBAAgB,EAAE,sBAAsB,EACxC,aAAa,EAAE,mBAAmB;IAG/C,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;IAwB7B,iBAAiB,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAI5C,kBAAkB,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAI7C,iBAAiB,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI3D,kBAAkB,CACtB,IAAI,EAAE,IAAI,EACV,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,IAAI,CAAC;IAKV,mBAAmB,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAI9C,gBAAgB,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI1D,mBAAmB,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAI9C,mBAAmB,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI9D,iBAAiB,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAI5C,sBAAsB,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAIjD,0BAA0B,CAC9B,IAAI,EAAE,IAAI,EACV,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,IAAI,CAAC;IAIV,gBAAgB,CACpB,OAAO,EAAE,MAAM,EACf,YAAY,CAAC,EAAE,MAAM,EACrB,UAAU,CAAC,EAAE,MAAM,GAClB,OAAO,CAAC,IAAI,CAAC;IAuBhB,gBAAgB,CACd,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,MAAM,EACb,MAAM,CAAC,EAAE,MAAM,GACd,eAAe,CAAC,kBAAkB,CAAC;IAIhC,UAAU,CACd,cAAc,EAAE,MAAM,EACtB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,IAAI,CAAC;IAYV,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAMzD;;;OAGG;YACW,aAAa;IAmC3B;;;OAGG;YACW,mBAAmB;CAqClC"}

package/dist/notifier/notifier.service.js

@@ -0,0 +1,191 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var NotifierService_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NotifierService = void 0;
+const common_1 = require("@nestjs/common");
+const bullmq_1 = require("bullmq");
+const protocol_1 = require("@overlordai/protocol");
+const notification_repository_1 = require("../database/repositories/notification.repository");
+const developer_repository_1 = require("../database/repositories/developer.repository");
+const debouncer_1 = require("./debouncer");
+const notification_consumer_1 = require("./notification-consumer");
+/** Default BullMQ job options for notification jobs. */
+const DEFAULT_JOB_OPTIONS = {
+    removeOnComplete: 100,
+    removeOnFail: 50,
+    attempts: 3,
+    backoff: {
+        type: 'exponential',
+        delay: 30_000, // 30s → 60s → 120s
+    },
+};
+let NotifierService = NotifierService_1 = class NotifierService {
+    debouncer;
+    notificationRepo;
+    developerRepo;
+    logger = new common_1.Logger(NotifierService_1.name);
+    queue;
+    constructor(debouncer, notificationRepo, developerRepo) {
+        this.debouncer = debouncer;
+        this.notificationRepo = notificationRepo;
+        this.developerRepo = developerRepo;
+    }
+    async onModuleInit() {
+        const redisUrl = process.env.REDIS_URL || 'redis://localhost:6379';
+        this.queue = new bullmq_1.Queue(notification_consumer_1.NOTIFICATION_QUEUE_NAME, {
+            connection: { url: redisUrl, maxRetriesPerRequest: null },
+            defaultJobOptions: {
+                ...DEFAULT_JOB_OPTIONS,
+            },
+        });
+        // Register debouncer flush callback to enqueue merged notifications.
+        this.debouncer.onFlush((notification) => {
+            this.enqueueFromDebounce(notification).catch((err) => {
+                this.logger.error(`Failed to enqueue debounced notification for task ${notification.taskId}: ${err instanceof Error ? err.message : String(err)}`);
+            });
+        });
+        this.logger.log('NotifierService initialized');
+    }
+    // ─── Notification entry points ────────────────────────────────────
+    async notifyTaskCreated(task) {
+        await this.enqueueDirect(task, 'task_created');
+    }
+    async notifyTaskAssigned(task) {
+        await this.enqueueDirect(task, 'task_assigned');
+    }
+    async notifyTaskRunning(task, stage) {
+        await this.enqueueDirect(task, 'task_running', { stage });
+    }
+    async notifyStageChanged(task, fromStage, toStage) {
+        // Stage changes use debounce + merge window.
+        this.debouncer.submit(task, 'stage_changed', { fromStage, toStage });
+    }
+    async notifyTaskCompleted(task) {
+        await this.enqueueDirect(task, 'task_completed');
+    }
+    async notifyTaskFailed(task, error) {
+        await this.enqueueDirect(task, 'task_failed', { error });
+    }
+    async notifyTaskCancelled(task) {
+        await this.enqueueDirect(task, 'task_cancelled');
+    }
+    async notifyTaskSuspended(task, reason) {
+        await this.enqueueDirect(task, 'task_suspended', { reason });
+    }
+    async notifyTaskResumed(task) {
+        await this.enqueueDirect(task, 'task_resumed');
+    }
+    async notifyQueueWaitTimeout(task) {
+        await this.enqueueDirect(task, 'queue_wait_timeout');
+    }
+    async notifyStageConfirmRequired(task, stage) {
+        await this.enqueueDirect(task, 'stage_confirm_required', { stage });
+    }
+    async notifyAdminAlert(message, resourceType, resourceId) {
+        // Admin alerts go to all admin developers as web notifications
+        // and also enqueue for platform delivery if configured.
+        const admins = this.developerRepo.findByRole(protocol_1.DeveloperRole.ADMIN);
+        for (const admin of admins) {
+            this.notificationRepo.create({
+                developerId: admin.id,
+                type: 'admin_alert',
+                title: '🚨 Admin Alert',
+                body: message,
+                resourceType: resourceType ?? undefined,
+                resourceId: resourceId ?? undefined,
+            });
+        }
+        this.logger.log(`Admin alert sent to ${admins.length} admin(s): ${message}`);
+    }
+    // ─── In-app notification queries ─────────────────────────────────
+    getNotifications(developerId, limit, cursor) {
+        return this.notificationRepo.findByDeveloper(developerId, limit, cursor);
+    }
+    async markAsRead(notificationId, developerId) {
+        const updated = this.notificationRepo.markAsRead(notificationId, developerId);
+        if (!updated) {
+            this.logger.warn(`markAsRead: notification ${notificationId} not found or not owned by developer ${developerId}`);
+        }
+    }
+    async markAllAsRead(developerId) {
+        return this.notificationRepo.markAllAsRead(developerId);
+    }
+    // ─── Internal helpers ─────────────────────────────────────────────
+    /**
+     * Enqueue a notification job directly (no debounce).
+     * Used for events that should be delivered immediately (created, completed, failed, etc.).
+     */
+    async enqueueDirect(task, eventType, extra = {}) {
+        const timeBucket = Math.floor(Date.now() / 60_000);
+        const jobId = `${task.id}_${eventType}_${timeBucket}`;
+        const jobData = {
+            taskId: task.id,
+            eventType,
+            sourcePlatform: task.sourcePlatform,
+            sourceChatId: task.sourceChatId,
+            sourceAppId: task.sourceAppId,
+            notificationMsgId: task.notificationMsgId,
+            task,
+            extra,
+        };
+        try {
+            await this.queue.add(eventType, jobData, {
+                jobId,
+                removeOnComplete: { age: 3600 },
+            });
+            this.logger.debug(`Enqueued notification: task=${task.id} event=${eventType} jobId=${jobId}`);
+        }
+        catch (err) {
+            this.logger.error(`Failed to enqueue notification for task ${task.id}: ${err instanceof Error ? err.message : String(err)}`);
+        }
+    }
+    /**
+     * Enqueue a notification from the debouncer's flush callback.
+     * This fires after the 10s debounce delay with merged data.
+     */
+    async enqueueFromDebounce(notification) {
+        const { task, eventType, stageChanges, extra } = notification;
+        const timeBucket = Math.floor(Date.now() / 60_000);
+        const jobId = `${task.id}_${eventType}_${timeBucket}`;
+        const jobData = {
+            taskId: task.id,
+            eventType,
+            sourcePlatform: task.sourcePlatform,
+            sourceChatId: task.sourceChatId,
+            sourceAppId: task.sourceAppId,
+            notificationMsgId: task.notificationMsgId,
+            task,
+            extra: {
+                ...extra,
+                stageChanges,
+            },
+        };
+        try {
+            await this.queue.add(eventType, jobData, {
+                jobId,
+                removeOnComplete: { age: 3600 },
+            });
+            this.logger.debug(`Enqueued debounced notification: task=${task.id} event=${eventType} stages=[${stageChanges.join(',')}]`);
+        }
+        catch (err) {
+            this.logger.error(`Failed to enqueue debounced notification for task ${task.id}: ${err instanceof Error ? err.message : String(err)}`);
+        }
+    }
+};
+exports.NotifierService = NotifierService;
+exports.NotifierService = NotifierService = NotifierService_1 = __decorate([
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [debouncer_1.NotificationDebouncer,
+        notification_repository_1.NotificationRepository,
+        developer_repository_1.DeveloperRepository])
+], NotifierService);
+//# sourceMappingURL=notifier.service.js.map

package/dist/notifier/notifier.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"notifier.service.js","sourceRoot":"","sources":["../../src/notifier/notifier.service.ts"],"names":[],"mappings":";;;;;;;;;;;;;AAAA,2CAAkE;AAClE,mCAA+B;AAC/B,mDAA+D;AAE/D,8FAA0F;AAC1F,wFAAoF;AACpF,2CAGqB;AACrB,mEAGiC;AAEjC,wDAAwD;AACxD,MAAM,mBAAmB,GAAG;IAC1B,gBAAgB,EAAE,GAAG;IACrB,YAAY,EAAE,EAAE;IAChB,QAAQ,EAAE,CAAC;IACX,OAAO,EAAE;QACP,IAAI,EAAE,aAAsB;QAC5B,KAAK,EAAE,MAAM,EAAE,mBAAmB;KACnC;CACF,CAAC;AAGK,IAAM,eAAe,uBAArB,MAAM,eAAe;IAKP;IACA;IACA;IANF,MAAM,GAAG,IAAI,eAAM,CAAC,iBAAe,CAAC,IAAI,CAAC,CAAC;IACnD,KAAK,CAAS;IAEtB,YACmB,SAAgC,EAChC,gBAAwC,EACxC,aAAkC;QAFlC,cAAS,GAAT,SAAS,CAAuB;QAChC,qBAAgB,GAAhB,gBAAgB,CAAwB;QACxC,kBAAa,GAAb,aAAa,CAAqB;IAClD,CAAC;IAEJ,KAAK,CAAC,YAAY;QAChB,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,SAAS,IAAI,wBAAwB,CAAC;QAEnE,IAAI,CAAC,KAAK,GAAG,IAAI,cAAK,CAAC,+CAAuB,EAAE;YAC9C,UAAU,EAAE,EAAE,GAAG,EAAE,QAAQ,EAAE,oBAAoB,EAAE,IAAI,EAAE;YACzD,iBAAiB,EAAE;gBACjB,GAAG,mBAAmB;aACvB;SACF,CAAC,CAAC;QAEH,qEAAqE;QACrE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,YAAY,EAAE,EAAE;YACtC,IAAI,CAAC,mBAAmB,CAAC,YAAY,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;gBACnD,IAAI,CAAC,MAAM,CAAC,KAAK,CACf,qDAAqD,YAAY,CAAC,MAAM,KAAK,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAChI,CAAC;YACJ,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,6BAA6B,CAAC,CAAC;IACjD,CAAC;IAED,qEAAqE;IAErE,KAAK,CAAC,iBAAiB,CAAC,IAAU;QAChC,MAAM,IAAI,CAAC,aAAa,CAAC,IAAI,EAAE,cAAc,CAAC,CAAC;IACjD,CAAC;IAED,KAAK,CAAC,kBAAkB,CAAC,IAAU;QACjC,MAAM,IAAI,CAAC,aAAa,CAAC,IAAI,EAAE,eAAe,CAAC,CAAC;IAClD,CAAC;IAED,KAAK,CAAC,iBAAiB,CAAC,IAAU,EAAE,KAAa;QAC/C,MAAM,IAAI,CAAC,aAAa,CAAC,IAAI,EAAE,cAAc,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;IAC5D,CAAC;IAED,KAAK,CAAC,kBAAkB,CACtB,IAAU,EACV,SAAiB,EACjB,OAAe;QAEf,6CAA6C;QAC7C,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,EAAE,eAAe,EAAE,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,CAAC;IACvE,CAAC;IAED,KAAK,CAAC,mBAAmB,CAAC,IAAU;QAClC,MAAM,IAAI,CAAC,aAAa,CAAC,IAAI,EAAE,gBAAgB,CAAC,CAAC;IACnD,CAAC;IAED,KAAK,CAAC,gBAAgB,CAAC,IAAU,EAAE,KAAa;QAC9C,MAAM,IAAI,CAAC,aAAa,CAAC,IAAI,EAAE,aAAa,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;IAC3D,CAAC;IAED,KAAK,CAAC,mBAAmB,CAAC,IAAU;QAClC,MAAM,IAAI,CAAC,aAAa,CAAC,IAAI,EAAE,gBAAgB,CAAC,CAAC;IACnD,CAAC;IAED,KAAK,CAAC,mBAAmB,CAAC,IAAU,EAAE,MAAc;QAClD,MAAM,IAAI,CAAC,aAAa,CAAC,IAAI,EAAE,gBAAgB,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;IAC/D,CAAC;IAED,KAAK,CAAC,iBAAiB,CAAC,IAAU;QAChC,MAAM,IAAI,CAAC,aAAa,CAAC,IAAI,EAAE,cAAc,CAAC,CAAC;IACjD,CAAC;IAED,KAAK,CAAC,sBAAsB,CAAC,IAAU;QACrC,MAAM,IAAI,CAAC,aAAa,CAAC,IAAI,EAAE,oBAAoB,CAAC,CAAC;IACvD,CAAC;IAED,KAAK,CAAC,0BAA0B,CAC9B,IAAU,EACV,KAAa;QAEb,MAAM,IAAI,CAAC,aAAa,CAAC,IAAI,EAAE,wBAAwB,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;IACtE,CAAC;IAED,KAAK,CAAC,gBAAgB,CACpB,OAAe,EACf,YAAqB,EACrB,UAAmB;QAEnB,+DAA+D;QAC/D,wDAAwD;QACxD,MAAM,MAAM,GAAG,IAAI,CAAC,aAAa,CAAC,UAAU,CAAC,wBAAa,CAAC,KAAK,CAAC,CAAC;QAElE,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;YAC3B,IAAI,CAAC,gBAAgB,CAAC,MAAM,CAAC;gBAC3B,WAAW,EAAE,KAAK,CAAC,EAAE;gBACrB,IAAI,EAAE,aAAa;gBACnB,KAAK,EAAE,gBAAgB;gBACvB,IAAI,EAAE,OAAO;gBACb,YAAY,EAAE,YAAY,IAAI,SAAS;gBACvC,UAAU,EAAE,UAAU,IAAI,SAAS;aACpC,CAAC,CAAC;QACL,CAAC;QAED,IAAI,CAAC,MAAM,CAAC,GAAG,CACb,uBAAuB,MAAM,CAAC,MAAM,cAAc,OAAO,EAAE,CAC5D,CAAC;IACJ,CAAC;IAED,oEAAoE;IAEpE,gBAAgB,CACd,WAAmB,EACnB,KAAa,EACb,MAAe;QAEf,OAAO,IAAI,CAAC,gBAAgB,CAAC,eAAe,CAAC,WAAW,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;IAC3E,CAAC;IAED,KAAK,CAAC,UAAU,CACd,cAAsB,EACtB,WAAmB;QAEnB,MAAM,OAAO,GAAG,IAAI,CAAC,gBAAgB,CAAC,UAAU,CAC9C,cAAc,EACd,WAAW,CACZ,CAAC;QACF,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,IAAI,CAAC,MAAM,CAAC,IAAI,CACd,4BAA4B,cAAc,wCAAwC,WAAW,EAAE,CAChG,CAAC;QACJ,CAAC;IACH,CAAC;IAED,KAAK,CAAC,aAAa,CAAC,WAAmB;QACrC,OAAO,IAAI,CAAC,gBAAgB,CAAC,aAAa,CAAC,WAAW,CAAC,CAAC;IAC1D,CAAC;IAED,qEAAqE;IAErE;;;OAGG;IACK,KAAK,CAAC,aAAa,CACzB,IAAU,EACV,SAAiB,EACjB,QAAiC,EAAE;QAEnC,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,MAAM,CAAC,CAAC;QACnD,MAAM,KAAK,GAAG,GAAG,IAAI,CAAC,EAAE,IAAI,SAAS,IAAI,UAAU,EAAE,CAAC;QAEtD,MAAM,OAAO,GAAwB;YACnC,MAAM,EAAE,IAAI,CAAC,EAAE;YACf,SAAS;YACT,cAAc,EAAE,IAAI,CAAC,cAAc;YACnC,YAAY,EAAE,IAAI,CAAC,YAAY;YAC/B,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,iBAAiB,EAAE,IAAI,CAAC,iBAAiB;YACzC,IAAI;YACJ,KAAK;SACN,CAAC;QAEF,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,SAAS,EAAE,OAAO,EAAE;gBACvC,KAAK;gBACL,gBAAgB,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE;aAChC,CAAC,CAAC;YAEH,IAAI,CAAC,MAAM,CAAC,KAAK,CACf,+BAA+B,IAAI,CAAC,EAAE,UAAU,SAAS,UAAU,KAAK,EAAE,CAC3E,CAAC;QACJ,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,CAAC,MAAM,CAAC,KAAK,CACf,2CAA2C,IAAI,CAAC,EAAE,KAAK,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAC1G,CAAC;QACJ,CAAC;IACH,CAAC;IAED;;;OAGG;IACK,KAAK,CAAC,mBAAmB,CAC/B,YAAmC;QAEnC,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,YAAY,EAAE,KAAK,EAAE,GAAG,YAAY,CAAC;QAE9D,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,MAAM,CAAC,CAAC;QACnD,MAAM,KAAK,GAAG,GAAG,IAAI,CAAC,EAAE,IAAI,SAAS,IAAI,UAAU,EAAE,CAAC;QAEtD,MAAM,OAAO,GAAwB;YACnC,MAAM,EAAE,IAAI,CAAC,EAAE;YACf,SAAS;YACT,cAAc,EAAE,IAAI,CAAC,cAAc;YACnC,YAAY,EAAE,IAAI,CAAC,YAAY;YAC/B,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,iBAAiB,EAAE,IAAI,CAAC,iBAAiB;YACzC,IAAI;YACJ,KAAK,EAAE;gBACL,GAAG,KAAK;gBACR,YAAY;aACb;SACF,CAAC;QAEF,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,SAAS,EAAE,OAAO,EAAE;gBACvC,KAAK;gBACL,gBAAgB,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE;aAChC,CAAC,CAAC;YAEH,IAAI,CAAC,MAAM,CAAC,KAAK,CACf,yCAAyC,IAAI,CAAC,EAAE,UAAU,SAAS,YAAY,YAAY,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CACzG,CAAC;QACJ,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,CAAC,MAAM,CAAC,KAAK,CACf,qDAAqD,IAAI,CAAC,EAAE,KAAK,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CACpH,CAAC;QACJ,CAAC;IACH,CAAC;CACF,CAAA;AA9NY,0CAAe;0BAAf,eAAe;IAD3B,IAAA,mBAAU,GAAE;qCAMmB,iCAAqB;QACd,gDAAsB;QACzB,0CAAmB;GAP1C,eAAe,CA8N3B"}

package/dist/notifier/template.service.d.ts

@@ -0,0 +1,42 @@
+import type { Task } from '@overlordai/protocol';
+export interface NotificationContent {
+    /** Plain-text representation (fallback / web notifications). */
+    text: string;
+    /** Structured card payload for platform adapters. */
+    card: {
+        title: string;
+        fields: Array<{
+            label: string;
+            value: string;
+        }>;
+        actions?: Array<{
+            label: string;
+            url?: string;
+        }>;
+    };
+}
+export declare class TemplateService {
+    private readonly webBaseUrl;
+    /**
+     * Build a task notification (created, running, stage changed, completed, etc.).
+     */
+    buildTaskNotification(task: Task, eventType: string, extra?: {
+        stage?: string;
+        fromStage?: string;
+        toStage?: string;
+        error?: string;
+        reason?: string;
+        stageChanges?: string[];
+    }): NotificationContent;
+    /**
+     * Build a stage-confirm-required notification.
+     */
+    buildStageConfirmNotification(task: Task, stage: string): NotificationContent;
+    /**
+     * Build an admin alert notification.
+     */
+    buildAdminAlert(message: string, resourceType?: string, resourceId?: string): NotificationContent;
+    private buildTitle;
+    private buildFields;
+}
+//# sourceMappingURL=template.service.d.ts.map

package/dist/notifier/template.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"template.service.d.ts","sourceRoot":"","sources":["../../src/notifier/template.service.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,sBAAsB,CAAC;AAmCjD,MAAM,WAAW,mBAAmB;IAClC,gEAAgE;IAChE,IAAI,EAAE,MAAM,CAAC;IACb,qDAAqD;IACrD,IAAI,EAAE;QACJ,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,KAAK,CAAC;YAAE,KAAK,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;QAChD,OAAO,CAAC,EAAE,KAAK,CAAC;YAAE,KAAK,EAAE,MAAM,CAAC;YAAC,GAAG,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;KAClD,CAAC;CACH;AAED,qBACa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,UAAU,CAC2B;IAEtD;;OAEG;IACH,qBAAqB,CACnB,IAAI,EAAE,IAAI,EACV,SAAS,EAAE,MAAM,EACjB,KAAK,CAAC,EAAE;QACN,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;KACzB,GACA,mBAAmB;IAyDtB;;OAEG;IACH,6BAA6B,CAC3B,IAAI,EAAE,IAAI,EACV,KAAK,EAAE,MAAM,GACZ,mBAAmB;IA0BtB;;OAEG;IACH,eAAe,CACb,OAAO,EAAE,MAAM,EACf,YAAY,CAAC,EAAE,MAAM,EACrB,UAAU,CAAC,EAAE,MAAM,GAClB,mBAAmB;IAyBtB,OAAO,CAAC,UAAU;IAgClB,OAAO,CAAC,WAAW;CAkDpB"}