@taskforcehq/taskforce 0.3.306 → 0.3.307

package/dist/components/features/DocumentViewer.js

@@ -4,7 +4,7 @@ import Markdown from 'react-markdown';
 import { renderToStaticMarkup } from 'react-dom/server';
 import remarkGfm from 'remark-gfm';
 import rehypeSanitize from 'rehype-sanitize';
-import { Printer, Link, Download, Clock, HardDrive, Tag, Pencil, X, Save, Eye, SplitSquareHorizontal, CheckCircle, AlertCircle, Zap, Trash2, MessageSquareText, Send, Bot, User, RotateCcw, CheckCheck } from 'lucide-react';
+import { Printer, Link, Download, Clock, HardDrive, Tag, Pencil, X, Save, Eye, SplitSquareHorizontal, CheckCircle, AlertCircle, Zap, Trash2, MessageSquareText, Send, Bot, User, RotateCcw, CheckCheck, ArrowLeft } from 'lucide-react';
 import styles from '../../Taskforce.module.css';
 import viewerStyles from './DocumentViewer.module.css';
 import taskFormStyles from '../task/TaskForm.module.css';
@@ -501,7 +501,7 @@ function toggleNthTaskCheckbox(markdown, targetIndex, nextChecked) {
     });
     return updated.join('\n');
 }
-export function DocumentViewer({ doc, taskTitle, tasks = [], apiBaseUrl = '', onSaved, onDeleted, enableTaskGeneration = false }) {
+export function DocumentViewer({ doc, taskTitle, tasks = [], apiBaseUrl = '', onSaved, onDeleted, onBackToTask, enableTaskGeneration = false }) {
     const fallbackReadableName = getReadableDocumentName(doc);
     const [currentDocumentName, setCurrentDocumentName] = useState(fallbackReadableName);
     const readableName = currentDocumentName;
@@ -554,7 +554,8 @@ export function DocumentViewer({ doc, taskTitle, tasks = [], apiBaseUrl = '', on
         const query = attachSearch.trim().toLowerCase();
         if (!query)
             return true;
-        return task.title.toLowerCase().includes(query);
+        return task.title.toLowerCase().includes(query)
+            || String(task.referenceLabel || '').trim().toLowerCase().includes(query);
     });
     const fetchContent = useCallback(async () => {
         setLoadingContent(true);
@@ -1276,7 +1277,7 @@ export function DocumentViewer({ doc, taskTitle, tasks = [], apiBaseUrl = '', on
                                         return;
                                     setRenameValue(readableName);
                                     setRenaming(true);
-                                }, children: readableName })), taskTitle && (_jsx("span", { className: viewerStyles.metaTaskName, title: `From task: ${taskTitle}`, children: taskTitle })), attachmentState === 'unattached' && (_jsx("span", { className: viewerStyles.statusBadge, children: "Unattached" })), doc.updatedAt && (_jsxs("span", { className: viewerStyles.metaDate, title: formatDate(doc.updatedAt), children: [_jsx(Clock, { size: 11 }), formatDate(doc.updatedAt)] })), _jsxs("span", { className: viewerStyles.metaSize, children: [_jsx(HardDrive, { size: 11 }), formatBytes(doc.sizeBytes)] }), documentReferenceLabel && (_jsx(ReferenceBadgeButton, { label: documentReferenceLabel, copied: copiedReference, onClick: () => { void handleCopyReference(); }, title: "Copy document reference" })), saveStatus.type === 'saved' && (_jsxs("span", { className: `${viewerStyles.saveStatus} ${viewerStyles.saveStatusSaved}`, children: [_jsx(CheckCircle, { size: 11 }), "Saved"] })), saveStatus.type === 'error' && (_jsxs("span", { className: `${viewerStyles.saveStatus} ${viewerStyles.saveStatusError}`, title: saveStatus.message, children: [_jsx(AlertCircle, { size: 11 }), saveStatus.message || 'Save failed'] })), isDirty && saveStatus.type !== 'saving' && (_jsx("span", { className: viewerStyles.unsaved, children: "Unsaved changes" }))] }), _jsx("div", { className: viewerStyles.actions, children: editMode ? (_jsxs(_Fragment, { children: [_jsxs("div", { className: viewerStyles.layoutToggle, children: [_jsx("button", { className: `${viewerStyles.layoutBtn} ${layout === 'editor' ? viewerStyles.layoutBtnActive : ''}`, onClick: () => setLayout('editor'), title: "Editor only", children: _jsx(Pencil, { size: 12 }) }), _jsx("button", { className: `${viewerStyles.layoutBtn} ${layout === 'split' ? viewerStyles.layoutBtnActive : ''}`, onClick: () => setLayout('split'), title: "Split view", children: _jsx(SplitSquareHorizontal, { size: 12 }) }), _jsx("button", { className: `${viewerStyles.layoutBtn} ${layout === 'preview' ? viewerStyles.layoutBtnActive : ''}`, onClick: () => setLayout('preview'), title: "Preview only", children: _jsx(Eye, { size: 12 }) })] }), _jsxs("button", { className: viewerStyles.actionBtn, onClick: handleCancelEdit, title: "Discard changes", children: [_jsx(X, { size: 13 }), "Cancel"] }), _jsxs("button", { className: `${viewerStyles.actionBtn} ${viewerStyles.saveBtn}`, onClick: handleSave, disabled: saveStatus.type === 'saving' || !isDirty, title: "Save (Ctrl+S)", children: [_jsx(Save, { size: 13 }), saveStatus.type === 'saving' ? 'Saving…' : 'Save'] })] })) : (_jsxs(_Fragment, { children: [doc.assetId && (_jsxs("button", { className: viewerStyles.actionBtn, onClick: () => setRenaming((prev) => !prev), title: "Rename document", children: [_jsx(Pencil, { size: 13 }), renaming ? 'Close Rename' : 'Rename'] })), isEditable && (_jsxs("button", { className: `${viewerStyles.actionBtn} ${viewerStyles.editBtn}`, onClick: handleEnterEdit, title: "Edit document", children: [_jsx(Pencil, { size: 13 }), "Edit"] })), doc.assetId && (_jsxs("button", { className: viewerStyles.actionBtn, onClick: handleOpenAttachModal, title: "Attach document to a task", children: [_jsx(Link, { size: 13 }), "Attach"] })), _jsxs("button", { className: viewerStyles.actionBtn, onClick: handleToggleReviewSidebar, title: showReviewSidebar ? 'Hide review and comments' : 'Show review and comments', children: [_jsx(MessageSquareText, { size: 13 }), showReviewSidebar ? 'Hide Review' : 'Show Review'] }), _jsxs("button", { className: viewerStyles.actionBtn, onClick: handleCopyLink, title: "Copy link", children: [_jsx(Link, { size: 13 }), copied ? 'Copied!' : 'Copy link'] }), _jsxs("button", { className: viewerStyles.actionBtn, onClick: handleDownload, title: "Download .md", children: [_jsx(Download, { size: 13 }), "Download"] }), _jsxs("button", { className: viewerStyles.actionBtn, onClick: handlePrint, title: "Print", children: [_jsx(Printer, { size: 13 }), "Print"] }), _jsxs("button", { className: viewerStyles.actionBtn, onClick: () => setMonochromeMode((prev) => !prev), title: "Toggle black and white style", children: [_jsx(Eye, { size: 13 }), monochromeMode ? 'Color' : 'B/W'] }), enableTaskGeneration && doc.docType === 'implementation-plan' && !editMode && (_jsxs("button", { className: `${viewerStyles.actionBtn} ${viewerStyles.generateBtn}`, onClick: () => setShowGenModal(true), title: "Generate tasks from this plan", children: [_jsx(Zap, { size: 13 }), "Generate Tasks"] })), canDelete && (_jsxs("button", { className: `${viewerStyles.actionBtn} ${viewerStyles.dangerBtn}`, onClick: () => { void handleDelete(); }, disabled: deleting, title: attachmentState === 'attached'
+                                }, children: readableName })), taskTitle && (_jsx("span", { className: viewerStyles.metaTaskName, title: `From task: ${taskTitle}`, children: taskTitle })), attachmentState === 'unattached' && (_jsx("span", { className: viewerStyles.statusBadge, children: "Unattached" })), doc.updatedAt && (_jsxs("span", { className: viewerStyles.metaDate, title: formatDate(doc.updatedAt), children: [_jsx(Clock, { size: 11 }), formatDate(doc.updatedAt)] })), _jsxs("span", { className: viewerStyles.metaSize, children: [_jsx(HardDrive, { size: 11 }), formatBytes(doc.sizeBytes)] }), documentReferenceLabel && (_jsx(ReferenceBadgeButton, { label: documentReferenceLabel, copied: copiedReference, onClick: () => { void handleCopyReference(); }, title: "Copy document reference" })), saveStatus.type === 'saved' && (_jsxs("span", { className: `${viewerStyles.saveStatus} ${viewerStyles.saveStatusSaved}`, children: [_jsx(CheckCircle, { size: 11 }), "Saved"] })), saveStatus.type === 'error' && (_jsxs("span", { className: `${viewerStyles.saveStatus} ${viewerStyles.saveStatusError}`, title: saveStatus.message, children: [_jsx(AlertCircle, { size: 11 }), saveStatus.message || 'Save failed'] })), isDirty && saveStatus.type !== 'saving' && (_jsx("span", { className: viewerStyles.unsaved, children: "Unsaved changes" }))] }), _jsx("div", { className: viewerStyles.actions, children: editMode ? (_jsxs(_Fragment, { children: [_jsxs("div", { className: viewerStyles.layoutToggle, children: [_jsx("button", { className: `${viewerStyles.layoutBtn} ${layout === 'editor' ? viewerStyles.layoutBtnActive : ''}`, onClick: () => setLayout('editor'), title: "Editor only", children: _jsx(Pencil, { size: 12 }) }), _jsx("button", { className: `${viewerStyles.layoutBtn} ${layout === 'split' ? viewerStyles.layoutBtnActive : ''}`, onClick: () => setLayout('split'), title: "Split view", children: _jsx(SplitSquareHorizontal, { size: 12 }) }), _jsx("button", { className: `${viewerStyles.layoutBtn} ${layout === 'preview' ? viewerStyles.layoutBtnActive : ''}`, onClick: () => setLayout('preview'), title: "Preview only", children: _jsx(Eye, { size: 12 }) })] }), _jsxs("button", { className: viewerStyles.actionBtn, onClick: handleCancelEdit, title: "Discard changes", children: [_jsx(X, { size: 13 }), "Cancel"] }), _jsxs("button", { className: `${viewerStyles.actionBtn} ${viewerStyles.saveBtn}`, onClick: handleSave, disabled: saveStatus.type === 'saving' || !isDirty, title: "Save (Ctrl+S)", children: [_jsx(Save, { size: 13 }), saveStatus.type === 'saving' ? 'Saving…' : 'Save'] })] })) : (_jsxs(_Fragment, { children: [doc.taskId && onBackToTask && (_jsxs("button", { className: viewerStyles.actionBtn, onClick: () => onBackToTask(doc.taskId), title: "Back to task", "aria-label": "Back to task", children: [_jsx(ArrowLeft, { size: 13 }), "Back to task"] })), doc.assetId && (_jsxs("button", { className: viewerStyles.actionBtn, onClick: () => setRenaming((prev) => !prev), title: "Rename document", children: [_jsx(Pencil, { size: 13 }), renaming ? 'Close Rename' : 'Rename'] })), isEditable && (_jsxs("button", { className: `${viewerStyles.actionBtn} ${viewerStyles.editBtn}`, onClick: handleEnterEdit, title: "Edit document", children: [_jsx(Pencil, { size: 13 }), "Edit"] })), doc.assetId && (_jsxs("button", { className: viewerStyles.actionBtn, onClick: handleOpenAttachModal, title: "Attach document to a task", children: [_jsx(Link, { size: 13 }), "Attach"] })), _jsxs("button", { className: viewerStyles.actionBtn, onClick: handleToggleReviewSidebar, title: showReviewSidebar ? 'Hide review and comments' : 'Show review and comments', children: [_jsx(MessageSquareText, { size: 13 }), showReviewSidebar ? 'Hide Review' : 'Show Review'] }), _jsxs("button", { className: viewerStyles.actionBtn, onClick: handleCopyLink, title: "Copy link", children: [_jsx(Link, { size: 13 }), copied ? 'Copied!' : 'Copy link'] }), _jsxs("button", { className: viewerStyles.actionBtn, onClick: handleDownload, title: "Download .md", children: [_jsx(Download, { size: 13 }), "Download"] }), _jsxs("button", { className: viewerStyles.actionBtn, onClick: handlePrint, title: "Print", children: [_jsx(Printer, { size: 13 }), "Print"] }), _jsxs("button", { className: viewerStyles.actionBtn, onClick: () => setMonochromeMode((prev) => !prev), title: "Toggle black and white style", children: [_jsx(Eye, { size: 13 }), monochromeMode ? 'Color' : 'B/W'] }), enableTaskGeneration && doc.docType === 'implementation-plan' && !editMode && (_jsxs("button", { className: `${viewerStyles.actionBtn} ${viewerStyles.generateBtn}`, onClick: () => setShowGenModal(true), title: "Generate tasks from this plan", children: [_jsx(Zap, { size: 13 }), "Generate Tasks"] })), canDelete && (_jsxs("button", { className: `${viewerStyles.actionBtn} ${viewerStyles.dangerBtn}`, onClick: () => { void handleDelete(); }, disabled: deleting, title: attachmentState === 'attached'
                                         ? 'Remove this document from linked tasks and delete it'
                                         : 'Permanently delete this unattached document', children: [_jsx(Trash2, { size: 13 }), deleting
                                             ? 'Deleting…'
@@ -1310,6 +1311,6 @@ export function DocumentViewer({ doc, taskTitle, tasks = [], apiBaseUrl = '', on
                 }, title: "Attach document", size: "md", footer: (_jsx("button", { className: viewerStyles.actionBtn, onClick: () => setAttachModalOpen(false), disabled: Boolean(attachingTaskId), children: "Close" })), children: _jsxs("div", { className: viewerStyles.attachModalBody, children: [_jsx("p", { className: viewerStyles.attachModalCopy, children: "Attach this document to a task from the document manager. Initiative and workstream targets can be enabled later on the same attachment model." }), _jsx("input", { type: "text", className: styles.input, placeholder: "Search tasks\u2026", value: attachSearch, onChange: (event) => setAttachSearch(event.target.value) }), attachError && (_jsxs("div", { className: viewerStyles.attachModalError, children: [_jsx(AlertCircle, { size: 14 }), _jsx("span", { children: attachError })] })), _jsx("div", { className: `${viewerStyles.attachTaskList} tf-scrollbar`, children: filteredTasks.length === 0 ? (_jsx("div", { className: viewerStyles.attachEmptyState, children: tasks.length === 0 ? 'No tasks are available in this workspace.' : 'No tasks match your search.' })) : (filteredTasks.map((task) => {
                                 const isCurrentPrimaryAttachment = doc.taskId === task.id;
                                 const isBusy = attachingTaskId === task.id;
-                                return (_jsxs("button", { type: "button", className: viewerStyles.attachTaskRow, disabled: isBusy, onClick: () => { void handleAttachToTask(task.id); }, children: [_jsx("span", { className: viewerStyles.attachTaskTitle, children: task.title }), _jsx("span", { className: viewerStyles.attachTaskMeta, children: isBusy ? 'Attaching…' : isCurrentPrimaryAttachment ? 'Attached' : 'Attach' })] }, task.id));
+                                return (_jsxs("button", { type: "button", className: viewerStyles.attachTaskRow, disabled: isBusy, onClick: () => { void handleAttachToTask(task.id); }, children: [_jsxs("span", { className: viewerStyles.attachTaskInfo, children: [_jsx("span", { className: viewerStyles.attachTaskTitle, children: task.title }), task.referenceLabel && (_jsx("span", { className: viewerStyles.attachTaskReference, children: task.referenceLabel }))] }), _jsx("span", { className: viewerStyles.attachTaskMeta, children: isBusy ? 'Attaching…' : isCurrentPrimaryAttachment ? 'Attached' : 'Attach' })] }, task.id));
                             })) })] }) }), !editMode && (_jsx("div", { className: viewerStyles.printHint, children: "For the cleanest output, disable browser Headers and footers in the print dialog." }))] }));
 }

package/dist/components/features/DocumentWorkspace.d.ts

@@ -7,6 +7,7 @@ interface Props {
     tasks: Array<{
         id: string;
         title: string;
+        referenceLabel?: string | null;
     }>;
     apiBaseUrl?: string;
     documents: DocMeta[];
@@ -15,16 +16,20 @@ interface Props {
     selectedDoc: DocMeta | null;
     searchQuery: string;
     hasActiveFilters: boolean;
+    documentTrayOpen?: boolean;
     onSearchChange: (value: string) => void;
     onSelectDoc: (doc: DocMeta | null) => void;
     onRefresh: () => Promise<void> | void;
+    onCloseDocumentTray?: () => void;
     onDeleteSelected: () => Promise<void> | void;
+    onBackToTask?: (taskId: string) => void;
     enableTaskGeneration?: boolean;
 }
 interface ShellProps {
     tasks: Array<{
         id: string;
         title: string;
+        referenceLabel?: string | null;
     }>;
     runtimeMode?: 'local' | 'cloud';
     apiBaseUrl?: string;
@@ -33,10 +38,13 @@ interface ShellProps {
     attachmentFilters?: DocumentAttachmentFilter[];
     onTypeFiltersChange?: (values: DocumentTypeFilter[]) => void;
     onAttachmentFiltersChange?: (values: DocumentAttachmentFilter[]) => void;
+    documentTrayOpen?: boolean;
+    onCloseDocumentTray?: () => void;
     requestedDocPath?: string | null;
     requestedDocAssetId?: string | null;
     onRequestedDocHandled?: () => void;
+    onBackToTask?: (taskId: string) => void;
     enableTaskGeneration?: boolean;
 }
-export declare function DocumentWorkspace({ tasks, apiBaseUrl, documents, loading, error, selectedDoc, searchQuery, hasActiveFilters, onSearchChange, onSelectDoc, onRefresh, onDeleteSelected, enableTaskGeneration }: Props): import("react/jsx-runtime").JSX.Element;
-export declare function DocumentWorkspaceShell({ tasks, runtimeMode, apiBaseUrl, cloudAuthBaseUrl, typeFilters: controlledTypeFilters, attachmentFilters: controlledAttachmentFilters, onTypeFiltersChange, onAttachmentFiltersChange, requestedDocPath, requestedDocAssetId, onRequestedDocHandled, enableTaskGeneration }: ShellProps): import("react/jsx-runtime").JSX.Element;
+export declare function DocumentWorkspace({ tasks, apiBaseUrl, documents, loading, error, selectedDoc, searchQuery, hasActiveFilters, documentTrayOpen, onSearchChange, onSelectDoc, onRefresh, onCloseDocumentTray, onDeleteSelected, onBackToTask, enableTaskGeneration }: Props): import("react/jsx-runtime").JSX.Element;
+export declare function DocumentWorkspaceShell({ tasks, runtimeMode, apiBaseUrl, cloudAuthBaseUrl, typeFilters: controlledTypeFilters, attachmentFilters: controlledAttachmentFilters, onTypeFiltersChange, onAttachmentFiltersChange, documentTrayOpen, onCloseDocumentTray, requestedDocPath, requestedDocAssetId, onRequestedDocHandled, onBackToTask, enableTaskGeneration }: ShellProps): import("react/jsx-runtime").JSX.Element;

package/dist/components/features/DocumentWorkspace.js

@@ -1,14 +1,17 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import React from 'react';
 import styles from '../../Taskforce.module.css';
 import { DocumentIndex } from './DocumentIndex';
 import { DocumentViewer } from './DocumentViewer';
 import { useDocumentWorkspaceController } from './useDocumentWorkspaceController';
 export { DOCUMENT_TYPE_FILTER_OPTIONS, DOCUMENT_ATTACHMENT_FILTER_OPTIONS } from './documentWorkspaceFilters';
-export function DocumentWorkspace({ tasks, apiBaseUrl = '', documents, loading, error, selectedDoc, searchQuery, hasActiveFilters, onSearchChange, onSelectDoc, onRefresh, onDeleteSelected, enableTaskGeneration = false }) {
+export function DocumentWorkspace({ tasks, apiBaseUrl = '', documents, loading, error, selectedDoc, searchQuery, hasActiveFilters, documentTrayOpen, onSearchChange, onSelectDoc, onRefresh, onCloseDocumentTray, onDeleteSelected, onBackToTask, enableTaskGeneration = false }) {
     const taskById = new Map(tasks.map(t => [t.id, t]));
-    return (_jsxs("div", { className: styles.docWorkspace, children: [_jsx("div", { className: styles.docIndexPanel, children: _jsx(DocumentIndex, { documents: documents, selectedDocId: selectedDoc?.id ?? null, loading: loading, error: error, searchQuery: searchQuery, onSearchChange: onSearchChange, onSelect: (doc) => onSelectDoc(doc), onRefresh: onRefresh, taskById: taskById, hasActiveFilters: hasActiveFilters }) }), _jsx("div", { className: styles.docViewerPanel, children: selectedDoc ? (_jsx(DocumentViewer, { doc: selectedDoc, taskTitle: selectedDoc.taskId ? (taskById.get(selectedDoc.taskId)?.title ?? null) : null, tasks: tasks, apiBaseUrl: apiBaseUrl, onSaved: (_updatedAt) => onRefresh(), onDeleted: () => void onDeleteSelected(), enableTaskGeneration: enableTaskGeneration })) : !loading && (_jsx("div", { className: styles.docViewerEmpty, children: _jsx("p", { className: "tf-empty-copy", children: documents.length === 0 ? 'No documents match your current filters.' : 'Select a document to view it.' }) })) })] }));
+    const useTrayIndex = typeof documentTrayOpen === 'boolean';
+    const documentIndex = (_jsx(DocumentIndex, { documents: documents, selectedDocId: selectedDoc?.id ?? null, loading: loading, error: error, searchQuery: searchQuery, onSearchChange: onSearchChange, onSelect: (doc) => onSelectDoc(doc), onCloseTray: useTrayIndex ? onCloseDocumentTray : undefined, taskById: taskById, hasActiveFilters: hasActiveFilters }));
+    return (_jsxs("div", { className: `${styles.docWorkspace} ${useTrayIndex ? styles.docWorkspaceTrayMode : ''} ${useTrayIndex && documentTrayOpen ? styles.docWorkspaceTrayOpen : ''}`.trim(), children: [useTrayIndex ? (_jsx("div", { className: `${styles.docTrayPanel} ${documentTrayOpen ? styles.docTrayPanelOpen : ''}`.trim(), "aria-hidden": !documentTrayOpen, children: documentIndex })) : (_jsx("div", { className: styles.docIndexPanel, children: documentIndex })), _jsx("div", { className: styles.docViewerPanel, children: selectedDoc ? (_jsx(DocumentViewer, { doc: selectedDoc, taskTitle: selectedDoc.taskId ? (taskById.get(selectedDoc.taskId)?.title ?? null) : null, tasks: tasks, apiBaseUrl: apiBaseUrl, onSaved: (_updatedAt) => onRefresh(), onDeleted: () => void onDeleteSelected(), onBackToTask: onBackToTask, enableTaskGeneration: enableTaskGeneration })) : !loading && (_jsx("div", { className: styles.docViewerEmpty, children: _jsx("p", { className: "tf-empty-copy", children: documents.length === 0 ? 'No documents match your current filters.' : 'Select a document to view it.' }) })) })] }));
 }
-export function DocumentWorkspaceShell({ tasks, runtimeMode = 'local', apiBaseUrl = '', cloudAuthBaseUrl = '', typeFilters: controlledTypeFilters, attachmentFilters: controlledAttachmentFilters, onTypeFiltersChange, onAttachmentFiltersChange, requestedDocPath = null, requestedDocAssetId = null, onRequestedDocHandled, enableTaskGeneration = false }) {
+export function DocumentWorkspaceShell({ tasks, runtimeMode = 'local', apiBaseUrl = '', cloudAuthBaseUrl = '', typeFilters: controlledTypeFilters, attachmentFilters: controlledAttachmentFilters, onTypeFiltersChange, onAttachmentFiltersChange, documentTrayOpen, onCloseDocumentTray, requestedDocPath = null, requestedDocAssetId = null, onRequestedDocHandled, onBackToTask, enableTaskGeneration = false }) {
     const { documentApiBaseUrl, filteredDocs, loading, error, selectedDoc, searchQuery, hasActiveFilters, setSearchQuery, fetchDocuments, selectDoc, handleDeleteSelected, } = useDocumentWorkspaceController({
         runtimeMode,
         apiBaseUrl,
@@ -21,5 +24,13 @@ export function DocumentWorkspaceShell({ tasks, runtimeMode = 'local', apiBaseUr
         requestedDocAssetId,
         onRequestedDocHandled,
     });
-    return (_jsx(DocumentWorkspace, { tasks: tasks, apiBaseUrl: documentApiBaseUrl, documents: filteredDocs, loading: loading, error: error, selectedDoc: selectedDoc, searchQuery: searchQuery, hasActiveFilters: hasActiveFilters, onSearchChange: setSearchQuery, onSelectDoc: selectDoc, onRefresh: fetchDocuments, onDeleteSelected: handleDeleteSelected, enableTaskGeneration: enableTaskGeneration }));
+    const previousDocumentTrayOpenRef = React.useRef(documentTrayOpen);
+    React.useEffect(() => {
+        const wasOpen = previousDocumentTrayOpenRef.current === true;
+        previousDocumentTrayOpenRef.current = documentTrayOpen;
+        if (documentTrayOpen !== true || wasOpen)
+            return;
+        void fetchDocuments();
+    }, [documentTrayOpen, fetchDocuments]);
+    return (_jsx(DocumentWorkspace, { tasks: tasks, apiBaseUrl: documentApiBaseUrl, documents: filteredDocs, loading: loading, error: error, selectedDoc: selectedDoc, searchQuery: searchQuery, hasActiveFilters: hasActiveFilters, documentTrayOpen: documentTrayOpen, onSearchChange: setSearchQuery, onSelectDoc: selectDoc, onRefresh: fetchDocuments, onCloseDocumentTray: onCloseDocumentTray, onDeleteSelected: handleDeleteSelected, onBackToTask: onBackToTask, enableTaskGeneration: enableTaskGeneration }));
 }

package/dist/components/features/DocumentWorkspace.test.js

@@ -45,7 +45,7 @@ function createEmptyReviewSessionsResponse() {
     };
 }
 function renderDocumentWorkspace(props) {
-    return render(_jsx(DocumentWorkspace, { tasks: props.tasks ?? [], documents: props.documents, loading: false, error: null, selectedDoc: props.selectedDoc ?? null, searchQuery: props.searchQuery ?? '', hasActiveFilters: props.hasActiveFilters ?? false, onSearchChange: props.onSearchChange ?? (() => { }), onSelectDoc: props.onSelectDoc ?? (() => { }), onRefresh: props.onRefresh ?? (() => { }), onDeleteSelected: props.onDeleteSelected ?? (() => { }) }));
+    return render(_jsx(DocumentWorkspace, { tasks: props.tasks ?? [], documents: props.documents, loading: false, error: null, selectedDoc: props.selectedDoc ?? null, searchQuery: props.searchQuery ?? '', hasActiveFilters: props.hasActiveFilters ?? false, documentTrayOpen: props.documentTrayOpen, onSearchChange: props.onSearchChange ?? (() => { }), onSelectDoc: props.onSelectDoc ?? (() => { }), onRefresh: props.onRefresh ?? (() => { }), onDeleteSelected: props.onDeleteSelected ?? (() => { }) }));
 }
 describe('Document workspace management', () => {
     beforeEach(() => {
@@ -97,6 +97,16 @@ describe('Document workspace management', () => {
         expect(screen.queryByRole('button', { name: /Attached notes/i })).not.toBeInTheDocument();
         expect(screen.getByText('Unattached')).toBeInTheDocument();
     });
+    it('can render the document index as a collapsible tray', () => {
+        const docs = [createDoc({ id: 'tray-doc', displayName: 'Tray Document' })];
+        const { container, rerender } = renderDocumentWorkspace({
+            documents: docs,
+            documentTrayOpen: true,
+        });
+        expect(container.querySelector('[aria-hidden="false"]')).toHaveTextContent('Tray Document');
+        rerender(_jsx(DocumentWorkspace, { tasks: [], documents: docs, loading: false, error: null, selectedDoc: null, searchQuery: "", hasActiveFilters: false, documentTrayOpen: false, onSearchChange: () => { }, onSelectDoc: () => { }, onRefresh: () => { }, onDeleteSelected: () => { } }));
+        expect(container.querySelector('[aria-hidden="true"]')).toHaveTextContent('Tray Document');
+    });
     it('keeps document search in the index without duplicate filter controls', () => {
         renderDocumentWorkspace({ documents: [createDoc()] });
         expect(screen.getByPlaceholderText('Search documents…')).toBeInTheDocument();
@@ -164,12 +174,19 @@ describe('Document workspace management', () => {
                 attachmentCount: 0,
                 attachmentState: 'unattached',
             }), taskTitle: null, tasks: [
-                { id: 'task-1', title: 'First attach target' },
-                { id: 'task-2', title: 'Second attach target' },
+                { id: 'task-1', title: 'First attach target', referenceLabel: 'T-11' },
+                { id: 'task-2', title: 'Second attach target', referenceLabel: 'T-12' },
             ], onSaved: onSaved }));
         await waitFor(() => expect(fetchTaskforceApi).toHaveBeenCalledWith('/api/taskforce/documents/asset-doc-1/content', { credentials: 'same-origin' }, ''));
         await user.click(screen.getByRole('button', { name: /^Attach$/i }));
         expect(screen.getByText(/Attach this document to a task from the document manager/i)).toBeInTheDocument();
+        expect(screen.getByText('T-11')).toBeInTheDocument();
+        expect(screen.getByText('T-12')).toBeInTheDocument();
+        await user.clear(screen.getByPlaceholderText('Search tasks…'));
+        await user.type(screen.getByPlaceholderText('Search tasks…'), 'T-12');
+        expect(screen.queryByRole('button', { name: /First attach target/i })).not.toBeInTheDocument();
+        expect(screen.getByRole('button', { name: /Second attach target/i })).toBeInTheDocument();
+        await user.clear(screen.getByPlaceholderText('Search tasks…'));
         await user.type(screen.getByPlaceholderText('Search tasks…'), 'Second');
         await user.click(screen.getByRole('button', { name: /Second attach target/i }));
         await waitFor(() => expect(fetchTaskforceApi).toHaveBeenLastCalledWith('/api/taskforce/documents/asset-doc-attach/attach', expect.objectContaining({

package/dist/components/features/TaskSettings.d.ts

@@ -208,11 +208,13 @@ export interface TaskSettingsModel {
         cleanupWarnings?: string[];
     }>;
     onMcpHostRootChange?: (value: string) => void;
+    onOpenCloudAuth?: (mode: 'login' | 'register') => void;
     isAuthenticated?: boolean;
 }
 interface TaskSettingsProps {
     settingsModel: TaskSettingsModel;
     onSectionChange?: (section: any) => void;
+    renderMode?: 'full' | 'mcp-only';
 }
 export declare function TaskSettings(props: TaskSettingsProps): import("react/jsx-runtime").JSX.Element;
 export {};