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

package/widgets/registry.d.ts

@@ -8,9 +8,10 @@
  * in their widget declaration, which gets rendered by `UiRenderer` via the
  * `WidgetHost` component.
  */
-import type { PluginInfo } from "../api/client-types-config";
-import type { PluginWidgetDeclaration, WidgetProps, WidgetSlot } from "./types";
-export { getWidgetComponent, registerBuiltinWidgets, registerWidgetComponent, } from "./registry-store";
+import type { PluginInfo } from "../api/client-types-config.js";
+import type { PluginWidgetDeclaration, WidgetProps, WidgetSlot } from "./types.js";
+type DefaultHomeWidgetSink = NonNullable<PluginWidgetDeclaration["defaultWidget"]>;
+export { getWidgetComponent, registerBuiltinWidgets, registerWidgetComponent, } from "./registry-store.js";
 /**
  * Public API for plugins outside app-core to append widget declarations to the
  * built-in fallback list. Declarations appear in the sidebar when the runtime
@@ -22,9 +23,10 @@ export declare function registerBuiltinWidgetDeclarations(declarations: Readonly
 export declare const BUILTIN_WIDGET_DECLARATIONS: PluginWidgetDeclaration[];
 /** Minimal plugin state needed for widget resolution. */
 export type WidgetPluginState = Pick<PluginInfo, "id" | "enabled" | "isActive">;
-interface ResolvedWidget {
+export interface ResolvedWidget {
     declaration: PluginWidgetDeclaration;
     Component: React.ComponentType<WidgetProps> | null;
+    defaultWidgetSink?: DefaultHomeWidgetSink;
 }
 /**
  * Resolve all enabled widgets for a slot.
@@ -32,5 +34,15 @@ interface ResolvedWidget {
  * Merges built-in declarations with any server-provided declarations
  * (from PluginInfo.widgets), deduplicating by declaration ID.
  */
+/**
+ * Maps a declaration's `defaultWidget` opt-in (#9143) to the registered shared
+ * frontpage sink component (already registered above via
+ * `registerWidgetComponent`). A `home`-slot plugin with no own component renders
+ * one of these shared widgets instead of shipping its own.
+ */
+export declare const DEFAULT_WIDGET_SINK_COMPONENT: Readonly<Record<DefaultHomeWidgetSink, {
+    pluginId: string;
+    id: string;
+}>>;
 export declare function resolveWidgetsForSlot(slot: WidgetSlot, plugins: readonly WidgetPluginState[], serverDeclarations?: readonly PluginWidgetDeclaration[]): ResolvedWidget[];
 //# sourceMappingURL=registry.d.ts.map

package/widgets/registry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../../../src/widgets/registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAM7D,OAAO,KAAK,EAAE,uBAAuB,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAEhF,OAAO,EACL,kBAAkB,EAClB,sBAAsB,EACtB,uBAAuB,GACxB,MAAM,kBAAkB,CAAC;AAmB1B;;;;GAIG;AACH,wBAAgB,iCAAiC,CAC/C,YAAY,EAAE,aAAa,CAAC,uBAAuB,CAAC,EACpD,OAAO,CAAC,EAAE;IAAE,iBAAiB,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAA;CAAE,GACtD,IAAI,CASN;AAOD,eAAO,MAAM,2BAA2B,EAAE,uBAAuB,EAiDhE,CAAC;AAIF,yDAAyD;AACzD,MAAM,MAAM,iBAAiB,GAAG,IAAI,CAAC,UAAU,EAAE,IAAI,GAAG,SAAS,GAAG,UAAU,CAAC,CAAC;AAoBhF,UAAU,cAAc;IACtB,WAAW,EAAE,uBAAuB,CAAC;IACrC,SAAS,EAAE,KAAK,CAAC,aAAa,CAAC,WAAW,CAAC,GAAG,IAAI,CAAC;CACpD;AAqCD;;;;;GAKG;AACH,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,UAAU,EAChB,OAAO,EAAE,SAAS,iBAAiB,EAAE,EACrC,kBAAkB,CAAC,EAAE,SAAS,uBAAuB,EAAE,GACtD,cAAc,EAAE,CAgDlB"}
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../../../src/widgets/registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAM7D,OAAO,KAAK,EAAE,uBAAuB,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAEhF,KAAK,qBAAqB,GAAG,WAAW,CACtC,uBAAuB,CAAC,eAAe,CAAC,CACzC,CAAC;AAEF,OAAO,EACL,kBAAkB,EAClB,sBAAsB,EACtB,uBAAuB,GACxB,MAAM,kBAAkB,CAAC;AA4P1B;;;;GAIG;AACH,wBAAgB,iCAAiC,CAC/C,YAAY,EAAE,aAAa,CAAC,uBAAuB,CAAC,EACpD,OAAO,CAAC,EAAE;IAAE,iBAAiB,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAA;CAAE,GACtD,IAAI,CASN;AAOD,eAAO,MAAM,2BAA2B,EAAE,uBAAuB,EAyMhE,CAAC;AAIF,yDAAyD;AACzD,MAAM,MAAM,iBAAiB,GAAG,IAAI,CAAC,UAAU,EAAE,IAAI,GAAG,SAAS,GAAG,UAAU,CAAC,CAAC;AAkChF,MAAM,WAAW,cAAc;IAC7B,WAAW,EAAE,uBAAuB,CAAC;IACrC,SAAS,EAAE,KAAK,CAAC,aAAa,CAAC,WAAW,CAAC,GAAG,IAAI,CAAC;IACnD,iBAAiB,CAAC,EAAE,qBAAqB,CAAC;CAC3C;AAqCD;;;;;GAKG;AACH;;;;;GAKG;AACH,eAAO,MAAM,6BAA6B,EAAE,QAAQ,CAClD,MAAM,CAAC,qBAAqB,EAAE;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,CAAC,CAQhE,CAAC;AAEF,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,UAAU,EAChB,OAAO,EAAE,SAAS,iBAAiB,EAAE,EACrC,kBAAkB,CAAC,EAAE,SAAS,uBAAuB,EAAE,GACtD,cAAc,EAAE,CAsElB"}

package/widgets/registry.js

@@ -8,17 +8,242 @@
  * in their widget declaration, which gets rendered by `UiRenderer` via the
  * `WidgetHost` component.
  */
-import { getWidgetComponent, registerWidgetComponent, seedLegacyWidgets, } from "./registry-store.js";
+import { getWidgetComponent, registerBuiltinWidgets, registerWidgetComponent, } from "./registry-store.js";
 export { getWidgetComponent, registerBuiltinWidgets, registerWidgetComponent, } from "./registry-store.js";
 // -- Bundled widget component imports ----------------------------------------
 import { MusicLibraryCharacterWidget } from "../components/character/MusicLibraryCharacterWidget.js";
 import { AGENT_ORCHESTRATOR_PLUGIN_WIDGETS } from "../components/chat/widgets/agent-orchestrator.js";
 import { BROWSER_STATUS_WIDGET } from "../components/chat/widgets/browser-status.helpers.js";
+import { CALENDAR_HOME_WIDGET } from "../components/chat/widgets/calendar-upcoming.js";
+import { FINANCES_HOME_WIDGET } from "../components/chat/widgets/finances-alerts.js";
+import { GOALS_HOME_WIDGET } from "../components/chat/widgets/goals-attention.js";
+import { HEALTH_HOME_WIDGET } from "../components/chat/widgets/health-sleep.js";
+import { INBOX_HOME_WIDGET } from "../components/chat/widgets/inbox-unread.js";
+import { MessagesWidget } from "../components/chat/widgets/messages.js";
 import { MUSIC_PLAYER_WIDGET } from "../components/chat/widgets/music-player.helpers.js";
+import { NEEDS_ATTENTION_HOME_WIDGET } from "../components/chat/widgets/needs-attention.js";
+import { NotificationsWidget } from "../components/chat/widgets/notifications.js";
+import { RELATIONSHIPS_HOME_WIDGET } from "../components/chat/widgets/relationships-attention.js";
+import { TODO_PLUGIN_WIDGETS } from "../components/chat/widgets/todo.js";
 // -- Seed bundled widgets into the registry ----------------------------------
-seedLegacyWidgets(AGENT_ORCHESTRATOR_PLUGIN_WIDGETS);
-seedLegacyWidgets([BROWSER_STATUS_WIDGET, MUSIC_PLAYER_WIDGET]);
+registerBuiltinWidgets(AGENT_ORCHESTRATOR_PLUGIN_WIDGETS);
+registerBuiltinWidgets([BROWSER_STATUS_WIDGET, MUSIC_PLAYER_WIDGET]);
+// Register the todo widget's component so it can be declared on the home slot
+// (#9143 per-plugin breadth — the todo plugin's frontpage opt-in). Idempotent
+// with the plugin's own runtime registration.
+registerBuiltinWidgets(TODO_PLUGIN_WIDGETS);
 registerWidgetComponent("music-library", "music-library.playlists", MusicLibraryCharacterWidget);
+// Notifications is a core feature (no separate plugin), so its frontpage widget
+// always resolves (see ALWAYS_VISIBLE_BUILTIN_WIDGET_PLUGIN_IDS). (#9143)
+registerWidgetComponent("notifications", "notifications.recent", NotificationsWidget);
+// Messages (recent conversations) is likewise a core surface — always-visible.
+registerWidgetComponent("messages", "messages.recent", MessagesWidget);
+// Per-plugin frontpage widgets (#9143): each surfaces a compact, attention-
+// ranked slice of its plugin's own state on the home grid (a step up from the
+// generic default-widget sinks), self-hides when empty, and self-publishes a
+// home-attention signal so it floats up on its own data urgency. They resolve
+// only when the plugin is enabled+active in the runtime snapshot.
+for (const w of [
+    CALENDAR_HOME_WIDGET,
+    GOALS_HOME_WIDGET,
+    FINANCES_HOME_WIDGET,
+    HEALTH_HOME_WIDGET,
+    RELATIONSHIPS_HOME_WIDGET,
+    INBOX_HOME_WIDGET,
+    NEEDS_ATTENTION_HOME_WIDGET,
+]) {
+    registerWidgetComponent(w.pluginId, w.id, w.Component);
+}
+const APP_HOME_DEFAULT_WIDGET_DECLARATIONS = [
+    {
+        pluginId: "blocker",
+        label: "Focus",
+        icon: "Shield",
+        defaultWidget: "notifications",
+        signalKinds: ["blocked", "reminder", "notification"],
+    },
+    {
+        pluginId: "companion",
+        label: "Companion",
+        icon: "Sparkles",
+        defaultWidget: "activity",
+        signalKinds: ["check-in", "nudge", "activity"],
+    },
+    {
+        pluginId: "contacts",
+        label: "Contacts",
+        icon: "Contact",
+        defaultWidget: "activity",
+        signalKinds: ["nudge", "activity"],
+    },
+    {
+        pluginId: "device-settings",
+        label: "Device Settings",
+        icon: "Settings",
+        defaultWidget: "notifications",
+        signalKinds: ["notification", "activity"],
+    },
+    {
+        pluginId: "documents",
+        label: "Documents",
+        icon: "FileText",
+        defaultWidget: "activity",
+        signalKinds: ["approval", "workflow", "activity"],
+    },
+    {
+        pluginId: "elizamaker",
+        label: "Elizamaker",
+        icon: "Bot",
+        defaultWidget: "activity",
+        signalKinds: ["workflow", "activity"],
+    },
+    {
+        pluginId: "feed",
+        label: "Feed",
+        icon: "Rss",
+        defaultWidget: "messages",
+        signalKinds: ["message", "activity"],
+    },
+    {
+        pluginId: "form",
+        label: "Forms",
+        icon: "ClipboardList",
+        defaultWidget: "activity",
+        signalKinds: ["approval", "workflow", "activity"],
+    },
+    {
+        pluginId: "hyperliquid-app",
+        label: "Hyperliquid",
+        icon: "ChartCandlestick",
+        defaultWidget: "notifications",
+        signalKinds: ["escalation", "notification", "activity"],
+    },
+    {
+        pluginId: "model-tester",
+        label: "Model Tester",
+        icon: "Gauge",
+        defaultWidget: "activity",
+        signalKinds: ["workflow", "activity"],
+    },
+    {
+        pluginId: "personal-assistant",
+        label: "Personal Assistant",
+        icon: "Sparkles",
+        defaultWidget: "notifications",
+        signalKinds: ["reminder", "check-in", "notification"],
+    },
+    {
+        pluginId: "phone",
+        label: "Phone",
+        icon: "Phone",
+        defaultWidget: "messages",
+        signalKinds: ["message", "notification"],
+    },
+    {
+        pluginId: "polymarket-app",
+        label: "Polymarket",
+        icon: "ChartNoAxesCombined",
+        defaultWidget: "notifications",
+        signalKinds: ["escalation", "notification", "activity"],
+    },
+    {
+        pluginId: "screenshare",
+        label: "Screen Share",
+        icon: "MonitorUp",
+        defaultWidget: "activity",
+        signalKinds: ["workflow", "activity"],
+    },
+    {
+        pluginId: "shopify-ui",
+        label: "Shopify",
+        icon: "ShoppingBag",
+        defaultWidget: "notifications",
+        signalKinds: ["approval", "notification", "activity"],
+    },
+    {
+        pluginId: "steward-app",
+        label: "Steward",
+        icon: "ShieldCheck",
+        defaultWidget: "notifications",
+        signalKinds: ["approval", "escalation", "notification"],
+    },
+    {
+        pluginId: "task-coordinator",
+        label: "Task Coordinator",
+        icon: "ListChecks",
+        defaultWidget: "activity",
+        signalKinds: ["blocked", "workflow", "activity"],
+    },
+    {
+        pluginId: "todos",
+        label: "Todos",
+        icon: "ListTodo",
+        defaultWidget: "activity",
+        signalKinds: ["reminder", "check-in", "nudge"],
+    },
+    {
+        pluginId: "training",
+        label: "Fine Tuning",
+        icon: "Brain",
+        defaultWidget: "activity",
+        signalKinds: ["workflow", "activity"],
+    },
+    {
+        pluginId: "trajectory-logger",
+        label: "Trajectory Logger",
+        icon: "Route",
+        defaultWidget: "activity",
+        signalKinds: ["workflow", "activity"],
+    },
+    {
+        pluginId: "vector-browser",
+        label: "Vector Browser",
+        icon: "Search",
+        defaultWidget: "activity",
+        signalKinds: ["workflow", "activity"],
+    },
+    {
+        pluginId: "vincent",
+        label: "Vincent",
+        icon: "KeyRound",
+        defaultWidget: "notifications",
+        signalKinds: ["approval", "notification"],
+    },
+    {
+        pluginId: "waifu-imagegen-app",
+        label: "Image Generation",
+        icon: "Image",
+        defaultWidget: "activity",
+        signalKinds: ["workflow", "activity"],
+    },
+    {
+        pluginId: "waifu-swap-app",
+        label: "Swap",
+        icon: "RefreshCcw",
+        defaultWidget: "activity",
+        signalKinds: ["workflow", "activity"],
+    },
+    {
+        pluginId: "wallet-ui",
+        label: "Wallet",
+        icon: "Wallet",
+        defaultWidget: "notifications",
+        signalKinds: ["approval", "escalation", "notification"],
+    },
+    {
+        pluginId: "wifi",
+        label: "WiFi",
+        icon: "Wifi",
+        defaultWidget: "notifications",
+        signalKinds: ["notification", "activity"],
+    },
+].map((declaration, index) => ({
+    id: `${declaration.pluginId}.default-home`,
+    slot: "home",
+    order: 300 + index,
+    defaultEnabled: true,
+    ...declaration,
+}));
 /**
  * Public API for plugins outside app-core to append widget declarations to the
  * built-in fallback list. Declarations appear in the sidebar when the runtime
@@ -39,6 +264,33 @@ export function registerBuiltinWidgetDeclarations(declarations, options) {
 // the server will eventually provide via GET /api/plugins, but are also
 // available client-side for zero-config rendering.
 export const BUILTIN_WIDGET_DECLARATIONS = [
+    // Notifications — the first-class "default" frontpage widget (#9143).
+    {
+        id: "notifications.recent",
+        pluginId: "notifications",
+        slot: "home",
+        label: "Notifications",
+        icon: "Bell",
+        order: 50,
+        defaultEnabled: true,
+        // Boosted by any notification; urgent ones map to escalation-level weight.
+        signalKinds: ["notification", "approval", "escalation"],
+    },
+    // NOTE: the "messages.recent" home widget was removed (#9304) — it duplicated
+    // the always-present floating chat overlay (recent conversations are already
+    // one tap away in chat), and being ALWAYS_VISIBLE it was the only card on a
+    // fresh home. The MessagesWidget component stays registered for the
+    // `defaultWidget: "messages"` sink; it just no longer occupies the home slot.
+    {
+        id: "messages.default-home",
+        pluginId: "messages",
+        slot: "home",
+        label: "Messages",
+        icon: "MessageSquare",
+        order: 55,
+        defaultWidget: "messages",
+        signalKinds: ["message"],
+    },
     // Agent Orchestrator — app runs
     {
         id: "agent-orchestrator.apps",
@@ -59,6 +311,131 @@ export const BUILTIN_WIDGET_DECLARATIONS = [
         order: 300,
         defaultEnabled: true,
     },
+    // Agent Orchestrator — activity surfaced on the home/frontpage too (#9143).
+    // Same pluginId+id reuses the registered component; the `home` slot is a
+    // separate resolveWidgetsForSlot pass, so this doesn't disturb the sidebar.
+    {
+        id: "agent-orchestrator.activity",
+        pluginId: "agent-orchestrator",
+        slot: "home",
+        label: "Activity",
+        icon: "Activity",
+        order: 100,
+        defaultEnabled: true,
+        // The orchestrator activity card bubbles up when a run is blocked, escalated,
+        // or busy — the highest-attention home signals.
+        signalKinds: ["blocked", "escalation", "workflow", "activity"],
+    },
+    // Agent Orchestrator — running app instances on the home (#9143). Distinct
+    // from the launcher icons (which open views): this lists live app runs.
+    // Reuses the registered AppRunsWidget component (self-contained data).
+    {
+        id: "agent-orchestrator.apps",
+        pluginId: "agent-orchestrator",
+        slot: "home",
+        label: "Apps",
+        icon: "LayoutGrid",
+        order: 70,
+        defaultEnabled: true,
+        signalKinds: ["activity"],
+    },
+    // Todos — the todo plugin's frontpage widget (#9143 per-plugin breadth).
+    {
+        id: "todo.items",
+        pluginId: "todo",
+        slot: "home",
+        label: "Todos",
+        icon: "ListTodo",
+        order: 80,
+        defaultEnabled: true,
+        signalKinds: ["reminder", "check-in", "nudge"],
+    },
+    // -- Per-plugin real-data frontpage widgets (#9143) ------------------------
+    // These carry their own bundled component (registered above) showing a
+    // compact, attention-ranked slice of the plugin's state, replacing the
+    // generic default-widget sinks for plugins that warrant a richer card. Each
+    // self-hides when empty and self-publishes a home-attention signal.
+    {
+        id: INBOX_HOME_WIDGET.id,
+        pluginId: INBOX_HOME_WIDGET.pluginId,
+        slot: "home",
+        label: "Inbox",
+        icon: "Inbox",
+        order: INBOX_HOME_WIDGET.order,
+        defaultEnabled: true,
+        signalKinds: INBOX_HOME_WIDGET.signalKinds,
+    },
+    // Needs response — the canonical "actions requiring your response" card
+    // (#9449). Backed by the core ApprovalService (GET /api/approvals), not a
+    // loadable plugin, so it is always-visible (see
+    // ALWAYS_VISIBLE_BUILTIN_WIDGET_PLUGIN_IDS) and self-hides when nothing is
+    // pending. Floats up at approval/escalation weight on its own data.
+    {
+        id: NEEDS_ATTENTION_HOME_WIDGET.id,
+        pluginId: NEEDS_ATTENTION_HOME_WIDGET.pluginId,
+        slot: "home",
+        label: "Needs response",
+        icon: "CircleHelp",
+        order: NEEDS_ATTENTION_HOME_WIDGET.order,
+        defaultEnabled: true,
+        signalKinds: NEEDS_ATTENTION_HOME_WIDGET.signalKinds,
+    },
+    {
+        id: RELATIONSHIPS_HOME_WIDGET.id,
+        pluginId: RELATIONSHIPS_HOME_WIDGET.pluginId,
+        slot: "home",
+        label: "Relationships",
+        icon: "Users",
+        order: RELATIONSHIPS_HOME_WIDGET.order,
+        defaultEnabled: true,
+        signalKinds: RELATIONSHIPS_HOME_WIDGET.signalKinds,
+    },
+    {
+        id: CALENDAR_HOME_WIDGET.id,
+        pluginId: CALENDAR_HOME_WIDGET.pluginId,
+        slot: "home",
+        label: "Upcoming",
+        icon: "Clock",
+        order: CALENDAR_HOME_WIDGET.order,
+        defaultEnabled: true,
+        signalKinds: CALENDAR_HOME_WIDGET.signalKinds,
+    },
+    {
+        id: GOALS_HOME_WIDGET.id,
+        pluginId: GOALS_HOME_WIDGET.pluginId,
+        slot: "home",
+        label: "Goals",
+        icon: "Target",
+        order: GOALS_HOME_WIDGET.order,
+        defaultEnabled: true,
+        signalKinds: GOALS_HOME_WIDGET.signalKinds,
+    },
+    {
+        id: FINANCES_HOME_WIDGET.id,
+        pluginId: FINANCES_HOME_WIDGET.pluginId,
+        slot: "home",
+        label: "Bills & Balance",
+        icon: "Wallet",
+        order: FINANCES_HOME_WIDGET.order,
+        defaultEnabled: true,
+        signalKinds: FINANCES_HOME_WIDGET.signalKinds,
+    },
+    {
+        id: HEALTH_HOME_WIDGET.id,
+        pluginId: HEALTH_HOME_WIDGET.pluginId,
+        slot: "home",
+        label: "Sleep",
+        icon: "Moon",
+        order: HEALTH_HOME_WIDGET.order,
+        defaultEnabled: true,
+        signalKinds: HEALTH_HOME_WIDGET.signalKinds,
+    },
+    // App-manifest plugins that do not ship an owned home card opt into one of
+    // the shared default sinks (#9143). These declarations are contract entries:
+    // they prove the plugin participates in the frontpage widget system, while
+    // the shared notifications/messages/activity cards above remain the single
+    // visible aggregate surfaces for their sink kind.
+    ...APP_HOME_DEFAULT_WIDGET_DECLARATIONS,
     // Browser workspace status — surfaces /browser state in the right rail.
     {
         id: BROWSER_STATUS_WIDGET.id,
@@ -92,8 +469,8 @@ export const BUILTIN_WIDGET_DECLARATIONS = [
  * Some bundled widgets intentionally stay visible even when the runtime plugin
  * snapshot omits their feature IDs because the UI has compat-backed data
  * sources for them. Generic task-list widgets do not qualify here — Eliza does
- * not ship a runtime task-list plugin, and leaving the fallback enabled crowds
- * out the LifeOps-first sidebar with a stale generic tasks panel.
+ * not ship a runtime task-list plugin, and leaving the fallback enabled would
+ * crowd the sidebar with a stale generic tasks panel.
  */
 const BUILTIN_WIDGET_FALLBACK_PLUGIN_IDS = new Set([
     "agent-orchestrator",
@@ -102,8 +479,22 @@ const BUILTIN_WIDGET_FALLBACK_PLUGIN_IDS = new Set([
     // plugin snapshot doesn't list them as plugins.
     "wallet",
     "browser-workspace",
+    // Todos render from the workbench store; show on the frontpage even before the
+    // runtime plugin snapshot lists the plugin (#9143).
+    "todo",
+]);
+const ALWAYS_VISIBLE_BUILTIN_WIDGET_PLUGIN_IDS = new Set([
+    "music-player",
+    // Notifications is a core runtime feature (NotificationService), not a
+    // loadable plugin, so its frontpage widget must render regardless of the
+    // plugin snapshot. (#9143). Messages was removed (#9304) — redundant with the
+    // always-present chat overlay.
+    "notifications",
+    // Needs-response is backed by the core ApprovalService (not a loadable
+    // plugin), so its frontpage widget must render regardless of the plugin
+    // snapshot — it self-hides when no decisions are pending (#9449).
+    "needs-attention",
 ]);
-const ALWAYS_VISIBLE_BUILTIN_WIDGET_PLUGIN_IDS = new Set(["music-player"]);
 function isWidgetEnabled(declaration, plugins, source) {
     if (source === "builtin" &&
         declaration.defaultEnabled !== false &&
@@ -129,6 +520,20 @@ function isWidgetEnabled(declaration, plugins, source) {
  * Merges built-in declarations with any server-provided declarations
  * (from PluginInfo.widgets), deduplicating by declaration ID.
  */
+/**
+ * Maps a declaration's `defaultWidget` opt-in (#9143) to the registered shared
+ * frontpage sink component (already registered above via
+ * `registerWidgetComponent`). A `home`-slot plugin with no own component renders
+ * one of these shared widgets instead of shipping its own.
+ */
+export const DEFAULT_WIDGET_SINK_COMPONENT = {
+    notifications: { pluginId: "notifications", id: "notifications.recent" },
+    messages: { pluginId: "messages", id: "messages.recent" },
+    activity: {
+        pluginId: "agent-orchestrator",
+        id: "agent-orchestrator.activity",
+    },
+};
 export function resolveWidgetsForSlot(slot, plugins, serverDeclarations) {
     // Merge: server declarations override built-in by id
     const declarationMap = new Map();
@@ -154,10 +559,29 @@ export function resolveWidgetsForSlot(slot, plugins, serverDeclarations) {
     for (const { declaration, source } of declarationMap.values()) {
         if (!isWidgetEnabled(declaration, plugins, source))
             continue;
-        const Component = getWidgetComponent(declaration.pluginId, declaration.id);
+        let Component = getWidgetComponent(declaration.pluginId, declaration.id);
+        let defaultWidgetSink;
+        // Home-slot opt-in sink (#9143): a plugin with no own component but a
+        // `defaultWidget` renders the shared sink component for that kind. Borrows
+        // only the component — the declaration keeps its own pluginId/id/order so
+        // ranking + dedupe treat it as distinct. Fallback-only: never overrides an
+        // own component, never fires off the home slot.
+        if (!Component &&
+            declaration.slot === "home" &&
+            declaration.defaultWidget) {
+            const sink = DEFAULT_WIDGET_SINK_COMPONENT[declaration.defaultWidget];
+            Component = getWidgetComponent(sink.pluginId, sink.id);
+            if (Component) {
+                defaultWidgetSink = declaration.defaultWidget;
+            }
+        }
         // Include if we have a React component OR a uiSpec fallback
         if (Component || declaration.uiSpec) {
-            results.push({ declaration, Component: Component ?? null });
+            results.push({
+                declaration,
+                Component: Component ?? null,
+                ...(defaultWidgetSink ? { defaultWidgetSink } : {}),
+            });
         }
     }
     results.sort((a, b) => (a.declaration.order ?? 100) - (b.declaration.order ?? 100));

package/widgets/types.d.ts

@@ -1,10 +1,11 @@
 import type { PluginWidgetDeclaration as CorePluginWidgetDeclaration } from "@elizaos/core";
 import type { ComponentType } from "react";
-import type { PluginInfo } from "../api/client-types-config";
-import type { UiSpec } from "../config/ui-spec";
-import type { ActivityEvent } from "../hooks/useActivityEvents";
+import type { PluginInfo } from "../api/client-types-config.js";
+import type { UiSpec } from "../config/ui-spec.js";
+import type { ActivityEvent } from "../hooks/useActivityEvents.js";
 /** Named injection points where plugin widgets can render. */
-export type WidgetSlot = "chat-sidebar" | "chat-inline" | "wallet" | "browser" | "heartbeats" | "character" | "settings" | "nav-page" | "automations";
+export declare const WIDGET_SLOTS: readonly ["chat-sidebar", "character", "nav-page", "home"];
+export type WidgetSlot = (typeof WIDGET_SLOTS)[number];
 /**
  * Serializable widget metadata declared by a plugin.
  *
@@ -23,6 +24,13 @@ export interface WidgetProps {
     pluginState?: PluginInfo;
     events?: ActivityEvent[];
     clearEvents?: () => void;
+    /**
+     * The slot this instance is rendering in. Lets a widget shared between the
+     * chat sidebar and the home grid adapt — e.g. render `null` instead of an
+     * empty-state card on `home` (the home surface must not show empty
+     * placeholders; #9143).
+     */
+    slot?: WidgetSlot;
 }
 /**
  * Client-side registration mapping a widget declaration to a React component.

package/widgets/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../src/widgets/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,IAAI,2BAA2B,EAAE,MAAM,eAAe,CAAC;AAC5F,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAC3C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAC7D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAEhE,8DAA8D;AAC9D,MAAM,MAAM,UAAU,GAClB,cAAc,GACd,aAAa,GACb,QAAQ,GACR,SAAS,GACT,YAAY,GACZ,WAAW,GACX,UAAU,GACV,UAAU,GACV,aAAa,CAAC;AAElB;;;;;;;GAOG;AACH,MAAM,WAAW,uBAAwB,SAAQ,2BAA2B;IAC1E,mFAAmF;IACnF,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,oDAAoD;AACpD,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,UAAU,CAAC;IACzB,MAAM,CAAC,EAAE,aAAa,EAAE,CAAC;IACzB,WAAW,CAAC,EAAE,MAAM,IAAI,CAAC;CAC1B;AAED;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC,+CAA+C;IAC/C,aAAa,EAAE,MAAM,CAAC;IACtB,qDAAqD;IACrD,QAAQ,EAAE,MAAM,CAAC;IACjB,qCAAqC;IACrC,SAAS,EAAE,aAAa,CAAC,WAAW,CAAC,CAAC;CACvC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../src/widgets/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,IAAI,2BAA2B,EAAE,MAAM,eAAe,CAAC;AAC5F,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAC3C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAC7D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAEhE,8DAA8D;AAC9D,eAAO,MAAM,YAAY,4DAKf,CAAC;AAEX,MAAM,MAAM,UAAU,GAAG,CAAC,OAAO,YAAY,CAAC,CAAC,MAAM,CAAC,CAAC;AAEvD;;;;;;;GAOG;AACH,MAAM,WAAW,uBAAwB,SAAQ,2BAA2B;IAC1E,mFAAmF;IACnF,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,oDAAoD;AACpD,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,UAAU,CAAC;IACzB,MAAM,CAAC,EAAE,aAAa,EAAE,CAAC;IACzB,WAAW,CAAC,EAAE,MAAM,IAAI,CAAC;IACzB;;;;;OAKG;IACH,IAAI,CAAC,EAAE,UAAU,CAAC;CACnB;AAED;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC,+CAA+C;IAC/C,aAAa,EAAE,MAAM,CAAC;IACtB,qDAAqD;IACrD,QAAQ,EAAE,MAAM,CAAC;IACjB,qCAAqC;IACrC,SAAS,EAAE,aAAa,CAAC,WAAW,CAAC,CAAC;CACvC"}

package/widgets/types.js

@@ -1 +1,7 @@
-export {};
+/** Named injection points where plugin widgets can render. */
+export const WIDGET_SLOTS = [
+    "chat-sidebar",
+    "character",
+    "nav-page",
+    "home",
+];

package/widgets/useChatSidebarVisibility.d.ts

@@ -1,16 +1,19 @@
 /**
- * React hook over the chat-sidebar widget visibility overrides.
+ * React hook over per-slot widget visibility overrides.
  *
  * - Reads the persisted state from localStorage on mount.
  * - Subscribes to cross-window `storage` events so two tabs stay in sync.
  * - Persists every mutation immediately and bumps internal state.
  */
-import { type VisibilityCandidate } from "./visibility";
-export interface ChatSidebarVisibilityHook {
+import type { WidgetSlot } from "./types.js";
+import { type VisibilityCandidate } from "./visibility.js";
+export interface WidgetVisibilityHook {
     overrides: Record<string, boolean>;
     isVisible(candidate: VisibilityCandidate): boolean;
     setVisible(candidate: VisibilityCandidate, next: boolean): void;
     reset(): void;
 }
+export type ChatSidebarVisibilityHook = WidgetVisibilityHook;
+export declare function useWidgetVisibility(slot?: WidgetSlot): WidgetVisibilityHook;
 export declare function useChatSidebarVisibility(): ChatSidebarVisibilityHook;
 //# sourceMappingURL=useChatSidebarVisibility.d.ts.map

package/widgets/useChatSidebarVisibility.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useChatSidebarVisibility.d.ts","sourceRoot":"","sources":["../../../../../src/widgets/useChatSidebarVisibility.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAKL,KAAK,mBAAmB,EAGzB,MAAM,cAAc,CAAC;AAEtB,MAAM,WAAW,yBAAyB;IACxC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,SAAS,CAAC,SAAS,EAAE,mBAAmB,GAAG,OAAO,CAAC;IACnD,UAAU,CAAC,SAAS,EAAE,mBAAmB,EAAE,IAAI,EAAE,OAAO,GAAG,IAAI,CAAC;IAChE,KAAK,IAAI,IAAI,CAAC;CACf;AAED,wBAAgB,wBAAwB,IAAI,yBAAyB,CAwDpE"}
+{"version":3,"file":"useChatSidebarVisibility.d.ts","sourceRoot":"","sources":["../../../../../src/widgets/useChatSidebarVisibility.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAC1C,OAAO,EAIL,KAAK,mBAAmB,EAIzB,MAAM,cAAc,CAAC;AAEtB,MAAM,WAAW,oBAAoB;IACnC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,SAAS,CAAC,SAAS,EAAE,mBAAmB,GAAG,OAAO,CAAC;IACnD,UAAU,CAAC,SAAS,EAAE,mBAAmB,EAAE,IAAI,EAAE,OAAO,GAAG,IAAI,CAAC;IAChE,KAAK,IAAI,IAAI,CAAC;CACf;AAED,MAAM,MAAM,yBAAyB,GAAG,oBAAoB,CAAC;AAE7D,wBAAgB,mBAAmB,CACjC,IAAI,GAAE,UAA2B,GAChC,oBAAoB,CAyDtB;AAED,wBAAgB,wBAAwB,IAAI,yBAAyB,CAEpE"}