@elizaos/ui 2.0.3-beta.2 → 2.0.3-beta.3

package/components/chat/widgets/finances-alerts.js

@@ -0,0 +1,214 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { Wallet } from "lucide-react";
+import { useCallback, useEffect, useMemo, useState } from "react";
+import { client } from "../../../api/index.js";
+import { useIntervalWhenDocumentVisible } from "../../../hooks/index.js";
+import { usePublishHomeAttention } from "../../../widgets/home-attention-store.js";
+import { HOME_SIGNAL_WEIGHTS } from "../../../widgets/home-priority.js";
+import { HomeWidgetCard, useWidgetNavigation } from "./home-widget-card.js";
+const FINANCES_WIDGET_KEY = "finances/finances.alerts";
+// Match FinancesView's 30s quiet poll (plugins/plugin-finances/src/components/
+// finances/FinancesView.tsx — POLL_INTERVAL_MS).
+const FINANCES_REFRESH_INTERVAL_MS = 30_000;
+const WEEK_MS = 7 * 24 * 60 * 60 * 1000;
+const USD = "USD";
+// ---------------------------------------------------------------------------
+// Boundary validation — the responses are untrusted network input, so narrow
+// each shape before mapping. Anything malformed degrades to empty (no source /
+// no bills), which makes the widget render null rather than throw.
+// ---------------------------------------------------------------------------
+function isRecord(value) {
+    return typeof value === "object" && value !== null;
+}
+function usdToMinor(amountUsd) {
+    return Math.round(amountUsd * 100);
+}
+/** FinancesView maps spending.netUsd -> netBalanceMinor at the USD boundary. */
+function parseNetBalanceMinor(dashboard) {
+    if (!isRecord(dashboard))
+        return 0;
+    const spending = dashboard.spending;
+    if (!isRecord(spending) || typeof spending.netUsd !== "number")
+        return 0;
+    return usdToMinor(spending.netUsd);
+}
+/** FinancesView: connected = any source whose status !== "disconnected". */
+function parseHasSource(sources) {
+    if (!isRecord(sources) || !Array.isArray(sources.sources))
+        return false;
+    return sources.sources.some((source) => isRecord(source) &&
+        typeof source.status === "string" &&
+        source.status !== "disconnected");
+}
+/** Mirror mapRecurring: USD avg -> minor; PA charges are always active. */
+function parseBills(recurring) {
+    if (!isRecord(recurring) || !Array.isArray(recurring.charges))
+        return [];
+    const bills = [];
+    for (const charge of recurring.charges) {
+        if (!isRecord(charge))
+            continue;
+        if (typeof charge.averageAmountUsd !== "number")
+            continue;
+        const merchantNormalized = typeof charge.merchantNormalized === "string"
+            ? charge.merchantNormalized
+            : "";
+        const merchantDisplay = typeof charge.merchantDisplay === "string" ? charge.merchantDisplay : "";
+        const label = merchantDisplay || merchantNormalized;
+        if (!label)
+            continue;
+        bills.push({
+            id: merchantNormalized || label,
+            label,
+            amountMinor: usdToMinor(charge.averageAmountUsd),
+            currency: USD,
+            nextChargeAt: typeof charge.nextExpectedAt === "string"
+                ? charge.nextExpectedAt
+                : null,
+            active: true,
+        });
+    }
+    return bills;
+}
+/**
+ * Load-bearing render boundary mirroring FinancesView.formatMinor: minor units
+ * (cents) -> grouped currency string. Kept inline (no shared util) to match the
+ * View's own formatting.
+ */
+function formatMinor(amountMinor, currency) {
+    const value = amountMinor / 100;
+    try {
+        return new Intl.NumberFormat(undefined, {
+            style: "currency",
+            currency,
+        }).format(value);
+    }
+    catch {
+        return `${value.toFixed(2)} ${currency}`;
+    }
+}
+/** Whole-day rounded "due in N days" / "due today" label for a bill. */
+function dueInLabel(nextChargeAt, now) {
+    const due = new Date(nextChargeAt).getTime();
+    const days = Math.round((due - now) / (24 * 60 * 60 * 1000));
+    if (days <= 0)
+        return "due today";
+    if (days === 1)
+        return "due tomorrow";
+    return `due in ${days} days`;
+}
+async function getJson(path) {
+    const response = await fetch(`${client.getBaseUrl()}${path}`);
+    if (!response.ok) {
+        throw new Error(`Money request failed (${response.status}): ${path}`);
+    }
+    return response.json();
+}
+function billsDueWithin7Days(bills, now) {
+    const weekFromNow = now + WEEK_MS;
+    return bills
+        .filter((bill) => {
+        if (!bill.active || !bill.nextChargeAt)
+            return false;
+        const due = new Date(bill.nextChargeAt).getTime();
+        return !Number.isNaN(due) && due >= now && due <= weekFromNow;
+    })
+        .sort((left, right) => {
+        const leftDue = new Date(left.nextChargeAt).getTime();
+        const rightDue = new Date(right.nextChargeAt).getTime();
+        return leftDue - rightDue;
+    });
+}
+/**
+ * FINANCES "Bills & Balance" home widget (#9143). Glanceable summary of money
+ * attention: an overdrawn-balance escalation row plus the next few recurring
+ * bills landing within a week. Fetches the same `/api/lifeops/money/*` routes
+ * FinancesView reads (dashboard + recurring + sources; transactions skipped),
+ * polling quietly while the document is visible.
+ */
+/** Shallow content equality so an unchanged 30s poll doesn't re-render. */
+function financesEqual(a, b) {
+    if (!a)
+        return false;
+    if (a.hasSource !== b.hasSource ||
+        a.netBalanceMinor !== b.netBalanceMinor ||
+        a.bills.length !== b.bills.length) {
+        return false;
+    }
+    return a.bills.every((bill, i) => {
+        const other = b.bills[i];
+        return (bill.id === other.id &&
+            bill.amountMinor === other.amountMinor &&
+            bill.nextChargeAt === other.nextChargeAt);
+    });
+}
+function FinancesAlertsWidget(_props) {
+    const [data, setData] = useState(null);
+    const nav = useWidgetNavigation();
+    const load = useCallback(async () => {
+        try {
+            const [dashboard, recurring, sources] = await Promise.all([
+                getJson("/api/lifeops/money/dashboard"),
+                getJson("/api/lifeops/money/recurring"),
+                getJson("/api/lifeops/money/sources"),
+            ]);
+            const next = {
+                hasSource: parseHasSource(sources),
+                netBalanceMinor: parseNetBalanceMinor(dashboard),
+                currency: USD,
+                bills: parseBills(recurring),
+            };
+            // Skip the state update (and the re-render) when the poll is unchanged.
+            setData((prev) => (financesEqual(prev, next) ? prev : next));
+        }
+        catch {
+            // Transient/poll failure: keep the last good snapshot (todo.tsx pattern).
+        }
+    }, []);
+    useEffect(() => {
+        void load();
+    }, [load]);
+    useIntervalWhenDocumentVisible(() => void load(), FINANCES_REFRESH_INTERVAL_MS);
+    const overdrawn = data != null && data.netBalanceMinor < 0;
+    const dueSoon = useMemo(() => (data ? billsDueWithin7Days(data.bills, Date.now()) : []), [data]);
+    const hasBillsDue = dueSoon.length > 0;
+    // Self-signal (#9143): overdrawn floats up at escalation strength, otherwise
+    // bills-due-this-week float up at reminder strength; nothing urgent clears it.
+    const weight = overdrawn
+        ? HOME_SIGNAL_WEIGHTS.escalation
+        : hasBillsDue
+            ? HOME_SIGNAL_WEIGHTS.reminder
+            : null;
+    usePublishHomeAttention(FINANCES_WIDGET_KEY, weight);
+    // Render nothing while the first load is pending and nothing is cached, when
+    // there's no connected source, or when the balance is healthy and no bill is
+    // due within 7 days — the home surface must not show empty placeholders.
+    if (data == null)
+        return null;
+    if (!data.hasSource)
+        return null;
+    if (!overdrawn && !hasBillsDue)
+        return null;
+    // One high-priority datum, icon-first: overdrawn balance (escalation) wins;
+    // otherwise the soonest bill due this week. Tapping opens the Finances view.
+    if (overdrawn) {
+        const amount = formatMinor(data.netBalanceMinor, data.currency);
+        return (_jsx(HomeWidgetCard, { icon: _jsx(Wallet, {}), label: "Bills", value: amount, badge: "Overdrawn", tone: "danger", testId: "chat-widget-finances-alerts", ariaLabel: `Bills: account overdrawn ${amount}. Open Finances.`, onActivate: () => nav.openView("/finances", "finances") }));
+    }
+    const soonest = dueSoon[0];
+    return (_jsx(HomeWidgetCard, { icon: _jsx(Wallet, {}), label: "Bills", value: soonest.label, meta: dueInLabel(soonest.nextChargeAt, Date.now()), badge: dueSoon.length > 1 ? `${dueSoon.length} due` : undefined, tone: "warn", testId: "chat-widget-finances-alerts", ariaLabel: `Bills: ${dueSoon.length} due this week, next ${soonest.label} ${dueInLabel(soonest.nextChargeAt, Date.now())}. Open Finances.`, onActivate: () => nav.openView("/finances", "finances") }));
+}
+/**
+ * Home-slot registration for the finances "Bills & Balance" widget. Wired into
+ * the registry centrally (see widgets/registry.ts). `signalKinds` mirror the
+ * self-signal kinds this widget publishes (escalation when overdrawn, reminder
+ * when bills are due soon).
+ */
+export const FINANCES_HOME_WIDGET = {
+    pluginId: "finances",
+    id: "finances.alerts",
+    order: 130,
+    signalKinds: ["escalation", "reminder"],
+    Component: FinancesAlertsWidget,
+};
+export { FinancesAlertsWidget };

package/components/chat/widgets/followups.d.ts

@@ -14,7 +14,7 @@
  * The whole row is dismissible (the agent's suggestions are optional), and the
  * row also locks after a `reply` so the agent only ever sees one decision.
  */
-import type { FollowupKind, FollowupOption } from "../message-followups-parser";
+import type { FollowupKind, FollowupOption } from "../message-followups-parser.js";
 export type { FollowupKind, FollowupOption };
 export type FollowupsWidgetProps = {
     /** Stable id from the source `[FOLLOWUPS id=xxx]` marker. */

package/components/chat/widgets/form-request.d.ts

@@ -10,7 +10,7 @@
  * structured result is handed to `onSubmit` (the host sends it back as a
  * message), matching the existing message-action callback wiring.
  */
-import type { FormFieldSpec, FormRequestSpec } from "../message-form-parser";
+import type { FormFieldSpec, FormRequestSpec } from "../message-form-parser.js";
 export type { FormFieldSpec, FormRequestSpec };
 /** Value emitted per field: string for text/number/select, boolean for checkbox. */
 export type FormResultValue = string | boolean;

package/components/chat/widgets/goals-attention.d.ts

@@ -0,0 +1,17 @@
+import type { WidgetProps } from "../../../widgets/types.js";
+/**
+ * Frontpage Goals widget (#9143). Glanceable, home-only, icon-first: surfaces
+ * the SINGLE most-urgent goal (at_risk first, then needs_attention) as one
+ * datum, with a count badge. Fetches the same `/api/lifeops/goals` endpoint
+ * GoalsView reads and floats itself up via the home-attention store when any
+ * goal is at risk or needs attention. Tapping the card opens the Goals view.
+ */
+export declare function GoalsAttentionWidget(_props: Partial<WidgetProps>): import("react/jsx-runtime").JSX.Element | null;
+export declare const GOALS_HOME_WIDGET: {
+    readonly pluginId: "goals";
+    readonly id: "goals.attention";
+    readonly order: 120;
+    readonly signalKinds: readonly ["escalation", "reminder"];
+    readonly Component: typeof GoalsAttentionWidget;
+};
+//# sourceMappingURL=goals-attention.d.ts.map

package/components/chat/widgets/goals-attention.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"goals-attention.d.ts","sourceRoot":"","sources":["../../../../../../../src/components/chat/widgets/goals-attention.tsx"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AA2I1D;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,OAAO,CAAC,WAAW,CAAC,kDAoDhE;AAED,eAAO,MAAM,iBAAiB;;;;;;CAMpB,CAAC"}

package/components/chat/widgets/goals-attention.js

@@ -0,0 +1,155 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { Target } from "lucide-react";
+import { useCallback, useEffect, useMemo, useState } from "react";
+import { client } from "../../../api/index.js";
+import { useIntervalWhenDocumentVisible } from "../../../hooks/index.js";
+import { usePublishHomeAttention } from "../../../widgets/home-attention-store.js";
+import { HOME_SIGNAL_WEIGHTS } from "../../../widgets/home-priority.js";
+import { HomeWidgetCard, useWidgetNavigation } from "./home-widget-card.js";
+const GOALS_WIDGET_KEY = "goals/goals.attention";
+const GOALS_REFRESH_INTERVAL_MS = 20_000; // matches GoalsView's 20s background poll
+const KNOWN_STATUSES = new Set([
+    "active",
+    "paused",
+    "archived",
+    "satisfied",
+]);
+const KNOWN_REVIEW_STATES = new Set([
+    "idle",
+    "needs_attention",
+    "on_track",
+    "at_risk",
+]);
+function toStatus(value) {
+    return typeof value === "string" && KNOWN_STATUSES.has(value)
+        ? value
+        : "active";
+}
+function toReviewState(value) {
+    return typeof value === "string" && KNOWN_REVIEW_STATES.has(value)
+        ? value
+        : "idle";
+}
+/**
+ * Validate + flatten the untrusted `{ goals: [{ goal, links }] }` payload at
+ * the network boundary, dropping any record missing the fields we render.
+ */
+function parseGoals(payload) {
+    if (typeof payload !== "object" || payload === null)
+        return [];
+    const records = payload.goals;
+    if (!Array.isArray(records))
+        return [];
+    const goals = [];
+    for (const record of records) {
+        if (typeof record !== "object" || record === null)
+            continue;
+        const goal = record.goal;
+        if (typeof goal !== "object" || goal === null)
+            continue;
+        const { id, title, status, reviewState } = goal;
+        if (typeof id !== "string" || typeof title !== "string")
+            continue;
+        goals.push({
+            id,
+            title,
+            status: toStatus(status),
+            reviewState: toReviewState(reviewState),
+        });
+    }
+    return goals;
+}
+async function fetchGoals() {
+    const response = await fetch(`${client.getBaseUrl()}/api/lifeops/goals`);
+    if (!response.ok) {
+        throw new Error(`Goals request failed (${response.status})`);
+    }
+    return parseGoals(await response.json());
+}
+/** Goals that belong on the home card: live (non-archived, non-satisfied). */
+function liveGoals(goals) {
+    return goals.filter((goal) => goal.status !== "archived" && goal.status !== "satisfied");
+}
+/**
+ * The single most-urgent goal for the home card: the first at_risk goal,
+ * otherwise the first needs_attention goal, otherwise null. Ties broken by
+ * title so the surfaced goal is deterministic across polls.
+ */
+function mostUrgentGoal(goals) {
+    const live = liveGoals(goals);
+    const byTitle = (left, right) => left.title.localeCompare(right.title);
+    const atRisk = live
+        .filter((goal) => goal.reviewState === "at_risk")
+        .sort(byTitle);
+    if (atRisk.length > 0)
+        return atRisk[0];
+    const needsAttention = live
+        .filter((goal) => goal.reviewState === "needs_attention")
+        .sort(byTitle);
+    if (needsAttention.length > 0)
+        return needsAttention[0];
+    return null;
+}
+/** Count of live goals that need attention (at_risk or needs_attention). */
+function attentionCount(goals) {
+    return liveGoals(goals).filter((goal) => goal.reviewState === "at_risk" || goal.reviewState === "needs_attention").length;
+}
+/** Shallow content equality so an unchanged 20s poll doesn't re-render. */
+function goalsEqual(a, b) {
+    if (!a || a.length !== b.length)
+        return false;
+    return a.every((goal, i) => {
+        const other = b[i];
+        return (goal.id === other.id &&
+            goal.title === other.title &&
+            goal.status === other.status &&
+            goal.reviewState === other.reviewState);
+    });
+}
+/**
+ * Frontpage Goals widget (#9143). Glanceable, home-only, icon-first: surfaces
+ * the SINGLE most-urgent goal (at_risk first, then needs_attention) as one
+ * datum, with a count badge. Fetches the same `/api/lifeops/goals` endpoint
+ * GoalsView reads and floats itself up via the home-attention store when any
+ * goal is at risk or needs attention. Tapping the card opens the Goals view.
+ */
+export function GoalsAttentionWidget(_props) {
+    // `null` distinguishes "first load still pending" from "loaded, empty" so the
+    // home surface renders nothing (not a card) until we actually know the data.
+    const [goals, setGoals] = useState(null);
+    const nav = useWidgetNavigation();
+    const load = useCallback(async () => {
+        try {
+            const next = await fetchGoals();
+            // Skip the state update (and the re-render) when the poll is unchanged.
+            setGoals((prev) => (goalsEqual(prev, next) ? prev : next));
+        }
+        catch {
+            // Silent fallback to the last good render (matches todo.tsx); never log.
+        }
+    }, []);
+    useEffect(() => {
+        void load();
+    }, [load]);
+    // Poll only while the document is visible, at the View's 20s cadence.
+    useIntervalWhenDocumentVisible(() => void load(), GOALS_REFRESH_INTERVAL_MS);
+    const urgent = useMemo(() => (goals ? mostUrgentGoal(goals) : null), [goals]);
+    const count = useMemo(() => (goals ? attentionCount(goals) : 0), [goals]);
+    // Float the home card up while any goal is at risk / needs attention.
+    usePublishHomeAttention(GOALS_WIDGET_KEY, urgent ? HOME_SIGNAL_WEIGHTS.escalation : null);
+    // Render nothing until the first load resolves, and nothing once loaded if no
+    // goal needs attention — the home surface must not show empty placeholders or
+    // on-track goals (#9143).
+    if (goals == null || urgent == null)
+        return null;
+    const tone = urgent.reviewState === "at_risk" ? "danger" : "warn";
+    const status = urgent.reviewState === "at_risk" ? "at risk" : "needs attention";
+    return (_jsx(HomeWidgetCard, { icon: _jsx(Target, {}), label: "Goals", value: urgent.title, badge: count > 1 ? `${count}` : undefined, tone: tone, testId: "widget-goals-attention", ariaLabel: `Goals: ${count} need attention, top "${urgent.title}" ${status}. Open Goals.`, onActivate: () => nav.openView("/goals", "goals") }));
+}
+export const GOALS_HOME_WIDGET = {
+    pluginId: "goals",
+    id: "goals.attention",
+    order: 120,
+    signalKinds: ["escalation", "reminder"],
+    Component: GoalsAttentionWidget,
+};

package/components/chat/widgets/health-sleep.d.ts

@@ -0,0 +1,18 @@
+import type { WidgetProps } from "../../../widgets/types.js";
+/**
+ * Frontpage Sleep widget (#9143). Glanceable, home-only, icon-first: a single
+ * high-priority datum — the latest sleep duration — on one whole-card-clickable
+ * tile that opens the Health view. When sleep reads off-rhythm it carries an
+ * "Irregular"/"Very irregular" badge (warn tone) and floats itself up via the
+ * home-attention store. Fetches the same `/api/lifeops/sleep/*` endpoints
+ * HealthView reads, polling quietly while the document is visible.
+ */
+export declare function HealthSleepWidget(_props: Partial<WidgetProps>): import("react/jsx-runtime").JSX.Element | null;
+export declare const HEALTH_HOME_WIDGET: {
+    readonly pluginId: "health";
+    readonly id: "health.sleep";
+    readonly order: 140;
+    readonly signalKinds: readonly ["check-in"];
+    readonly Component: typeof HealthSleepWidget;
+};
+//# sourceMappingURL=health-sleep.d.ts.map

package/components/chat/widgets/health-sleep.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"health-sleep.d.ts","sourceRoot":"","sources":["../../../../../../../src/components/chat/widgets/health-sleep.tsx"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AA8J1D;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,OAAO,CAAC,WAAW,CAAC,kDA2D7D;AAED,eAAO,MAAM,kBAAkB;;;;;;CAMrB,CAAC"}

package/components/chat/widgets/health-sleep.js

@@ -0,0 +1,159 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { Moon } from "lucide-react";
+import { useCallback, useEffect, useState } from "react";
+import { client } from "../../../api/index.js";
+import { useIntervalWhenDocumentVisible } from "../../../hooks/index.js";
+import { usePublishHomeAttention } from "../../../widgets/home-attention-store.js";
+import { HOME_SIGNAL_WEIGHTS } from "../../../widgets/home-priority.js";
+import { HomeWidgetCard, useWidgetNavigation } from "./home-widget-card.js";
+const HEALTH_SLEEP_WIDGET_KEY = "health/health.sleep";
+// HealthView polls the same `/api/lifeops/sleep/*` endpoints every 20s
+// (POLL_INTERVAL_MS in plugins/plugin-health/src/components/health/HealthView.tsx).
+const SLEEP_REFRESH_INTERVAL_MS = 20_000;
+const WINDOW_DAYS = 14;
+const REGULARITY_CLASSES = new Set([
+    "very_regular",
+    "regular",
+    "irregular",
+    "very_irregular",
+    "insufficient_data",
+]);
+const OFF_RHYTHM_LABELS = {
+    irregular: "Irregular",
+    very_irregular: "Very irregular",
+};
+// HealthView's `sleepProactiveLine` only speaks up for these two classes — the
+// same "needs attention" threshold drives this widget's home-attention signal.
+function isOffRhythm(classification) {
+    return classification === "irregular" || classification === "very_irregular";
+}
+// ---------------------------------------------------------------------------
+// Boundary validation — the fetched JSON is untrusted network input, so narrow
+// it to the wire shapes before reading any field.
+// ---------------------------------------------------------------------------
+function isEpisode(value) {
+    if (typeof value !== "object" || value === null)
+        return false;
+    const record = value;
+    return (typeof record.startedAt === "string" &&
+        (record.endedAt === null || typeof record.endedAt === "string") &&
+        (record.durationMin === null || typeof record.durationMin === "number"));
+}
+function isHistoryResponse(value) {
+    if (typeof value !== "object" || value === null)
+        return false;
+    const episodes = value.episodes;
+    return Array.isArray(episodes) && episodes.every(isEpisode);
+}
+function isRegularityResponse(value) {
+    if (typeof value !== "object" || value === null)
+        return false;
+    const classification = value.classification;
+    return (typeof classification === "string" && REGULARITY_CLASSES.has(classification));
+}
+/** Validated latest sleep episode in the window, or null when absent/malformed. */
+function parseHistory(value) {
+    if (!isHistoryResponse(value))
+        return null;
+    return value.episodes[0] ?? null;
+}
+/** Validated regularity classification, or null when absent/malformed. */
+function parseRegularity(value) {
+    return isRegularityResponse(value) ? value.classification : null;
+}
+async function getJson(path) {
+    const response = await fetch(`${client.getBaseUrl()}${path}`);
+    if (!response.ok) {
+        throw new Error(`Sleep request failed (${response.status}): ${path}`);
+    }
+    return (await response.json());
+}
+async function fetchSleep() {
+    const [historyRaw, regularityRaw] = await Promise.all([
+        getJson(`/api/lifeops/sleep/history?windowDays=${WINDOW_DAYS}&includeNaps=true`),
+        getJson(`/api/lifeops/sleep/regularity?windowDays=${WINDOW_DAYS}`),
+    ]);
+    return {
+        latest: parseHistory(historyRaw),
+        classification: parseRegularity(regularityRaw),
+    };
+}
+// Display-only formatting (client displays, never computes) — mirrors
+// HealthView's formatDuration helper.
+function formatDuration(minutes) {
+    if (minutes === null)
+        return "—";
+    const hours = Math.floor(minutes / 60);
+    const mins = minutes % 60;
+    return hours === 0 ? `${mins}m` : `${hours}h ${mins}m`;
+}
+/** Shallow content equality so an unchanged 20s poll doesn't re-render. */
+function sleepEqual(a, b) {
+    if (!a)
+        return false;
+    if (a.classification !== b.classification)
+        return false;
+    if (a.latest === b.latest)
+        return true;
+    if (a.latest === null || b.latest === null)
+        return false;
+    return (a.latest.startedAt === b.latest.startedAt &&
+        a.latest.endedAt === b.latest.endedAt &&
+        a.latest.durationMin === b.latest.durationMin);
+}
+/**
+ * Frontpage Sleep widget (#9143). Glanceable, home-only, icon-first: a single
+ * high-priority datum — the latest sleep duration — on one whole-card-clickable
+ * tile that opens the Health view. When sleep reads off-rhythm it carries an
+ * "Irregular"/"Very irregular" badge (warn tone) and floats itself up via the
+ * home-attention store. Fetches the same `/api/lifeops/sleep/*` endpoints
+ * HealthView reads, polling quietly while the document is visible.
+ */
+export function HealthSleepWidget(_props) {
+    // `null` = first load still pending; a value (with `latest: null`) = loaded
+    // but no episode. This keeps the home surface blank until we actually know
+    // there's data, and a transient fetch error never clobbers a populated card.
+    const [data, setData] = useState(null);
+    const nav = useWidgetNavigation();
+    const load = useCallback(async () => {
+        try {
+            const next = await fetchSleep();
+            // Skip the state update (and the re-render) when the poll is unchanged.
+            setData((prev) => (sleepEqual(prev, next) ? prev : next));
+        }
+        catch {
+            // Silent fallback to the last good render (matches todo.tsx); never log.
+        }
+    }, []);
+    useEffect(() => {
+        void load();
+    }, [load]);
+    // Poll only while the document is visible, at HealthView's 20s cadence.
+    useIntervalWhenDocumentVisible(() => void load(), SLEEP_REFRESH_INTERVAL_MS);
+    const offRhythm = isOffRhythm(data?.classification ?? null);
+    // Float the home card up while sleep regularity reads as off-rhythm; clear it
+    // otherwise (sustained-state self-signal — see home-attention-store.ts).
+    usePublishHomeAttention(HEALTH_SLEEP_WIDGET_KEY, offRhythm ? HOME_SIGNAL_WEIGHTS["check-in"] : null);
+    // Render nothing until the first load resolves, and nothing once loaded if
+    // there is no sleep episode in the window — the home surface must not show
+    // empty placeholders (#9143).
+    if (data == null || !data.latest)
+        return null;
+    // One high-priority datum, icon-first: the latest sleep duration. The
+    // off-rhythm regularity becomes a warn badge; tapping opens the Health view.
+    const duration = formatDuration(data.latest.durationMin);
+    const badge = data.classification && isOffRhythm(data.classification)
+        ? OFF_RHYTHM_LABELS[data.classification]
+        : undefined;
+    const ariaLabel = badge
+        ? `Sleep: last ${duration}, regularity ${badge.toLowerCase()}. Open Health.`
+        : `Sleep: last ${duration}. Open Health.`;
+    return (_jsx(HomeWidgetCard, { icon: _jsx(Moon, {}), label: "Sleep", value: duration, badge: badge, tone: badge ? "warn" : "default", testId: "widget-health-sleep", ariaLabel: ariaLabel, onActivate: () => nav.openView("/health", "health") }));
+}
+export const HEALTH_HOME_WIDGET = {
+    pluginId: "health",
+    id: "health.sleep",
+    order: 140,
+    signalKinds: ["check-in"],
+    Component: HealthSleepWidget,
+};

package/components/chat/widgets/home-widget-card.d.ts

@@ -0,0 +1,47 @@
+/**
+ * HomeWidgetCard — the compact, icon-first, whole-card-clickable building block
+ * for the home dashboard (#9143).
+ *
+ * Home widgets are glanceable, not dashboards: an icon, a one-word label, and a
+ * SINGLE high-priority datum (a value and/or a status badge). The whole card is
+ * a button — tapping it navigates to the full surface (or runs the relevant
+ * action). Because the visible text is intentionally minimal, the full meaning
+ * lives in `ariaLabel` for screen readers.
+ *
+ * Sits on the orange home wallpaper, so it's a translucent neutral glass tile
+ * (orange is accent-only; resting neutral → neutral-with-opacity hover, never
+ * orange→black — per the hover system).
+ */
+import { type ReactNode } from "react";
+/**
+ * Navigation for home widgets: tapping a card opens the relevant full surface.
+ * `openView` mirrors the home tile path (the `eliza:navigate:view` rail +
+ * proactive-decider report), `openTab` switches a builtin tab. Stable across
+ * renders so it never breaks a widget's memoization.
+ */
+export declare function useWidgetNavigation(): {
+    openView: (path: string, viewId?: string) => void;
+    openTab: (tab: string) => void;
+};
+export type HomeWidgetTone = "default" | "danger" | "warn";
+export interface HomeWidgetCardProps {
+    /** Lucide icon (the primary identifier — text is secondary). */
+    icon: ReactNode;
+    /** One short label, e.g. "Bills", "Goals", "Sleep". */
+    label: string;
+    /** The single high-priority datum, e.g. "−$125.50" or "Design review". */
+    value?: ReactNode;
+    /** Secondary metric kept tight, e.g. "in 45m" — omit when not high-signal. */
+    meta?: ReactNode;
+    /** Count/status pill, e.g. "1", "At risk", "Irregular". */
+    badge?: ReactNode;
+    tone?: HomeWidgetTone;
+    /** data-testid on the card button. */
+    testId: string;
+    /** Full accessible description — visible text is minimal, so this carries it. */
+    ariaLabel: string;
+    /** Tap / Enter → navigate to the full surface or run the action. */
+    onActivate: () => void;
+}
+export declare function HomeWidgetCard({ icon, label, value, meta, badge, tone, testId, ariaLabel, onActivate, }: HomeWidgetCardProps): React.JSX.Element;
+//# sourceMappingURL=home-widget-card.d.ts.map

package/components/chat/widgets/home-widget-card.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"home-widget-card.d.ts","sourceRoot":"","sources":["../../../../../../../src/components/chat/widgets/home-widget-card.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,KAAK,SAAS,EAAW,MAAM,OAAO,CAAC;AAKhD;;;;;GAKG;AACH,wBAAgB,mBAAmB,IAAI;IACrC,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IAClD,OAAO,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;CAChC,CAqBA;AAED,MAAM,MAAM,cAAc,GAAG,SAAS,GAAG,QAAQ,GAAG,MAAM,CAAC;AAe3D,MAAM,WAAW,mBAAmB;IAClC,gEAAgE;IAChE,IAAI,EAAE,SAAS,CAAC;IAChB,uDAAuD;IACvD,KAAK,EAAE,MAAM,CAAC;IACd,0EAA0E;IAC1E,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,8EAA8E;IAC9E,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,2DAA2D;IAC3D,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,IAAI,CAAC,EAAE,cAAc,CAAC;IACtB,sCAAsC;IACtC,MAAM,EAAE,MAAM,CAAC;IACf,iFAAiF;IACjF,SAAS,EAAE,MAAM,CAAC;IAClB,oEAAoE;IACpE,UAAU,EAAE,MAAM,IAAI,CAAC;CACxB;AAED,wBAAgB,cAAc,CAAC,EAC7B,IAAI,EACJ,KAAK,EACL,KAAK,EACL,IAAI,EACJ,KAAK,EACL,IAAgB,EAChB,MAAM,EACN,SAAS,EACT,UAAU,GACX,EAAE,mBAAmB,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CAuEzC"}