Skip to content

Open-source Grok Bot alternative for named AI teammates. Local-first desktop, web, and mobile clients with per-bot tools, instructions, and memory. Independent fork of T3 Code.

feat(mobile): add thread title regeneration (#6253)

Chris Deemingd37a9b09b8ea
diff --git a/apps/mobile/src/features/home/HomeRouteScreen.tsx b/apps/mobile/src/features/home/HomeRouteScreen.tsx
index d67446a61..331347867 100644
--- a/apps/mobile/src/features/home/HomeRouteScreen.tsx
+++ b/apps/mobile/src/features/home/HomeRouteScreen.tsx
@@ -45,6 +45,7 @@ export function HomeRouteScreen() {
pinThread,
unpinThread,
movePinnedThread,
+ regenerateThreadTitle,
unsettleThread,
} = useThreadListActions();
const pendingTasks = usePendingNewTasks();
@@ -186,6 +187,7 @@ export function HomeRouteScreen() {
onPinThread={pinThread}
onUnpinThread={unpinThread}
onMovePinnedThread={movePinnedThread}
+ onRegenerateThreadTitle={regenerateThreadTitle}
onEnvironmentChange={setSelectedEnvironmentId}
onProjectChange={setSelectedProjectKey}
onOpenSettings={() =>
diff --git a/apps/mobile/src/features/home/HomeScreen.tsx b/apps/mobile/src/features/home/HomeScreen.tsx
index 64f0480d2..6c3647873 100644
--- a/apps/mobile/src/features/home/HomeScreen.tsx
+++ b/apps/mobile/src/features/home/HomeScreen.tsx
@@ -115,6 +115,7 @@ interface HomeScreenProps {
thread: EnvironmentThreadShell,
direction: "up" | "down",
) => Promise<boolean>;
+ readonly onRegenerateThreadTitle: (thread: EnvironmentThreadShell) => Promise<boolean>;
readonly onSelectPendingTask: (pendingTask: PendingNewTask) => void;
readonly onDeletePendingTask: (pendingTask: PendingNewTask) => void;
readonly onNewThreadInProject: (project: EnvironmentProject) => void;
@@ -538,6 +539,12 @@ export function HomeScreen(props: HomeScreenProps) {
},
[props.onUnpinThread],
);
+ const handleRegenerateThreadTitle = useCallback(
+ (thread: EnvironmentThreadShell) => {
+ void props.onRegenerateThreadTitle(thread);
+ },
+ [props.onRegenerateThreadTitle],
+ );
const handleDeleteThread = props.onDeleteThread;
const handleUnsettleThread = props.onUnsettleThread;
// The settled tail renders in pages; expansion resets when the filter
@@ -615,6 +622,15 @@ export function HomeScreen(props: HomeScreenProps) {
}
return supported;
}, [serverConfigs]);
+ const titleRegenerationEnvironmentIds = useMemo(() => {
+ const supported = new Set<EnvironmentId>();
+ for (const [environmentId, config] of serverConfigs) {
+ if (config.environment.capabilities.threadTitleRegeneration === true) {
+ supported.add(environmentId);
+ }
+ }
+ return supported;
+ }, [serverConfigs]);
// Canonical arranged pinned order (reorder-capable threads only) for the
// Move up/down position flags. Computed from all shells, not the rendered
// list, so search/scope filtering never disables or misdirects a move.
@@ -811,6 +827,8 @@ export function HomeScreen(props: HomeScreenProps) {
onSelectThread={props.onSelectThread}
onDeleteThread={handleDeleteThread}
onArchiveThread={props.onArchiveThread}
+ onRegenerateThreadTitle={handleRegenerateThreadTitle}
+ titleRegenerationSupported={titleRegenerationEnvironmentIds.has(thread.environmentId)}
settlementSupported={settlementEnvironmentIds.has(thread.environmentId)}
onSettleThread={handleSettleThread}
snoozeSupported={snoozeEnvironmentIds.has(thread.environmentId)}
@@ -842,6 +860,7 @@ export function HomeScreen(props: HomeScreenProps) {
arrangedPinnedKeys,
handleMovePinnedThread,
handlePinThread,
+ handleRegenerateThreadTitle,
handleSettleThread,
handleSnoozeThread,
handleUnpinThread,
@@ -863,6 +882,7 @@ export function HomeScreen(props: HomeScreenProps) {
snoozeEnvironmentIds,
threadListV2Items,
threadSearchMatchByKey,
+ titleRegenerationEnvironmentIds,
toggleSettledShelf,
toggleSnoozedShelf,
v2ProjectTitleByProjectKey,
@@ -967,6 +987,8 @@ export function HomeScreen(props: HomeScreenProps) {
searchQuery={props.searchQuery}
onArchiveThread={props.onArchiveThread}
onDeleteThread={props.onDeleteThread}
+ onRegenerateThreadTitle={handleRegenerateThreadTitle}
+ titleRegenerationSupported={titleRegenerationEnvironmentIds.has(thread.environmentId)}
onSelectThread={props.onSelectThread}
onSwipeableClose={handleSwipeableClose}
onSwipeableWillOpen={handleSwipeableWillOpen}
@@ -988,6 +1010,7 @@ export function HomeScreen(props: HomeScreenProps) {
[
handleSwipeableClose,
handleSwipeableWillOpen,
+ handleRegenerateThreadTitle,
projectCwdByKey,
props.onArchiveThread,
props.onDeletePendingTask,
@@ -998,6 +1021,7 @@ export function HomeScreen(props: HomeScreenProps) {
props.searchQuery,
props.savedConnectionsById,
threadSearchMatchByKey,
+ titleRegenerationEnvironmentIds,
updateGroupDisplay,
],
);
diff --git a/apps/mobile/src/features/home/useThreadListActions.ts b/apps/mobile/src/features/home/useThreadListActions.ts
index 3103c5379..5c6694404 100644
--- a/apps/mobile/src/features/home/useThreadListActions.ts
+++ b/apps/mobile/src/features/home/useThreadListActions.ts
@@ -48,6 +48,15 @@ function environmentSupportsPinReorder(environmentId: EnvironmentThreadShell["en
);
}
+function environmentSupportsTitleRegeneration(
+ environmentId: EnvironmentThreadShell["environmentId"],
+) {
+ return (
+ appAtomRegistry.get(environmentServerConfigsAtom).get(environmentId)?.environment.capabilities
+ .threadTitleRegeneration === true
+ );
+}
+
type ThreadListAction = "archive" | "unarchive" | "delete" | "settle" | "unsettle";
const ACTION_VERBS: Record<ThreadListAction, string> = {
@@ -227,13 +236,18 @@ export function useThreadListActions(): {
thread: EnvironmentThreadShell,
direction: "up" | "down",
) => Promise<boolean>;
+ readonly regenerateThreadTitle: (thread: EnvironmentThreadShell) => Promise<boolean>;
} {
const executeAction = useThreadActionExecutor();
const snoozeMutation = useAtomCommand(threadEnvironment.snooze, { reportFailure: false });
const unsnoozeMutation = useAtomCommand(threadEnvironment.unsnooze, { reportFailure: false });
const pinMutation = useAtomCommand(threadEnvironment.pin, { reportFailure: false });
const unpinMutation = useAtomCommand(threadEnvironment.unpin, { reportFailure: false });
+ const updateThreadMetadata = useAtomCommand(threadEnvironment.updateMetadata, {
+ reportFailure: false,
+ });
const snoozeInFlightThreadKeys = useRef(new Set<string>());
+ const titleRegenerationInFlightThreadKeys = useRef(new Set<string>());
const archiveThread = useCallback(
(thread: EnvironmentThreadShell) => {
@@ -405,6 +419,47 @@ export function useThreadListActions(): {
},
[unpinMutation],
);
+ const regenerateThreadTitle = useCallback(
+ async (thread: EnvironmentThreadShell) => {
+ const key = scopedThreadKey(thread.environmentId, thread.id);
+ if (
+ thread.titleRegeneration != null ||
+ titleRegenerationInFlightThreadKeys.current.has(key)
+ ) {
+ return false;
+ }
+ if (!environmentSupportsTitleRegeneration(thread.environmentId)) {
+ Alert.alert(
+ "Could not regenerate title",
+ "This environment's server does not support title regeneration yet. Update the server to regenerate thread titles.",
+ );
+ return false;
+ }
+
+ titleRegenerationInFlightThreadKeys.current.add(key);
+ selectionHaptic();
+ try {
+ const result = await updateThreadMetadata({
+ environmentId: thread.environmentId,
+ input: { threadId: thread.id, regenerateTitle: true },
+ });
+ if (result._tag === "Failure") {
+ const error = Cause.squash(result.cause);
+ Alert.alert(
+ "Could not regenerate title",
+ error instanceof Error && error.message.trim().length > 0
+ ? error.message
+ : "The thread title could not be regenerated.",
+ );
+ return false;
+ }
+ return true;
+ } finally {
+ titleRegenerationInFlightThreadKeys.current.delete(key);
+ }
+ },
+ [updateThreadMetadata],
+ );
// Move up / Move down for the pinned block. Computed against the CANONICAL
// keyed pinned order (not the rendered list), so the move is valid even
@@ -497,6 +552,7 @@ export function useThreadListActions(): {
pinThread,
unpinThread,
movePinnedThread,
+ regenerateThreadTitle,
};
}
diff --git a/apps/mobile/src/features/threads/ThreadNavigationSidebar.tsx b/apps/mobile/src/features/threads/ThreadNavigationSidebar.tsx
index d80d906ad..b03ba9468 100644
--- a/apps/mobile/src/features/threads/ThreadNavigationSidebar.tsx
+++ b/apps/mobile/src/features/threads/ThreadNavigationSidebar.tsx
@@ -211,6 +211,7 @@ function ThreadNavigationSidebarPane(
pinThread,
unpinThread,
movePinnedThread,
+ regenerateThreadTitle,
} = useThreadListActions();
const threadListV2Enabled = useThreadListV2Enabled();
const pendingTasks = usePendingNewTasks();
@@ -505,6 +506,15 @@ function ThreadNavigationSidebarPane(
}
return supported;
}, [serverConfigs]);
+ const titleRegenerationEnvironmentIds = useMemo(() => {
+ const supported = new Set<EnvironmentId>();
+ for (const [environmentId, config] of serverConfigs) {
+ if (config.environment.capabilities.threadTitleRegeneration === true) {
+ supported.add(environmentId);
+ }
+ }
+ return supported;
+ }, [serverConfigs]);
// Canonical arranged pinned order for Move up/down flags — computed from
// all shells so search/scope filtering never disables a valid move.
const arrangedPinnedKeys = useMemo(() => {
@@ -950,6 +960,8 @@ function ThreadNavigationSidebarPane(
onSelectThread={handleSelectThread}
onDeleteThread={confirmDeleteThread}
onArchiveThread={archiveThread}
+ onRegenerateThreadTitle={regenerateThreadTitle}
+ titleRegenerationSupported={titleRegenerationEnvironmentIds.has(thread.environmentId)}
settlementSupported={settlementEnvironmentIds.has(thread.environmentId)}
onSettleThread={settleThread}
snoozeSupported={snoozeEnvironmentIds.has(thread.environmentId)}
@@ -1067,6 +1079,8 @@ function ThreadNavigationSidebarPane(
fullSwipeWidth={props.width - 20}
onArchiveThread={archiveThread}
onDeleteThread={confirmDeleteThread}
+ onRegenerateThreadTitle={regenerateThreadTitle}
+ titleRegenerationSupported={titleRegenerationEnvironmentIds.has(thread.environmentId)}
onSelectThread={handleSelectThread}
onSwipeableClose={handleSwipeableClose}
onSwipeableWillOpen={handleSwipeableWillOpen}
@@ -1103,6 +1117,7 @@ function ThreadNavigationSidebarPane(
projectByKey,
projectCwdByKey,
projectTitleByProjectKey,
+ regenerateThreadTitle,
props.onNewThreadInProject,
props.searchQuery,
props.selectedThreadKey,
@@ -1110,6 +1125,7 @@ function ThreadNavigationSidebarPane(
savedConnectionsById,
serverConfigs,
threadSearchMatchByKey,
+ titleRegenerationEnvironmentIds,
settleThread,
settlementEnvironmentIds,
showMoreSettled,
diff --git a/apps/mobile/src/features/threads/thread-list-items.tsx b/apps/mobile/src/features/threads/thread-list-items.tsx
index 8f32df5c7..24feb0be6 100644
--- a/apps/mobile/src/features/threads/thread-list-items.tsx
+++ b/apps/mobile/src/features/threads/thread-list-items.tsx
@@ -22,6 +22,7 @@ import type { PendingNewTask } from "../../state/use-pending-new-tasks";
import { useThreadPr, type ThreadPr } from "../../state/use-thread-pr";
import type { HomeGroupDisplayAction } from "../home/homeListItems";
import { ThreadSwipeable } from "../home/thread-swipe-actions";
+import { buildThreadTitleRegenerationMenuItems } from "./thread-title-regeneration-menu";
import { resolveThreadStatus } from "./threadPresentation";
import { ThreadSearchMatchExcerpt } from "./thread-search-match";
@@ -430,6 +431,8 @@ export const ThreadListRow = memo(function ThreadListRow(props: {
readonly onSelectThread: (thread: EnvironmentThreadShell) => void;
readonly onArchiveThread: (thread: EnvironmentThreadShell) => void;
readonly onDeleteThread: (thread: EnvironmentThreadShell) => void;
+ readonly onRegenerateThreadTitle: (thread: EnvironmentThreadShell) => void;
+ readonly titleRegenerationSupported: boolean;
readonly onSwipeableWillOpen: (methods: SwipeableMethods) => void;
readonly onSwipeableClose: (methods: SwipeableMethods) => void;
readonly simultaneousSwipeGesture?: ComponentProps<
@@ -451,7 +454,8 @@ export const ThreadListRow = memo(function ThreadListRow(props: {
const pressedBackgroundColor = useThemeColor("--color-subtle");
const selectedBackgroundColor = useThemeColor("--color-user-bubble");
- const { thread, onSelectThread, onArchiveThread, onDeleteThread } = props;
+ const { thread, onSelectThread, onArchiveThread, onDeleteThread, onRegenerateThreadTitle } =
+ props;
const status = resolveThreadStatus(thread);
const pr = useThreadPr(thread, props.projectCwd);
const timestamp = relativeTime(
@@ -471,6 +475,21 @@ export const ThreadListRow = memo(function ThreadListRow(props: {
const handleDelete = useCallback(() => onDeleteThread(thread), [onDeleteThread, thread]);
const handleArchive = useCallback(() => onArchiveThread(thread), [onArchiveThread, thread]);
+ const handleRegenerateTitle = useCallback(
+ () => onRegenerateThreadTitle(thread),
+ [onRegenerateThreadTitle, thread],
+ );
+ const menuActions = useMemo<MenuAction[]>(
+ () => [
+ THREAD_ROW_MENU_ACTIONS[0]!,
+ ...buildThreadTitleRegenerationMenuItems({
+ supported: props.titleRegenerationSupported,
+ isRegenerating: thread.titleRegeneration != null,
+ }),
+ THREAD_ROW_MENU_ACTIONS[1]!,
+ ],
+ [props.titleRegenerationSupported, thread.titleRegeneration],
+ );
const primaryAction = useMemo(
() => ({
accessibilityLabel: `Archive ${thread.title}`,
@@ -483,9 +502,10 @@ export const ThreadListRow = memo(function ThreadListRow(props: {
const handleMenuAction = useCallback(
({ nativeEvent }: { readonly nativeEvent: { readonly event: string } }) => {
if (nativeEvent.event === "archive") handleArchive();
+ if (nativeEvent.event === "regenerate-title") handleRegenerateTitle();
if (nativeEvent.event === "delete") handleDelete();
},
- [handleArchive, handleDelete],
+ [handleArchive, handleDelete, handleRegenerateTitle],
);
const statusPill = effectiveStatus ? (
@@ -674,7 +694,7 @@ export const ThreadListRow = memo(function ThreadListRow(props: {
// ControlPillMenu injects onLongPress into the row and anchors the
// token-styled dropdown to it; taps and swipes are untouched.
<ControlPillMenu
- actions={THREAD_ROW_MENU_ACTIONS}
+ actions={menuActions}
onPressAction={handleMenuAction}
shouldOpenOnLongPress
>
diff --git a/apps/mobile/src/features/threads/thread-list-v2-items.tsx b/apps/mobile/src/features/threads/thread-list-v2-items.tsx
index 17b6a4ea9..db2e805d0 100644
--- a/apps/mobile/src/features/threads/thread-list-v2-items.tsx
+++ b/apps/mobile/src/features/threads/thread-list-v2-items.tsx
@@ -27,6 +27,7 @@ import { useThemeColor } from "../../lib/useThemeColor";
import type { PendingNewTask } from "../../state/use-pending-new-tasks";
import { useThreadPr } from "../../state/use-thread-pr";
import { ThreadSwipeable } from "../home/thread-swipe-actions";
+import { buildThreadTitleRegenerationMenuItems } from "./thread-title-regeneration-menu";
import {
resolveThreadListV2SnoozeMenuSelection,
resolveThreadListV2SnoozeGateExpiryMs,
@@ -65,8 +66,8 @@ function threadTimeLabel(thread: EnvironmentThreadShell): string {
return relativeTime(thread.latestUserMessageAt ?? thread.updatedAt ?? thread.createdAt);
}
-// Menus stay lifecycle-focused: settle/un-settle plus delete. Archive keeps
-// its own surface (thread screen / settings) rather than crowding the row.
+// Menus keep lifecycle and title regeneration together. Archive keeps its
+// own surface (thread screen / settings) rather than crowding v2 rows.
const CARD_MENU_ACTIONS: MenuAction[] = [
{ id: "settle", title: "Settle", image: "checkmark" },
{ id: "delete", title: "Delete", image: "trash", attributes: { destructive: true } },
@@ -341,6 +342,7 @@ export const ThreadListV2Row = memo(function ThreadListV2Row(props: {
readonly fullSwipeWidth?: number;
readonly onSelectThread: (thread: EnvironmentThreadShell) => void;
readonly onDeleteThread: (thread: EnvironmentThreadShell) => void;
+ readonly onRegenerateThreadTitle: (thread: EnvironmentThreadShell) => void;
readonly onSettleThread: (thread: EnvironmentThreadShell) => void;
readonly onSnoozeThread: (thread: EnvironmentThreadShell, snoozedUntil: string) => void;
readonly onUnsnoozeThread: (thread: EnvironmentThreadShell) => void;
@@ -355,6 +357,8 @@ export const ThreadListV2Row = memo(function ThreadListV2Row(props: {
readonly snoozeSupported: boolean;
/** False on servers that predate thread.pin/unpin. */
readonly pinningSupported: boolean;
+ /** False on servers that predate thread title regeneration. */
+ readonly titleRegenerationSupported: boolean;
/** False on servers that predate thread.pin.reorder. Gates the pinned
Move up / Move down menu items. */
readonly pinReorderSupported?: boolean;
@@ -384,6 +388,7 @@ export const ThreadListV2Row = memo(function ThreadListV2Row(props: {
variant,
onSelectThread,
onDeleteThread,
+ onRegenerateThreadTitle,
onSettleThread,
onSnoozeThread,
onUnsnoozeThread,
@@ -417,6 +422,10 @@ export const ThreadListV2Row = memo(function ThreadListV2Row(props: {
const timeLabel = threadTimeLabel(thread);
const handleDelete = useCallback(() => onDeleteThread(thread), [onDeleteThread, thread]);
+ const handleRegenerateTitle = useCallback(
+ () => onRegenerateThreadTitle(thread),
+ [onRegenerateThreadTitle, thread],
+ );
const handleSettle = useCallback(() => onSettleThread(thread), [onSettleThread, thread]);
const handleSnooze = useCallback(
(snoozedUntil: string) => onSnoozeThread(thread, snoozedUntil),
@@ -506,6 +515,14 @@ export const ThreadListV2Row = memo(function ThreadListV2Row(props: {
props.pinningSupported,
],
);
+ const titleRegenerationMenuItems = useMemo<MenuAction[]>(
+ () =>
+ buildThreadTitleRegenerationMenuItems({
+ supported: props.titleRegenerationSupported,
+ isRegenerating: thread.titleRegeneration != null,
+ }),
+ [props.titleRegenerationSupported, thread.titleRegeneration],
+ );
const snoozableCardMenuActions = useMemo<MenuAction[]>(
() => [
{ id: "settle", title: "Settle", image: "checkmark" },
@@ -516,13 +533,31 @@ export const ThreadListV2Row = memo(function ThreadListV2Row(props: {
subactions: snoozePresetActions,
},
...pinMenuItem,
+ ...titleRegenerationMenuItems,
{ id: "delete", title: "Delete", image: "trash", attributes: { destructive: true } },
],
- [pinMenuItem, snoozePresetActions],
+ [pinMenuItem, snoozePresetActions, titleRegenerationMenuItems],
);
const cardMenuActions = useMemo<MenuAction[]>(
- () => [CARD_MENU_ACTIONS[0]!, ...pinMenuItem, ...CARD_MENU_ACTIONS.slice(1)],
- [pinMenuItem],
+ () => [
+ CARD_MENU_ACTIONS[0]!,
+ ...pinMenuItem,
+ ...titleRegenerationMenuItems,
+ ...CARD_MENU_ACTIONS.slice(1),
+ ],
+ [pinMenuItem, titleRegenerationMenuItems],
+ );
+ const slimMenuActions = useMemo<MenuAction[]>(
+ () => [SLIM_MENU_ACTIONS[0]!, ...titleRegenerationMenuItems, SLIM_MENU_ACTIONS[1]!],
+ [titleRegenerationMenuItems],
+ );
+ const snoozedMenuActions = useMemo<MenuAction[]>(
+ () => [SNOOZED_MENU_ACTIONS[0]!, ...titleRegenerationMenuItems, SNOOZED_MENU_ACTIONS[1]!],
+ [titleRegenerationMenuItems],
+ );
+ const legacyMenuActions = useMemo<MenuAction[]>(
+ () => [LEGACY_MENU_ACTIONS[0]!, ...titleRegenerationMenuItems, LEGACY_MENU_ACTIONS[1]!],
+ [titleRegenerationMenuItems],
);
const handleMenuAction = useCallback(
({ nativeEvent }: { readonly nativeEvent: { readonly event: string } }) => {
@@ -534,6 +569,7 @@ export const ThreadListV2Row = memo(function ThreadListV2Row(props: {
if (nativeEvent.event === "move-pin-up") handleMovePinnedUp();
if (nativeEvent.event === "move-pin-down") handleMovePinnedDown();
if (nativeEvent.event === "archive") handleArchive();
+ if (nativeEvent.event === "regenerate-title") handleRegenerateTitle();
if (nativeEvent.event === "delete") handleDelete();
const snoozeSelection = resolveThreadListV2SnoozeMenuSelection({
event: nativeEvent.event,
@@ -549,6 +585,7 @@ export const ThreadListV2Row = memo(function ThreadListV2Row(props: {
[
handleArchive,
handleDelete,
+ handleRegenerateTitle,
handleMovePinnedDown,
handleMovePinnedUp,
handlePin,
@@ -890,11 +927,11 @@ export const ThreadListV2Row = memo(function ThreadListV2Row(props: {
<ControlPillMenu
actions={
snoozedRow
- ? SNOOZED_MENU_ACTIONS
+ ? snoozedMenuActions
: !props.settlementSupported
- ? LEGACY_MENU_ACTIONS
+ ? legacyMenuActions
: canUnsettle
- ? SLIM_MENU_ACTIONS
+ ? slimMenuActions
: swipeActions.secondary === "snooze"
? snoozableCardMenuActions
: cardMenuActions
diff --git a/apps/mobile/src/features/threads/thread-title-regeneration-menu.test.ts b/apps/mobile/src/features/threads/thread-title-regeneration-menu.test.ts
new file mode 100644
index 000000000..6425d6361
--- /dev/null
+++ b/apps/mobile/src/features/threads/thread-title-regeneration-menu.test.ts
@@ -0,0 +1,36 @@
+import { describe, expect, it } from "vite-plus/test";
+
+import { buildThreadTitleRegenerationMenuItems } from "./thread-title-regeneration-menu";
+
+describe("buildThreadTitleRegenerationMenuItems", () => {
+ it("hides regeneration when the environment does not advertise support", () => {
+ expect(
+ buildThreadTitleRegenerationMenuItems({ supported: false, isRegenerating: false }),
+ ).toEqual([]);
+ });
+
+ it("offers regeneration for a supported environment", () => {
+ expect(
+ buildThreadTitleRegenerationMenuItems({ supported: true, isRegenerating: false }),
+ ).toEqual([
+ {
+ id: "regenerate-title",
+ title: "Regenerate title",
+ image: "arrow.clockwise",
+ },
+ ]);
+ });
+
+ it("shows and disables the pending state", () => {
+ expect(
+ buildThreadTitleRegenerationMenuItems({ supported: true, isRegenerating: true }),
+ ).toEqual([
+ {
+ id: "regenerate-title",
+ title: "Regenerating…",
+ image: "arrow.clockwise",
+ attributes: { disabled: true },
+ },
+ ]);
+ });
+});
diff --git a/apps/mobile/src/features/threads/thread-title-regeneration-menu.ts b/apps/mobile/src/features/threads/thread-title-regeneration-menu.ts
new file mode 100644
index 000000000..bef25afab
--- /dev/null
+++ b/apps/mobile/src/features/threads/thread-title-regeneration-menu.ts
@@ -0,0 +1,17 @@
+import type { MenuAction } from "@react-native-menu/menu";
+
+export function buildThreadTitleRegenerationMenuItems(input: {
+ readonly supported: boolean;
+ readonly isRegenerating: boolean;
+}): MenuAction[] {
+ if (!input.supported) return [];
+
+ return [
+ {
+ id: "regenerate-title",
+ title: input.isRegenerating ? "Regenerating…" : "Regenerate title",
+ image: "arrow.clockwise",
+ ...(input.isRegenerating ? { attributes: { disabled: true } } : {}),
+ },
+ ];
+}
diff --git a/docs/user/thread-sidebar.md b/docs/user/thread-sidebar.md
index 3ff286055..70b3cccc9 100644
--- a/docs/user/thread-sidebar.md
+++ b/docs/user/thread-sidebar.md
@@ -18,3 +18,7 @@ Dev and Nightly environments can identify themselves with artwork at the top of
the send button. Choose **Artwork**, **Version pill**, or **None** in Settings under environment
identification. Artwork is recolored to match each built-in theme. Custom themes use the **Version
pill** fallback because their colors are not controlled by T3 Code.
+
+To generate a fresh title from the conversation, open a thread's context menu and choose
+**Regenerate title**. While T3 Code is generating it, the action reads **Regenerating…** and cannot
+be selected again. The option is hidden when the connected environment needs a server update.