aimeat 1.2.0

package/dist/src/services/hooks.js

@@ -0,0 +1,85 @@
+import { logger } from '../utils/logger.js';
+import { validateOutboundUrl } from '../utils/url-validator.js';
+/**
+ * Execute all extension hooks for a given hook name.
+ * Each hook is an action reference (GAII format).
+ * Actions are called in sequence; if any returns failure, the flow is aborted.
+ */
+export async function executeHooks(config, storage, hookName, context) {
+    const actions = config.extensionHooks[hookName];
+    if (!actions || actions.length === 0) {
+        return { allowed: true };
+    }
+    for (const actionRef of actions) {
+        try {
+            // Action ref format: "actionId#owner@node" or just "actionId"
+            // Try to find by iterating actions since we may not have provider GAII
+            const allActions = await storage.listActions();
+            const action = allActions.find(a => a.id === actionRef || `${a.id}#${a.providerGaii}` === actionRef);
+            if (!action) {
+                logger.warn(`Extension hook ${hookName}: action "${actionRef}" not found, skipping`);
+                continue;
+            }
+            // Execute the hook action via webhook if configured
+            const webhookUrl = action.webhookUrl;
+            if (webhookUrl) {
+                // SSRF validation: block requests to private/reserved IPs
+                const urlCheck = await validateOutboundUrl(webhookUrl);
+                if (!urlCheck.valid) {
+                    logger.warn(`Blocked outbound request to ${webhookUrl}: ${urlCheck.reason}`);
+                    continue;
+                }
+                const response = await fetch(webhookUrl, {
+                    method: 'POST',
+                    headers: { 'Content-Type': 'application/json' },
+                    body: JSON.stringify({
+                        hook: hookName,
+                        action_ref: actionRef,
+                        context,
+                        node_id: config.nodeId,
+                        timestamp: new Date().toISOString(),
+                    }),
+                    signal: AbortSignal.timeout(10_000),
+                });
+                if (!response.ok) {
+                    const body = await response.text().catch(() => '');
+                    logger.info(`Extension hook ${hookName}: action "${actionRef}" rejected`, { status: response.status, body });
+                    return {
+                        allowed: false,
+                        reason: `Hook action "${actionRef}" rejected the request`,
+                        hookAction: actionRef,
+                    };
+                }
+                const result = await response.json().catch(() => ({}));
+                if (result.allowed === false) {
+                    return {
+                        allowed: false,
+                        reason: result.reason ?? `Hook action "${actionRef}" denied`,
+                        hookAction: actionRef,
+                    };
+                }
+            }
+            // If no webhook URL, the action is a no-op placeholder — allow by default
+        }
+        catch (err) {
+            logger.error(`Extension hook ${hookName}: action "${actionRef}" failed`, { error: err });
+            // On hook execution failure, abort (fail-closed for pre-hooks)
+            if (hookName.startsWith('pre_')) {
+                return {
+                    allowed: false,
+                    reason: `Hook action "${actionRef}" failed to execute`,
+                    hookAction: actionRef,
+                };
+            }
+            // Post-hooks failure is logged but doesn't block
+        }
+    }
+    return { allowed: true };
+}
+/**
+ * List all configured extension hooks.
+ */
+export function listHooks(config) {
+    return { ...config.extensionHooks };
+}
+//# sourceMappingURL=hooks.js.map

package/dist/src/services/hooks.js.map

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

package/dist/src/services/job-seeding.d.ts

@@ -0,0 +1,7 @@
+import type { AimeatConfig } from '../config.js';
+import type { Storage } from '../storage/interface.js';
+/**
+ * Seed core scheduled jobs into storage (idempotent -- only creates if not already present).
+ */
+export declare function seedCoreScheduledJobs(config: AimeatConfig, storage: Storage): Promise<void>;
+//# sourceMappingURL=job-seeding.d.ts.map

package/dist/src/services/job-seeding.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"job-seeding.d.ts","sourceRoot":"","sources":["../../../src/services/job-seeding.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AAUvD;;GAEG;AACH,wBAAsB,qBAAqB,CAAC,MAAM,EAAE,YAAY,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAoCjG"}

package/dist/src/services/job-seeding.js

@@ -0,0 +1,39 @@
+import { logger } from '../utils/logger.js';
+/**
+ * Seed core scheduled jobs into storage (idempotent -- only creates if not already present).
+ */
+export async function seedCoreScheduledJobs(config, storage) {
+    const jobs = [
+        { id: 'core:daily-allowance', name: 'Daily Allowance', coreHandler: 'daily-allowance', cron: '0 0 * * *' },
+        { id: 'core:work-timeout', name: 'Work Timeout Expiry', coreHandler: 'work-timeout', cron: '* * * * *' },
+        { id: 'core:memory-ttl-cleanup', name: 'Memory TTL Cleanup', coreHandler: 'memory-ttl-cleanup', cron: '*/5 * * * *' },
+        { id: 'core:board-post-ttl-cleanup', name: 'Board Post TTL Cleanup', coreHandler: 'board-post-ttl-cleanup', cron: '*/10 * * * *' },
+        { id: 'core:dispute-timeout', name: 'Dispute Auto-Escalation', coreHandler: 'dispute-timeout', cron: '0 * * * *' },
+        { id: 'core:execution-log-prune', name: 'Execution Log Prune', coreHandler: 'execution-log-prune', cron: '0 3 * * *' },
+    ];
+    if (config.consentEnabled) {
+        jobs.push({ id: 'core:consent-expiry', name: 'Consent Expiry', coreHandler: 'consent-expiry', cron: '*/10 * * * *' });
+    }
+    if (config.personalNodesEnabled) {
+        jobs.push({ id: 'core:mailbox-cleanup', name: 'Mailbox Cleanup', coreHandler: 'mailbox-cleanup', cron: '*/10 * * * *' });
+    }
+    const now = new Date().toISOString();
+    for (const def of jobs) {
+        const existing = await storage.getScheduledJob(def.id);
+        if (!existing) {
+            await storage.createScheduledJob({
+                id: def.id,
+                name: def.name,
+                type: 'core',
+                coreHandler: def.coreHandler,
+                cron: def.cron,
+                enabled: true,
+                createdBy: `system@${config.nodeId}`,
+                createdAt: now,
+                updatedAt: now,
+            });
+            logger.info(`Seeded core scheduled job: ${def.id} (${def.cron})`);
+        }
+    }
+}
+//# sourceMappingURL=job-seeding.js.map

package/dist/src/services/job-seeding.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"job-seeding.js","sourceRoot":"","sources":["../../../src/services/job-seeding.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAS5C;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAAC,MAAoB,EAAE,OAAgB;IAChF,MAAM,IAAI,GAAiB;QACzB,EAAE,EAAE,EAAE,sBAAsB,EAAE,IAAI,EAAE,iBAAiB,EAAE,WAAW,EAAE,iBAAiB,EAAE,IAAI,EAAE,WAAW,EAAE;QAC1G,EAAE,EAAE,EAAE,mBAAmB,EAAE,IAAI,EAAE,qBAAqB,EAAE,WAAW,EAAE,cAAc,EAAE,IAAI,EAAE,WAAW,EAAE;QACxG,EAAE,EAAE,EAAE,yBAAyB,EAAE,IAAI,EAAE,oBAAoB,EAAE,WAAW,EAAE,oBAAoB,EAAE,IAAI,EAAE,aAAa,EAAE;QACrH,EAAE,EAAE,EAAE,6BAA6B,EAAE,IAAI,EAAE,wBAAwB,EAAE,WAAW,EAAE,wBAAwB,EAAE,IAAI,EAAE,cAAc,EAAE;QAClI,EAAE,EAAE,EAAE,sBAAsB,EAAE,IAAI,EAAE,yBAAyB,EAAE,WAAW,EAAE,iBAAiB,EAAE,IAAI,EAAE,WAAW,EAAE;QAClH,EAAE,EAAE,EAAE,0BAA0B,EAAE,IAAI,EAAE,qBAAqB,EAAE,WAAW,EAAE,qBAAqB,EAAE,IAAI,EAAE,WAAW,EAAE;KACvH,CAAC;IAEF,IAAI,MAAM,CAAC,cAAc,EAAE,CAAC;QAC1B,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,qBAAqB,EAAE,IAAI,EAAE,gBAAgB,EAAE,WAAW,EAAE,gBAAgB,EAAE,IAAI,EAAE,cAAc,EAAE,CAAC,CAAC;IACxH,CAAC;IAED,IAAI,MAAM,CAAC,oBAAoB,EAAE,CAAC;QAChC,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,sBAAsB,EAAE,IAAI,EAAE,iBAAiB,EAAE,WAAW,EAAE,iBAAiB,EAAE,IAAI,EAAE,cAAc,EAAE,CAAC,CAAC;IAC3H,CAAC;IAED,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACrC,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,eAAe,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACvD,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,MAAM,OAAO,CAAC,kBAAkB,CAAC;gBAC/B,EAAE,EAAE,GAAG,CAAC,EAAE;gBACV,IAAI,EAAE,GAAG,CAAC,IAAI;gBACd,IAAI,EAAE,MAAM;gBACZ,WAAW,EAAE,GAAG,CAAC,WAAW;gBAC5B,IAAI,EAAE,GAAG,CAAC,IAAI;gBACd,OAAO,EAAE,IAAI;gBACb,SAAS,EAAE,UAAU,MAAM,CAAC,MAAM,EAAE;gBACpC,SAAS,EAAE,GAAG;gBACd,SAAS,EAAE,GAAG;aACf,CAAC,CAAC;YACH,MAAM,CAAC,IAAI,CAAC,8BAA8B,GAAG,CAAC,EAAE,KAAK,GAAG,CAAC,IAAI,GAAG,CAAC,CAAC;QACpE,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/src/services/knowledge.d.ts

@@ -0,0 +1,13 @@
+import type { Storage } from '../storage/interface.js';
+/**
+ * Knowledge template seeding — REMOVED.
+ *
+ * Previously seeded knowledge packager prompt templates into memory.
+ * Now the system prompt storage is authoritative (see prompt-defaults.ts
+ * for 'knowledge-packager-human' and 'knowledge-packager-agent' entries).
+ *
+ * This function is kept as a no-op for backward compatibility with server.ts
+ * startup sequence. It can be removed once all callers are updated.
+ */
+export declare function seedKnowledgeTemplates(_storage: Storage, _systemGaii: string): Promise<void>;
+//# sourceMappingURL=knowledge.d.ts.map

package/dist/src/services/knowledge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"knowledge.d.ts","sourceRoot":"","sources":["../../../src/services/knowledge.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AAEvD;;;;;;;;;GASG;AACH,wBAAsB,sBAAsB,CAAC,QAAQ,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAGlG"}

package/dist/src/services/knowledge.js

@@ -0,0 +1,15 @@
+/**
+ * Knowledge template seeding — REMOVED.
+ *
+ * Previously seeded knowledge packager prompt templates into memory.
+ * Now the system prompt storage is authoritative (see prompt-defaults.ts
+ * for 'knowledge-packager-human' and 'knowledge-packager-agent' entries).
+ *
+ * This function is kept as a no-op for backward compatibility with server.ts
+ * startup sequence. It can be removed once all callers are updated.
+ */
+export async function seedKnowledgeTemplates(_storage, _systemGaii) {
+    // No-op: knowledge packager templates are now managed via system prompt storage
+    // (seeded by prompt-seeder.ts from prompt-defaults.ts)
+}
+//# sourceMappingURL=knowledge.js.map

package/dist/src/services/knowledge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"knowledge.js","sourceRoot":"","sources":["../../../src/services/knowledge.ts"],"names":[],"mappings":"AAEA;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAAC,QAAiB,EAAE,WAAmB;IACjF,gFAAgF;IAChF,uDAAuD;AACzD,CAAC"}

package/dist/src/services/mailbox-notification.d.ts

@@ -0,0 +1,37 @@
+import type { AimeatConfig } from '../config.js';
+import type { Storage, MailboxItemRecord } from '../storage/interface.js';
+export interface MailboxPushPayload {
+    type: 'mailbox_alert';
+    node_id: string;
+    pending_count: number;
+    highest_priority_type: string;
+    oldest_item_age_minutes: number;
+    operator_node: string;
+    timestamp: string;
+}
+export interface NotifyResult {
+    sent: boolean;
+    channel?: string;
+    reason?: string;
+}
+export declare function isAllowedPushEndpoint(endpoint: string): boolean;
+export declare class MailboxNotificationService {
+    private config;
+    private storage;
+    private webpush;
+    private emailTransport;
+    private cooldownMap;
+    private emailCooldownMap;
+    constructor(config: AimeatConfig, storage: Storage);
+    /**
+     * Notify the owner of a personal node that a message has been queued.
+     * Fire-and-forget — callers should `void` this.
+     */
+    notify(personalNodeId: string, mailboxItem: MailboxItemRecord): Promise<NotifyResult>;
+    /** Clear cooldown when a node reconnects */
+    clearCooldown(personalNodeId: string): void;
+    private sendWebPush;
+    private sendEmail;
+    private isInQuietHours;
+}
+//# sourceMappingURL=mailbox-notification.d.ts.map

package/dist/src/services/mailbox-notification.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mailbox-notification.d.ts","sourceRoot":"","sources":["../../../src/services/mailbox-notification.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,KAAK,EAAE,OAAO,EAAE,iBAAiB,EAA2D,MAAM,yBAAyB,CAAC;AAMnI,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,eAAe,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,MAAM,CAAC;IACtB,qBAAqB,EAAE,MAAM,CAAC;IAC9B,uBAAuB,EAAE,MAAM,CAAC;IAChC,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,OAAO,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAWD,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAS/D;AAeD,qBAAa,0BAA0B;IAOnC,OAAO,CAAC,MAAM;IACd,OAAO,CAAC,OAAO;IAPjB,OAAO,CAAC,OAAO,CAA0C;IACzD,OAAO,CAAC,cAAc,CAAiD;IACvE,OAAO,CAAC,WAAW,CAA6B;IAChD,OAAO,CAAC,gBAAgB,CAA6B;gBAG3C,MAAM,EAAE,YAAY,EACpB,OAAO,EAAE,OAAO;IAuC1B;;;OAGG;IACG,MAAM,CAAC,cAAc,EAAE,MAAM,EAAE,WAAW,EAAE,iBAAiB,GAAG,OAAO,CAAC,YAAY,CAAC;IAuE3F,4CAA4C;IAC5C,aAAa,CAAC,cAAc,EAAE,MAAM,GAAG,IAAI;YAK7B,WAAW;YA2CX,SAAS;IAwCvB,OAAO,CAAC,cAAc;CAgBvB"}

package/dist/src/services/mailbox-notification.js

@@ -0,0 +1,249 @@
+import { createRequire } from 'node:module';
+import { logger } from '../utils/logger.js';
+import { resolveTemplate } from './notification-templates.js';
+const require = createRequire(import.meta.url);
+/** Allowed push service domains (SSRF prevention) */
+const ALLOWED_PUSH_DOMAINS = [
+    'fcm.googleapis.com',
+    'updates.push.services.mozilla.com',
+    'notify.windows.com',
+    'push.apple.com',
+    'web.push.apple.com',
+];
+export function isAllowedPushEndpoint(endpoint) {
+    try {
+        const url = new URL(endpoint);
+        return ALLOWED_PUSH_DOMAINS.some(domain => url.hostname === domain || url.hostname.endsWith('.' + domain));
+    }
+    catch {
+        return false;
+    }
+}
+/** Default notification preferences for a new node */
+function defaultPreferences(personalNodeId, config) {
+    return {
+        personalNodeId,
+        enabled: true,
+        channels: ['web_push'],
+        notifyTypes: [...config.pushNotifyTypes],
+        cooldownMinutes: config.pushCooldownMin,
+        quietHoursUtc: null,
+        email: null,
+    };
+}
+export class MailboxNotificationService {
+    config;
+    storage;
+    webpush = null;
+    emailTransport = null;
+    cooldownMap = new Map();
+    emailCooldownMap = new Map();
+    constructor(config, storage) {
+        this.config = config;
+        this.storage = storage;
+        if (config.pushEnabled && config.vapidPublicKey && config.vapidPrivateKey) {
+            try {
+                this.webpush = require('web-push');
+                this.webpush.setVapidDetails(config.vapidSubject, config.vapidPublicKey, config.vapidPrivateKey);
+                logger.info('MailboxNotificationService: web-push initialized');
+            }
+            catch (err) {
+                logger.warn('MailboxNotificationService: failed to initialize web-push', { error: String(err) });
+            }
+        }
+        // Email transport (Phase 2)
+        if (config.smtpHost && config.smtpUser) {
+            try {
+                const nodemailer = require('nodemailer');
+                this.emailTransport = nodemailer.createTransport({
+                    host: config.smtpHost,
+                    port: config.smtpPort,
+                    secure: config.smtpSecure,
+                    auth: {
+                        user: config.smtpUser,
+                        pass: config.smtpPass ?? '',
+                    },
+                    tls: {
+                        rejectUnauthorized: config.smtpRejectUnauthorized,
+                    },
+                });
+                logger.info('MailboxNotificationService: email transport initialized');
+            }
+            catch (err) {
+                logger.warn('MailboxNotificationService: failed to initialize email transport', { error: String(err) });
+            }
+        }
+    }
+    /**
+     * Notify the owner of a personal node that a message has been queued.
+     * Fire-and-forget — callers should `void` this.
+     */
+    async notify(personalNodeId, mailboxItem) {
+        try {
+            const prefs = (await this.storage.getNotificationPreferences(personalNodeId))
+                ?? defaultPreferences(personalNodeId, this.config);
+            if (!prefs.enabled) {
+                return { sent: false, reason: 'notifications_disabled' };
+            }
+            if (!prefs.notifyTypes.includes(mailboxItem.type)) {
+                return { sent: false, reason: 'type_not_configured' };
+            }
+            const now = Date.now();
+            const lastNotified = this.cooldownMap.get(personalNodeId) ?? 0;
+            const cooldownMs = prefs.cooldownMinutes * 60_000;
+            if (now - lastNotified < cooldownMs) {
+                return { sent: false, reason: 'cooldown_active' };
+            }
+            if (this.isInQuietHours(prefs)) {
+                return { sent: false, reason: 'quiet_hours' };
+            }
+            const stats = await this.storage.getMailboxStats(personalNodeId);
+            // Only fetch oldest item for age calculation (limit 1 to avoid loading all items)
+            const oldestItems = await this.storage.listMailboxItems(personalNodeId, { limit: 1 });
+            const oldestAge = oldestItems.length > 0
+                ? Math.round((now - new Date(oldestItems[0].createdAt).getTime()) / 60_000)
+                : 0;
+            const payload = {
+                type: 'mailbox_alert',
+                node_id: personalNodeId,
+                pending_count: stats.count,
+                highest_priority_type: mailboxItem.type,
+                oldest_item_age_minutes: oldestAge,
+                operator_node: this.config.nodeId,
+                timestamp: new Date().toISOString(),
+            };
+            const locale = prefs.locale ?? 'en';
+            let sentAny = false;
+            const sentChannels = [];
+            if (prefs.channels.includes('web_push') && this.webpush) {
+                const subscriptions = await this.storage.listPersonalPushSubscriptions(personalNodeId);
+                for (const sub of subscriptions) {
+                    const ok = await this.sendWebPush(sub, payload, locale);
+                    if (ok) {
+                        sentAny = true;
+                        sentChannels.push('web_push');
+                    }
+                }
+            }
+            // Email channel
+            if (prefs.channels.includes('email') && prefs.email) {
+                const emailSent = await this.sendEmail(personalNodeId, prefs.email, payload, locale);
+                if (emailSent) {
+                    sentAny = true;
+                    sentChannels.push('email');
+                }
+            }
+            if (sentAny) {
+                this.cooldownMap.set(personalNodeId, now);
+            }
+            const uniqueChannels = [...new Set(sentChannels)];
+            return { sent: sentAny, channel: uniqueChannels.join(',') || undefined };
+        }
+        catch (err) {
+            logger.error('MailboxNotificationService.notify failed', { personalNodeId, error: String(err) });
+            return { sent: false, reason: 'internal_error' };
+        }
+    }
+    /** Clear cooldown when a node reconnects */
+    clearCooldown(personalNodeId) {
+        this.cooldownMap.delete(personalNodeId);
+        this.emailCooldownMap.delete(personalNodeId);
+    }
+    async sendWebPush(sub, payload, locale) {
+        if (!this.webpush)
+            return false;
+        try {
+            const tpl = await resolveTemplate(this.storage, 'web_push_mailbox', locale, {
+                count: payload.pending_count,
+                type: payload.highest_priority_type,
+            });
+            await this.webpush.sendNotification({ endpoint: sub.endpoint, keys: sub.keys }, JSON.stringify({
+                title: tpl.title ?? 'AIMEAT: Pending messages',
+                body: tpl.body,
+                icon: '/icons/icon-192.png',
+                tag: 'mailbox-alert',
+                data: payload,
+            }), { TTL: 3600 });
+            await this.storage.updatePersonalPushSubscription(sub.id, {
+                lastUsedAt: new Date().toISOString(),
+                failureCount: 0,
+            });
+            logger.info('Web push notification sent', { nodeId: sub.personalNodeId, subId: sub.id });
+            return true;
+        }
+        catch (err) {
+            const statusCode = err.statusCode;
+            if (statusCode === 404 || statusCode === 410) {
+                await this.storage.deletePersonalPushSubscription(sub.id);
+                logger.info('Push subscription expired, removed', { subId: sub.id, nodeId: sub.personalNodeId });
+            }
+            else {
+                const newCount = sub.failureCount + 1;
+                if (newCount >= this.config.pushMaxFailures) {
+                    await this.storage.deletePersonalPushSubscription(sub.id);
+                    logger.warn('Push subscription removed after max failures', { subId: sub.id, failures: newCount });
+                }
+                else {
+                    await this.storage.updatePersonalPushSubscription(sub.id, { failureCount: newCount });
+                    logger.warn('Push notification failed', { subId: sub.id, failureCount: newCount, error: String(err) });
+                }
+            }
+            return false;
+        }
+    }
+    async sendEmail(personalNodeId, email, payload, locale) {
+        if (!this.emailTransport)
+            return false;
+        // Check email-specific rate limit
+        const now = Date.now();
+        const lastEmail = this.emailCooldownMap.get(personalNodeId) ?? 0;
+        const emailCooldownMs = this.config.emailRateLimitMin * 60_000;
+        if (now - lastEmail < emailCooldownMs) {
+            return false;
+        }
+        try {
+            const tpl = await resolveTemplate(this.storage, 'email_mailbox', locale, {
+                count: payload.pending_count,
+                type: payload.highest_priority_type,
+                nodeId: payload.node_id,
+                age: payload.oldest_item_age_minutes,
+            });
+            await this.emailTransport.sendMail({
+                from: this.config.smtpFrom,
+                to: email,
+                subject: tpl.subject ?? `AIMEAT: ${payload.pending_count} pending message(s) for your node`,
+                text: [
+                    tpl.body,
+                    '',
+                    '---',
+                    'This notification was sent by the AIMEAT Protocol.',
+                    'To unsubscribe, update your notification preferences via PATCH /v1/personal/anchor/<nodeId>/notifications',
+                ].join('\n'),
+            });
+            this.emailCooldownMap.set(personalNodeId, now);
+            logger.info('Email notification sent', { personalNodeId, email: email.substring(0, 3) + '***' });
+            return true;
+        }
+        catch (err) {
+            logger.error('Email notification failed', { personalNodeId, error: String(err) });
+            return false;
+        }
+    }
+    isInQuietHours(prefs) {
+        if (!prefs.quietHoursUtc)
+            return false;
+        const now = new Date();
+        const currentMinutes = now.getUTCHours() * 60 + now.getUTCMinutes();
+        const [startH, startM] = prefs.quietHoursUtc.start.split(':').map(Number);
+        const [endH, endM] = prefs.quietHoursUtc.end.split(':').map(Number);
+        const startMinutes = startH * 60 + startM;
+        const endMinutes = endH * 60 + endM;
+        if (startMinutes <= endMinutes) {
+            return currentMinutes >= startMinutes && currentMinutes < endMinutes;
+        }
+        else {
+            return currentMinutes >= startMinutes || currentMinutes < endMinutes;
+        }
+    }
+}
+//# sourceMappingURL=mailbox-notification.js.map

package/dist/src/services/mailbox-notification.js.map

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

package/dist/src/services/mailbox.d.ts

@@ -0,0 +1,16 @@
+import type { AimeatConfig } from '../config.js';
+import type { Storage, MailboxItemRecord } from '../storage/interface.js';
+export declare class MailboxService {
+    private config;
+    private storage;
+    constructor(config: AimeatConfig, storage: Storage);
+    enqueue(personalNodeId: string, item: Omit<MailboxItemRecord, 'id' | 'createdAt' | 'expiresAt'>): Promise<MailboxItemRecord | null>;
+    flush(personalNodeId: string): Promise<MailboxItemRecord[]>;
+    hasCapacity(personalNodeId: string, additionalBytes: number): Promise<boolean>;
+    cleanExpired(): Promise<number>;
+    getStats(personalNodeId: string): Promise<{
+        count: number;
+        totalBytes: number;
+    }>;
+}
+//# sourceMappingURL=mailbox.d.ts.map

package/dist/src/services/mailbox.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mailbox.d.ts","sourceRoot":"","sources":["../../../src/services/mailbox.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,KAAK,EAAE,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAK1E,qBAAa,cAAc;IAEvB,OAAO,CAAC,MAAM;IACd,OAAO,CAAC,OAAO;gBADP,MAAM,EAAE,YAAY,EACpB,OAAO,EAAE,OAAO;IAGpB,OAAO,CACX,cAAc,EAAE,MAAM,EACtB,IAAI,EAAE,IAAI,CAAC,iBAAiB,EAAE,IAAI,GAAG,WAAW,GAAG,WAAW,CAAC,GAC9D,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC;IAoC9B,KAAK,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC;IAI3D,WAAW,CAAC,cAAc,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAM9E,YAAY,IAAI,OAAO,CAAC,MAAM,CAAC;IAc/B,QAAQ,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC;CAGvF"}

package/dist/src/services/mailbox.js

@@ -0,0 +1,77 @@
+import { v4 as uuidv4 } from 'uuid';
+import { logger } from '../utils/logger.js';
+import { getStats } from './stats.js';
+import { getPromMetrics } from './prometheus.js';
+export class MailboxService {
+    config;
+    storage;
+    constructor(config, storage) {
+        this.config = config;
+        this.storage = storage;
+    }
+    async enqueue(personalNodeId, item) {
+        // Check capacity
+        const hasRoom = await this.hasCapacity(personalNodeId, item.sizeBytes);
+        if (!hasRoom) {
+            const stats = getStats();
+            if (stats)
+                stats.incrementMailbox('quota_rejections_total');
+            const prom = getPromMetrics();
+            if (prom)
+                prom.mailboxQuotaRejectionsTotal.inc();
+            logger.warn('Mailbox quota exceeded', { personalNodeId, sizeBytes: item.sizeBytes });
+            return null;
+        }
+        const now = new Date();
+        const retentionMs = item.retentionDays * 24 * 3600_000;
+        const record = {
+            ...item,
+            id: uuidv4(),
+            expiresAt: new Date(now.getTime() + retentionMs).toISOString(),
+            createdAt: now.toISOString(),
+        };
+        const created = await this.storage.createMailboxItem(record);
+        const stats = getStats();
+        if (stats)
+            stats.incrementMailbox('enqueued_total');
+        const prom = getPromMetrics();
+        if (prom)
+            prom.mailboxEnqueuedTotal.inc({ type: item.type });
+        logger.info('Mailbox item queued', {
+            personalNodeId,
+            type: item.type,
+            from: item.fromGaii,
+            to: item.toGaii,
+            sizeBytes: item.sizeBytes,
+        });
+        return created;
+    }
+    async flush(personalNodeId) {
+        return this.storage.listMailboxItems(personalNodeId);
+    }
+    async hasCapacity(personalNodeId, additionalBytes) {
+        const node = await this.storage.getPersonalNode(personalNodeId);
+        if (!node)
+            return false;
+        return (node.mailboxUsedBytes + additionalBytes) <= node.mailboxQuotaBytes;
+    }
+    async cleanExpired() {
+        const removed = await this.storage.cleanExpiredMailboxItems();
+        const stats = getStats();
+        if (stats && removed > 0) {
+            for (let i = 0; i < removed; i++)
+                stats.incrementMailbox('expired_total');
+        }
+        const prom = getPromMetrics();
+        if (prom && removed > 0)
+            prom.mailboxExpiredTotal.inc(removed);
+        if (removed > 0) {
+            logger.info(`Mailbox cleanup: removed ${removed} expired items`);
+        }
+        return removed;
+    }
+    async getStats(personalNodeId) {
+        return this.storage.getMailboxStats(personalNodeId);
+    }
+}
+//# sourceMappingURL=mailbox.js.map

package/dist/src/services/mailbox.js.map

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

package/dist/src/services/match-notification.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Match Notification Service — Phase 1.6
+ *
+ * Background job that periodically scans the directory index for
+ * new matches and sends email notifications to users who opted in.
+ */
+import type { AimeatConfig } from '../config.js';
+import type { Storage } from '../storage/interface.js';
+import type { EmailService } from './email.js';
+import type { DirectoryService } from './directory.js';
+export declare function startMatchNotificationJob(config: AimeatConfig, storage: Storage, emailService: EmailService, directoryService: DirectoryService): NodeJS.Timeout | null;
+//# sourceMappingURL=match-notification.d.ts.map

package/dist/src/services/match-notification.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"match-notification.d.ts","sourceRoot":"","sources":["../../../src/services/match-notification.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,KAAK,EAAE,gBAAgB,EAAkB,MAAM,gBAAgB,CAAC;AASvE,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,YAAY,EACpB,OAAO,EAAE,OAAO,EAChB,YAAY,EAAE,YAAY,EAC1B,gBAAgB,EAAE,gBAAgB,GACjC,MAAM,CAAC,OAAO,GAAG,IAAI,CAkIvB"}