feat(search): add private history and responsive result states

Author: waleedlatif1

apps/sim/app/api/organizations/[id]/search/history/route.ts

@@ -0,0 +1,49 @@
+import {
+  clearSearchHistoryContract,
+  listSearchHistoryContract,
+  recordSearchHistoryContract,
+} from '@/lib/api/contracts/knowledge/search-history'
+import {
+  defineInternalJsonRoute,
+  internalOrchestrationErrorPolicy,
+  internalRateLimits,
+  internalSessionAuth,
+} from '@/lib/api/server/routes'
+import {
+  clearSearchHistory,
+  listSearchHistory,
+  recordSearchHistory,
+  searchHistoryOperations,
+} from '@/lib/knowledge/application/search-history'
+
+export const GET = defineInternalJsonRoute({
+  contract: listSearchHistoryContract,
+  auth: internalSessionAuth,
+  operation: searchHistoryOperations.list,
+  rateLimit: internalRateLimits.user({ bucketName: 'search-history-read' }),
+  errorPolicy: internalOrchestrationErrorPolicy,
+  mapInput: ({ params }) => ({ organizationId: params.id }),
+  useCase: listSearchHistory,
+  staticResponseHeaders: { 'Cache-Control': 'private, no-store' },
+})
+export const POST = defineInternalJsonRoute({
+  contract: recordSearchHistoryContract,
+  auth: internalSessionAuth,
+  operation: searchHistoryOperations.record,
+  rateLimit: internalRateLimits.user({ bucketName: 'search-history-write' }),
+  errorPolicy: internalOrchestrationErrorPolicy,
+  parseOptions: { maxBodyBytes: 24 * 1024 },
+  mapInput: ({ params, body }) => ({ organizationId: params.id, event: body }),
+  useCase: recordSearchHistory,
+  staticResponseHeaders: { 'Cache-Control': 'private, no-store' },
+})
+export const DELETE = defineInternalJsonRoute({
+  contract: clearSearchHistoryContract,
+  auth: internalSessionAuth,
+  operation: searchHistoryOperations.clear,
+  rateLimit: internalRateLimits.user({ bucketName: 'search-history-write' }),
+  errorPolicy: internalOrchestrationErrorPolicy,
+  mapInput: ({ params }) => ({ organizationId: params.id }),
+  useCase: clearSearchHistory,
+  staticResponseHeaders: { 'Cache-Control': 'private, no-store' },
+})

apps/sim/app/o/[organizationId]/components/search-landing-history.tsx

@@ -0,0 +1,94 @@
+'use client'
+
+import { type ReactNode, useState } from 'react'
+import { Chip, cn, toast } from '@sim/emcn'
+import { Clock } from '@sim/emcn/icons'
+import { inter } from '@/app/_styles/fonts/inter/inter'
+import { SourceCard } from '@/app/workspace/[workspaceId]/home/components/message-content/components/source-card'
+import { useClearSearchHistory, useSearchHistory } from '@/hooks/queries/search-history'
+
+interface SearchLandingHistoryProps {
+  organizationId: string
+  userId: string
+  onSearch: (query: string) => void
+  children: ReactNode
+}
+
+/** Private shortcuts under the composer; ordinary buttons retain native Tab/Enter navigation. */
+export function SearchLandingHistory({
+  organizationId,
+  userId,
+  onSearch,
+  children,
+}: SearchLandingHistoryProps) {
+  const history = useSearchHistory(organizationId)
+  const clear = useClearSearchHistory(organizationId, userId)
+  const [selection, setSelection] = useState<'sources' | 'queries' | null>(null)
+  const sources = history.data?.sources.slice(0, 5) ?? []
+  const queries = history.data?.queries.slice(0, 5) ?? []
+  const selected = selection ?? (sources.length > 0 ? 'sources' : 'queries')
+  return (
+    <div className={cn('w-full min-w-0', inter.className)}>
+      {children}
+      {(sources.length > 0 || queries.length > 0) && (
+        <section aria-label='Recent activity' className='mt-6 px-2'>
+          <div className='mb-2 flex flex-wrap items-center justify-between gap-2'>
+            <div role='group' aria-label='History type' className='flex items-center gap-1'>
+              <Chip
+                active={selected === 'sources'}
+                aria-pressed={selected === 'sources'}
+                onClick={() => setSelection('sources')}
+              >
+                Recently viewed
+              </Chip>
+              <Chip
+                active={selected === 'queries'}
+                aria-pressed={selected === 'queries'}
+                onClick={() => setSelection('queries')}
+              >
+                Recent searches
+              </Chip>
+            </div>
+            <Chip
+              disabled={clear.isPending}
+              onClick={() =>
+                clear.mutate(undefined, { onError: (error) => toast.error(error.message) })
+              }
+            >
+              Clear history
+            </Chip>
+          </div>
+          {selected === 'sources' ? (
+            sources.length > 0 ? (
+              sources.map((source) => <SourceCard key={source.url} source={source} dense />)
+            ) : (
+              <p className='px-2 py-2 text-[var(--text-tertiary)] text-small'>
+                Sources you open will appear here.
+              </p>
+            )
+          ) : queries.length > 0 ? (
+            <div className='flex flex-col gap-1'>
+              {queries.map(({ query }) => (
+                <Chip key={query} fullWidth leftIcon={Clock} onClick={() => onSearch(query)}>
+                  {query}
+                </Chip>
+              ))}
+            </div>
+          ) : (
+            <p className='px-2 py-2 text-[var(--text-tertiary)] text-small'>
+              Your recent searches will appear here.
+            </p>
+          )}
+        </section>
+      )}
+      {history.isError && (
+        <div className='mt-6 flex items-center gap-2 px-4 text-[var(--text-tertiary)] text-small'>
+          Recent activity couldn’t load.
+          <Chip onClick={() => void history.refetch()} disabled={history.isFetching}>
+            Try again
+          </Chip>
+        </div>
+      )}
+    </div>
+  )
+}

apps/sim/app/o/[organizationId]/home/organization-home.tsx

@@ -16,12 +16,14 @@ import {
   getMothershipAttachmentUrl,
 } from '@/lib/mothership/chat/attachment-preview'
 import { createSearchResource } from '@/lib/mothership/resources/search'
+import { SearchLandingHistory } from '@/app/o/[organizationId]/components/search-landing-history'
 import { Composer } from '@/app/o/[organizationId]/home/components/composer'
 import { GetStarted } from '@/app/o/[organizationId]/home/components/get-started'
 import { organizationHomeParsers } from '@/app/o/[organizationId]/home/search-params'
 import { useOrganizationContext } from '@/app/o/[organizationId]/providers/organization-provider'
 import { organizationSearchUrlKeys } from '@/app/o/[organizationId]/search/search-params'
 import { ChatResourcePanel } from '@/app/workspace/[workspaceId]/home/components/chat-resource-panel'
+import { useSearchHistoryActions } from '@/app/workspace/[workspaceId]/home/components/message-content/components/source-history-context'
 import { SearchIntegrationConnection } from '@/app/workspace/[workspaceId]/home/components/message-content/components/special-tags/search-integration-connection'
 import { MothershipChat } from '@/app/workspace/[workspaceId]/home/components/mothership-chat'
 import { SuggestedActions } from '@/app/workspace/[workspaceId]/home/components/suggested-actions'
@@ -223,6 +225,7 @@ function OrganizationHomeContent({
   useEffect(() => {
     if (chat.error) toast.error(chat.error)
   }, [chat.error])
+  const { recordQuery } = useSearchHistoryActions()
   const { sendMessage } = chat
   const { mutate: markRead } = useMarkMothershipChatRead({ organizationId: organization.id })
   const firstName = userName?.split(' ')[0] ?? ''
@@ -263,6 +266,7 @@ function OrganizationHomeContent({
     assistantSearch?: WorkspaceSearchFilters
   ) => {
     if (requestMode !== 'assistant' && !canBuild) return
+    if (requestMode === 'assistant') recordQuery(message)
     setSelectedMode(requestMode)
     if (requestMode !== 'assistant') panel.prepareResourceViewForAgentTurn()
     void sendMessage(message, fileAttachments, contexts, {
@@ -334,6 +338,14 @@ function OrganizationHomeContent({
     <div className='flex h-full min-h-0 min-w-[min(480px,100%)] flex-1 flex-col bg-[var(--bg)]'>
       {hasChat ? (
         <MothershipChat
+          onViewSources={(messageId, requestId) =>
+            addResource({
+              type: 'sources',
+              id: 'cited-sources',
+              title: 'Sources',
+              sources: { messageId, ...(requestId ? { requestId } : {}) },
+            })
+          }
           SearchConnectionComponent={SearchIntegrationConnection}
           messages={chat.messages}
           isSending={chat.isSending}
@@ -396,9 +408,18 @@ function OrganizationHomeContent({
                   : `What should we get done${firstName ? `, ${firstName}` : ''}?`}
             </h1>
             <div className='relative w-full max-w-chat'>
-              {composer}
-              {/* Anchored out of flow so expanding/collapsing never shifts the centered input */}
-              <div className='absolute inset-x-0 top-full'>
+              {requestMode === 'assistant' && searchAccess.memberScoped && userId ? (
+                <SearchLandingHistory
+                  organizationId={organization.id}
+                  userId={userId}
+                  onSearch={(query) => submit(query)}
+                >
+                  {composer}
+                </SearchLandingHistory>
+              ) : (
+                composer
+              )}
+              <div className={requestMode === 'agent' ? 'absolute inset-x-0 top-full' : 'mt-4'}>
                 {requestMode === 'agent' ? (
                   <SuggestedActions
                     organizationId={organization.id}

apps/sim/app/o/[organizationId]/providers/organization-provider.tsx

@@ -3,6 +3,7 @@
 import { createContext, type ReactNode, useContext } from 'react'
 import { useSession } from '@/lib/auth/auth-client'
 import type { OrganizationSurfaceContext } from '@/lib/organizations/surface'
+import { SourceHistoryProvider } from '@/app/workspace/[workspaceId]/home/components/message-content/components/source-history-context'
 import { SocketProvider } from '@/app/workspace/providers/socket-provider'
 import { useMothershipChatEvents } from '@/hooks/use-mothership-chat-events'
 import { useSeedDeploymentShape } from '@/hooks/use-seed-deployment-shape'
@@ -43,7 +44,12 @@ export function OrganizationProvider({ children, context }: OrganizationProvider
             : undefined
         }
       >
-        {children}
+        <SourceHistoryProvider
+          organizationId={context.searchAccess.memberScoped ? context.organization.id : undefined}
+          userId={session?.user?.id}
+        >
+          {children}
+        </SourceHistoryProvider>
       </SocketProvider>
     </OrganizationContextValue.Provider>
   )