gloomberb 0.16.1 → 0.16.2

package/src/plugins/builtin/chat/direct-messages.ts

@@ -0,0 +1,200 @@
+import type { ChatChannel, ChatUserSummary } from "../../../api-client";
+import { ApiRequestError } from "../../../api-client/errors";
+import { t, tf } from "../../../i18n";
+
+/**
+ * The server's code for "this user only takes DMs from people they have
+ * written to first". Any other refusal, a block among them, stays the neutral
+ * generic line so the reason never reads as "they blocked you".
+ */
+const DMS_CLOSED_CODE = "dms_closed";
+
+/** Why a DM cannot be started: the user's own setting, or an account nobody can DM (a bot, a bridged Discord user). */
+type DirectMessageRefusal = "dms-off" | "no-dms";
+
+export type DirectMessageAvailability =
+  | { kind: "self" }
+  /** A DM with this user exists; opening it needs no new conversation. */
+  | { kind: "open"; channelId: string }
+  | { kind: "start" }
+  | { kind: "refused"; reason: DirectMessageRefusal };
+
+function normalizedUsername(user: Pick<ChatUserSummary, "username">): string | null {
+  return user.username?.trim().replace(/^@+/, "").toLowerCase() || null;
+}
+
+export function findDirectChannelWith(channels: readonly ChatChannel[], user: Pick<ChatUserSummary, "id" | "username">): ChatChannel | null {
+  const username = normalizedUsername(user);
+  return channels.find((channel) => {
+    if (channel.kind !== "direct" || !channel.dmUser) return false;
+    if (channel.dmUser.id === user.id) return true;
+    return !!username && normalizedUsername(channel.dmUser) === username;
+  }) ?? null;
+}
+
+function refusalOf(user: ChatUserSummary): DirectMessageRefusal | null {
+  if (user.accountType === "managed_llm" || user.accountType === "discord") return "no-dms";
+  if (user.acceptUnknownDms === false) return "dms-off";
+  return null;
+}
+
+/**
+ * What "Message @name" does for this user: open the DM you already share,
+ * start one, or nothing. The server only lets you start a DM with someone
+ * whose settings take DMs from people they have not talked to; one that
+ * already exists stays open to both sides. A summary from an older server
+ * that leaves the setting out is assumed to take DMs.
+ */
+export function directMessageAvailability(
+  user: ChatUserSummary,
+  { currentUserId, channels }: { currentUserId: string | null | undefined; channels: readonly ChatChannel[] },
+): DirectMessageAvailability {
+  if (currentUserId && user.id === currentUserId) return { kind: "self" };
+  const existing = findDirectChannelWith(channels, user);
+  if (existing) return { kind: "open", channelId: existing.id };
+  const reason = refusalOf(user);
+  return reason ? { kind: "refused", reason } : { kind: "start" };
+}
+
+export interface DirectMessageAction {
+  /**
+   * Opens the DM you already share, starts one, or cannot: their settings or
+   * the account refuse a new DM. A menu shows a refused one disabled, the
+   * card of someone with no public profile says why, and a profile card or
+   * the pane menu leaves it out.
+   */
+  kind: "open" | "start" | "refused";
+  username: string;
+  /** For a menu: "Message @name", or "Open DM with @name" when one exists. */
+  menuLabel: string;
+  /** For a button beside the name: "Message" or "Open DM". */
+  buttonLabel: string;
+  /**
+   * A refused one: why, for a line where the button would be. It leaves the
+   * name out; the card it sits on already shows it.
+   */
+  refusal?: string;
+}
+
+/**
+ * The "Message" action on a user's name, card or message. Null for yourself
+ * and before you can send. Refused for a bot, a bridged Discord user, and
+ * someone who takes no DMs from people they have not talked to, unless you
+ * already share one.
+ */
+export function directMessageAction(
+  user: ChatUserSummary,
+  context: { currentUserId: string | null | undefined; channels: readonly ChatChannel[]; canSend: boolean },
+): DirectMessageAction | null {
+  const username = normalizedUsername(user);
+  if (!context.canSend || !username) return null;
+  const availability = directMessageAvailability(user, context);
+  if (availability.kind === "open") {
+    return {
+      kind: "open",
+      username,
+      menuLabel: tf("Open DM with @{username}", { username }),
+      buttonLabel: t("Open DM"),
+    };
+  }
+  if (availability.kind === "self") return null;
+  return {
+    kind: availability.kind,
+    username,
+    menuLabel: tf("Message @{username}", { username }),
+    buttonLabel: t("Message"),
+    ...(availability.kind === "refused" ? {
+      refusal: availability.reason === "dms-off"
+        ? t("Only takes DMs from people they have written to first.")
+        : t("Does not take DMs."),
+    } : {}),
+  };
+}
+
+function directMessageRefusalText(username: string, reason: DirectMessageRefusal): string {
+  return reason === "dms-off"
+    ? tf("@{username} only takes DMs from people they have written to first.", { username })
+    : tf("@{username} does not take DMs.", { username });
+}
+
+/**
+ * The first named user a group chat cannot include. Unlike a direct message,
+ * a DM already shared with them does not help: every member of a new group
+ * has to take DMs from people they have not talked to.
+ */
+function groupChatRefusal(
+  usernames: readonly string[],
+  userByUsername: ReadonlyMap<string, ChatUserSummary>,
+): { username: string; reason: DirectMessageRefusal } | null {
+  for (const username of usernames) {
+    const user = userByUsername.get(username);
+    const reason = user ? refusalOf(user) : null;
+    if (reason) return { username, reason };
+  }
+  return null;
+}
+
+/**
+ * What the app knows, before asking the server, about why these names cannot
+ * start a conversation. Null when it knows of no reason (an unknown name, an
+ * existing DM, or users who take DMs).
+ */
+export function knownConversationRefusal(
+  usernames: readonly string[],
+  {
+    userByUsername,
+    currentUserId,
+    channels,
+  }: {
+    userByUsername: ReadonlyMap<string, ChatUserSummary>;
+    currentUserId: string | null | undefined;
+    channels: readonly ChatChannel[];
+  },
+): string | null {
+  if (usernames.length === 1) {
+    const user = userByUsername.get(usernames[0]!);
+    if (!user) return null;
+    const availability = directMessageAvailability(user, { currentUserId, channels });
+    return availability.kind === "refused" ? directMessageRefusalText(usernames[0]!, availability.reason) : null;
+  }
+  const refusal = groupChatRefusal(usernames, userByUsername);
+  return refusal ? directMessageRefusalText(refusal.username, refusal.reason) : null;
+}
+
+function joinUsernames(usernames: readonly string[]): string {
+  return usernames.map((username) => `@${username}`).join(", ");
+}
+
+/**
+ * The line shown when opening a DM or group chat failed. A name the server
+ * does not know is named; a user whose settings refuse DMs from new people is
+ * named with that reason; every other refusal, a block included, stays
+ * neutral and only carries the status.
+ */
+export function describeConversationStartError(
+  error: unknown,
+  usernames: readonly string[],
+  userByUsername: ReadonlyMap<string, ChatUserSummary>,
+): string {
+  const status = error instanceof ApiRequestError ? error.status : undefined;
+  if (status === 404) {
+    // The server does not say which member of a group it could not find; the
+    // names this app has never seen are the candidates.
+    const missing = usernames.length === 1 ? usernames : usernames.filter((username) => !userByUsername.has(username));
+    if (missing.length === 1) return tf("@{username} was not found.", { username: missing[0]! });
+    if (missing.length > 1) return tf("{usernames} were not found.", { usernames: joinUsernames(missing) });
+    return t("One of those users was not found.");
+  }
+  if (status === 403 && error instanceof ApiRequestError && error.code === DMS_CLOSED_CODE) {
+    const named = typeof error.details?.username === "string" ? error.details.username.toLowerCase() : null;
+    const username = named
+      ?? (usernames.length === 1 ? usernames[0] : groupChatRefusal(usernames, userByUsername)?.username)
+      ?? null;
+    return username
+      ? directMessageRefusalText(username, "dms-off")
+      : t("Someone in that group only takes DMs from people they have written to first.");
+  }
+  return status
+    ? tf("Could not start the conversation (error {status}).", { status })
+    : t("Could not start the conversation. Check your connection and try again.");
+}

package/src/plugins/builtin/chat/index.tsx

@@ -31,6 +31,7 @@ export const chatModule: PluginModule = {
     },
   }, {
     id: UNREAD_INBOX_PANE_ID,
+    reportFreshness: { status: "not-a-feed", basis: "chat messages" },
     name: "Unread",
     icon: "U",
     component: UnreadInboxPane,

package/src/plugins/builtin/chat/message/desktop.tsx

@@ -28,6 +28,7 @@ export const DesktopChatMessage = memo(function DesktopChatMessage({
   onUserHover,
   onUserHoverEnd,
   onUserActivate,
+  onUserContextMenu,
   beginReplyTo,
   beginEditMessage,
   jumpToMessage,
@@ -113,6 +114,7 @@ export const DesktopChatMessage = memo(function DesktopChatMessage({
           onUserHover={onUserHover}
           onUserHoverEnd={onUserHoverEnd}
           onUserActivate={onUserActivate}
+          onUserContextMenu={onUserContextMenu}
           {...actionProps}
         />
       )}
@@ -134,6 +136,7 @@ export const DesktopChatMessage = memo(function DesktopChatMessage({
               onUserHover={onUserHover}
               onUserHoverEnd={onUserHoverEnd}
               onUserActivate={onUserActivate}
+              onUserContextMenu={onUserContextMenu}
             />
           </Box>
           {state.grouped && <ChatMessageActions floating {...actionProps} />}

package/src/plugins/builtin/chat/message/header.tsx

@@ -1,4 +1,5 @@
-import { Box, Text } from "../../../../ui";
+import { useRef } from "react";
+import { Box, Text, useUiCapabilities, type BoxRenderable } from "../../../../ui";
 import { t } from "../../../../i18n";
 import { Button } from "../../../../components/ui";
 import { MESSAGE_ACTION_WIDTH } from "../layout";
@@ -73,27 +74,36 @@ export function ChatMessageHeader({
   onUserHover,
   onUserHoverEnd,
   onUserActivate,
+  onUserContextMenu,
   ...actionProps
-}: ChatMessageActionProps & Pick<ChatMessageBaseProps, "msg" | "onUserHover" | "onUserHoverEnd" | "onUserActivate"> & {
+}: ChatMessageActionProps & Pick<ChatMessageBaseProps, "msg" | "onUserHover" | "onUserHoverEnd" | "onUserActivate" | "onUserContextMenu"> & {
   /** Host row props: width, background and hover or selection hooks. */
   rowProps: Record<string, unknown>;
   /** The terminal sizes the author cell to its label. */
   fitAuthorWidth?: boolean;
 }) {
   const authorLabel = msg.user.username ?? "anon";
+  const { nativeContextMenu } = useUiCapabilities();
+  // The card opens beside the name the pointer is on.
+  const nameRef = useRef<BoxRenderable | null>(null);
   return (
     <Box {...rowProps} flexDirection="row" height={1} paddingLeft={1}>
       <Box
+        ref={nameRef}
         width={fitAuthorWidth ? authorLabel.length : undefined}
         height={1}
-        onMouseOver={() => onUserHover(msg.user)}
-        onMouseMove={() => onUserHover(msg.user)}
+        onMouseOver={() => onUserHover(msg.user, nameRef.current)}
+        onMouseMove={() => onUserHover(msg.user, nameRef.current)}
         onMouseOut={onUserHoverEnd}
-        onMouseDown={(event: { preventDefault?: () => void; stopPropagation?: () => void }) => {
+        data-gloom-context-menu-surface="true"
+        onMouseDown={(event: { button?: number; preventDefault?: () => void; stopPropagation?: () => void }) => {
           event.preventDefault?.();
           event.stopPropagation?.();
-          onUserActivate?.(msg.user);
+          // A native menu opens on the right-click's contextmenu event instead.
+          if (event.button === 2 && nativeContextMenu === true) return;
+          onUserActivate?.(msg.user, nameRef.current);
         }}
+        onContextMenu={(event: { preventDefault?: () => void; stopPropagation?: () => void }) => onUserContextMenu?.(msg.user, event, nameRef.current)}
         style={{ cursor: "pointer" }}
       >
         <Text fg={state.authorColor} attributes={state.authorAttributes}>

package/src/plugins/builtin/chat/message/inline-tokens.tsx

@@ -1,5 +1,5 @@
-import { useMemo, useState } from "react";
-import { Box, Text } from "../../../../ui";
+import { useMemo, useRef, useState } from "react";
+import { Box, Text, useUiCapabilities, type BoxRenderable } from "../../../../ui";
 import { TextAttributes } from "../../../../ui";
 import { ExternalLinkText } from "../../../../components/ui";
 import { InlineTickerBadge } from "../../../../components/ticker/badge";
@@ -8,6 +8,59 @@ import { blendHex, colors } from "../../../../theme/colors";
 import type { ChatUserSummary } from "../../../../api-client";
 import { tokenizeInlineContent, type InlineContentToken } from "../../../../utils/inline-content-tokenizer";
 import { chatBadgeTextWidth } from "../layout";
+import type { ChatUserAnchor, ChatUserContextMenuEvent } from "./types";
+
+/** An @mention: a name that opens its user's card, when the chat knows the user. */
+function UserMentionToken({
+  value,
+  user,
+  nativeContextMenu,
+  onUserHover,
+  onUserHoverEnd,
+  onUserActivate,
+  onUserContextMenu,
+}: {
+  value: string;
+  user: ChatUserSummary | null;
+  nativeContextMenu: boolean;
+  onUserHover?: (user: ChatUserSummary, anchor?: ChatUserAnchor) => void;
+  onUserHoverEnd?: () => void;
+  onUserActivate?: (user: ChatUserSummary, anchor?: ChatUserAnchor) => void;
+  onUserContextMenu?: (user: ChatUserSummary, event: ChatUserContextMenuEvent, anchor?: ChatUserAnchor) => void;
+}) {
+  // The card opens beside the mention the pointer is on.
+  const tokenRef = useRef<BoxRenderable | null>(null);
+  return (
+    <Box
+      ref={tokenRef}
+      height={1}
+      flexDirection="row"
+      backgroundColor={blendHex(colors.panel, colors.positive, 0.24)}
+      onMouseOver={() => {
+        if (user) onUserHover?.(user, tokenRef.current);
+      }}
+      onMouseOut={() => {
+        if (user) onUserHoverEnd?.();
+      }}
+      // Only a mention of someone the chat has a summary for has a card or a menu to open.
+      onMouseDown={user && onUserActivate ? (event: { button?: number; preventDefault?: () => void; stopPropagation?: () => void }) => {
+        event.preventDefault?.();
+        event.stopPropagation?.();
+        if (event.button === 2 && nativeContextMenu) return;
+        onUserActivate(user, tokenRef.current);
+      } : undefined}
+      {...(user && onUserContextMenu ? {
+        "data-gloom-context-menu-surface": "true",
+        onContextMenu: (event: ChatUserContextMenuEvent) => onUserContextMenu(user, event, tokenRef.current),
+      } : {})}
+      style={user && onUserActivate ? { cursor: "pointer" } : undefined}
+    >
+      <Text fg={colors.positive} attributes={TextAttributes.BOLD}>
+        {value}
+      </Text>
+    </Box>
+  );
+}
 
 export function ResponsiveTickerBadgeText({
   text = "",
@@ -20,6 +73,7 @@ export function ResponsiveTickerBadgeText({
   onUserHover,
   onUserHoverEnd,
   onUserActivate,
+  onUserContextMenu,
 }: {
   text?: string;
   tokens?: readonly InlineContentToken[];
@@ -28,10 +82,12 @@ export function ResponsiveTickerBadgeText({
   textColor: string;
   openTicker: (symbol: string) => void;
   userByUsername?: Map<string, ChatUserSummary>;
-  onUserHover?: (user: ChatUserSummary) => void;
+  onUserHover?: (user: ChatUserSummary, anchor?: ChatUserAnchor) => void;
   onUserHoverEnd?: () => void;
-  onUserActivate?: (user: ChatUserSummary) => void;
+  onUserActivate?: (user: ChatUserSummary, anchor?: ChatUserAnchor) => void;
+  onUserContextMenu?: (user: ChatUserSummary, event: ChatUserContextMenuEvent, anchor?: ChatUserAnchor) => void;
 }) {
+  const { nativeContextMenu } = useUiCapabilities();
   const [hoveredSymbol, setHoveredSymbol] = useState<string | null>(null);
   const tokens = useMemo(() => providedTokens ?? tokenizeInlineContent(text), [providedTokens, text]);
   const renderTextToken = (value: string, tokenIndex: number) => {
@@ -53,34 +109,18 @@ export function ResponsiveTickerBadgeText({
       </Text>
     );
   };
-  const renderUsernameToken = (username: string, value: string, tokenIndex: number) => {
-    const user = userByUsername?.get(username.toLowerCase()) ?? null;
-    return (
-      <Box
-        key={`mention:${tokenIndex}:${username}`}
-        height={1}
-        flexDirection="row"
-        backgroundColor={blendHex(colors.panel, colors.positive, 0.24)}
-        onMouseOver={() => {
-          if (user) onUserHover?.(user);
-        }}
-        onMouseOut={() => {
-          if (user) onUserHoverEnd?.();
-        }}
-        // Only a mention of someone the chat has a summary for has a card to open.
-        onMouseDown={user && onUserActivate ? (event: { preventDefault?: () => void; stopPropagation?: () => void }) => {
-          event.preventDefault?.();
-          event.stopPropagation?.();
-          onUserActivate(user);
-        } : undefined}
-        style={user && onUserActivate ? { cursor: "pointer" } : undefined}
-      >
-        <Text fg={colors.positive} attributes={TextAttributes.BOLD}>
-          {value}
-        </Text>
-      </Box>
-    );
-  };
+  const renderUsernameToken = (username: string, value: string, tokenIndex: number) => (
+    <UserMentionToken
+      key={`mention:${tokenIndex}:${username}`}
+      value={value}
+      user={userByUsername?.get(username.toLowerCase()) ?? null}
+      nativeContextMenu={nativeContextMenu === true}
+      onUserHover={onUserHover}
+      onUserHoverEnd={onUserHoverEnd}
+      onUserActivate={onUserActivate}
+      onUserContextMenu={onUserContextMenu}
+    />
+  );
 
   return (
     <Box

package/src/plugins/builtin/chat/message/profile-popover.tsx

@@ -3,10 +3,15 @@ import { Box, Text, useUiCapabilities } from "../../../../ui";
 import { TextAttributes } from "../../../../ui";
 import { colors } from "../../../../theme/colors";
 import type { ChatUserSummary, PublicPortfolioAnalytics } from "../../../../api-client";
-import { formatNumber } from "../../../../utils/format";
+import { displayWidth, formatNumber, truncateToDisplayWidth } from "../../../../utils/format";
 import { truncateWithEllipsis } from "../../../../utils/text-wrap";
+import type { ChatUserAnchor } from "./types";
 
-export const PROFILE_POPOVER_CLOSE_DELAY_MS = 40;
+/**
+ * How long a card the pointer left stays: long enough to move from the name
+ * onto the card beside it, whose own hover then keeps it open.
+ */
+export const PROFILE_POPOVER_CLOSE_DELAY_MS = 250;
 
 function hasPortfolioAnalytics(analytics: PublicPortfolioAnalytics | null | undefined): boolean {
   return Boolean(
@@ -122,31 +127,92 @@ function HeaderAnalyticsStats({
   );
 }
 
+/** The narrowest name-only card, so a short name still has a button to aim at. */
+const NAME_CARD_MIN_WIDTH = 18;
+
+/**
+ * A name-only card's one row: the handle, then the display name where it says
+ * something the handle does not.
+ */
+function nameCardRow(user: ChatUserSummary): { handle: string; name: string | null } {
+  const displayName = user.displayName?.trim() ?? "";
+  if (!user.username) return { handle: displayName, name: null };
+  const same = displayName.replace(/^@+/, "").toLowerCase() === user.username.toLowerCase();
+  return { handle: `@${user.username}`, name: displayName && !same ? displayName : null };
+}
+
+function nameCardNaturalWidth(user: ChatUserSummary): number {
+  const { handle, name } = nameCardRow(user);
+  return displayWidth(handle) + (name ? 1 + displayWidth(name) : 0);
+}
+
+function NameCardRow({ user, width }: { user: ChatUserSummary; width: number }) {
+  const { handle, name } = nameCardRow(user);
+  const handleText = truncateToDisplayWidth(handle, width);
+  const nameWidth = width - displayWidth(handleText) - 1;
+  return (
+    <Box height={1} width={width} flexDirection="row">
+      <Text fg={colors.positive} attributes={TextAttributes.BOLD}>{handleText}</Text>
+      {name && nameWidth >= 4 ? <Text fg={colors.textDim}>{` ${truncateToDisplayWidth(name, nameWidth)}`}</Text> : null}
+    </Box>
+  );
+}
+
 export function UserProfilePopover({
   user,
+  anchor = null,
   width,
   onClose,
   onDismiss = onClose,
   onKeepOpen,
   isOwnProfile = false,
   onSetUpProfile,
+  messageAction,
+  messageRefusal,
 }: {
   user: ChatUserSummary;
+  /**
+   * The name or @mention it opened from. The desktop and the web place the
+   * card just below it, or above it near the pane's foot; without one, and in
+   * the terminal, it sits in the pane's top-right corner.
+   */
+  anchor?: ChatUserAnchor;
   width: number;
   /** The pointer left the card. */
   onClose: () => void;
   /** A click outside the card or Esc closes it, even a pinned one. */
   onDismiss?: () => void;
+  /** The pointer came onto the card: it stays open while it is used. */
   onKeepOpen: () => void;
   isOwnProfile?: boolean;
   onSetUpProfile?: () => void;
+  /** "Message" or "Open DM" for someone you can write to; left out for anyone else. */
+  messageAction?: { label: string; onPress: () => void } | null;
+  /**
+   * Why someone takes no DM from you. The name-only card says it where the
+   * button would be; a profile card leaves it out.
+   */
+  messageRefusal?: string | null;
 }) {
-  const popoverWidth = Math.max(24, Math.min(38, width - 4));
+  const { nativePaneChrome } = useUiCapabilities();
+  // The terminal card's border and padding take two cells a side; the desktop
+  // popover pads itself, and its content keeps the width it always had.
+  const chromeWidth = nativePaneChrome ? 2 : 4;
+  const maxPopoverWidth = Math.max(24, Math.min(38, width - 4));
+  // Anyone without a public profile still gets a card: the name and a way to write to them.
+  const nameOnly = !isOwnProfile && !hasPublicChatProfileInfo(user);
+  const popoverWidth = nameOnly
+    ? Math.min(maxPopoverWidth, Math.max(
+      NAME_CARD_MIN_WIDTH,
+      nameCardNaturalWidth(user),
+      messageRefusal ? displayWidth(messageRefusal) : 0,
+    ) + chromeWidth)
+    : maxPopoverWidth;
   const meta = [user.title, user.company].filter(Boolean).join(" · ");
   const bio = user.bio?.trim();
   const analytics = user.portfolioAnalytics;
   const metrics = analytics ? analyticsMetrics(analytics) : [];
-  const headerWidth = Math.max(1, popoverWidth - 2);
+  const headerWidth = Math.max(1, popoverWidth - chromeWidth);
   const maxStatsWidth = Math.max(0, headerWidth - 8);
   const statsWidth = metrics.length > 0 && maxStatsWidth >= 8
     ? Math.min(headerMetricsNaturalWidth(metrics), maxStatsWidth)
@@ -154,8 +220,16 @@ export function UserProfilePopover({
   const usernameWidth = Math.max(1, headerWidth - (statsWidth > 0 ? statsWidth + 1 : 0));
   const showSetupAction = shouldOfferChatProfileSetup(user, isOwnProfile) && !!onSetUpProfile;
 
-  const { nativePaneChrome } = useUiCapabilities();
-  const content = (
+  const content = nameOnly ? (
+    <>
+      <NameCardRow user={user} width={headerWidth} />
+      {messageAction ? (
+        <Button label={messageAction.label} width={headerWidth} variant="ghost" compact stopPropagation onPress={messageAction.onPress} />
+      ) : messageRefusal ? (
+        <Text fg={colors.textDim} wrapText width={headerWidth}>{messageRefusal}</Text>
+      ) : null}
+    </>
+  ) : (
     <>
       <Box height={1} width={headerWidth} flexDirection="row">
         <Box width={usernameWidth}>
@@ -171,33 +245,42 @@ export function UserProfilePopover({
         ) : null}
         <Box flexGrow={1} />
       </Box>
-      {meta ? <Text fg={colors.textDim}>{truncateWithEllipsis(meta, popoverWidth - 2)}</Text> : null}
+      {meta ? <Text fg={colors.textDim}>{truncateWithEllipsis(meta, headerWidth)}</Text> : null}
       {bio ? (
-        <Text fg={colors.text} wrapText width={popoverWidth - 2}>
+        <Text fg={colors.text} wrapText width={headerWidth}>
           {bio}
         </Text>
       ) : null}
       {showSetupAction ? (
         <Button label="Set up profile" width={headerWidth} variant="ghost" compact stopPropagation onPress={onSetUpProfile} />
       ) : null}
+      {messageAction ? (
+        <Button label={messageAction.label} width={headerWidth} variant="ghost" compact stopPropagation onPress={messageAction.onPress} />
+      ) : null}
     </>
   );
 
   if (nativePaneChrome) {
-    // The kit popover, anchored to the chat pane's top-right corner where the
-    // terminal card sits. It stays open while the pointer is over it.
+    // The kit popover, beside the name it opened from so the pointer reaches
+    // it in one short move, and inside the pane. Opened with no name (the
+    // keyboard on a message that is not on screen), it takes the pane's
+    // top-right corner like the terminal card. It stays open while pointed at.
     return (
       <Box position="absolute" top={1} right={2} width={1} height={0}>
         <Popover
           open
           onOpenChange={(open) => { if (!open) onDismiss(); }}
           trigger={<Box width={1} height={0} />}
-          placement="bottom-end"
+          anchor={anchor}
+          boundary="pane"
+          placement={anchor ? "bottom-start" : "bottom-end"}
           minWidth={0}
           focusOnOpen={false}
           label="User profile"
+          onPointerEnter={onKeepOpen}
+          onPointerLeave={onClose}
         >
-          <Box flexDirection="column" width={headerWidth} onMouseMove={onKeepOpen} onMouseOut={onClose}>
+          <Box flexDirection="column" width={headerWidth}>
             {content}
           </Box>
         </Popover>
@@ -216,6 +299,7 @@ export function UserProfilePopover({
       border
       borderColor={colors.borderFocused}
       paddingX={1}
+      onMouseOver={onKeepOpen}
       onMouseMove={onKeepOpen}
       onMouseOut={onClose}
       style={{ zIndex: 4 }}

package/src/plugins/builtin/chat/message/terminal.tsx

@@ -30,6 +30,7 @@ export function TerminalChatMessage({
   onUserHover,
   onUserHoverEnd,
   onUserActivate,
+  onUserContextMenu,
   beginReplyTo,
   beginEditMessage,
   jumpToMessage,
@@ -97,6 +98,7 @@ export function TerminalChatMessage({
           onUserHover={onUserHover}
           onUserHoverEnd={onUserHoverEnd}
           onUserActivate={onUserActivate}
+          onUserContextMenu={onUserContextMenu}
           {...actionProps}
         />
       )}
@@ -120,6 +122,7 @@ export function TerminalChatMessage({
               onUserHover={onUserHover}
               onUserHoverEnd={onUserHoverEnd}
               onUserActivate={onUserActivate}
+              onUserContextMenu={onUserContextMenu}
             />
           </Box>
           {lineIndex === 0 && state.grouped && <ChatMessageActions floating {...actionProps} />}

package/src/plugins/builtin/chat/message/types.ts

@@ -1,5 +1,15 @@
 import type { InlineTickerCatalogEntry } from "../../../../state/hooks/inline-tickers";
 import type { ChatAttachment, ChatMessage, ChatUserSummary } from "../../../../api-client";
+import type { BoxRenderable } from "../../../../ui";
+
+/** The name or @mention a user's card opens beside, where the renderer places cards next to it. */
+export type ChatUserAnchor = BoxRenderable | null;
+
+/** The pointer event a user menu opens from. */
+export interface ChatUserContextMenuEvent {
+  preventDefault?: () => void;
+  stopPropagation?: () => void;
+}
 
 export interface ChatMessageBaseProps {
   msg: ChatMessage;
@@ -11,9 +21,11 @@ export interface ChatMessageBaseProps {
   catalog: Record<string, InlineTickerCatalogEntry>;
   userByUsername: Map<string, ChatUserSummary>;
   openTicker: (symbol: string) => void;
-  onUserHover: (user: ChatUserSummary) => void;
+  onUserHover: (user: ChatUserSummary, anchor?: ChatUserAnchor) => void;
   onUserHoverEnd: () => void;
-  onUserActivate?: (user: ChatUserSummary) => void;
+  onUserActivate?: (user: ChatUserSummary, anchor?: ChatUserAnchor) => void;
+  /** A right-click on a name or @mention: the user's own menu. */
+  onUserContextMenu?: (user: ChatUserSummary, event: ChatUserContextMenuEvent, anchor?: ChatUserAnchor) => void;
   beginReplyTo: (index: number, options?: { deferFocus?: boolean }) => void;
   beginEditMessage: (index: number, options?: { deferFocus?: boolean }) => boolean;
   jumpToMessage: (messageId: string) => void;