import { type EnvironmentId, type FilesystemBrowseEntry, type KeybindingCommand, type PluginCommand, type PluginCommandSurface, THREAD_JUMP_KEYBINDING_COMMANDS, } from "@t3tools/contracts"; import { filterFilesystemBrowseEntries } from "@t3tools/client-runtime/state/filesystem"; import type { SidebarThreadSortOrder } from "@t3tools/contracts/settings"; import * as Arr from "effect/Array"; import * as Result from "effect/Result"; import { type ReactNode } from "react"; import { sortThreads } from "../lib/threadSort"; import { formatRelativeTimeLabel } from "../timestampFormat"; import { type Project, type SidebarThreadSummary, type Thread } from "../types"; export const RECENT_THREAD_LIMIT = 12; export const ITEM_ICON_CLASS = "size-4 text-icon-muted"; export const ADDON_ICON_CLASS = "size-4"; export function browseInputEndPaddingClass(input: { readonly willCreateProjectPath: boolean; readonly hasHighlightedBrowseItem: boolean; }): string { if (input.willCreateProjectPath) { return "*:data-[slot=autocomplete-input]:pe-38!"; } if (input.hasHighlightedBrowseItem) { return "*:data-[slot=autocomplete-input]:pe-30!"; } return "*:data-[slot=autocomplete-input]:pe-24!"; } /** * The global search overlay hosts three mutually exclusive surfaces: the * command palette (⌘K), the project file picker (⌘P), and project content * search (⇧⌘F). One reducer owns open/mode state so the surfaces can never * stack and re-triggering a mode's shortcut toggles it closed. */ export type SearchOverlayMode = "command" | "files" | "content"; export interface CommandPaletteOpenIntent { readonly kind: "add-project" | "new-thread-in"; } export interface CommandPaletteUiState { readonly open: boolean; readonly mode: SearchOverlayMode; readonly openIntent: CommandPaletteOpenIntent | null; } export type CommandPaletteUiAction = | { readonly _tag: "SetOpen"; readonly open: boolean } | { readonly _tag: "ToggleMode"; readonly mode: SearchOverlayMode } | { readonly _tag: "OpenAddProject" } | { readonly _tag: "OpenNewThreadIn" } | { readonly _tag: "ClearOpenIntent" }; export function reduceCommandPaletteUiState( state: CommandPaletteUiState, action: CommandPaletteUiAction, ): CommandPaletteUiState { switch (action._tag) { case "SetOpen": return action.open ? { open: true, mode: "command", openIntent: state.openIntent } : { ...state, open: false, openIntent: null }; case "ToggleMode": return state.open && state.mode === action.mode ? { ...state, open: false, openIntent: null } : { open: true, mode: action.mode, openIntent: null }; case "OpenAddProject": return { open: true, mode: "command", openIntent: { kind: "add-project" } }; case "OpenNewThreadIn": return { open: true, mode: "command", openIntent: { kind: "new-thread-in" } }; case "ClearOpenIntent": return state.openIntent ? { ...state, openIntent: null } : state; } } export interface CommandPaletteThreadContentMatch { readonly source: "user" | "assistant"; readonly snippet: string; readonly query: string; } export interface CommandPaletteItem { readonly kind: "action" | "submenu"; readonly value: string; readonly searchTerms: ReadonlyArray; readonly title: ReactNode; readonly description?: ReactNode; readonly threadContentMatch?: CommandPaletteThreadContentMatch; readonly timestamp?: string; readonly icon: ReactNode; readonly disabled?: boolean; /** Optional content rendered inline before the title text. */ readonly titleLeadingContent?: ReactNode; /** Optional content rendered inline after the title text (before the timestamp). */ readonly titleTrailingContent?: ReactNode; readonly shortcutCommand?: KeybindingCommand; } export interface CommandPaletteActionItem extends CommandPaletteItem { readonly kind: "action"; readonly keepOpen?: boolean; readonly run: () => Promise; } export function buildPluginCommandActionItems(input: { readonly commands: ReadonlyArray; readonly icon: ReactNode; readonly run: (command: PluginCommand) => Promise; readonly surface: PluginCommandSurface; }): CommandPaletteActionItem[] { return input.commands .filter((command) => command.surfaces.includes(input.surface)) .map((command) => ({ kind: "action", value: `plugin-command:${command.id}`, searchTerms: [command.label, command.description ?? "", command.id, "plugin"], title: command.label, ...(command.description === undefined ? {} : { description: command.description }), icon: input.icon, run: async () => input.run(command), })); } export const resolvePluginCommandEnvironmentId = (input: { readonly activeDraftEnvironmentId: EnvironmentId | null; readonly activeThreadEnvironmentId: EnvironmentId | null; readonly primaryEnvironmentId: EnvironmentId | null; }): EnvironmentId | null => input.activeThreadEnvironmentId ?? input.activeDraftEnvironmentId ?? input.primaryEnvironmentId; export interface CommandPaletteSubmenuItem extends CommandPaletteItem { readonly kind: "submenu"; readonly addonIcon: ReactNode; readonly groups: ReadonlyArray; readonly initialQuery?: string; } export interface CommandPaletteGroup { readonly value: string; readonly label: string; readonly items: ReadonlyArray; } export interface CommandPaletteView { readonly addonIcon: ReactNode; readonly groups: ReadonlyArray; readonly initialQuery?: string; } export function enumerateCommandPaletteItems( items: ReadonlyArray, ): CommandPaletteActionItem[] { return items.map((item, index) => { const shortcutCommand = THREAD_JUMP_KEYBINDING_COMMANDS[index]; if (shortcutCommand) return { ...item, shortcutCommand }; const { shortcutCommand: _shortcutCommand, ...itemWithoutShortcut } = item; return itemWithoutShortcut; }); } export type CommandPaletteMode = "root" | "root-browse" | "submenu" | "submenu-browse"; export function normalizeSearchText(value: string): string { return value.trim().toLowerCase().replace(/\s+/g, " "); } export function buildProjectActionItems(input: { projects: ReadonlyArray; valuePrefix: string; icon: (project: Project) => ReactNode; runProject: (project: Project) => Promise; searchTerms?: (project: Project) => ReadonlyArray; renderDescription?: (project: Project) => ReactNode; shortcutCommand?: KeybindingCommand; }): CommandPaletteActionItem[] { return input.projects.map((project) => ({ kind: "action", value: `${input.valuePrefix}:${project.environmentId}:${project.id}`, searchTerms: [project.title, project.workspaceRoot, ...(input.searchTerms?.(project) ?? [])], title: project.title, description: input.renderDescription?.(project) ?? project.workspaceRoot, icon: input.icon(project), ...(input.shortcutCommand !== undefined ? { shortcutCommand: input.shortcutCommand } : {}), run: async () => { await input.runProject(project); }, })); } export type BuildThreadActionItemsThread = Pick< SidebarThreadSummary, | "archivedAt" | "branch" | "createdAt" | "environmentId" | "id" | "modelSelection" | "projectId" | "session" | "title" | "worktreePath" > & { updatedAt: string; latestUserMessageAt?: string | null; }; export function buildThreadActionItems(input: { threads: ReadonlyArray; activeThreadId?: Thread["id"]; projectTitleById: ReadonlyMap; sortOrder: SidebarThreadSortOrder; icon: ReactNode; /** Optional content rendered inline before the title text per-thread. */ renderLeadingContent?: (thread: TThread) => ReactNode; /** Optional content rendered inline after the title text per-thread. */ renderTrailingContent?: (thread: TThread) => ReactNode; /** Optional rich description (e.g. favicon + workspace icons). Falls back to text. */ renderDescription?: (thread: TThread, meta: { projectTitle: string | undefined }) => ReactNode; getContentMatch?: (thread: TThread) => CommandPaletteThreadContentMatch | undefined; runThread: (thread: Pick) => Promise; limit?: number; }): CommandPaletteActionItem[] { const sortedThreads = sortThreads( input.threads.filter((thread) => thread.archivedAt === null), input.sortOrder, ); const visibleThreads = input.limit === undefined ? sortedThreads : sortedThreads.slice(0, input.limit); return visibleThreads.map((thread) => { const projectTitle = input.projectTitleById.get(thread.projectId); const descriptionParts: string[] = []; if (projectTitle) { descriptionParts.push(projectTitle); } if (thread.branch) { descriptionParts.push(`#${thread.branch}`); } if (thread.id === input.activeThreadId) { descriptionParts.push("Current thread"); } const leadingContent = input.renderLeadingContent?.(thread); const trailingContent = input.renderTrailingContent?.(thread); const contentMatch = input.getContentMatch?.(thread); const description = input.renderDescription ? input.renderDescription(thread, { projectTitle }) : descriptionParts.join(` · `); return Object.assign( { kind: "action" as const, value: `thread:${thread.id}`, searchTerms: [ thread.title, projectTitle ?? ``, thread.branch ?? ``, contentMatch?.snippet ?? ``, ], title: thread.title, description, timestamp: formatRelativeTimeLabel( thread.latestUserMessageAt ?? thread.updatedAt ?? thread.createdAt, ), icon: input.icon, }, leadingContent ? { titleLeadingContent: leadingContent } : {}, trailingContent ? { titleTrailingContent: trailingContent } : {}, contentMatch ? { threadContentMatch: contentMatch } : {}, { run: async () => { await input.runThread(thread); }, }, ); }); } function rankSearchFieldMatch(field: string, normalizedQuery: string): number { const normalizedField = normalizeSearchText(field); if (normalizedField.length === 0 || !normalizedField.includes(normalizedQuery)) { return Number.NEGATIVE_INFINITY; } if (normalizedField === normalizedQuery) { return 3; } if (normalizedField.startsWith(normalizedQuery)) { return 2; } return 1; } function rankCommandPaletteItemMatch( item: CommandPaletteActionItem | CommandPaletteSubmenuItem, normalizedQuery: string, ): number { const terms = item.searchTerms.filter((term) => term.length > 0); if (terms.length === 0) { return 0; } for (const [index, field] of terms.entries()) { const fieldRank = rankSearchFieldMatch(field, normalizedQuery); if (fieldRank !== Number.NEGATIVE_INFINITY) { return 1_000 - index * 100 + fieldRank; } } return 0; } export function filterCommandPaletteGroups(input: { activeGroups: ReadonlyArray; query: string; isInSubmenu: boolean; projectSearchItems: ReadonlyArray; threadSearchItems: ReadonlyArray; }): CommandPaletteGroup[] { const isActionsFilter = input.query.startsWith(">"); const searchQuery = isActionsFilter ? input.query.slice(1) : input.query; const normalizedQuery = normalizeSearchText(searchQuery); if (normalizedQuery.length === 0) { if (isActionsFilter) { return input.activeGroups.filter((group) => group.value === "actions"); } return [...input.activeGroups]; } let baseGroups = [...input.activeGroups]; if (isActionsFilter) { baseGroups = baseGroups.filter((group) => group.value === "actions"); } else if (!input.isInSubmenu) { baseGroups = baseGroups.filter((group) => group.value !== "recent-threads"); } const searchableGroups = [...baseGroups]; if (!input.isInSubmenu && !isActionsFilter) { if (input.projectSearchItems.length > 0) { searchableGroups.push({ value: "projects-search", label: "Projects", items: input.projectSearchItems, }); } if (input.threadSearchItems.length > 0) { searchableGroups.push({ value: "threads-search", label: "Threads", items: input.threadSearchItems, }); } } return searchableGroups.flatMap((group) => { const items = Arr.filterMap(group.items, (item, index) => { const haystack = normalizeSearchText(item.searchTerms.join(" ")); if (!haystack.includes(normalizedQuery)) { return Result.failVoid; } return Result.succeed({ item, index, rank: rankCommandPaletteItemMatch(item, normalizedQuery), }); }) .toSorted((left, right) => right.rank - left.rank || left.index - right.index) .map((entry) => entry.item); if (items.length === 0) { return []; } return [{ value: group.value, label: group.label, items }]; }); } export function buildBrowseGroups(input: { browseEntries: ReadonlyArray; browseQuery: string; canBrowseUp: boolean; upIcon: ReactNode; directoryIcon: ReactNode; browseUp: () => void | Promise; browseTo: (name: string) => void | Promise; }): CommandPaletteGroup[] { const items: CommandPaletteActionItem[] = []; if (input.canBrowseUp) { items.push({ kind: "action", value: "browse:up", searchTerms: [input.browseQuery, ".."], title: "..", icon: input.upIcon, keepOpen: true, run: async () => { await input.browseUp(); }, }); } for (const entry of input.browseEntries) { items.push({ kind: "action", value: `browse:${entry.fullPath}`, searchTerms: [input.browseQuery, entry.fullPath, entry.name], title: entry.name, icon: input.directoryIcon, keepOpen: true, run: async () => { await input.browseTo(entry.name); }, }); } return [{ value: "directories", label: "Directories", items }]; } export function filterPinnedBrowseEntries(input: { browseEntries: ReadonlyArray; filterQuery: string; pinnedDirectoryName: string; caseSensitive: boolean; }): ReturnType { const namesMatch = (left: string, right: string) => input.caseSensitive ? left === right : left.toLowerCase() === right.toLowerCase(); const visibleFilterQuery = namesMatch(input.filterQuery, input.pinnedDirectoryName) ? "" : input.filterQuery; const { visibleEntries } = filterFilesystemBrowseEntries(input.browseEntries, visibleFilterQuery); const exactEntry = input.filterQuery.length > 0 ? (input.browseEntries.find((entry) => namesMatch(entry.name, input.filterQuery)) ?? null) : null; return { visibleEntries, exactEntry }; } export function getCommandPaletteMode(input: { currentView: CommandPaletteView | null; isBrowsing: boolean; }): CommandPaletteMode { if (input.currentView) { return input.isBrowsing ? "submenu-browse" : "submenu"; } return input.isBrowsing ? "root-browse" : "root"; } export function buildRootGroups(input: { actionItems: ReadonlyArray; recentThreadItems: ReadonlyArray; }): CommandPaletteGroup[] { const groups: CommandPaletteGroup[] = []; if (input.actionItems.length > 0) { groups.push({ value: "actions", label: "Actions", items: input.actionItems }); } if (input.recentThreadItems.length > 0) { groups.push({ value: "recent-threads", label: "Recent Threads", items: input.recentThreadItems, }); } return groups; } export function getCommandPaletteInputPlaceholder(mode: CommandPaletteMode): string { switch (mode) { case "root": return "Search commands, projects, and threads..."; case "root-browse": return "Enter project path (e.g. ~/projects/my-app)"; case "submenu": return "Search..."; case "submenu-browse": return "Enter path (e.g. ~/projects/my-app)"; } }