@aitne/daemon 0.1.0

package/dist/core/drift-effects.js

@@ -0,0 +1,384 @@
+import { formatSqliteDatetime, localDateStr, } from "@aitne/shared";
+import { createLogger } from "../logging.js";
+import { CALENDAR_HORIZON_MS, shouldTriggerRefreshForCalendarEvent, } from "./roadmap-refresh-triggers.js";
+import { deleteRuntimeState, readRuntimeState, writeRuntimeState, } from "../db/runtime-state.js";
+import { notifyObservationSummarizer } from "../db/observations.js";
+const logger = createLogger("drift-effects");
+const TODAY_REFRESH_AUTO_AT_KEY = "today_refresh_auto_at";
+const TODAY_REFRESH_PENDING_KEY = "today_refresh_pending";
+const TODAY_REFRESH_DEDUP_MS = 5 * 60 * 1000;
+const TODAY_REFRESH_DELAY_MS = 30 * 1000;
+const EMPTY_EFFECTS = {
+    observationsWritten: 0,
+    scheduleApproachingEmitted: [],
+    roadmapRefreshTriggered: false,
+    todayRefreshScheduled: false,
+    todayRefreshPending: false,
+};
+export function emptyDriftSideEffects() {
+    return { ...EMPTY_EFFECTS, scheduleApproachingEmitted: [] };
+}
+export function applyDriftEffects(req, diff, deps) {
+    if (diff.isInitialSnapshot)
+        return emptyDriftSideEffects();
+    switch (req.integration) {
+        case "google_calendar":
+            return applyCalendarDriftEffects(req, diff, deps);
+        case "gmail":
+            return applyGmailDriftEffects(diff, deps);
+        case "notion":
+            return applyNotionDriftEffects(diff, deps);
+        /* c8 ignore start — defensive against a future IntegrationKey
+         *   landing before its drift handler is wired in `applyDriftEffects`. */
+        default:
+            return emptyDriftSideEffects();
+        /* c8 ignore stop */
+    }
+}
+function applyCalendarDriftEffects(req, diff, deps) {
+    const effects = emptyDriftSideEffects();
+    const source = `calendar:${deps.calendarId ?? "primary"}`;
+    const changes = calendarChangesFromDiff(diff);
+    for (const change of changes) {
+        effects.observationsWritten += recordCoalescedObservation(deps.db, {
+            source,
+            ref: change.itemId,
+            changeType: change.changeType,
+            actor: change.actor,
+            payload: change.payload,
+        });
+        if (shouldTriggerRoadmapRefreshForCalendarChange(change, deps.now?.())) {
+            effects.roadmapRefreshTriggered = true;
+            try {
+                deps.triggerRoadmapRefresh?.("calendar_event_detected");
+            }
+            catch (err) {
+                logger.warn({ err }, "triggerRoadmapRefresh threw during drift effects");
+            }
+        }
+    }
+    const todayRefresh = maybeScheduleTodayRefresh(req, changes, deps);
+    effects.todayRefreshScheduled = todayRefresh.scheduled;
+    effects.todayRefreshPending = todayRefresh.pending;
+    return effects;
+}
+/**
+ * Gmail drift → `mail:lifecycle` observations (matches MailPoller's existing
+ * source so consumers of the `observations` skill don't need a special-case
+ * for delegated mode). `ref` is the threadId — drift granularity is thread-
+ * level (§15.4); a new message landing in an existing thread surfaces as a
+ * `modified` diff and gets coalesced onto the same `(source, ref)`.
+ *
+ * Roadmap refresh and today_refresh both stay calendar-only — Gmail drift
+ * doesn't have the time-bound semantics either depends on. Plan §7.1 floats
+ * "maybe today_refresh if mail mentions today's User Tasks" as a future
+ * extension; that requires NLP and is explicitly out of Phase 5 scope.
+ */
+function applyGmailDriftEffects(diff, deps) {
+    const effects = emptyDriftSideEffects();
+    const source = "mail:lifecycle";
+    for (const change of genericChangesFromDiff(diff)) {
+        effects.observationsWritten += recordCoalescedObservation(deps.db, {
+            source,
+            ref: change.itemId,
+            changeType: change.changeType,
+            actor: change.actor,
+            payload: change.payload,
+        });
+    }
+    return effects;
+}
+/**
+ * Notion drift → `notion:<parentDatabaseId>` observations when the page is
+ * database-rooted (matches NotionPoller's source key, so multi-database
+ * filtering downstream works cross-mode), or `notion:lifecycle` when the
+ * page is workspace- or page-rooted (the poller never produces such rows
+ * because it iterates by database, but the delegated worker can surface
+ * them). `ref` is the pageId.
+ */
+function applyNotionDriftEffects(diff, deps) {
+    const effects = emptyDriftSideEffects();
+    for (const change of genericChangesFromDiff(diff)) {
+        const source = notionObservationSource(change.payload);
+        effects.observationsWritten += recordCoalescedObservation(deps.db, {
+            source,
+            ref: change.itemId,
+            changeType: change.changeType,
+            actor: change.actor,
+            payload: change.payload,
+        });
+    }
+    return effects;
+}
+function notionObservationSource(payload) {
+    if (payload && typeof payload === "object") {
+        const parent = payload.parentDatabase;
+        if (typeof parent === "string" && parent.length > 0) {
+            return `notion:${parent}`;
+        }
+    }
+    return "notion:lifecycle";
+}
+function genericChangesFromDiff(diff) {
+    return [
+        ...diff.created.map((item) => ({
+            itemId: item.itemId,
+            changeType: "created",
+            actor: item.actor,
+            payload: item.payload,
+        })),
+        ...diff.modified.map((item) => ({
+            itemId: item.itemId,
+            changeType: "modified",
+            actor: item.actor,
+            payload: item.current.payload,
+        })),
+        ...diff.deleted.map((item) => ({
+            itemId: item.itemId,
+            changeType: "deleted",
+            actor: item.actor,
+            payload: item.payload,
+        })),
+    ];
+}
+function calendarChangesFromDiff(diff) {
+    return [
+        ...diff.created.map((item) => ({
+            itemId: item.itemId,
+            changeType: "created",
+            actor: item.actor,
+            payload: item.payload,
+            itemStart: item.itemStart ?? null,
+        })),
+        ...diff.modified.map((item) => ({
+            itemId: item.itemId,
+            changeType: "modified",
+            actor: item.actor,
+            payload: item.current.payload,
+            itemStart: item.itemStart,
+            priorPayload: item.prior.payload,
+        })),
+        ...diff.deleted.map((item) => ({
+            itemId: item.itemId,
+            changeType: "deleted",
+            actor: item.actor,
+            payload: item.payload,
+            itemStart: item.itemStart,
+        })),
+    ];
+}
+function shouldTriggerRoadmapRefreshForCalendarChange(change, now = new Date()) {
+    if (change.changeType === "created") {
+        return shouldTriggerRefreshForCalendarEvent({
+            startIso: change.itemStart,
+            actor: change.actor,
+            changeType: "created",
+            now: now.getTime(),
+        });
+    }
+    if (change.changeType !== "modified")
+        return false;
+    if (change.actor === "agent")
+        return false;
+    const currentStart = change.itemStart ?? extractPayloadStart(change.payload);
+    if (!isBeyondCalendarHorizon(currentStart, now))
+        return false;
+    const priorStart = extractPayloadStart(change.priorPayload);
+    return !isBeyondCalendarHorizon(priorStart, now);
+}
+function extractPayloadStart(payload) {
+    if (!payload || typeof payload !== "object")
+        return null;
+    const start = payload.start;
+    return typeof start === "string" && start.length > 0 ? start : null;
+}
+function isBeyondCalendarHorizon(startIso, now) {
+    if (!startIso)
+        return false;
+    const startMs = Date.parse(startIso);
+    if (!Number.isFinite(startMs))
+        return false;
+    return startMs - now.getTime() > CALENDAR_HORIZON_MS;
+}
+function mergeActor(prior, next) {
+    if (prior === "user" || next === "user")
+        return "user";
+    if (next === "unknown")
+        return prior;
+    return next;
+}
+function recordCoalescedObservation(db, params) {
+    const payload = JSON.stringify(params.payload);
+    const existing = db
+        .prepare(`SELECT id, change_type AS changeType, actor
+       FROM observations
+       WHERE source = ? AND ref = ? AND consumed_at IS NULL
+       LIMIT 1`)
+        .get(params.source, params.ref);
+    if (!existing) {
+        const inserted = db.prepare(`INSERT INTO observations
+         (source, ref, change_type, actor, observed_at, payload)
+       VALUES (?, ?, ?, ?, CURRENT_TIMESTAMP, ?)
+       RETURNING id`).get(params.source, params.ref, params.changeType, params.actor, payload);
+        // Wake the summarizer worker so the new row gets summary_text /
+        // novelty_score populated. Without this, coalesced inserts only get
+        // summarized via the daemon-startup reclaim sweep — a row that lands
+        // mid-run sits at `summary_status='pending'` forever and the
+        // hourly_check skill is forced into the legacy fetch-on-doubt path.
+        if (inserted)
+            notifyObservationSummarizer(inserted.id);
+        return 1;
+    }
+    const actor = mergeActor(existing.actor, params.actor);
+    const prior = existing.changeType;
+    const next = params.changeType;
+    if (prior === "created" && next === "deleted") {
+        db.prepare("DELETE FROM observations WHERE id = ?").run(existing.id);
+        return 0;
+    }
+    let coalesced = next;
+    if (prior === "created" && next === "modified") {
+        coalesced = "created";
+    }
+    else if (prior === "modified" && next === "modified") {
+        coalesced = "modified";
+    }
+    else if (prior === "modified" && next === "deleted") {
+        coalesced = "deleted";
+    }
+    else if (prior === "deleted" && next === "created") {
+        coalesced = "modified";
+    }
+    else if (prior === "deleted" && next === "modified") {
+        logger.warn({ source: params.source, ref: params.ref }, "deleted observation followed by modified drift; treating as modified");
+        coalesced = "modified";
+    }
+    // Re-coalesce overwrites the stored payload, so the previously-computed
+    // summary describes obsolete content. Reset the summarizer-owned columns
+    // to mirror `recordObservation`'s UPSERT on payload change — without
+    // this, `summary_text` / `novelty_score` linger from the prior payload
+    // and the hourly_check skill consumes a stale summary as if it were
+    // current (`summary_status='done'` with `summaryStale=false`).
+    db.prepare(`UPDATE observations
+     SET change_type = ?,
+         actor = ?,
+         observed_at = CURRENT_TIMESTAMP,
+         payload = ?,
+         summary_text = NULL,
+         novelty_score = NULL,
+         summary_at = NULL,
+         summary_backend = NULL,
+         summary_status = 'pending'
+     WHERE id = ?`).run(coalesced, actor, payload, existing.id);
+    notifyObservationSummarizer(existing.id);
+    return 1;
+}
+function maybeScheduleTodayRefresh(req, changes, deps) {
+    if (req.windowKey !== "primary:24h" && req.windowKey !== "primary:14d") {
+        return { scheduled: false, pending: false };
+    }
+    const now = deps.now?.() ?? new Date();
+    const timezone = deps.timezone;
+    const today = localDateStr(now, timezone);
+    const materialTodayDrift = changes.some((change) => startsOnLocalDate(change.payload, change.itemStart, today, timezone));
+    if (!materialTodayDrift)
+        return { scheduled: false, pending: false };
+    const lastAt = readLastAutoRefreshAt(deps.db);
+    if (lastAt !== null && now.getTime() - lastAt.getTime() < TODAY_REFRESH_DEDUP_MS) {
+        return { scheduled: false, pending: false };
+    }
+    const requestedAt = now.toISOString();
+    if (deps.todayWriteLock?.getHolder()) {
+        writeRuntimeState(deps.db, TODAY_REFRESH_PENDING_KEY, {
+            reason: "calendar_drift_while_morning_lock_held",
+            requestedAt,
+            integration: req.integration,
+            windowKey: req.windowKey,
+        });
+        return { scheduled: false, pending: true };
+    }
+    const enqueueResult = enqueueTodayRefresh(deps.db, {
+        requestedAt,
+        scheduledFor: new Date(now.getTime() + TODAY_REFRESH_DELAY_MS),
+        integration: req.integration,
+        windowKey: req.windowKey,
+        reason: "calendar_drift",
+    });
+    if (enqueueResult.inserted || enqueueResult.existing) {
+        writeRuntimeState(deps.db, TODAY_REFRESH_AUTO_AT_KEY, requestedAt);
+    }
+    return { scheduled: enqueueResult.inserted, pending: false };
+}
+function startsOnLocalDate(payload, itemStart, localDate, timezone) {
+    const start = payload && typeof payload === "object"
+        ? payload.start
+        : undefined;
+    if (typeof start === "string" && /^\d{4}-\d{2}-\d{2}$/.test(start)) {
+        return start === localDate;
+    }
+    const candidate = typeof start === "string" ? start : itemStart;
+    if (!candidate)
+        return false;
+    const ms = Date.parse(candidate);
+    if (!Number.isFinite(ms))
+        return false;
+    return localDateStr(new Date(ms), timezone) === localDate;
+}
+function readLastAutoRefreshAt(db) {
+    const raw = readRuntimeState(db, TODAY_REFRESH_AUTO_AT_KEY);
+    const iso = typeof raw === "string" ? raw : raw?.at;
+    if (!iso)
+        return null;
+    const ms = Date.parse(iso);
+    return Number.isFinite(ms) ? new Date(ms) : null;
+}
+function enqueueTodayRefresh(db, params) {
+    const existing = db
+        .prepare(`SELECT id
+       FROM agent_schedule
+       WHERE task_type = 'wake'
+         AND status IN ('pending', 'running')
+         AND json_extract(task_context, '$.routine') = 'today_refresh'
+       LIMIT 1`)
+        .get();
+    if (existing)
+        return { inserted: false, existing: true };
+    // correlation_id mirrors morning_routine's queueMorningRoutineWake
+    // pattern (scheduler.ts) — a stable per-trigger id lets operators tie
+    // the resulting agent_actions row back to the drift POST that scheduled
+    // it. Drift can fire from CalendarPoller, the reconcile route, or a
+    // post-morning flush; the prefix encodes which.
+    const correlationId = `drift:${params.integration}:${params.windowKey}:${params.requestedAt}`;
+    db.prepare(`INSERT INTO agent_schedule
+       (scheduled_for, task_type, task_description, task_context, correlation_id, model, status)
+     VALUES (?, 'wake', ?, ?, ?, NULL, 'pending')`).run(formatSqliteDatetime(params.scheduledFor), "Refresh today.md User Schedule after calendar drift.", JSON.stringify({
+        routine: "today_refresh",
+        source: "integration_drift",
+        reason: params.reason,
+        requestedAt: params.requestedAt,
+        integration: params.integration,
+        windowKey: params.windowKey,
+        importance: "low",
+    }), correlationId);
+    return { inserted: true, existing: false };
+}
+export function flushPendingTodayRefresh(db, now = new Date()) {
+    const pending = readRuntimeState(db, TODAY_REFRESH_PENDING_KEY);
+    if (!pending)
+        return { scheduled: false, hadPending: false };
+    const enqueueResult = enqueueTodayRefresh(db, {
+        requestedAt: pending.requestedAt,
+        scheduledFor: new Date(now.getTime() + TODAY_REFRESH_DELAY_MS),
+        integration: pending.integration,
+        windowKey: pending.windowKey,
+        reason: pending.reason,
+    });
+    writeRuntimeState(db, TODAY_REFRESH_AUTO_AT_KEY, now.toISOString());
+    deleteRuntimeState(db, TODAY_REFRESH_PENDING_KEY);
+    return { scheduled: enqueueResult.inserted, hadPending: true };
+}
+export const __driftEffectsTestExports = {
+    TODAY_REFRESH_AUTO_AT_KEY,
+    TODAY_REFRESH_PENDING_KEY,
+};
+//# sourceMappingURL=drift-effects.js.map

package/dist/core/drift-effects.js.map

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

package/dist/core/event-bus.d.ts

@@ -0,0 +1,56 @@
+import type { Event } from "@aitne/shared";
+/**
+ * Priority queue for events backed by a binary min-heap (heap-js).
+ *
+ * - O(log n) insert via `put()`
+ * - O(log n) extract-min via `get()`
+ * - Eviction of lowest-priority (highest numeric value) items when full
+ */
+export declare class EventBus {
+    private readonly heap;
+    private counter;
+    private readonly maxSize;
+    private waitQueue;
+    private closed;
+    /**
+     * Management Mode Phase 2 migration hook — when true, `get()` blocks
+     * consumers instead of returning events. `put()` keeps enqueuing so
+     * adapters can continue accepting inbound messages during a migration;
+     * they just don't fire until `resumeDispatch()`. Not persisted —
+     * resumed on daemon restart.
+     */
+    private dispatchPaused;
+    constructor(maxSize?: number);
+    put(event: Event): Promise<void>;
+    get(): Promise<Event | null>;
+    /** Unblock all waiting get() calls, causing them to return null. */
+    close(): void;
+    /**
+     * Block dispatch of new events without dropping the queue. Used by the
+     * Management Mode migration endpoint so in-flight events (cron ticks,
+     * delivery retries) don't fire against a half-moved vault. Pairs with
+     * `resumeDispatch()` in a try/finally.
+     *
+     * Waiting `get()` consumers are NOT woken up — they sleep until a
+     * real event or `close()` arrives. This means a paused bus holds
+     * whichever consumer happened to be polling; see `resumeDispatch()`
+     * for the release semantics.
+     */
+    pauseDispatch(): void;
+    /**
+     * Re-enable dispatch. If consumers were sleeping on `get()` while
+     * paused, wake them proportionally to queued events so they can
+     * resume pulling. A single notify per queued entry is enough: each
+     * woken consumer either pops its event or loops and re-parks.
+     */
+    resumeDispatch(): void;
+    isDispatchPaused(): boolean;
+    get size(): number;
+    /**
+     * Find the entry with the worst (highest numeric) priority.
+     * Scans heap leaves — O(n/2) in the worst case, but only runs
+     * when the queue is full (maxSize reached), which is rare.
+     */
+    private findWorst;
+}
+//# sourceMappingURL=event-bus.d.ts.map

package/dist/core/event-bus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-bus.d.ts","sourceRoot":"","sources":["../../src/core/event-bus.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AAO3C;;;;;;GAMG;AACH,qBAAa,QAAQ;IACnB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAkB;IACvC,OAAO,CAAC,OAAO,CAAK;IACpB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,SAAS,CAAyC;IAC1D,OAAO,CAAC,MAAM,CAAS;IACvB;;;;;;OAMG;IACH,OAAO,CAAC,cAAc,CAAS;gBAEnB,OAAO,SAAO;IAOpB,GAAG,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC;IA6BhC,GAAG,IAAI,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC;IAelC,oEAAoE;IACpE,KAAK,IAAI,IAAI;IAQb;;;;;;;;;;OAUG;IACH,aAAa,IAAI,IAAI;IAKrB;;;;;OAKG;IACH,cAAc,IAAI,IAAI;IAYtB,gBAAgB,IAAI,OAAO;IAI3B,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED;;;;OAIG;IACH,OAAO,CAAC,SAAS;CAclB"}

package/dist/core/event-bus.js

@@ -0,0 +1,135 @@
+import { Heap } from "heap-js";
+import { createLogger } from "../logging.js";
+const logger = createLogger("event-bus");
+/**
+ * Priority queue for events backed by a binary min-heap (heap-js).
+ *
+ * - O(log n) insert via `put()`
+ * - O(log n) extract-min via `get()`
+ * - Eviction of lowest-priority (highest numeric value) items when full
+ */
+export class EventBus {
+    heap;
+    counter = 0;
+    maxSize;
+    waitQueue = [];
+    closed = false;
+    /**
+     * Management Mode Phase 2 migration hook — when true, `get()` blocks
+     * consumers instead of returning events. `put()` keeps enqueuing so
+     * adapters can continue accepting inbound messages during a migration;
+     * they just don't fire until `resumeDispatch()`. Not persisted —
+     * resumed on daemon restart.
+     */
+    dispatchPaused = false;
+    constructor(maxSize = 1000) {
+        this.maxSize = maxSize;
+        this.heap = new Heap((a, b) => a[0] - b[0] || a[1] - b[1]);
+    }
+    async put(event) {
+        if (this.heap.size() >= this.maxSize) {
+            // Find the worst (highest priority number = lowest priority) entry
+            const worst = this.findWorst();
+            if (worst && event.priority <= worst[0]) {
+                // New event is at least as important — evict the worst
+                const evicted = worst[2];
+                this.heap.remove(worst, (a, b) => a[1] === b[1]); // match by seq
+                logger.warn({ evictedType: evicted.type, evictedPriority: evicted.priority, newType: event.type, queueSize: this.maxSize }, "Event evicted from full queue");
+            }
+            else {
+                // New event is strictly lower priority than all existing — drop it
+                logger.warn({ droppedType: event.type, droppedPriority: event.priority, queueSize: this.maxSize }, "Event dropped — queue full and lower priority than all existing");
+                return;
+            }
+        }
+        this.heap.push([event.priority, this.counter++, event]);
+        // Wake one waiting consumer
+        const waiter = this.waitQueue.shift();
+        waiter?.();
+    }
+    async get() {
+        while (this.heap.size() === 0 || this.dispatchPaused) {
+            if (this.closed)
+                return null;
+            const wasClosed = await new Promise((resolve) => {
+                this.waitQueue.push((closed) => resolve(closed));
+            });
+            if (wasClosed)
+                return null;
+        }
+        const entry = this.heap.pop();
+        // Loop exit guarantees heap.size() > 0 → pop() returns a value; the
+        // `: null` branch below is defensive only.
+        /* c8 ignore next */
+        return entry ? entry[2] : null;
+    }
+    /** Unblock all waiting get() calls, causing them to return null. */
+    close() {
+        this.closed = true;
+        for (const waiter of this.waitQueue) {
+            waiter(true);
+        }
+        this.waitQueue = [];
+    }
+    /**
+     * Block dispatch of new events without dropping the queue. Used by the
+     * Management Mode migration endpoint so in-flight events (cron ticks,
+     * delivery retries) don't fire against a half-moved vault. Pairs with
+     * `resumeDispatch()` in a try/finally.
+     *
+     * Waiting `get()` consumers are NOT woken up — they sleep until a
+     * real event or `close()` arrives. This means a paused bus holds
+     * whichever consumer happened to be polling; see `resumeDispatch()`
+     * for the release semantics.
+     */
+    pauseDispatch() {
+        this.dispatchPaused = true;
+        logger.info("EventBus dispatch paused");
+    }
+    /**
+     * Re-enable dispatch. If consumers were sleeping on `get()` while
+     * paused, wake them proportionally to queued events so they can
+     * resume pulling. A single notify per queued entry is enough: each
+     * woken consumer either pops its event or loops and re-parks.
+     */
+    resumeDispatch() {
+        if (!this.dispatchPaused)
+            return;
+        this.dispatchPaused = false;
+        const backlog = this.heap.size();
+        for (let i = 0; i < backlog; i++) {
+            const waiter = this.waitQueue.shift();
+            if (!waiter)
+                break;
+            waiter();
+        }
+        logger.info({ backlog }, "EventBus dispatch resumed");
+    }
+    isDispatchPaused() {
+        return this.dispatchPaused;
+    }
+    get size() {
+        return this.heap.size();
+    }
+    /**
+     * Find the entry with the worst (highest numeric) priority.
+     * Scans heap leaves — O(n/2) in the worst case, but only runs
+     * when the queue is full (maxSize reached), which is rare.
+     */
+    findWorst() {
+        const arr = this.heap.toArray();
+        // Only called when heap.size() >= maxSize; the empty array branch is
+        // defensive against future callers.
+        /* c8 ignore next */
+        if (arr.length === 0)
+            return null;
+        let worst = arr[0];
+        for (let i = 1; i < arr.length; i++) {
+            if (arr[i][0] > worst[0] || (arr[i][0] === worst[0] && arr[i][1] < worst[1])) {
+                worst = arr[i];
+            }
+        }
+        return worst;
+    }
+}
+//# sourceMappingURL=event-bus.js.map

package/dist/core/event-bus.js.map

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