@vertesia/ui 1.5.0-dev.20260807.073259Z → 1.5.0-dev.20260826.064249Z

package/src/features/oauth/McpConnectionsButton.tsx

@@ -93,7 +93,7 @@ export function McpConnectionsButton({
 }
 
 /**
- * Inline MCP status list for forms. It shows all available OAuth MCP groups
+ * Inline MCP status list for forms. It shows all available authenticated MCP groups
  * without requiring the user to open the management dialog.
  */
 export function McpConnectionsInlineList({
@@ -165,7 +165,7 @@ export function McpConnectionsInlineList({
                             >
                                 <Spinner className="size-3" />
                             </Button>
-                        ) : (
+                        ) : group.authType === 'oauth' ? (
                             <RemoteMcpConnectionButton
                                 appId={group.appId}
                                 collectionId={group.representativeId}
@@ -176,6 +176,10 @@ export function McpConnectionsInlineList({
                                 showDisconnect
                                 readOnly={readOnly}
                             />
+                        ) : (
+                            <Badge variant="outline" className="h-6 w-32 justify-center px-2 text-xs">
+                                {t('mcpConnections.apiKey')}
+                            </Badge>
                         )}
                         {onChange && (
                             <div className="flex min-w-24 items-center justify-end gap-2 text-xs">

package/src/features/oauth/McpConnectionsDialog.tsx

@@ -25,7 +25,7 @@ export interface McpConnectionsDialogProps {
 
 /**
  * Dialog to manage the MCP servers available to an agent conversation.
- * Each server can be connected/disconnected (OAuth) and activated/deactivated for this run.
+ * OAuth servers can be connected, and every server can be activated or deactivated for this run.
  */
 export function McpConnectionsDialog({
     isOpen,
@@ -102,7 +102,7 @@ export function McpConnectionsDialog({
                                             >
                                                 <Spinner className="size-3" />
                                             </Button>
-                                        ) : (
+                                        ) : group.authType === 'oauth' ? (
                                             <RemoteMcpConnectionButton
                                                 appId={group.appId}
                                                 collectionId={group.representativeId}
@@ -113,7 +113,7 @@ export function McpConnectionsDialog({
                                                 showDisconnect
                                                 readOnly={readOnly}
                                             />
-                                        )}
+                                        ) : null}
                                         {onChange && (
                                             <Switch
                                                 size="sm"

package/src/features/oauth/useMcpConnections.test.ts

@@ -16,6 +16,7 @@ function group(memberIds: string[], authenticated?: boolean, label = 'Server'):
         representativeId: memberIds[0],
         memberIds,
         memberNames: memberIds,
+        authType: 'oauth',
         authStatus:
             authenticated === undefined
                 ? undefined

package/src/features/oauth/useMcpConnections.ts

@@ -8,8 +8,7 @@ import { useUserSession } from '@vertesia/ui/session';
 import { useCallback, useEffect, useRef, useState } from 'react';
 
 /**
- * A group of MCP tool collections that share a single OAuth connection.
- * Connection/activation operations act on the whole group.
+ * A group of MCP tool collections that share authentication and activation state.
  */
 export interface McpConnectionGroup {
     key: string;
@@ -17,18 +16,18 @@ export interface McpConnectionGroup {
     appName: string;
     /** Display label: provider display_name, oauth_app name, or individual collection name */
     label: string;
-    /** Representative collection ID used for OAuth operations (all in group share the same OAuth provider) */
+    /** Representative collection ID used for status and, for OAuth groups, connection operations. */
     representativeId: string;
     /** All collection IDs in this group (used for per-conversation activation toggles) */
     memberIds: string[];
     /** Names of all collections in this group (for tooltip when > 1) */
     memberNames: string[];
+    authType: 'oauth' | 'api_key';
     authStatus?: OAuthAuthStatus;
 }
 
 /**
- * Loads the project's installed MCP tool collections that require OAuth, grouped by their
- * shared OAuth provider/app, and resolves each group's current connection status.
+ * Loads the project's installed authenticated MCP tool collections and resolves their status.
  *
  * Shared by the MCP connections button (badge count) and dialog (list) so the data is
  * fetched once and refreshed together after connect/disconnect.
@@ -56,9 +55,11 @@ export function useMcpConnections() {
 
                 if (!inst.manifest.tool_collections) continue;
 
-                const oauthCollections = inst.manifest.tool_collections
+                const mcpCollections = inst.manifest.tool_collections
                     .map((c) => normalizeToolCollection(c))
-                    .filter((c): c is MCPToolCollectionObject => c.type === 'mcp' && oauthIds.includes(c.id));
+                    .filter((c): c is MCPToolCollectionObject => c.type === 'mcp');
+                const oauthCollections = mcpCollections.filter((c) => c.auth !== 'api_key' && oauthIds.includes(c.id));
+                const apiKeyCollections = mcpCollections.filter((c) => c.auth === 'api_key');
 
                 const providerMap = new Map<string, MCPToolCollectionObject[]>();
                 const oauthAppMap = new Map<string, MCPToolCollectionObject[]>();
@@ -87,6 +88,7 @@ export function useMcpConnections() {
                         representativeId: cols[0].id,
                         memberIds: cols.map((c) => c.id),
                         memberNames: cols.map((c) => c.name),
+                        authType: 'oauth',
                     });
                 }
 
@@ -99,6 +101,7 @@ export function useMcpConnections() {
                         representativeId: cols[0].id,
                         memberIds: cols.map((c) => c.id),
                         memberNames: cols.map((c) => c.name),
+                        authType: 'oauth',
                     });
                 }
 
@@ -111,6 +114,20 @@ export function useMcpConnections() {
                         representativeId: col.id,
                         memberIds: [col.id],
                         memberNames: [col.name],
+                        authType: 'oauth',
+                    });
+                }
+
+                for (const col of apiKeyCollections) {
+                    allGroups.push({
+                        key: `${inst.id}:api-key:${col.id}`,
+                        appId: inst.id,
+                        appName: inst.manifest.title || inst.manifest.name,
+                        label: col.name,
+                        representativeId: col.id,
+                        memberIds: [col.id],
+                        memberNames: [col.name],
+                        authType: 'api_key',
                     });
                 }
             }

package/src/features/pdf-viewer/PdfPageRenderer.tsx

@@ -1,9 +1,6 @@
 import { Loader2 } from 'lucide-react';
-import { createContext, useCallback, useContext, useEffect, useRef, useState } from 'react';
-import { Document, Page, pdfjs } from 'react-pdf';
-
-// Configure PDF.js worker - use CDN for the worker
-pdfjs.GlobalWorkerOptions.workerSrc = `//unpkg.com/pdfjs-dist@${pdfjs.version}/build/pdf.worker.min.mjs`;
+import { createContext, Suspense, useCallback, useContext, useEffect, useRef, useState } from 'react';
+import { Document, Page } from './lazyReactPdf';
 
 // Loading spinner component
 function LoadingSpinner({ className, size = 'md' }: { className?: string; size?: 'sm' | 'md' | 'lg' }) {
@@ -65,15 +62,17 @@ export function PdfPageRenderer({
     return (
         <div className={className}>
             {loading && <LoadingSpinner className="py-4" size="md" />}
-            <Document file={pdfUrl} onLoadSuccess={handleLoadSuccess} onLoadError={handleError} loading={null}>
-                <Page
-                    pageNumber={pageNumber}
-                    width={width}
-                    renderTextLayer={renderTextLayer}
-                    renderAnnotationLayer={renderAnnotationLayer}
-                    loading={<LoadingSpinner className="py-4" size="sm" />}
-                />
-            </Document>
+            <Suspense fallback={null}>
+                <Document file={pdfUrl} onLoadSuccess={handleLoadSuccess} onLoadError={handleError} loading={null}>
+                    <Page
+                        pageNumber={pageNumber}
+                        width={width}
+                        renderTextLayer={renderTextLayer}
+                        renderAnnotationLayer={renderAnnotationLayer}
+                        loading={<LoadingSpinner className="py-4" size="sm" />}
+                    />
+                </Document>
+            </Suspense>
         </div>
     );
 }
@@ -174,14 +173,16 @@ export function SharedPdfProvider({ pdfUrl, urlLoading = false, children, onLoad
     return (
         <SharedPdfContext.Provider value={value}>
             {pdfUrl ? (
-                <Document
-                    file={pdfUrl}
-                    onLoadSuccess={handleLoadSuccess}
-                    onLoadError={handleError}
-                    loading={<LoadingSpinner className="py-4" size="md" />}
-                >
-                    {children(renderPage)}
-                </Document>
+                <Suspense fallback={<LoadingSpinner className="py-4" size="md" />}>
+                    <Document
+                        file={pdfUrl}
+                        onLoadSuccess={handleLoadSuccess}
+                        onLoadError={handleError}
+                        loading={<LoadingSpinner className="py-4" size="md" />}
+                    >
+                        {children(renderPage)}
+                    </Document>
+                </Suspense>
             ) : (
                 <LoadingSpinner className="py-4" size="md" />
             )}
@@ -480,45 +481,47 @@ export function PdfThumbnailList({
 
     return (
         <div ref={containerRef}>
-            <Document
-                file={pdfUrl}
-                onLoadSuccess={handleLoadSuccess}
-                onLoadError={handleError}
-                loading={<LoadingSpinner className="py-4" size="md" />}
-            >
-                {hasAspectRatio ? (
-                    <>
-                        {/* Top spacer for pages above visible window */}
-                        {topSpacerHeight > 0 && <div style={{ height: topSpacerHeight }} />}
-
-                        {/* Only render pages within the visible window */}
-                        {Array.from({ length: visibleRange.end - visibleRange.start }, (_, index) => {
-                            const pageNumber = visibleRange.start + index + 1;
-                            return (
-                                <div
-                                    key={pageNumber}
-                                    data-page-index={pageNumber - 1}
-                                    style={{ height: itemHeight, overflow: 'hidden' }}
-                                >
-                                    <VirtualizedThumbnail
-                                        pageNumber={pageNumber}
-                                        width={thumbnailWidth}
-                                        isSelected={pageNumber === currentPage}
-                                        onSelect={() => onPageSelect(pageNumber)}
-                                        renderThumbnail={renderThumbnail}
-                                        aspectRatio={effectiveAspectRatio}
-                                    />
-                                </div>
-                            );
-                        })}
-
-                        {/* Bottom spacer for pages below visible window */}
-                        {bottomSpacerHeight > 0 && <div style={{ height: bottomSpacerHeight }} />}
-                    </>
-                ) : (
-                    <LoadingSpinner className="py-4" size="md" />
-                )}
-            </Document>
+            <Suspense fallback={<LoadingSpinner className="py-4" size="md" />}>
+                <Document
+                    file={pdfUrl}
+                    onLoadSuccess={handleLoadSuccess}
+                    onLoadError={handleError}
+                    loading={<LoadingSpinner className="py-4" size="md" />}
+                >
+                    {hasAspectRatio ? (
+                        <>
+                            {/* Top spacer for pages above visible window */}
+                            {topSpacerHeight > 0 && <div style={{ height: topSpacerHeight }} />}
+
+                            {/* Only render pages within the visible window */}
+                            {Array.from({ length: visibleRange.end - visibleRange.start }, (_, index) => {
+                                const pageNumber = visibleRange.start + index + 1;
+                                return (
+                                    <div
+                                        key={pageNumber}
+                                        data-page-index={pageNumber - 1}
+                                        style={{ height: itemHeight, overflow: 'hidden' }}
+                                    >
+                                        <VirtualizedThumbnail
+                                            pageNumber={pageNumber}
+                                            width={thumbnailWidth}
+                                            isSelected={pageNumber === currentPage}
+                                            onSelect={() => onPageSelect(pageNumber)}
+                                            renderThumbnail={renderThumbnail}
+                                            aspectRatio={effectiveAspectRatio}
+                                        />
+                                    </div>
+                                );
+                            })}
+
+                            {/* Bottom spacer for pages below visible window */}
+                            {bottomSpacerHeight > 0 && <div style={{ height: bottomSpacerHeight }} />}
+                        </>
+                    ) : (
+                        <LoadingSpinner className="py-4" size="md" />
+                    )}
+                </Document>
+            </Suspense>
         </div>
     );
 }
@@ -575,16 +578,18 @@ export function PdfDocumentRenderer({
     return (
         <div className={className}>
             {loading && <LoadingSpinner className="py-8" size="lg" />}
-            <Document file={pdfUrl} onLoadSuccess={handleLoadSuccess} onLoadError={handleError} loading={null}>
-                <Page
-                    pageNumber={Math.min(pageNumber, numPages || 1)}
-                    width={width}
-                    height={height}
-                    renderTextLayer={renderTextLayer}
-                    renderAnnotationLayer={renderAnnotationLayer}
-                    loading={<LoadingSpinner className="py-8" size="md" />}
-                />
-            </Document>
+            <Suspense fallback={null}>
+                <Document file={pdfUrl} onLoadSuccess={handleLoadSuccess} onLoadError={handleError} loading={null}>
+                    <Page
+                        pageNumber={Math.min(pageNumber, numPages || 1)}
+                        width={width}
+                        height={height}
+                        renderTextLayer={renderTextLayer}
+                        renderAnnotationLayer={renderAnnotationLayer}
+                        loading={<LoadingSpinner className="py-8" size="md" />}
+                    />
+                </Document>
+            </Suspense>
         </div>
     );
 }

package/src/features/pdf-viewer/lazyReactPdf.ts

@@ -0,0 +1,33 @@
+import { type LazyExoticComponent, lazy } from 'react';
+
+type ReactPdf = typeof import('react-pdf');
+
+let reactPdfPromise: Promise<ReactPdf> | undefined;
+
+/**
+ * react-pdf carries pdf.js with it, which is by far the heaviest dependency of this package and is
+ * only needed once a PDF is actually displayed. Loading it on demand keeps it out of the eager
+ * bundle of every consuming app. The pdf.js worker (served from a CDN) is configured as part of the
+ * same load, since it must be set before the first document is opened.
+ */
+function loadReactPdf(): Promise<ReactPdf> {
+    if (!reactPdfPromise) {
+        reactPdfPromise = import('react-pdf').then((reactPdf) => {
+            const { pdfjs } = reactPdf;
+            pdfjs.GlobalWorkerOptions.workerSrc = `//unpkg.com/pdfjs-dist@${pdfjs.version}/build/pdf.worker.min.mjs`;
+            return reactPdf;
+        });
+    }
+    return reactPdfPromise;
+}
+
+/**
+ * Drop-in replacements for react-pdf's `Document` and `Page`. Both resolve from the same load, so a
+ * single `Suspense` boundary around the `Document` also covers the `Page` elements inside it.
+ */
+export const Document: LazyExoticComponent<ReactPdf['Document']> = lazy(() =>
+    loadReactPdf().then(({ Document: component }) => ({ default: component })),
+);
+export const Page: LazyExoticComponent<ReactPdf['Page']> = lazy(() =>
+    loadReactPdf().then(({ Page: component }) => ({ default: component })),
+);

package/src/features/store/collections/CollectionsTable.tsx

@@ -14,14 +14,11 @@ import {
 import { useUITranslation } from '@vertesia/ui/i18n';
 import { NavLink } from '@vertesia/ui/router';
 import { useUserSession } from '@vertesia/ui/session';
-import dayjs from 'dayjs';
-import relativeTime from 'dayjs/plugin/relativeTime';
 import { FolderClosed, Search, Trash2 } from 'lucide-react';
 import { useEffect, useState } from 'react';
+import dayjs from '../../../core/utils/dayjs.js';
 import { CreateCollectionModal } from './CreateCollection';
 
-dayjs.extend(relativeTime);
-
 export function CollectionsTable() {
     const { client } = useUserSession();
     const toast = useToast();

package/src/features/store/collections/EditCollectionView.tsx

@@ -23,8 +23,8 @@ import {
 import { useUITranslation } from '@vertesia/ui/i18n';
 import { useUserSession } from '@vertesia/ui/session';
 import { type EditorApi, GeneratedForm, ManagedObject, MonacoEditor, type Node } from '@vertesia/ui/widgets';
-import dayjs from 'dayjs';
 import { useContext, useMemo, useRef, useState } from 'react';
+import dayjs from '../../../core/utils/dayjs.js';
 import { UserInfo } from '../../user/UserInfo';
 import { SearchContext } from '../objects/search/DocumentSearchContext';
 import { SelectContentType, stringifyTableLayout } from '../types';

package/src/features/store/objects/ExportPropertiesModal.tsx

@@ -11,15 +11,22 @@ interface ExportPropertiesModalProps {
     isExporting: boolean;
     isOpen: boolean;
     onClose: (exportType?: string | null | undefined, exportAll?: boolean) => void;
+    /** Hide the all-objects option when the caller can only export an explicit selection. */
+    allowExportAll?: boolean;
 }
-export function ExportPropertiesModal({ isExporting, isOpen, onClose }: ExportPropertiesModalProps) {
+export function ExportPropertiesModal({
+    isExporting,
+    isOpen,
+    onClose,
+    allowExportAll = true,
+}: ExportPropertiesModalProps) {
     const title = 'Export Object Properties';
 
     return (
         <Modal onClose={() => onClose(undefined)} isOpen={isOpen}>
             <ModalTitle>{title}</ModalTitle>
             <ModalBody>
-                {!isExporting && <SelectPanel onClose={onClose} />}
+                {!isExporting && <SelectPanel onClose={onClose} allowExportAll={allowExportAll} />}
                 {isExporting && <WaitingPanel />}
             </ModalBody>
         </Modal>
@@ -28,13 +35,13 @@ export function ExportPropertiesModal({ isExporting, isOpen, onClose }: ExportPr
 
 interface SelectPanelProps {
     onClose: (exportType?: string | null, exportAll?: boolean) => void;
+    allowExportAll: boolean;
 }
-function SelectPanel({ onClose }: SelectPanelProps) {
+function SelectPanel({ onClose, allowExportAll }: SelectPanelProps) {
     const { t } = useUITranslation();
     const [exportType, setExportType] = useState<string | undefined>(undefined);
-    const [exportAll, setExportAll] = useState<string | undefined>(undefined);
-
     const selectionOption: string[] = ['Export selected objects', 'Export all objects'];
+    const [exportAll, setExportAll] = useState<string | undefined>(allowExportAll ? undefined : selectionOption[0]);
 
     const exportAllBoolean = (option: string | undefined) => {
         return option === selectionOption[1];
@@ -46,17 +53,19 @@ function SelectPanel({ onClose }: SelectPanelProps) {
 
     return (
         <ModalBody className="min-h-[104px] pt-0 flex flex-col gap-y-4">
-            <div className="h-1/3">
-                <SelectBox
-                    options={selectionOption}
-                    value={exportAll}
-                    onChange={setExportAll}
-                    placeholder={t('store.chooseWhatToExport')}
-                    className="h-full w-full text-sm"
-                    filterBy="name"
-                    isClearable
-                />
-            </div>
+            {allowExportAll && (
+                <div className="h-1/3">
+                    <SelectBox
+                        options={selectionOption}
+                        value={exportAll}
+                        onChange={setExportAll}
+                        placeholder={t('store.chooseWhatToExport')}
+                        className="h-full w-full text-sm"
+                        filterBy="name"
+                        isClearable
+                    />
+                </div>
+            )}
             <div className="h-1/2 flex flex-col gap-y-8 content-between">
                 <SelectBox
                     options={Object.values(ExportTypes)}

package/src/features/store/objects/components/ContentOverview.tsx

@@ -11,7 +11,6 @@ import {
     WorkflowExecutionStatus,
 } from '@vertesia/common';
 import {
-    Badge,
     Button,
     Dropdown,
     MenuItem,
@@ -36,11 +35,7 @@ import {
     UniversalDocumentViewer,
 } from '../../../document-viewer/UniversalDocumentViewer.js';
 import { MagicPdfView } from '../../../magic-pdf';
-import {
-    GroundedExtractionView,
-    useGroundedExtractionAvailable,
-    useGroundedSummary,
-} from '../../../magic-pdf/GroundedExtractionView.js';
+import { GroundedExtractionView, useGroundedExtractionAvailable } from '../../../magic-pdf/GroundedExtractionView.js';
 import { AudioPanel, ImagePanel, VideoPanel } from '../../../media-viewer';
 import { SecureButton } from '../../../permissions/SecureButton.js';
 import { getWorkflowStatusColor, getWorkflowStatusName, isPreviewableAsPdf } from '../../../utils/index.js';
@@ -348,7 +343,6 @@ function PropertiesPanel({
     const { t } = useUITranslation();
     const [viewCode, setViewCode] = useState(false);
     const [isPropertiesModalOpen, setPropertiesModalOpen] = useState(false);
-    const groundedSummary = useGroundedSummary(object.id);
 
     const handleOpenPropertiesModal = () => {
         setPropertiesModalOpen(true);
@@ -408,26 +402,6 @@ function PropertiesPanel({
                     </div>
                 </div>
 
-                {groundedSummary && object.properties && (
-                    <div className="flex items-center gap-2 px-2 pb-2">
-                        {typeof groundedSummary.confidence === 'number' && (
-                            <Badge
-                                variant={groundedSummary.confidence >= 0.95 ? 'success' : 'attention'}
-                                title={t('grounded.confidenceHint')}
-                            >
-                                {t('grounded.confidence', {
-                                    percent: Math.floor(groundedSummary.confidence * 100),
-                                })}
-                            </Badge>
-                        )}
-                        <Badge variant={groundedSummary.verified === groundedSummary.total ? 'success' : 'attention'}>
-                            {t('grounded.verifiedOf', {
-                                verified: groundedSummary.verified,
-                                total: groundedSummary.total,
-                            })}
-                        </Badge>
-                    </div>
-                )}
                 {object.properties ? (
                     <div className="flex-1 min-h-0 px-2">
                         <JSONDisplay value={object.properties} viewCode={viewCode} />
@@ -1229,7 +1203,7 @@ function PdfPreviewPanel({ object }: { object: ContentObject }) {
 
     return (
         <div className="h-full">
-            <UniversalDocumentViewer source={source} className="h-full" />
+            <UniversalDocumentViewer source={source} className="h-full" showHeader={false} />
         </div>
     );
 }

package/src/features/store/objects/components/TextEditorPanel.tsx

@@ -1,14 +1,22 @@
 import type { ContentObject } from '@vertesia/common';
 import { Button, errorMessage, useTheme, useToast } from '@vertesia/ui/core';
 import { useUITranslation } from '@vertesia/ui/i18n';
-import { VertesiaMarkdownDocumentEditor } from '@vertesia/ui/rich-text';
 import { useNavigate } from '@vertesia/ui/router';
 import { useUserSession } from '@vertesia/ui/session';
 import { type IEditorApi, MonacoEditor } from '@vertesia/ui/widgets';
-import { useCallback, useEffect, useRef, useState } from 'react';
+import { lazy, Suspense, useCallback, useEffect, useRef, useState } from 'react';
 import { isMarkdownContentType } from './documentEditingRun.js';
 import { SaveVersionConfirmModal } from './SaveVersionConfirmModal.js';
 
+/**
+ * The rich-text editor carries the whole TipTap stack. Importing it statically here would defeat the
+ * lazy boundaries the markdown widgets already use, pulling TipTap into every app that can reach
+ * this panel — so it is loaded on demand, like the other consumers do.
+ */
+const MarkdownDocumentEditor = lazy(() =>
+    import('@vertesia/ui/rich-text').then((module) => ({ default: module.VertesiaMarkdownDocumentEditor })),
+);
+
 interface TextEditorPanelProps {
     object: ContentObject;
     text: string;
@@ -139,7 +147,9 @@ export function TextEditorPanel({ object, text, onClose, onSaved }: TextEditorPa
             </div>
             <div className="flex-1 min-h-0 border rounded-md overflow-hidden mx-2 mb-2">
                 {isMarkdown ? (
-                    <VertesiaMarkdownDocumentEditor value={editorText} onChange={handleMarkdownChange} />
+                    <Suspense fallback={<div className="h-full w-full" />}>
+                        <MarkdownDocumentEditor value={editorText} onChange={handleMarkdownChange} />
+                    </Suspense>
                 ) : (
                     <MonacoEditor
                         value={text}

package/src/features/store/objects/layout/renderers.tsx

@@ -1,14 +1,9 @@
 import { Button, VTooltip } from '@vertesia/ui/core';
-import dayjs from 'dayjs';
-import LocalizedFormat from 'dayjs/plugin/localizedFormat';
-import RelativeTime from 'dayjs/plugin/relativeTime';
 import { ExternalLink, Eye } from 'lucide-react';
 import type { ReactNode } from 'react';
+import dayjs from '../../../../core/utils/dayjs.js';
 import { shortId } from '../../../utils';
 
-dayjs.extend(RelativeTime);
-dayjs.extend(LocalizedFormat);
-
 function isRecord(value: unknown): value is Record<string, unknown> {
     return typeof value === 'object' && value !== null;
 }

package/src/features/store/objects/search/DocumentSearchContext.ts

@@ -118,12 +118,14 @@ export class DocumentSearch implements SearchInterface {
     }
 
     _searchRequest(query: ComplexSearchQuery, limit: number, offset: number, includeFacets: boolean = true) {
-        const payload: ComplexSearchPayload = {
+        // Keep this as `satisfies`: the full-object overload depends on preserving the literal
+        // `select?: undefined` shape rather than widening to a generic ComplexSearchPayload.
+        const payload = {
             limit,
             offset,
             query,
             facets: includeFacets ? this.facetSpecs : undefined,
-        };
+        } satisfies ComplexSearchPayload;
 
         const request = this.collectionId
             ? this.client.collections.searchMembers(this.collectionId, payload)