@pellux/goodvibes-sdk 0.18.3 → 0.18.11

package/dist/platform/runtime/notifications/formatters/panel-jump.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Panel jump action generator — creates NotificationAction objects that
+ * instruct the UI to focus a specific panel. These actions are attached to
+ * conversation-surface notifications so the user can jump directly from a
+ * summary to the relevant panel for full detail.
+ */
+import type { NotificationAction } from '../types.js';
+/**
+ * Create a "Jump to panel" action for a given panel ID.
+ *
+ * @param panelId - The panel to navigate to on activation.
+ * @param label   - Optional custom label (defaults to "Jump to panel").
+ * @returns A NotificationAction of type `jump_to_panel`.
+ */
+export declare function createPanelJumpAction(panelId: string, label?: string): NotificationAction;
+/**
+ * Create a dismiss action for a notification.
+ *
+ * @param label - Optional custom label (defaults to "Dismiss").
+ * @returns A NotificationAction of type `dismiss`.
+ */
+export declare function createDismissAction(label?: string): NotificationAction;
+//# sourceMappingURL=panel-jump.d.ts.map

package/dist/platform/runtime/notifications/formatters/panel-jump.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"panel-jump.d.ts","sourceRoot":"","sources":["../../../../../src/platform/runtime/notifications/formatters/panel-jump.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAEtD;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,MAAM,EACf,KAAK,SAAkB,GACtB,kBAAkB,CAMpB;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,SAAY,GAAG,kBAAkB,CAKzE"}

package/dist/platform/runtime/notifications/formatters/panel-jump.js

@@ -0,0 +1,32 @@
+/**
+ * Panel jump action generator — creates NotificationAction objects that
+ * instruct the UI to focus a specific panel. These actions are attached to
+ * conversation-surface notifications so the user can jump directly from a
+ * summary to the relevant panel for full detail.
+ */
+/**
+ * Create a "Jump to panel" action for a given panel ID.
+ *
+ * @param panelId - The panel to navigate to on activation.
+ * @param label   - Optional custom label (defaults to "Jump to panel").
+ * @returns A NotificationAction of type `jump_to_panel`.
+ */
+export function createPanelJumpAction(panelId, label = 'Jump to panel') {
+    return {
+        label,
+        type: 'jump_to_panel',
+        panelId,
+    };
+}
+/**
+ * Create a dismiss action for a notification.
+ *
+ * @param label - Optional custom label (defaults to "Dismiss").
+ * @returns A NotificationAction of type `dismiss`.
+ */
+export function createDismissAction(label = 'Dismiss') {
+    return {
+        label,
+        type: 'dismiss',
+    };
+}

package/dist/platform/runtime/notifications/formatters/summary.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Summary formatter — produces condensed single-line summaries for batched
+ * or grouped notifications destined for the conversation surface. Keeps the
+ * main conversation high-signal by collapsing repeated events into a brief
+ * human-readable description.
+ */
+import type { Notification } from '../types.js';
+/**
+ * Format a single notification as a condensed one-line summary.
+ *
+ * @param notification - The notification to summarise.
+ * @returns A short string suitable for inline conversation display.
+ */
+export declare function formatNotificationSummary(notification: Notification): string;
+/**
+ * Format a group of related notifications into a single condensed summary
+ * line. Used when the batch policy has collapsed multiple events.
+ *
+ * @param notifications - The notifications to collapse (must be non-empty).
+ * @returns A condensed summary string, e.g.
+ *          "[Info] Tool progress (×12 events) — last: Wrote 3 files"
+ */
+export declare function formatBatchSummary(notifications: Notification[]): string;
+//# sourceMappingURL=summary.d.ts.map

package/dist/platform/runtime/notifications/formatters/summary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"summary.d.ts","sourceRoot":"","sources":["../../../../../src/platform/runtime/notifications/formatters/summary.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAqB,MAAM,aAAa,CAAC;AAanE;;;;;GAKG;AACH,wBAAgB,yBAAyB,CAAC,YAAY,EAAE,YAAY,GAAG,MAAM,CAa5E;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,aAAa,EAAE,YAAY,EAAE,GAAG,MAAM,CAmBxE"}

package/dist/platform/runtime/notifications/formatters/summary.js

@@ -0,0 +1,56 @@
+/**
+ * Summary formatter — produces condensed single-line summaries for batched
+ * or grouped notifications destined for the conversation surface. Keeps the
+ * main conversation high-signal by collapsing repeated events into a brief
+ * human-readable description.
+ */
+/** Maximum length for a truncated notification body in summaries. */
+const MAX_BODY_PREVIEW = 80;
+/** Level labels used in summary lines. */
+const LEVEL_LABELS = {
+    critical: 'CRITICAL',
+    warning: 'Warning',
+    info: 'Info',
+    debug: 'Debug',
+};
+/**
+ * Format a single notification as a condensed one-line summary.
+ *
+ * @param notification - The notification to summarise.
+ * @returns A short string suitable for inline conversation display.
+ */
+export function formatNotificationSummary(notification) {
+    const label = LEVEL_LABELS[notification.level];
+    const body = notification.body && notification.body.length > MAX_BODY_PREVIEW
+        ? `${notification.body.slice(0, MAX_BODY_PREVIEW)}…`
+        : notification.body;
+    const parts = [`[${label}] ${notification.title}`];
+    if (body) {
+        parts.push(body);
+    }
+    return parts.join(' — ');
+}
+/**
+ * Format a group of related notifications into a single condensed summary
+ * line. Used when the batch policy has collapsed multiple events.
+ *
+ * @param notifications - The notifications to collapse (must be non-empty).
+ * @returns A condensed summary string, e.g.
+ *          "[Info] Tool progress (×12 events) — last: Wrote 3 files"
+ */
+export function formatBatchSummary(notifications) {
+    if (notifications.length === 0) {
+        return '';
+    }
+    if (notifications.length === 1) {
+        return formatNotificationSummary(notifications[0]);
+    }
+    const last = notifications[notifications.length - 1];
+    const label = LEVEL_LABELS[last.level];
+    const count = notifications.length;
+    const preview = last.body && last.body.length > MAX_BODY_PREVIEW
+        ? `${last.body.slice(0, MAX_BODY_PREVIEW)}…`
+        : last.body;
+    const suffix = preview ? ` — last: ${preview}` : '';
+    return `[${label}] ${last.title} (\xD7${count} events)${suffix}`;
+}

package/dist/platform/runtime/notifications/index.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Notification routing module — barrel export and factory.
+ *
+ * Implements conversation noise routing.
+ * Operational noise is routed to dedicated panels while the main
+ * conversation receives only high-signal items.
+ *
+ * @example
+ * ```ts
+ * import { createNotificationRouter } from './notifications/index.js';
+ *
+ * const router = createNotificationRouter();
+ * router.setDomainVerbosity('tools', 'minimal');
+ * router.setQuietWhileTyping(true);
+ *
+ * const decision = router.route(myNotification);
+ * ```
+ */
+export type { NotificationLevel, NotificationTarget, DomainVerbosity, NotificationAction, Notification, RoutingDecision, RoutedNotification, DomainConfig, RoutingReasonCode, NotificationTag, } from './types.js';
+export { NotificationRouter } from './router.js';
+export { applyDefaultPolicy, applyQuietTypingPolicy, BatchPolicy, applyModeContextPolicy, BurstPolicy, } from './policies/index.js';
+export { formatNotificationSummary, formatBatchSummary, createPanelJumpAction, createDismissAction, } from './formatters/index.js';
+import { NotificationRouter } from './router.js';
+/**
+ * Factory function — creates a NotificationRouter with default policy stack.
+ *
+ * @param batchWindowMs - Optional batch window override in milliseconds
+ *                        (default: 2000ms).
+ * @returns A configured NotificationRouter instance ready for use.
+ */
+export declare function createNotificationRouter(batchWindowMs?: number, adaptiveSuppression?: boolean): NotificationRouter;
+//# sourceMappingURL=index.d.ts.map

package/dist/platform/runtime/notifications/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/platform/runtime/notifications/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,YAAY,EACV,iBAAiB,EACjB,kBAAkB,EAClB,eAAe,EACf,kBAAkB,EAClB,YAAY,EACZ,eAAe,EACf,kBAAkB,EAClB,YAAY,EACZ,iBAAiB,EACjB,eAAe,GAChB,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAEjD,OAAO,EACL,kBAAkB,EAClB,sBAAsB,EACtB,WAAW,EACX,sBAAsB,EACtB,WAAW,GACZ,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,yBAAyB,EACzB,kBAAkB,EAClB,qBAAqB,EACrB,mBAAmB,GACpB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAEjD;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CACtC,aAAa,CAAC,EAAE,MAAM,EACtB,mBAAmB,CAAC,EAAE,OAAO,GAC5B,kBAAkB,CAEpB"}

package/dist/platform/runtime/notifications/index.js

@@ -0,0 +1,32 @@
+/**
+ * Notification routing module — barrel export and factory.
+ *
+ * Implements conversation noise routing.
+ * Operational noise is routed to dedicated panels while the main
+ * conversation receives only high-signal items.
+ *
+ * @example
+ * ```ts
+ * import { createNotificationRouter } from './notifications/index.js';
+ *
+ * const router = createNotificationRouter();
+ * router.setDomainVerbosity('tools', 'minimal');
+ * router.setQuietWhileTyping(true);
+ *
+ * const decision = router.route(myNotification);
+ * ```
+ */
+export { NotificationRouter } from './router.js';
+export { applyDefaultPolicy, applyQuietTypingPolicy, BatchPolicy, applyModeContextPolicy, BurstPolicy, } from './policies/index.js';
+export { formatNotificationSummary, formatBatchSummary, createPanelJumpAction, createDismissAction, } from './formatters/index.js';
+import { NotificationRouter } from './router.js';
+/**
+ * Factory function — creates a NotificationRouter with default policy stack.
+ *
+ * @param batchWindowMs - Optional batch window override in milliseconds
+ *                        (default: 2000ms).
+ * @returns A configured NotificationRouter instance ready for use.
+ */
+export function createNotificationRouter(batchWindowMs, adaptiveSuppression) {
+    return new NotificationRouter(batchWindowMs, adaptiveSuppression);
+}

package/dist/platform/runtime/notifications/policies/batch-policy.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Batch policy — collapses repeated notifications from the same domain +
+ * level within a rolling time window to prevent UI flooding from high-
+ * frequency operational events (e.g. tool progress ticks, agent heartbeats).
+ */
+import type { Notification } from '../types.js';
+/**
+ * BatchPolicy tracks repeated notifications and decides whether a new
+ * arrival should be collapsed into an existing batch group.
+ *
+ * A batch group key is `{domain}:{level}`. Two notifications sharing the
+ * same key within `batchWindowMs` are considered duplicates.
+ */
+export declare class BatchPolicy {
+    /** Active batch groups keyed by `{domain}:{level}`. */
+    private readonly groups;
+    /** Pending flushed notifications paired with their batch count. */
+    private readonly pending;
+    /** Rolling window in ms within which repeated notifications are batched. */
+    private readonly batchWindowMs;
+    constructor(batchWindowMs?: number);
+    /**
+     * Builds the batch group key for a notification.
+     *
+     * @param notification - The notification to key.
+     * @returns A string key in the form `{domain}:{level}`.
+     */
+    private buildKey;
+    /**
+     * Evaluates a notification against the batch policy.
+     *
+     * @param notification - Incoming notification to evaluate.
+     * @returns The batch group key if this notification is being batched,
+     *          or undefined if it should be routed immediately.
+     */
+    evaluate(notification: Notification): string | undefined;
+    /**
+     * Flushes all pending batched notifications.
+     *
+     * Call this at the end of a batch cycle (e.g. on a timer tick or when
+     * quiet-typing mode ends) to surface collapsed notifications.
+     *
+     * @param now - Optional timestamp override for expiry checks (defaults to Date.now()).
+     * @returns Array of the most-recent notification from each expired batch group, paired with batch count.
+     */
+    flush(now?: number): Array<{
+        notification: Notification;
+        batchCount: number;
+    }>;
+}
+//# sourceMappingURL=batch-policy.d.ts.map

package/dist/platform/runtime/notifications/policies/batch-policy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"batch-policy.d.ts","sourceRoot":"","sources":["../../../../../src/platform/runtime/notifications/policies/batch-policy.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAehD;;;;;;GAMG;AACH,qBAAa,WAAW;IACtB,uDAAuD;IACvD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAiC;IAExD,mEAAmE;IACnE,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAiE;IAEzF,4EAA4E;IAC5E,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;gBAE3B,aAAa,GAAE,MAAgC;IAI3D;;;;;OAKG;IACH,OAAO,CAAC,QAAQ;IAIhB;;;;;;OAMG;IACH,QAAQ,CAAC,YAAY,EAAE,YAAY,GAAG,MAAM,GAAG,SAAS;IA4BxD;;;;;;;;OAQG;IACH,KAAK,CAAC,GAAG,GAAE,MAAmB,GAAG,KAAK,CAAC;QAAE,YAAY,EAAE,YAAY,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC;CAc3F"}

package/dist/platform/runtime/notifications/policies/batch-policy.js

@@ -0,0 +1,85 @@
+/**
+ * Batch policy — collapses repeated notifications from the same domain +
+ * level within a rolling time window to prevent UI flooding from high-
+ * frequency operational events (e.g. tool progress ticks, agent heartbeats).
+ */
+/** Default batch window in milliseconds. */
+const DEFAULT_BATCH_WINDOW_MS = 2_000;
+/**
+ * BatchPolicy tracks repeated notifications and decides whether a new
+ * arrival should be collapsed into an existing batch group.
+ *
+ * A batch group key is `{domain}:{level}`. Two notifications sharing the
+ * same key within `batchWindowMs` are considered duplicates.
+ */
+export class BatchPolicy {
+    /** Active batch groups keyed by `{domain}:{level}`. */
+    groups = new Map();
+    /** Pending flushed notifications paired with their batch count. */
+    pending = [];
+    /** Rolling window in ms within which repeated notifications are batched. */
+    batchWindowMs;
+    constructor(batchWindowMs = DEFAULT_BATCH_WINDOW_MS) {
+        this.batchWindowMs = batchWindowMs;
+    }
+    /**
+     * Builds the batch group key for a notification.
+     *
+     * @param notification - The notification to key.
+     * @returns A string key in the form `{domain}:{level}`.
+     */
+    buildKey(notification) {
+        return `${notification.domain}:${notification.level}`;
+    }
+    /**
+     * Evaluates a notification against the batch policy.
+     *
+     * @param notification - Incoming notification to evaluate.
+     * @returns The batch group key if this notification is being batched,
+     *          or undefined if it should be routed immediately.
+     */
+    evaluate(notification) {
+        const key = this.buildKey(notification);
+        const now = notification.timestamp;
+        const entry = this.groups.get(key);
+        if (!entry) {
+            // First notification in this group — start a new window.
+            this.groups.set(key, { last: notification, count: 1, windowStart: now });
+            // First in group is NOT batched — route immediately.
+            return undefined;
+        }
+        const windowExpired = now - entry.windowStart > this.batchWindowMs;
+        if (windowExpired) {
+            // Window has expired — flush the held batch and start fresh.
+            this.pending.push({ notification: entry.last, batchCount: entry.count });
+            this.groups.set(key, { last: notification, count: 1, windowStart: now });
+            // New window start is NOT batched.
+            return undefined;
+        }
+        // Within window — collapse into batch.
+        entry.last = notification;
+        entry.count += 1;
+        return key;
+    }
+    /**
+     * Flushes all pending batched notifications.
+     *
+     * Call this at the end of a batch cycle (e.g. on a timer tick or when
+     * quiet-typing mode ends) to surface collapsed notifications.
+     *
+     * @param now - Optional timestamp override for expiry checks (defaults to Date.now()).
+     * @returns Array of the most-recent notification from each expired batch group, paired with batch count.
+     */
+    flush(now = Date.now()) {
+        const flushed = [...this.pending];
+        this.pending.length = 0;
+        for (const [key, entry] of this.groups) {
+            const windowExpired = now - entry.windowStart > this.batchWindowMs;
+            if (windowExpired) {
+                flushed.push({ notification: entry.last, batchCount: entry.count });
+                this.groups.delete(key);
+            }
+        }
+        return flushed;
+    }
+}

package/dist/platform/runtime/notifications/policies/burst-policy.d.ts

@@ -0,0 +1,70 @@
+/**
+ * Burst policy — detects rapid notification floods within a short observation
+ * window and collapses them into a batch group key.
+ *
+ * Unlike the rolling BatchPolicy (which uses a fixed time window), the burst
+ * policy measures the event rate within a sliding observation window and
+ * activates only when the rate exceeds a configured threshold. Once activated,
+ * subsequent notifications in the group are collapsed until the burst subsides.
+ *
+ * A burst group key is `{domain}:{level}` — matching the BatchPolicy scheme
+ * so downstream consumers can coalesce both batch types uniformly.
+ */
+import type { Notification } from '../types.js';
+/**
+ * BurstPolicy tracks notification arrival rates per domain:level group and
+ * activates burst suppression when the rate exceeds the threshold.
+ */
+export declare class BurstPolicy {
+    /** Active burst group entries keyed by `{domain}:{level}`. */
+    private readonly groups;
+    /** Observation window in ms. */
+    private readonly observationWindowMs;
+    /** Number of events within the window before burst activates. */
+    private readonly burstThreshold;
+    /** Cooldown in ms after last event before the burst group resets. */
+    private readonly cooldownMs;
+    constructor(observationWindowMs?: number, burstThreshold?: number, cooldownMs?: number);
+    /**
+     * Builds the burst group key for a notification.
+     *
+     * @param notification - The notification to key.
+     * @returns A string key in the form `{domain}:{level}`.
+     */
+    private buildKey;
+    /**
+     * Prune timestamps outside the current observation window.
+     */
+    private pruneWindow;
+    /**
+     * Evaluates a notification against the burst policy.
+     *
+     * @param notification - Incoming notification to evaluate.
+     * @returns The burst group key if the notification is being burst-collapsed,
+     *          or undefined if it should proceed to the next policy stage.
+     */
+    evaluate(notification: Notification): string | undefined;
+    /**
+     * Returns the number of notifications collapsed in a burst group.
+     *
+     * @param key - The burst group key (`{domain}:{level}`).
+     * @returns The collapsed count, or 0 if no group exists.
+     */
+    getCollapsedCount(key: string): number;
+    /**
+     * Resets a specific burst group, clearing its state.
+     * Call this when the burst window expires and the group is ready to
+     * surface its summary.
+     *
+     * @param key - The burst group key to reset.
+     */
+    resetGroup(key: string): void;
+    /**
+     * Returns all currently active burst group keys.
+     *
+     * Callers can use this to surface summary notifications for each active
+     * burst group at flush time.
+     */
+    getActiveGroups(): string[];
+}
+//# sourceMappingURL=burst-policy.d.ts.map

package/dist/platform/runtime/notifications/policies/burst-policy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"burst-policy.d.ts","sourceRoot":"","sources":["../../../../../src/platform/runtime/notifications/policies/burst-policy.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAuBhD;;;GAGG;AACH,qBAAa,WAAW;IACtB,8DAA8D;IAC9D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAiC;IAExD,gCAAgC;IAChC,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAS;IAE7C,iEAAiE;IACjE,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IAExC,qEAAqE;IACrE,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;gBAGlC,mBAAmB,GAAE,MAAsC,EAC3D,cAAc,GAAE,MAAgC,EAChD,UAAU,GAAE,MAA4B;IAO1C;;;;;OAKG;IACH,OAAO,CAAC,QAAQ;IAIhB;;OAEG;IACH,OAAO,CAAC,WAAW;IAKnB;;;;;;OAMG;IACH,QAAQ,CAAC,YAAY,EAAE,YAAY,GAAG,MAAM,GAAG,SAAS;IAyCxD;;;;;OAKG;IACH,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;IAItC;;;;;;OAMG;IACH,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAI7B;;;;;OAKG;IACH,eAAe,IAAI,MAAM,EAAE;CAK5B"}

package/dist/platform/runtime/notifications/policies/burst-policy.js

@@ -0,0 +1,122 @@
+/**
+ * Burst policy — detects rapid notification floods within a short observation
+ * window and collapses them into a batch group key.
+ *
+ * Unlike the rolling BatchPolicy (which uses a fixed time window), the burst
+ * policy measures the event rate within a sliding observation window and
+ * activates only when the rate exceeds a configured threshold. Once activated,
+ * subsequent notifications in the group are collapsed until the burst subsides.
+ *
+ * A burst group key is `{domain}:{level}` — matching the BatchPolicy scheme
+ * so downstream consumers can coalesce both batch types uniformly.
+ */
+/** Default observation window for rate measurement. */
+const DEFAULT_OBSERVATION_WINDOW_MS = 1_000;
+/** Default event count threshold that activates burst suppression. */
+const DEFAULT_BURST_THRESHOLD = 3;
+/** Default cooldown period after the last burst event before the group resets. */
+const DEFAULT_COOLDOWN_MS = 3_000;
+/**
+ * BurstPolicy tracks notification arrival rates per domain:level group and
+ * activates burst suppression when the rate exceeds the threshold.
+ */
+export class BurstPolicy {
+    /** Active burst group entries keyed by `{domain}:{level}`. */
+    groups = new Map();
+    /** Observation window in ms. */
+    observationWindowMs;
+    /** Number of events within the window before burst activates. */
+    burstThreshold;
+    /** Cooldown in ms after last event before the burst group resets. */
+    cooldownMs;
+    constructor(observationWindowMs = DEFAULT_OBSERVATION_WINDOW_MS, burstThreshold = DEFAULT_BURST_THRESHOLD, cooldownMs = DEFAULT_COOLDOWN_MS) {
+        this.observationWindowMs = Math.max(1, observationWindowMs);
+        this.burstThreshold = Math.max(1, burstThreshold);
+        this.cooldownMs = Math.max(0, cooldownMs);
+    }
+    /**
+     * Builds the burst group key for a notification.
+     *
+     * @param notification - The notification to key.
+     * @returns A string key in the form `{domain}:{level}`.
+     */
+    buildKey(notification) {
+        return `${notification.domain}:${notification.level}`;
+    }
+    /**
+     * Prune timestamps outside the current observation window.
+     */
+    pruneWindow(entry, now) {
+        const cutoff = now - this.observationWindowMs;
+        entry.timestamps = entry.timestamps.filter((t) => t >= cutoff);
+    }
+    /**
+     * Evaluates a notification against the burst policy.
+     *
+     * @param notification - Incoming notification to evaluate.
+     * @returns The burst group key if the notification is being burst-collapsed,
+     *          or undefined if it should proceed to the next policy stage.
+     */
+    evaluate(notification) {
+        const key = this.buildKey(notification);
+        const now = notification.timestamp;
+        let entry = this.groups.get(key);
+        if (!entry) {
+            entry = { timestamps: [], active: false, lastSeen: now, collapsedCount: 0 };
+            this.groups.set(key, entry);
+        }
+        // Expire cooldown: if the group was active but the last event is beyond
+        // the cooldown window, reset it.
+        if (entry.active && now - entry.lastSeen > this.cooldownMs) {
+            entry.active = false;
+            entry.collapsedCount = 0;
+            entry.timestamps = [];
+        }
+        this.pruneWindow(entry, now);
+        entry.timestamps.push(now);
+        entry.lastSeen = now;
+        const rate = entry.timestamps.length;
+        if (entry.active) {
+            // Already in burst mode — collapse this notification.
+            entry.collapsedCount += 1;
+            return key;
+        }
+        if (rate > this.burstThreshold) {
+            // Rate exceeded threshold — activate burst suppression.
+            entry.active = true;
+            entry.collapsedCount += 1;
+            return key;
+        }
+        return undefined;
+    }
+    /**
+     * Returns the number of notifications collapsed in a burst group.
+     *
+     * @param key - The burst group key (`{domain}:{level}`).
+     * @returns The collapsed count, or 0 if no group exists.
+     */
+    getCollapsedCount(key) {
+        return this.groups.get(key)?.collapsedCount ?? 0;
+    }
+    /**
+     * Resets a specific burst group, clearing its state.
+     * Call this when the burst window expires and the group is ready to
+     * surface its summary.
+     *
+     * @param key - The burst group key to reset.
+     */
+    resetGroup(key) {
+        this.groups.delete(key);
+    }
+    /**
+     * Returns all currently active burst group keys.
+     *
+     * Callers can use this to surface summary notifications for each active
+     * burst group at flush time.
+     */
+    getActiveGroups() {
+        return Array.from(this.groups.entries())
+            .filter(([, entry]) => entry.active)
+            .map(([key]) => key);
+    }
+}

package/dist/platform/runtime/notifications/policies/default-policy.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Default routing policy — maps notification level + domain verbosity to a
+ * NotificationTarget. This is the base layer; other policies (quiet-typing,
+ * batch) layer on top.
+ */
+import type { DomainVerbosity, NotificationLevel, NotificationTarget } from '../types.js';
+/**
+ * Apply the default level-based routing rule.
+ *
+ * Rules:
+ * - `critical` → always `conversation`
+ * - `warning`  → `conversation` if verbosity is `normal` or `verbose`, else `status_bar`
+ * - `info`     → `panel_only` unless verbosity is `verbose` (then `status_bar`)
+ * - `debug`    → always `panel_only`
+ *
+ * @param level     - Notification severity level.
+ * @param verbosity - Per-domain verbosity setting.
+ * @returns The base routing target before suppression/batch policies apply.
+ */
+export declare function applyDefaultPolicy(level: NotificationLevel, verbosity: DomainVerbosity): NotificationTarget;
+//# sourceMappingURL=default-policy.d.ts.map

package/dist/platform/runtime/notifications/policies/default-policy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"default-policy.d.ts","sourceRoot":"","sources":["../../../../../src/platform/runtime/notifications/policies/default-policy.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EACV,eAAe,EACf,iBAAiB,EACjB,kBAAkB,EACnB,MAAM,aAAa,CAAC;AAErB;;;;;;;;;;;;GAYG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,iBAAiB,EACxB,SAAS,EAAE,eAAe,GACzB,kBAAkB,CAgBpB"}

package/dist/platform/runtime/notifications/policies/default-policy.js

@@ -0,0 +1,32 @@
+/**
+ * Default routing policy — maps notification level + domain verbosity to a
+ * NotificationTarget. This is the base layer; other policies (quiet-typing,
+ * batch) layer on top.
+ */
+/**
+ * Apply the default level-based routing rule.
+ *
+ * Rules:
+ * - `critical` → always `conversation`
+ * - `warning`  → `conversation` if verbosity is `normal` or `verbose`, else `status_bar`
+ * - `info`     → `panel_only` unless verbosity is `verbose` (then `status_bar`)
+ * - `debug`    → always `panel_only`
+ *
+ * @param level     - Notification severity level.
+ * @param verbosity - Per-domain verbosity setting.
+ * @returns The base routing target before suppression/batch policies apply.
+ */
+export function applyDefaultPolicy(level, verbosity) {
+    switch (level) {
+        case 'critical':
+            return 'conversation';
+        case 'warning':
+            return verbosity === 'normal' || verbosity === 'verbose'
+                ? 'conversation'
+                : 'status_bar';
+        case 'info':
+            return verbosity === 'verbose' ? 'status_bar' : 'panel_only';
+        case 'debug':
+            return 'panel_only';
+    }
+}

package/dist/platform/runtime/notifications/policies/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Notification policies — barrel export.
+ */
+export { applyDefaultPolicy } from './default-policy.js';
+export { applyQuietTypingPolicy } from './quiet-typing.js';
+export { BatchPolicy } from './batch-policy.js';
+export { applyModeContextPolicy } from './mode-context-policy.js';
+export { BurstPolicy } from './burst-policy.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/platform/runtime/notifications/policies/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/platform/runtime/notifications/policies/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAC3D,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAClE,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/platform/runtime/notifications/policies/index.js

@@ -0,0 +1,8 @@
+/**
+ * Notification policies — barrel export.
+ */
+export { applyDefaultPolicy } from './default-policy.js';
+export { applyQuietTypingPolicy } from './quiet-typing.js';
+export { BatchPolicy } from './batch-policy.js';
+export { applyModeContextPolicy } from './mode-context-policy.js';
+export { BurstPolicy } from './burst-policy.js';