@helpai/elements 0.42.1 → 0.43.0

package/index.d.ts

@@ -1,4 +1,4 @@
-export { A as Asset, B as BlocksConfig, C as ConnectionConfig, a as ConnectionConfigPartial, H as HandshakeResponse, L as Link, S as ServerConfig, b as SiteConfig, W as WidgetConfig, c as WidgetConfigPartial, d as WidgetSettings, e as WidgetSettingsPartial } from './deployment-CB6xjMr0.js';
+export { A as Asset, B as BlocksConfig, C as ConnectionConfig, a as ConnectionConfigPartial, H as HandshakeResponse, L as Link, S as ServerConfig, b as SiteConfig, W as WidgetConfig, c as WidgetConfigPartial, d as WidgetSettings, e as WidgetSettingsPartial } from './deployment-paIqjCiE.js';
 import 'zod';
 
 /**
@@ -1371,6 +1371,30 @@ interface EventMap {
         toolCallId: string;
         approved: boolean;
     };
+    /** A content list (news / help / home block) rendered. */
+    contentView: {
+        section: string;
+        tags?: string;
+        count: number;
+    };
+    /** An article / content item was opened. */
+    contentOpen: {
+        contentId: string;
+        tags?: string;
+    };
+    /** The help search ran. Length + hit count only — never the query text. */
+    contentSearch: {
+        queryLength: number;
+        hitCount: number;
+    };
+    /** An opened article was read (dwell threshold passed). Fires once per open. */
+    contentRead: {
+        contentId: string;
+    };
+    /** A link inside an opened article was followed. */
+    contentLinkClick: {
+        contentId: string;
+    };
     /** Files attached (drag-drop, file picker, paste). */
     attach: {
         count: number;

package/index.mjs

@@ -5268,6 +5268,7 @@ function MessageList({
     if (!el) return;
     const last = messages.value.at(-1);
     if (!last) return;
+    if (last.status !== "streaming" && !messages.value.some((m) => m.role === "user")) return;
     const pinIfNear = () => {
       if (detachedRef.current || inInteractionGrace()) return;
       const distance = el.scrollHeight - el.scrollTop - el.clientHeight;
@@ -6224,7 +6225,7 @@ function ArticleRow({ article, nav }) {
     }
   );
 }
-function HelpRoot({ transport, strings, config, nav, panelProps }) {
+function HelpRoot({ transport, strings, config, nav, bus, panelProps }) {
   const tags = config.contentTags;
   const [state, setState] = useState8("loading");
   const [errorMsg, setErrorMsg] = useState8(strings.errorGeneric);
@@ -6236,8 +6237,10 @@ function HelpRoot({ transport, strings, config, nav, panelProps }) {
     setState("loading");
     transport.listContent({ tags, sortBy: "order", limit: 100 }).then((res) => {
       if (cancelled) return;
-      setItems(res.items ?? []);
+      const rows = res.items ?? [];
+      setItems(rows);
       setState("loaded");
+      bus.emit("contentView", { section: "help", tags: tags?.join(","), count: rows.length });
     }).catch((err) => {
       if (cancelled) return;
       log13.warn("listContent (help) failed", { err });
@@ -6247,8 +6250,14 @@ function HelpRoot({ transport, strings, config, nav, panelProps }) {
     return () => {
       cancelled = true;
     };
-  }, [transport, tags, reloadKey]);
+  }, [transport, tags, reloadKey, bus]);
   const results = useMemo2(() => fuzzySearch(items, query), [items, query]);
+  useEffect11(() => {
+    const q = query.trim();
+    if (!q) return;
+    const timer = setTimeout(() => bus.emit("contentSearch", { queryLength: q.length, hitCount: results.length }), 600);
+    return () => clearTimeout(timer);
+  }, [query, results, bus]);
   function renderBody() {
     if (query.trim().length > 0) {
       if (results.length === 0) return /* @__PURE__ */ jsx27(ModuleState, { message: strings.helpSearchEmpty, strings });
@@ -6303,7 +6312,7 @@ function resolveGreeting(props2) {
 }
 var openContent = (nav, item) => item.url ? nav.push({ kind: "iframe", url: item.url, title: item.title }) : nav.push({ kind: "content", id: item.id, title: item.title });
 function HomeRoot(props2) {
-  const { transport, strings, config, nav, panelProps } = props2;
+  const { transport, strings, config, nav, bus, panelProps } = props2;
   const [recent, setRecent] = useState9(null);
   const [content, setContent] = useState9([]);
   const tagsKey = config.contentTags?.join(",");
@@ -6318,11 +6327,16 @@ function HomeRoot(props2) {
   useEffect12(() => {
     if (!config.contentTags?.length) return;
     let cancelled = false;
-    transport.listContent({ tags: config.contentTags, limit: 6 }).then((res) => !cancelled && setContent(res.items ?? [])).catch((err) => !cancelled && log14.warn("listContent (home) failed", { err }));
+    transport.listContent({ tags: config.contentTags, limit: 6 }).then((res) => {
+      if (cancelled) return;
+      const rows = res.items ?? [];
+      setContent(rows);
+      bus.emit("contentView", { section: "home", tags: tagsKey, count: rows.length });
+    }).catch((err) => !cancelled && log14.warn("listContent (home) failed", { err }));
     return () => {
       cancelled = true;
     };
-  }, [transport, tagsKey]);
+  }, [transport, tagsKey, bus]);
   const greeting = resolveGreeting(props2);
   const avatars = config.userAvatars ?? [];
   const status = config.status;
@@ -6394,7 +6408,7 @@ import { useEffect as useEffect13, useState as useState10 } from "preact/hooks";
 import { jsx as jsx30, jsxs as jsxs25 } from "preact/jsx-runtime";
 var p26 = BRAND.cssPrefix;
 var log15 = logger.scope("news");
-function NewsRoot({ transport, strings, config, nav, panelProps }) {
+function NewsRoot({ transport, strings, config, nav, bus, panelProps }) {
   const tags = config.contentTags;
   const [state, setState] = useState10("loading");
   const [errorMsg, setErrorMsg] = useState10(strings.errorGeneric);
@@ -6405,8 +6419,10 @@ function NewsRoot({ transport, strings, config, nav, panelProps }) {
     setState("loading");
     transport.listContent({ tags, sortBy: "publishedAt", sortOrder: "desc" }).then((res) => {
       if (cancelled) return;
-      setItems(res.items ?? []);
+      const rows = res.items ?? [];
+      setItems(rows);
       setState("loaded");
+      bus.emit("contentView", { section: "news", tags: tags?.join(","), count: rows.length });
     }).catch((err) => {
       if (cancelled) return;
       log15.warn("listContent (news) failed", { err });
@@ -6416,7 +6432,7 @@ function NewsRoot({ transport, strings, config, nav, panelProps }) {
     return () => {
       cancelled = true;
     };
-  }, [transport, tags, reloadKey]);
+  }, [transport, tags, reloadKey, bus]);
   function renderBody() {
     if (state === "loading") return /* @__PURE__ */ jsx30(ModuleState, { message: strings.newsLoading, strings });
     if (state === "error") {
@@ -6524,7 +6540,8 @@ import { useCallback as useCallback3, useEffect as useEffect14, useState as useS
 import { jsx as jsx33, jsxs as jsxs28 } from "preact/jsx-runtime";
 var p29 = BRAND.cssPrefix;
 var log16 = logger.scope("content");
-function ContentView({ id, title, transport, strings, onBack, actions }) {
+var READ_DWELL_MS = 5e3;
+function ContentView({ id, title, transport, strings, bus, onBack, actions }) {
   const [item, setItem] = useState11(null);
   const [failed, setFailed] = useState11(false);
   const [reloadKey, setReloadKey] = useState11(0);
@@ -6538,8 +6555,10 @@ function ContentView({ id, title, transport, strings, onBack, actions }) {
     transport.listContent({ ids: [id], limit: 1 }).then((res) => {
       if (cancelled) return;
       const found = res.items[0];
-      if (found) setItem(found);
-      else setFailed(true);
+      if (found) {
+        setItem(found);
+        bus.emit("contentOpen", { contentId: id, tags: found.tags?.length ? found.tags.join(",") : void 0 });
+      } else setFailed(true);
     }).catch((err) => {
       if (cancelled) return;
       log16.warn("listContent (reader) failed", { err });
@@ -6548,11 +6567,24 @@ function ContentView({ id, title, transport, strings, onBack, actions }) {
     return () => {
       cancelled = true;
     };
-  }, [transport, id, reloadKey]);
+  }, [transport, id, reloadKey, bus]);
+  useEffect14(() => {
+    if (!item) return;
+    const timer = setTimeout(() => bus.emit("contentRead", { contentId: id }), READ_DWELL_MS);
+    return () => clearTimeout(timer);
+  }, [item, id, bus]);
+  const onArticleClick = useCallback3(
+    (e) => {
+      const anchor = e.target?.closest?.("a");
+      const href = anchor?.getAttribute("href") ?? "";
+      if (href && !href.startsWith("#")) bus.emit("contentLinkClick", { contentId: id });
+    },
+    [bus, id]
+  );
   function renderBody() {
     if (failed) return /* @__PURE__ */ jsx33(ModuleState, { tone: "error", message: strings.errorGeneric, onRetry: retry, strings });
     if (item === null) return /* @__PURE__ */ jsx33(ModuleState, { message: strings.contentLoading, strings });
-    return /* @__PURE__ */ jsxs28("article", { class: `${p29}-content`, "data-testid": TID.contentView, children: [
+    return /* @__PURE__ */ jsxs28("article", { class: `${p29}-content`, "data-testid": TID.contentView, onClick: onArticleClick, children: [
       item.image ? /* @__PURE__ */ jsx33("img", { class: `${p29}-content-hero`, src: item.image, alt: "", loading: "lazy" }) : null,
       item.description ? /* @__PURE__ */ jsx33("p", { class: `${p29}-content-subtitle`, children: item.description }) : null,
       /* @__PURE__ */ jsx33(StaticMarkdown, { text: item.content ?? "" })
@@ -6580,6 +6612,7 @@ function MessengerHome({
   panelProps,
   enabledModules,
   nav,
+  bus,
   unreadCount,
   onSelectConversation,
   onStartNewConversation,
@@ -6641,6 +6674,7 @@ function MessengerHome({
     config: module,
     visitorId: panelProps.visitorId,
     nav: moduleNav,
+    bus,
     panelProps
   });
   const plainActions = /* @__PURE__ */ jsx34(HeaderActions, { panelProps, variant: "plain" });
@@ -6655,6 +6689,7 @@ function MessengerHome({
         title: top.title,
         transport: panelProps.transport,
         strings,
+        bus,
         onBack: nav.pop,
         actions: plainActions
       }
@@ -7687,6 +7722,7 @@ function App({ options, hostElement, bus }) {
         panelProps: { ...panelProps, panelSize: size, onClose: closeable ? handleClose : void 0 },
         enabledModules,
         nav: homeNav,
+        bus,
         unreadCount: unreadCountSig.value,
         onSelectConversation,
         onStartNewConversation: handleNewChat,
@@ -7813,6 +7849,12 @@ var TRACKED = {
   formSubmit: (p33) => ({ formId: p33.formId, skipped: p33.skipped }),
   toolResult: () => void 0,
   toolDecision: (p33) => ({ approved: p33.approved }),
+  // Content — ids, tags + counts only; titles/bodies never ride.
+  contentView: (p33) => ({ section: p33.section, tags: p33.tags, count: p33.count }),
+  contentOpen: (p33) => ({ contentId: p33.contentId, tags: p33.tags }),
+  contentSearch: (p33) => ({ qlen: p33.queryLength, hits: p33.hitCount }),
+  contentRead: (p33) => ({ contentId: p33.contentId }),
+  contentLinkClick: (p33) => ({ contentId: p33.contentId }),
   // Composer / attachments / voice.
   attach: (p33) => ({ count: p33.count, bytes: p33.totalBytes }),
   voiceStart: () => void 0,
@@ -8031,6 +8073,12 @@ var EVENT_NAMES = [
   "formSubmit",
   "toolResult",
   "toolDecision",
+  // Content (news / help / home articles)
+  "contentView",
+  "contentOpen",
+  "contentSearch",
+  "contentRead",
+  "contentLinkClick",
   // Composer / attachments / voice
   "attach",
   "removeAttachment",

package/package.json

@@ -80,5 +80,5 @@
   ],
   "type": "module",
   "types": "./index.d.ts",
-  "version": "0.42.1"
+  "version": "0.43.0"
 }

package/schema.d.ts

@@ -1,4 +1,4 @@
-export { A as Asset, B as BlocksConfig, C as ConnectionConfig, a as ConnectionConfigPartial, E as Endpoints, H as HandshakeResponse, L as Link, P as PAGE_AREA_SUGGESTIONS, f as PageContext, S as ServerConfig, b as SiteConfig, U as UserContext, W as WidgetConfig, c as WidgetConfigPartial, d as WidgetSettings, e as WidgetSettingsPartial, g as assetSchema, h as blocksConfigSchema, i as connectionConfigPartialSchema, j as connectionConfigSchema, k as cssColorSchema, l as cssLengthSchema, m as endpointsSchema, n as handshakeResponseSchema, o as linkSchema, p as localeSchema, q as pageContextSchema, s as serverConfigSchema, r as siteConfigSchema, u as userContextSchema, t as uuid7Schema, w as widgetConfigPartialSchema, v as widgetConfigSchema, x as widgetSettingsPartialSchema, y as widgetSettingsSchema } from './deployment-CB6xjMr0.js';
+export { A as Asset, B as BlocksConfig, C as ConnectionConfig, a as ConnectionConfigPartial, E as Endpoints, H as HandshakeResponse, L as Link, P as PAGE_AREA_SUGGESTIONS, f as PageContext, S as ServerConfig, b as SiteConfig, U as UserContext, W as WidgetConfig, c as WidgetConfigPartial, d as WidgetSettings, e as WidgetSettingsPartial, g as assetSchema, h as blocksConfigSchema, i as connectionConfigPartialSchema, j as connectionConfigSchema, k as cssColorSchema, l as cssLengthSchema, m as endpointsSchema, n as handshakeResponseSchema, o as linkSchema, p as localeSchema, q as pageContextSchema, s as serverConfigSchema, r as siteConfigSchema, u as userContextSchema, t as uuid7Schema, w as widgetConfigPartialSchema, v as widgetConfigSchema, x as widgetSettingsPartialSchema, y as widgetSettingsSchema } from './deployment-paIqjCiE.js';
 import { z } from 'zod';
 
 /**
@@ -56,9 +56,9 @@ declare const presentationSchema: z.ZodObject<{
         inset: z.ZodOptional<z.ZodString>;
         initialSize: z.ZodDefault<z.ZodEnum<{
             fullscreen: "fullscreen";
-            normal: "normal";
             expanded: "expanded";
             auto: "auto";
+            normal: "normal";
         }>>;
         autoSizeBreakpoint: z.ZodDefault<z.ZodNumber>;
     }, z.core.$loose>>;
@@ -239,9 +239,9 @@ type LauncherOptions = z.infer<typeof launcherOptionsSchema>;
 
 declare const initialSizeSchema: z.ZodEnum<{
     fullscreen: "fullscreen";
-    normal: "normal";
     expanded: "expanded";
     auto: "auto";
+    normal: "normal";
 }>;
 declare const resizeOptionsSchema: z.ZodObject<{
     enabled: z.ZodDefault<z.ZodBoolean>;
@@ -268,9 +268,9 @@ declare const sizeOptionsSchema: z.ZodObject<{
     inset: z.ZodOptional<z.ZodString>;
     initialSize: z.ZodDefault<z.ZodEnum<{
         fullscreen: "fullscreen";
-        normal: "normal";
         expanded: "expanded";
         auto: "auto";
+        normal: "normal";
     }>>;
     autoSizeBreakpoint: z.ZodDefault<z.ZodNumber>;
 }, z.core.$loose>;
@@ -322,40 +322,40 @@ type FeatureFlags = z.infer<typeof featureFlagsSchema>;
  */
 
 declare const actionNameSchema: z.ZodEnum<{
+    close: "close";
     expand: "expand";
     fullscreen: "fullscreen";
-    close: "close";
-    language: "language";
+    clear: "clear";
     theme: "theme";
+    language: "language";
     textSize: "textSize";
     history: "history";
-    clear: "clear";
     sound: "sound";
 }>;
 type ActionName = z.infer<typeof actionNameSchema>;
 declare const headerActionsSchema: z.ZodArray<z.ZodEnum<{
+    close: "close";
     expand: "expand";
     fullscreen: "fullscreen";
-    close: "close";
-    language: "language";
+    clear: "clear";
     theme: "theme";
+    language: "language";
     textSize: "textSize";
     history: "history";
-    clear: "clear";
     sound: "sound";
 }>>;
 type HeaderActions = z.infer<typeof headerActionsSchema>;
 /** Section wrapper — `actions` list wrapped under `header` in the dashboard form. */
 declare const headerSchema: z.ZodObject<{
     actions: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+        close: "close";
         expand: "expand";
         fullscreen: "fullscreen";
-        close: "close";
-        language: "language";
+        clear: "clear";
         theme: "theme";
+        language: "language";
         textSize: "textSize";
         history: "history";
-        clear: "clear";
         sound: "sound";
     }>>>;
 }, z.core.$loose>;
@@ -371,33 +371,33 @@ type HeaderOptions = z.infer<typeof headerSchema>;
  */
 
 declare const feedbackEventSchema: z.ZodEnum<{
+    voiceStart: "voiceStart";
+    voiceStop: "voiceStop";
     error: "error";
     messageReceived: "messageReceived";
     messageSent: "messageSent";
-    voiceStart: "voiceStart";
-    voiceStop: "voiceStop";
 }>;
 type FeedbackEvent = z.infer<typeof feedbackEventSchema>;
 declare const soundOptionsSchema: z.ZodObject<{
     enabled: z.ZodDefault<z.ZodBoolean>;
     volume: z.ZodDefault<z.ZodNumber>;
     events: z.ZodOptional<z.ZodRecord<z.ZodEnum<{
+        voiceStart: "voiceStart";
+        voiceStop: "voiceStop";
         error: "error";
         messageReceived: "messageReceived";
         messageSent: "messageSent";
-        voiceStart: "voiceStart";
-        voiceStop: "voiceStop";
     }> & z.core.$partial, z.ZodUnion<readonly [z.ZodBoolean, z.ZodString]>>>;
 }, z.core.$loose>;
 type SoundOptions = z.infer<typeof soundOptionsSchema>;
 declare const hapticsOptionsSchema: z.ZodObject<{
     enabled: z.ZodDefault<z.ZodBoolean>;
     events: z.ZodOptional<z.ZodRecord<z.ZodEnum<{
+        voiceStart: "voiceStart";
+        voiceStop: "voiceStop";
         error: "error";
         messageReceived: "messageReceived";
         messageSent: "messageSent";
-        voiceStart: "voiceStart";
-        voiceStop: "voiceStop";
     }> & z.core.$partial, z.ZodUnion<readonly [z.ZodBoolean, z.ZodNumber, z.ZodArray<z.ZodNumber>]>>>;
 }, z.core.$loose>;
 type HapticsOptions = z.infer<typeof hapticsOptionsSchema>;
@@ -406,21 +406,21 @@ declare const feedbackSchema: z.ZodObject<{
         enabled: z.ZodDefault<z.ZodBoolean>;
         volume: z.ZodDefault<z.ZodNumber>;
         events: z.ZodOptional<z.ZodRecord<z.ZodEnum<{
+            voiceStart: "voiceStart";
+            voiceStop: "voiceStop";
             error: "error";
             messageReceived: "messageReceived";
             messageSent: "messageSent";
-            voiceStart: "voiceStart";
-            voiceStop: "voiceStop";
         }> & z.core.$partial, z.ZodUnion<readonly [z.ZodBoolean, z.ZodString]>>>;
     }, z.core.$loose>>;
     haptics: z.ZodOptional<z.ZodObject<{
         enabled: z.ZodDefault<z.ZodBoolean>;
         events: z.ZodOptional<z.ZodRecord<z.ZodEnum<{
+            voiceStart: "voiceStart";
+            voiceStop: "voiceStop";
             error: "error";
             messageReceived: "messageReceived";
             messageSent: "messageSent";
-            voiceStart: "voiceStart";
-            voiceStop: "voiceStop";
         }> & z.core.$partial, z.ZodUnion<readonly [z.ZodBoolean, z.ZodNumber, z.ZodArray<z.ZodNumber>]>>>;
     }, z.core.$loose>>;
 }, z.core.$loose>;
@@ -855,18 +855,18 @@ type I18nOptions = z.infer<typeof i18nSchema>;
  */
 
 declare const moduleLayoutSchema: z.ZodEnum<{
+    home: "home";
     chat: "chat";
     help: "help";
-    home: "home";
     news: "news";
 }>;
 type ModuleLayout = z.infer<typeof moduleLayoutSchema>;
 declare const moduleSchema: z.ZodObject<{
     label: z.ZodString;
     layout: z.ZodEnum<{
+        home: "home";
         chat: "chat";
         help: "help";
-        home: "home";
         news: "news";
     }>;
     contentTags: z.ZodOptional<z.ZodArray<z.ZodString>>;
@@ -892,9 +892,9 @@ type ModuleOptions = z.infer<typeof moduleSchema>;
 declare const modulesSchema: z.ZodArray<z.ZodObject<{
     label: z.ZodString;
     layout: z.ZodEnum<{
+        home: "home";
         chat: "chat";
         help: "help";
-        home: "home";
         news: "news";
     }>;
     contentTags: z.ZodOptional<z.ZodArray<z.ZodString>>;

package/web-component.mjs

@@ -5227,6 +5227,7 @@ function MessageList({
     if (!el) return;
     const last = messages.value.at(-1);
     if (!last) return;
+    if (last.status !== "streaming" && !messages.value.some((m) => m.role === "user")) return;
     const pinIfNear = () => {
       if (detachedRef.current || inInteractionGrace()) return;
       const distance = el.scrollHeight - el.scrollTop - el.clientHeight;
@@ -6183,7 +6184,7 @@ function ArticleRow({ article, nav }) {
     }
   );
 }
-function HelpRoot({ transport, strings, config, nav, panelProps }) {
+function HelpRoot({ transport, strings, config, nav, bus, panelProps }) {
   const tags = config.contentTags;
   const [state, setState] = useState8("loading");
   const [errorMsg, setErrorMsg] = useState8(strings.errorGeneric);
@@ -6195,8 +6196,10 @@ function HelpRoot({ transport, strings, config, nav, panelProps }) {
     setState("loading");
     transport.listContent({ tags, sortBy: "order", limit: 100 }).then((res) => {
       if (cancelled) return;
-      setItems(res.items ?? []);
+      const rows = res.items ?? [];
+      setItems(rows);
       setState("loaded");
+      bus.emit("contentView", { section: "help", tags: tags?.join(","), count: rows.length });
     }).catch((err) => {
       if (cancelled) return;
       log12.warn("listContent (help) failed", { err });
@@ -6206,8 +6209,14 @@ function HelpRoot({ transport, strings, config, nav, panelProps }) {
     return () => {
       cancelled = true;
     };
-  }, [transport, tags, reloadKey]);
+  }, [transport, tags, reloadKey, bus]);
   const results = useMemo2(() => fuzzySearch(items, query), [items, query]);
+  useEffect11(() => {
+    const q = query.trim();
+    if (!q) return;
+    const timer = setTimeout(() => bus.emit("contentSearch", { queryLength: q.length, hitCount: results.length }), 600);
+    return () => clearTimeout(timer);
+  }, [query, results, bus]);
   function renderBody() {
     if (query.trim().length > 0) {
       if (results.length === 0) return /* @__PURE__ */ jsx27(ModuleState, { message: strings.helpSearchEmpty, strings });
@@ -6262,7 +6271,7 @@ function resolveGreeting(props2) {
 }
 var openContent = (nav, item) => item.url ? nav.push({ kind: "iframe", url: item.url, title: item.title }) : nav.push({ kind: "content", id: item.id, title: item.title });
 function HomeRoot(props2) {
-  const { transport, strings, config, nav, panelProps } = props2;
+  const { transport, strings, config, nav, bus, panelProps } = props2;
   const [recent, setRecent] = useState9(null);
   const [content, setContent] = useState9([]);
   const tagsKey = config.contentTags?.join(",");
@@ -6277,11 +6286,16 @@ function HomeRoot(props2) {
   useEffect12(() => {
     if (!config.contentTags?.length) return;
     let cancelled = false;
-    transport.listContent({ tags: config.contentTags, limit: 6 }).then((res) => !cancelled && setContent(res.items ?? [])).catch((err) => !cancelled && log13.warn("listContent (home) failed", { err }));
+    transport.listContent({ tags: config.contentTags, limit: 6 }).then((res) => {
+      if (cancelled) return;
+      const rows = res.items ?? [];
+      setContent(rows);
+      bus.emit("contentView", { section: "home", tags: tagsKey, count: rows.length });
+    }).catch((err) => !cancelled && log13.warn("listContent (home) failed", { err }));
     return () => {
       cancelled = true;
     };
-  }, [transport, tagsKey]);
+  }, [transport, tagsKey, bus]);
   const greeting = resolveGreeting(props2);
   const avatars = config.userAvatars ?? [];
   const status = config.status;
@@ -6353,7 +6367,7 @@ import { useEffect as useEffect13, useState as useState10 } from "preact/hooks";
 import { jsx as jsx30, jsxs as jsxs25 } from "preact/jsx-runtime";
 var p26 = BRAND.cssPrefix;
 var log14 = logger.scope("news");
-function NewsRoot({ transport, strings, config, nav, panelProps }) {
+function NewsRoot({ transport, strings, config, nav, bus, panelProps }) {
   const tags = config.contentTags;
   const [state, setState] = useState10("loading");
   const [errorMsg, setErrorMsg] = useState10(strings.errorGeneric);
@@ -6364,8 +6378,10 @@ function NewsRoot({ transport, strings, config, nav, panelProps }) {
     setState("loading");
     transport.listContent({ tags, sortBy: "publishedAt", sortOrder: "desc" }).then((res) => {
       if (cancelled) return;
-      setItems(res.items ?? []);
+      const rows = res.items ?? [];
+      setItems(rows);
       setState("loaded");
+      bus.emit("contentView", { section: "news", tags: tags?.join(","), count: rows.length });
     }).catch((err) => {
       if (cancelled) return;
       log14.warn("listContent (news) failed", { err });
@@ -6375,7 +6391,7 @@ function NewsRoot({ transport, strings, config, nav, panelProps }) {
     return () => {
       cancelled = true;
     };
-  }, [transport, tags, reloadKey]);
+  }, [transport, tags, reloadKey, bus]);
   function renderBody() {
     if (state === "loading") return /* @__PURE__ */ jsx30(ModuleState, { message: strings.newsLoading, strings });
     if (state === "error") {
@@ -6483,7 +6499,8 @@ import { useCallback as useCallback3, useEffect as useEffect14, useState as useS
 import { jsx as jsx33, jsxs as jsxs28 } from "preact/jsx-runtime";
 var p29 = BRAND.cssPrefix;
 var log15 = logger.scope("content");
-function ContentView({ id, title, transport, strings, onBack, actions }) {
+var READ_DWELL_MS = 5e3;
+function ContentView({ id, title, transport, strings, bus, onBack, actions }) {
   const [item, setItem] = useState11(null);
   const [failed, setFailed] = useState11(false);
   const [reloadKey, setReloadKey] = useState11(0);
@@ -6497,8 +6514,10 @@ function ContentView({ id, title, transport, strings, onBack, actions }) {
     transport.listContent({ ids: [id], limit: 1 }).then((res) => {
       if (cancelled) return;
       const found = res.items[0];
-      if (found) setItem(found);
-      else setFailed(true);
+      if (found) {
+        setItem(found);
+        bus.emit("contentOpen", { contentId: id, tags: found.tags?.length ? found.tags.join(",") : void 0 });
+      } else setFailed(true);
     }).catch((err) => {
       if (cancelled) return;
       log15.warn("listContent (reader) failed", { err });
@@ -6507,11 +6526,24 @@ function ContentView({ id, title, transport, strings, onBack, actions }) {
     return () => {
       cancelled = true;
     };
-  }, [transport, id, reloadKey]);
+  }, [transport, id, reloadKey, bus]);
+  useEffect14(() => {
+    if (!item) return;
+    const timer = setTimeout(() => bus.emit("contentRead", { contentId: id }), READ_DWELL_MS);
+    return () => clearTimeout(timer);
+  }, [item, id, bus]);
+  const onArticleClick = useCallback3(
+    (e) => {
+      const anchor = e.target?.closest?.("a");
+      const href = anchor?.getAttribute("href") ?? "";
+      if (href && !href.startsWith("#")) bus.emit("contentLinkClick", { contentId: id });
+    },
+    [bus, id]
+  );
   function renderBody() {
     if (failed) return /* @__PURE__ */ jsx33(ModuleState, { tone: "error", message: strings.errorGeneric, onRetry: retry, strings });
     if (item === null) return /* @__PURE__ */ jsx33(ModuleState, { message: strings.contentLoading, strings });
-    return /* @__PURE__ */ jsxs28("article", { class: `${p29}-content`, "data-testid": TID.contentView, children: [
+    return /* @__PURE__ */ jsxs28("article", { class: `${p29}-content`, "data-testid": TID.contentView, onClick: onArticleClick, children: [
       item.image ? /* @__PURE__ */ jsx33("img", { class: `${p29}-content-hero`, src: item.image, alt: "", loading: "lazy" }) : null,
       item.description ? /* @__PURE__ */ jsx33("p", { class: `${p29}-content-subtitle`, children: item.description }) : null,
       /* @__PURE__ */ jsx33(StaticMarkdown, { text: item.content ?? "" })
@@ -6539,6 +6571,7 @@ function MessengerHome({
   panelProps,
   enabledModules,
   nav,
+  bus,
   unreadCount,
   onSelectConversation,
   onStartNewConversation,
@@ -6600,6 +6633,7 @@ function MessengerHome({
     config: module,
     visitorId: panelProps.visitorId,
     nav: moduleNav,
+    bus,
     panelProps
   });
   const plainActions = /* @__PURE__ */ jsx34(HeaderActions, { panelProps, variant: "plain" });
@@ -6614,6 +6648,7 @@ function MessengerHome({
         title: top.title,
         transport: panelProps.transport,
         strings,
+        bus,
         onBack: nav.pop,
         actions: plainActions
       }
@@ -7646,6 +7681,7 @@ function App({ options, hostElement, bus }) {
         panelProps: { ...panelProps, panelSize: size, onClose: closeable ? handleClose : void 0 },
         enabledModules,
         nav: homeNav,
+        bus,
         unreadCount: unreadCountSig.value,
         onSelectConversation,
         onStartNewConversation: handleNewChat,
@@ -7772,6 +7808,12 @@ var TRACKED = {
   formSubmit: (p33) => ({ formId: p33.formId, skipped: p33.skipped }),
   toolResult: () => void 0,
   toolDecision: (p33) => ({ approved: p33.approved }),
+  // Content — ids, tags + counts only; titles/bodies never ride.
+  contentView: (p33) => ({ section: p33.section, tags: p33.tags, count: p33.count }),
+  contentOpen: (p33) => ({ contentId: p33.contentId, tags: p33.tags }),
+  contentSearch: (p33) => ({ qlen: p33.queryLength, hits: p33.hitCount }),
+  contentRead: (p33) => ({ contentId: p33.contentId }),
+  contentLinkClick: (p33) => ({ contentId: p33.contentId }),
   // Composer / attachments / voice.
   attach: (p33) => ({ count: p33.count, bytes: p33.totalBytes }),
   voiceStart: () => void 0,