@aitne/daemon 0.1.2 → 0.1.4

package/dist/core/dispatcher-date-utils.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Pure timezone-aware date helpers used by the dispatcher's quota-reset
+ * logic (`resolveQuotaResetAtMs`) — no instance state, no I/O.
+ *
+ * Extracted from `core/dispatcher.ts` as part of phase D-2 of
+ * `docs/design/appendices/file-split-plan.md` (pattern A — pure
+ * functions). The dispatcher imports these directly at the call sites
+ * that previously read `this.…`; no re-export from `dispatcher.ts`
+ * because none of these were ever public surface.
+ */
+export interface LocalDateParts {
+    year: number;
+    month: number;
+    day: number;
+    hour: number;
+    minute: number;
+}
+/**
+ * Convert local-time `parts` in `timeZone` to a UTC epoch ms. Returns
+ * `null` when the wall-clock instant does not exist in the zone (e.g.
+ * the "spring forward" gap) or when `timeZone` is not a valid IANA id.
+ *
+ * The implementation iterates up to 3 times because the first offset
+ * lookup uses the UTC instant — the resolved offset can shift the wall
+ * time across a DST boundary, requiring another lookup at the new guess.
+ */
+export declare function localDateTimeToUtcMs(parts: LocalDateParts, timeZone?: string): number | null;
+/**
+ * Return the offset (in minutes) that the given `timeZone` applied at
+ * the supplied instant. Positive east of UTC, negative west; `null`
+ * when `timeZone` is invalid or the platform's `Intl` data lacks the
+ * shortOffset name.
+ */
+export declare function getTimeZoneOffsetMinutes(date: Date, timeZone: string): number | null;
+/**
+ * Decompose `date` into year/month/day/hour/minute as observed in the
+ * given `timeZone`. Falls back to the runtime's local zone when the
+ * supplied id is invalid (matching the original behaviour from
+ * dispatcher.ts).
+ */
+export declare function getLocalDateParts(date: Date, timeZone?: string): LocalDateParts;
+/**
+ * Lexicographic comparator on `LocalDateParts` — returns negative when
+ * `a < b`, positive when `a > b`, 0 when equal. Used by the quota-reset
+ * resolver to decide whether the next reset wall-clock has already
+ * passed today.
+ */
+export declare function compareLocalDateParts(a: LocalDateParts, b: LocalDateParts): number;
+//# sourceMappingURL=dispatcher-date-utils.d.ts.map

package/dist/core/dispatcher-date-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dispatcher-date-utils.d.ts","sourceRoot":"","sources":["../../src/core/dispatcher-date-utils.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,cAAc,EACrB,QAAQ,CAAC,EAAE,MAAM,GAChB,MAAM,GAAG,IAAI,CAyCf;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CACtC,IAAI,EAAE,IAAI,EACV,QAAQ,EAAE,MAAM,GACf,MAAM,GAAG,IAAI,CAyBf;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,IAAI,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,cAAc,CAiC/E;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CACnC,CAAC,EAAE,cAAc,EACjB,CAAC,EAAE,cAAc,GAChB,MAAM,CAMR"}

package/dist/core/dispatcher-date-utils.js

@@ -0,0 +1,132 @@
+/**
+ * Pure timezone-aware date helpers used by the dispatcher's quota-reset
+ * logic (`resolveQuotaResetAtMs`) — no instance state, no I/O.
+ *
+ * Extracted from `core/dispatcher.ts` as part of phase D-2 of
+ * `docs/design/appendices/file-split-plan.md` (pattern A — pure
+ * functions). The dispatcher imports these directly at the call sites
+ * that previously read `this.…`; no re-export from `dispatcher.ts`
+ * because none of these were ever public surface.
+ */
+/**
+ * Convert local-time `parts` in `timeZone` to a UTC epoch ms. Returns
+ * `null` when the wall-clock instant does not exist in the zone (e.g.
+ * the "spring forward" gap) or when `timeZone` is not a valid IANA id.
+ *
+ * The implementation iterates up to 3 times because the first offset
+ * lookup uses the UTC instant — the resolved offset can shift the wall
+ * time across a DST boundary, requiring another lookup at the new guess.
+ */
+export function localDateTimeToUtcMs(parts, timeZone) {
+    if (!timeZone) {
+        return new Date(parts.year, parts.month - 1, parts.day, parts.hour, parts.minute, 0, 0).getTime();
+    }
+    const baseUtc = Date.UTC(parts.year, parts.month - 1, parts.day, parts.hour, parts.minute, 0, 0);
+    let guess = baseUtc;
+    for (let attempt = 0; attempt < 3; attempt++) {
+        const offsetMinutes = getTimeZoneOffsetMinutes(new Date(guess), timeZone);
+        if (offsetMinutes === null) {
+            return null;
+        }
+        const nextGuess = baseUtc - offsetMinutes * 60 * 1000;
+        if (nextGuess === guess) {
+            break;
+        }
+        guess = nextGuess;
+    }
+    const resolved = getLocalDateParts(new Date(guess), timeZone);
+    if (compareLocalDateParts(resolved, parts) !== 0) {
+        return null;
+    }
+    return guess;
+}
+/**
+ * Return the offset (in minutes) that the given `timeZone` applied at
+ * the supplied instant. Positive east of UTC, negative west; `null`
+ * when `timeZone` is invalid or the platform's `Intl` data lacks the
+ * shortOffset name.
+ */
+export function getTimeZoneOffsetMinutes(date, timeZone) {
+    let formatter;
+    try {
+        formatter = new Intl.DateTimeFormat("en-US", {
+            timeZone,
+            timeZoneName: "shortOffset",
+        });
+    }
+    catch {
+        return null;
+    }
+    const zonePart = formatter.formatToParts(date).find((part) => part.type === "timeZoneName")?.value;
+    if (!zonePart) {
+        return null;
+    }
+    if (zonePart === "GMT") {
+        return 0;
+    }
+    const match = /^GMT([+-])(\d{1,2})(?::?(\d{2}))?$/.exec(zonePart);
+    if (!match) {
+        return null;
+    }
+    const sign = match[1] === "-" ? -1 : 1;
+    const hours = Number(match[2]);
+    const minutes = Number(match[3] ?? "0");
+    return sign * (hours * 60 + minutes);
+}
+/**
+ * Decompose `date` into year/month/day/hour/minute as observed in the
+ * given `timeZone`. Falls back to the runtime's local zone when the
+ * supplied id is invalid (matching the original behaviour from
+ * dispatcher.ts).
+ */
+export function getLocalDateParts(date, timeZone) {
+    let formatter;
+    try {
+        formatter = new Intl.DateTimeFormat("en-US", {
+            timeZone,
+            year: "numeric",
+            month: "2-digit",
+            day: "2-digit",
+            hour: "2-digit",
+            minute: "2-digit",
+            hourCycle: "h23",
+        });
+    }
+    catch {
+        formatter = new Intl.DateTimeFormat("en-US", {
+            year: "numeric",
+            month: "2-digit",
+            day: "2-digit",
+            hour: "2-digit",
+            minute: "2-digit",
+            hourCycle: "h23",
+        });
+    }
+    const parts = formatter.formatToParts(date);
+    const valueOf = (type) => Number(parts.find((part) => part.type === type)?.value ?? "0");
+    return {
+        year: valueOf("year"),
+        month: valueOf("month"),
+        day: valueOf("day"),
+        hour: valueOf("hour"),
+        minute: valueOf("minute"),
+    };
+}
+/**
+ * Lexicographic comparator on `LocalDateParts` — returns negative when
+ * `a < b`, positive when `a > b`, 0 when equal. Used by the quota-reset
+ * resolver to decide whether the next reset wall-clock has already
+ * passed today.
+ */
+export function compareLocalDateParts(a, b) {
+    if (a.year !== b.year)
+        return a.year - b.year;
+    if (a.month !== b.month)
+        return a.month - b.month;
+    if (a.day !== b.day)
+        return a.day - b.day;
+    if (a.hour !== b.hour)
+        return a.hour - b.hour;
+    return a.minute - b.minute;
+}
+//# sourceMappingURL=dispatcher-date-utils.js.map

package/dist/core/dispatcher-date-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dispatcher-date-utils.js","sourceRoot":"","sources":["../../src/core/dispatcher-date-utils.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAUH;;;;;;;;GAQG;AACH,MAAM,UAAU,oBAAoB,CAClC,KAAqB,EACrB,QAAiB;IAEjB,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,OAAO,IAAI,IAAI,CACb,KAAK,CAAC,IAAI,EACV,KAAK,CAAC,KAAK,GAAG,CAAC,EACf,KAAK,CAAC,GAAG,EACT,KAAK,CAAC,IAAI,EACV,KAAK,CAAC,MAAM,EACZ,CAAC,EACD,CAAC,CACF,CAAC,OAAO,EAAE,CAAC;IACd,CAAC;IAED,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CACtB,KAAK,CAAC,IAAI,EACV,KAAK,CAAC,KAAK,GAAG,CAAC,EACf,KAAK,CAAC,GAAG,EACT,KAAK,CAAC,IAAI,EACV,KAAK,CAAC,MAAM,EACZ,CAAC,EACD,CAAC,CACF,CAAC;IACF,IAAI,KAAK,GAAG,OAAO,CAAC;IAEpB,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,GAAG,CAAC,EAAE,OAAO,EAAE,EAAE,CAAC;QAC7C,MAAM,aAAa,GAAG,wBAAwB,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,EAAE,QAAQ,CAAC,CAAC;QAC1E,IAAI,aAAa,KAAK,IAAI,EAAE,CAAC;YAC3B,OAAO,IAAI,CAAC;QACd,CAAC;QACD,MAAM,SAAS,GAAG,OAAO,GAAG,aAAa,GAAG,EAAE,GAAG,IAAI,CAAC;QACtD,IAAI,SAAS,KAAK,KAAK,EAAE,CAAC;YACxB,MAAM;QACR,CAAC;QACD,KAAK,GAAG,SAAS,CAAC;IACpB,CAAC;IAED,MAAM,QAAQ,GAAG,iBAAiB,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,EAAE,QAAQ,CAAC,CAAC;IAC9D,IAAI,qBAAqB,CAAC,QAAQ,EAAE,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC;QACjD,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,wBAAwB,CACtC,IAAU,EACV,QAAgB;IAEhB,IAAI,SAA8B,CAAC;IACnC,IAAI,CAAC;QACH,SAAS,GAAG,IAAI,IAAI,CAAC,cAAc,CAAC,OAAO,EAAE;YAC3C,QAAQ;YACR,YAAY,EAAE,aAAa;SAC5B,CAAC,CAAC;IACL,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;IACD,MAAM,QAAQ,GAAG,SAAS,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,cAAc,CAAC,EAAE,KAAK,CAAC;IACnG,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IAAI,QAAQ,KAAK,KAAK,EAAE,CAAC;QACvB,OAAO,CAAC,CAAC;IACX,CAAC;IACD,MAAM,KAAK,GAAG,oCAAoC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAClE,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,IAAI,CAAC;IACd,CAAC;IACD,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACvC,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IAC/B,MAAM,OAAO,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC;IACxC,OAAO,IAAI,GAAG,CAAC,KAAK,GAAG,EAAE,GAAG,OAAO,CAAC,CAAC;AACvC,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAAC,IAAU,EAAE,QAAiB;IAC7D,IAAI,SAA8B,CAAC;IACnC,IAAI,CAAC;QACH,SAAS,GAAG,IAAI,IAAI,CAAC,cAAc,CAAC,OAAO,EAAE;YAC3C,QAAQ;YACR,IAAI,EAAE,SAAS;YACf,KAAK,EAAE,SAAS;YAChB,GAAG,EAAE,SAAS;YACd,IAAI,EAAE,SAAS;YACf,MAAM,EAAE,SAAS;YACjB,SAAS,EAAE,KAAK;SACjB,CAAC,CAAC;IACL,CAAC;IAAC,MAAM,CAAC;QACP,SAAS,GAAG,IAAI,IAAI,CAAC,cAAc,CAAC,OAAO,EAAE;YAC3C,IAAI,EAAE,SAAS;YACf,KAAK,EAAE,SAAS;YAChB,GAAG,EAAE,SAAS;YACd,IAAI,EAAE,SAAS;YACf,MAAM,EAAE,SAAS;YACjB,SAAS,EAAE,KAAK;SACjB,CAAC,CAAC;IACL,CAAC;IACD,MAAM,KAAK,GAAG,SAAS,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC;IAC5C,MAAM,OAAO,GAAG,CAAC,IAAkC,EAAE,EAAE,CACrD,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC,EAAE,KAAK,IAAI,GAAG,CAAC,CAAC;IAEjE,OAAO;QACL,IAAI,EAAE,OAAO,CAAC,MAAM,CAAC;QACrB,KAAK,EAAE,OAAO,CAAC,OAAO,CAAC;QACvB,GAAG,EAAE,OAAO,CAAC,KAAK,CAAC;QACnB,IAAI,EAAE,OAAO,CAAC,MAAM,CAAC;QACrB,MAAM,EAAE,OAAO,CAAC,QAAQ,CAAC;KAC1B,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,qBAAqB,CACnC,CAAiB,EACjB,CAAiB;IAEjB,IAAI,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,IAAI;QAAE,OAAO,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC;IAC9C,IAAI,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,KAAK;QAAE,OAAO,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC;IAClD,IAAI,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,GAAG;QAAE,OAAO,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,GAAG,CAAC;IAC1C,IAAI,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,IAAI;QAAE,OAAO,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC;IAC9C,OAAO,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,MAAM,CAAC;AAC7B,CAAC"}

package/dist/core/dispatcher-error-handling.d.ts

@@ -0,0 +1,159 @@
+/**
+ * `DispatcherErrorRouter` — owns the dispatcher's failure-path
+ * machinery: the shallow retry wrapper around BackendRouter
+ * (`executeWithRetry`), the post-throw cleanup + DM/dashboard
+ * notification (`handleError`), the quota-error introspection +
+ * formatting helpers, and the §4.5 delegated-connector health
+ * warning consult/dispatch pair.
+ *
+ * Extracted from `core/dispatcher.ts` as part of phase D-2 of
+ * `docs/design/appendices/file-split-plan.md`. Pattern B (stateful
+ * coordinator): the router owns its own logic but borrows live
+ * references from the dispatcher for state that must remain
+ * observable to the parent class — the `notifiedEvents` Set used to
+ * dedup outbound notifications, the `shutdownAwaiters` Set used to
+ * shortcut the retry sleep on SIGTERM, plus accessors for the
+ * dispatcher's `shutdown` flag and lazily-injected dashboard stream.
+ *
+ * Dispatcher entry points served:
+ *   - `dispatchSafe` calls `executeWithRetry` around backend invokes
+ *     and `handleError` on failure;
+ *   - `handleMessage` calls the `consult/run` connector-warning pair
+ *     before/after recording the user message;
+ *   - the §4.5 finalize callbacks (`onRetemplateFinalize` /
+ *     `onManagementScanFinalize`) bridge into the ResultProcessor —
+ *     the success path uses ResultProcessor directly; the error path
+ *     calls through these closures to keep the failure ordering
+ *     identical to the pre-split file.
+ *
+ * Shared-state references held:
+ *   - `notifiedEvents: Set<string>` — live reference; `handleError`
+ *     deletes the entry as defense-in-depth cleanup when execution
+ *     threw before reaching `processResult`.
+ *   - `shutdownAwaiters: Set<() => void>` — live reference; the retry
+ *     sleep races a 5-min timer against this awaiter set so SIGTERM
+ *     resolves the wait promptly.
+ *   - `isShutdown: () => boolean` — getter; on shutdown wakeup the
+ *     retry loop rethrows instead of looping again.
+ *   - `getDashboardStream: () => IDashboardStream | null` — lazy
+ *     accessor; the dashboard stream is wired after construction.
+ */
+import type Database from "better-sqlite3";
+import type { Event, MessageEvent, BackendId } from "@aitne/shared";
+import type { AgentConfig } from "../config.js";
+import { BackendQuotaError } from "./agent-core.js";
+import { type DelegatedSignoutWarning } from "./delegated-connector-health.js";
+import type { IDashboardStream, INotificationManager, IMessageRecorder } from "./dispatcher-types.js";
+export interface DispatcherErrorRouterDeps {
+    db: Database.Database;
+    config: AgentConfig;
+    notificationMgr: INotificationManager;
+    messageRecorder: IMessageRecorder;
+    /** Live reference to the dispatcher's notify-dedup set. */
+    notifiedEvents: Set<string>;
+    /** Live reference to the dispatcher's shutdown-awaiter set. */
+    shutdownAwaiters: Set<() => void>;
+    /** Lazily-resolved dashboard stream (may be null in tests). */
+    getDashboardStream: () => IDashboardStream | null;
+    /** Returns the dispatcher's current shutdown flag. */
+    isShutdown: () => boolean;
+    /**
+     * Closure that bridges into `ResultProcessor.finalizeRetemplateRun`.
+     * Used by `handleError` so a retemplate run that throws still
+     * rolls back / records the right outcome.
+     */
+    onRetemplateFinalize: (event: Event, opts: {
+        errored: boolean;
+    }) => void;
+    /**
+     * Closure that bridges into `ResultProcessor.finalizeManagementScan`.
+     * Used by `handleError` so a management-scan that throws still
+     * records `failed` against the right repository row.
+     */
+    onManagementScanFinalize: (event: Event, opts: {
+        errored: boolean;
+    }) => void;
+}
+export declare class DispatcherErrorRouter {
+    private readonly db;
+    private readonly config;
+    private readonly notificationMgr;
+    private readonly messageRecorder;
+    private readonly notifiedEvents;
+    private readonly shutdownAwaiters;
+    private readonly getDashboardStream;
+    private readonly isShutdown;
+    private readonly onRetemplateFinalize;
+    private readonly onManagementScanFinalize;
+    constructor(deps: DispatcherErrorRouterDeps);
+    isRetryable(error: unknown): boolean;
+    /**
+     * Defense-in-depth retry wrapper around BackendRouter.execute().
+     *
+     * **Primary retry responsibility lives inside each BackendCore** (§12/§13).
+     * Quota errors, timeouts, and auth failures are all normalized into
+     * BackendDecisiveFailure / BackendQuotaError before they reach this layer.
+     * The BackendRouter handles fallback on decisive failures.
+     *
+     * This outer loop exists solely as a safety net for raw 5xx errors that
+     * somehow escape the BackendCore → Router chain (e.g., an unexpected HTTP
+     * error from the SDK transport layer). In practice it almost never fires.
+     */
+    executeWithRetry<T>(fn: () => Promise<T>, event: Event): Promise<T>;
+    handleError(event: Event, error: Error): Promise<void>;
+    /**
+     * Best-effort inline error to the dashboard tab whose POST triggered
+     * this event. `DashboardAdapter` is `notificationEligible=false`, so
+     * the normal `notificationMgr.send` path skips it — without this hook
+     * the browser sees the request accepted (200 OK), watches nothing
+     * happen, and hits the 120s waiting timeout with no explanation. We
+     * target the originating channel id; if the tab already reconnected
+     * with a new UUID the adapter silently drops, which matches the
+     * chat_error semantics.
+     */
+    notifyDashboardError(event: Event, message: string): void;
+    extractQuotaError(error: unknown): BackendQuotaError | null;
+    formatQuotaMessage(quotaError: BackendQuotaError): string;
+    formatBackendLabel(backendId: BackendQuotaError["backendId"]): string;
+    resolveQuotaResetAtMs(resetHint: {
+        hour: number;
+        minute: number;
+        timeZone?: string;
+    }): number | null;
+    /**
+     * DELEGATED-MODE-V2-DESIGN.md §4.5 — at every DM dispatch, consult the
+     * cached probe for delegated integrations whose effective backend
+     * matches the session backend. Surfaces a one-shot DM (deduped via
+     * `runtime_state`) when the cached probe says required capabilities
+     * are no longer present.
+     *
+     * The consult itself is synchronous DB-only work (cheap on the hot
+     * path). The DM dispatch is fire-and-forget so the agent's response
+     * latency is not gated on Slack/Telegram round-trips. Per-warning
+     * dispatch failures are swallowed so a flaky messaging adapter never
+     * breaks the user's actual DM.
+     *
+     * Phase 1 of the §4.5 health check — synchronous cache consult only.
+     * Returns the warnings the dispatcher must surface this turn (or `[]`
+     * when nothing is broken / setup mode is active / the consult itself
+     * threw). Recovery markers are cleared inline by the consult helper, so
+     * the caller does not have to track them.
+     *
+     * Split from the dispatch step so the actual DM (and its messages-table
+     * persist) fires AFTER the dispatcher has recorded the inbound user
+     * message — otherwise the warning row's `CURRENT_TIMESTAMP` lands before
+     * the user-message row's, which makes `chat_meta` history reload reorder
+     * the bubbles (warning above user) and a one-time visual flicker leaks
+     * to the user. See `runDelegatedConnectorWarningDispatch` below.
+     */
+    consultDelegatedConnectorWarnings(sessionBackend: BackendId): readonly DelegatedSignoutWarning[];
+    /**
+     * Phase 2 of the §4.5 health check — asynchronous DM dispatch + post-
+     * delivery bookkeeping (throttle marker + dashboard-channel persist).
+     * Caller invokes this AFTER the user message is recorded so the DM's
+     * messages-table row carries a strictly-later `CURRENT_TIMESTAMP`
+     * (preserves pre-reconcile chat order on the dashboard).
+     */
+    runDelegatedConnectorWarningDispatch(warnings: readonly DelegatedSignoutWarning[], event: MessageEvent, sessionBackend: BackendId, sessionId: number): void;
+}
+//# sourceMappingURL=dispatcher-error-handling.d.ts.map

package/dist/core/dispatcher-error-handling.d.ts.map

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