@elizaos/ui 2.0.0-beta.1 → 2.0.3-beta.2

package/components/pages/DocumentsView.js

@@ -0,0 +1,737 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { BadgeCheck, Bot, FileSearch, FileText, Globe2, Layers, Lock, Shield, User, } from "lucide-react";
+import { useCallback, useEffect, useMemo, useRef, useState, } from "react";
+import { useAgentElement } from "../../agent-surface/index.js";
+import { client } from "../../api/client.js";
+import { isApiError } from "../../api/client-types-core.js";
+import { getCached, setCached } from "../../hooks/resource-cache.js";
+import { useApp } from "../../state/useApp.js";
+import { useRegisterViewChatBinding } from "../../state/view-chat-binding.js";
+import { confirmDesktopAction } from "../../utils/desktop-dialogs.js";
+import { isDocumentImageFile, MAX_DOCUMENT_IMAGE_PROCESSING_BYTES, maybeCompressDocumentUploadImage, } from "../../utils/documents-upload-image.js";
+import { formatByteSize } from "../../utils/format.js";
+import { ChatSearchHint } from "../composites/chat-search-hint.js";
+import { PagePanel } from "../composites/page-panel/index.js";
+import { ConfirmDeleteControl } from "../shared/confirm-delete-control.js";
+import { Button } from "../ui/button.js";
+import { ListSkeleton } from "../ui/skeleton-layouts.js";
+import { DocumentViewer } from "./documents-detail.js";
+import { getDocumentSummary, getDocumentTypeLabel, } from "./documents-detail.helpers.js";
+import { UploadZone } from "./documents-upload.js";
+import { BULK_UPLOAD_TARGET_BYTES, DEFAULT_DOCUMENT_UPLOAD_SCOPE, DOCUMENT_UPLOAD_ACCEPT, getDocumentUploadFilename, isSupportedDocumentFile, LARGE_FILE_WARNING_BYTES, MAX_BULK_REQUEST_DOCUMENTS, MAX_UPLOAD_REQUEST_BYTES, shouldReadDocumentFileAsText, } from "./documents-upload.helpers.js";
+const SCOPE_FILTER_OPTIONS = [
+    {
+        value: "all",
+        labelKey: "documentsview.ScopeAll",
+        defaultLabel: "All",
+        Icon: Layers,
+    },
+    {
+        value: "global",
+        labelKey: "documentsview.ScopeGlobal",
+        defaultLabel: "Global",
+        Icon: Globe2,
+    },
+    {
+        value: "owner-private",
+        labelKey: "documentsview.ScopeOwner",
+        defaultLabel: "Owner",
+        Icon: Shield,
+    },
+    {
+        value: "user-private",
+        labelKey: "documentsview.ScopeUser",
+        defaultLabel: "User",
+        Icon: User,
+    },
+    {
+        value: "agent-private",
+        labelKey: "documentsview.ScopeAgent",
+        defaultLabel: "Agent",
+        Icon: Bot,
+    },
+];
+/* ── Scope Filter Chip ──────────────────────────────────────────────── */
+function ScopeFilterChip({ value, label, Icon, active, onSelect, }) {
+    const { ref, agentProps } = useAgentElement({
+        id: `scope-${value}`,
+        role: "tab",
+        label,
+        group: "documents-scope",
+        status: active ? "active" : "inactive",
+        description: `Filter documents to the ${label} scope`,
+        onActivate: () => onSelect(value),
+    });
+    return (_jsxs("button", { ref: ref, ...agentProps, type: "button", "aria-pressed": active, "aria-current": active ? "page" : undefined, onClick: () => onSelect(value), className: `inline-flex items-center gap-1 rounded-full border px-2 py-0.5 text-2xs font-semibold transition-colors ${active
+            ? "border-accent/45 bg-accent/12 text-accent-fg"
+            : "border-border/30 bg-bg-muted/20 text-muted hover:border-border/55 hover:text-txt"}`, children: [_jsx(Icon, { className: "h-3 w-3", "aria-hidden": true }), label] }));
+}
+/* ── Search Result Item ─────────────────────────────────────────────── */
+function SearchResultListItem({ result, active, onSelect, }) {
+    const { t } = useApp();
+    const documentId = result.documentId || result.id;
+    const title = result.documentTitle ||
+        t("documentsview.UnknownDocument", {
+            defaultValue: "Unknown Document",
+        });
+    const { ref, agentProps } = useAgentElement({
+        id: `result-${result.id}`,
+        role: "list-item",
+        label: title,
+        group: "documents-results",
+        status: active ? "active" : "inactive",
+        description: `Open search result "${title}"`,
+        onActivate: () => onSelect(documentId),
+    });
+    return (_jsxs("button", { ref: ref, ...agentProps, onClick: () => onSelect(documentId), type: "button", "aria-current": active ? "page" : undefined, className: `group flex w-full items-start px-0 py-3 text-left transition-colors ${active ? "bg-transparent" : "bg-transparent hover:bg-bg-hover"}`, children: [_jsxs("span", { className: `mt-0.5 flex h-8 w-8 shrink-0 items-center justify-center rounded-full border text-2xs font-bold ${active
+                    ? "border-accent/25 bg-accent/10 text-accent-fg"
+                    : "border-border/15 bg-transparent text-muted-strong"}`, children: [(result.similarity * 100).toFixed(0), "%"] }), _jsxs("div", { className: "min-w-0 flex-1", children: [_jsxs("div", { className: "flex min-w-0 items-center gap-1.5", children: [_jsx(FileSearch, { className: "h-3.5 w-3.5 shrink-0 text-muted", "aria-hidden": true }), _jsx("div", { className: "truncate text-sm font-semibold text-txt", children: title })] }), _jsx("div", { className: "mt-1 line-clamp-2 text-xs text-muted", children: result.text })] })] }));
+}
+/* ── Document Card ──────────────────────────────────────────────────── */
+function DocumentListItem({ doc, active, onSelect, onDelete, deleting, }) {
+    const { t } = useApp();
+    const scopeLabel = doc.scope === "owner-private"
+        ? t("documentsview.ScopeOwner", { defaultValue: "Owner" })
+        : doc.scope === "user-private"
+            ? t("documentsview.ScopeUser", { defaultValue: "User" })
+            : doc.scope === "agent-private"
+                ? t("documentsview.ScopeAgent", { defaultValue: "Agent" })
+                : t("documentsview.ScopeGlobal", { defaultValue: "Global" });
+    const ScopeIcon = doc.scope === "owner-private"
+        ? Shield
+        : doc.scope === "user-private"
+            ? User
+            : doc.scope === "agent-private"
+                ? Bot
+                : Globe2;
+    const { ref, agentProps } = useAgentElement({
+        id: `document-${doc.id}`,
+        role: "list-item",
+        label: doc.filename,
+        group: "documents-list",
+        status: active ? "active" : "inactive",
+        description: `Open document "${doc.filename}"`,
+        onActivate: () => onSelect(doc.id),
+    });
+    return (_jsxs("div", { className: `group relative flex w-full transition-colors ${active ? "bg-transparent" : "bg-transparent hover:bg-bg-hover"}`, children: [_jsxs("button", { ref: ref, ...agentProps, type: "button", onClick: () => onSelect(doc.id), "aria-label": t("documentsview.OpenDocument", {
+                    defaultValue: "Open {{filename}}",
+                    filename: doc.filename,
+                }), "aria-current": active ? "page" : undefined, title: doc.filename, className: "flex min-w-0 flex-1 items-center gap-3 px-3.5 py-3 text-left", children: [_jsx("span", { className: `flex h-8 w-8 shrink-0 items-center justify-center rounded-sm border ${active
+                            ? "border-accent/30 bg-accent/10 text-accent"
+                            : "border-border/30 bg-bg-muted/20 text-muted"}`, children: _jsx(FileText, { className: "h-4 w-4", "aria-hidden": true }) }), _jsxs("div", { className: "min-w-0 flex-1", children: [_jsx("div", { className: "truncate text-sm font-semibold leading-snug text-txt", children: doc.filename }), _jsx("div", { className: "mt-1 truncate text-xs text-muted", children: getDocumentSummary(doc, t) }), _jsxs("div", { className: "mt-1 flex flex-wrap items-center gap-1.5 text-2xs text-muted/70", children: [_jsxs("span", { className: "inline-flex items-center gap-1 rounded-full border border-accent/20 bg-accent/8 px-1.5 py-0.5 text-accent-fg", children: [_jsx(ScopeIcon, { className: "h-3 w-3", "aria-hidden": true }), scopeLabel] }), _jsx("span", { className: "rounded-full border border-border/30 bg-bg-muted/20 px-1.5 py-0.5", children: getDocumentTypeLabel(doc.contentType) }), doc.canEditText ? (_jsxs("span", { className: "inline-flex items-center gap-1 rounded-full border border-status-success/25 bg-status-success-bg px-1.5 py-0.5 text-status-success", children: [_jsx(BadgeCheck, { className: "h-3 w-3", "aria-hidden": true }), t("documentsview.Editable", { defaultValue: "editable" })] })) : null, !doc.canDelete ? (_jsxs("span", { className: "inline-flex items-center gap-1 rounded-full border border-border/30 bg-bg-muted/20 px-1.5 py-0.5", children: [_jsx(Lock, { className: "h-3 w-3", "aria-hidden": true }), t("documentsview.Locked", { defaultValue: "locked" })] })) : null] })] })] }), _jsx("span", { className: "absolute right-2 top-2 opacity-100 transition-opacity sm:opacity-0 sm:group-hover:opacity-100 focus-within:opacity-100", children: _jsx(ConfirmDeleteControl, { triggerClassName: "h-7 rounded-sm border border-transparent px-2 text-2xs font-bold !bg-transparent text-danger/70 transition-all hover:!bg-danger/12 hover:border-danger/25 hover:text-danger", confirmClassName: "h-7 rounded-sm border border-danger/25 bg-danger/14 px-2 text-2xs font-bold text-danger transition-all hover:bg-danger/20", cancelClassName: "h-7 rounded-sm border border-border/35 px-2 text-2xs font-bold text-muted-strong transition-all hover:border-border-strong hover:text-txt", disabled: deleting || !doc.canDelete, busyLabel: "...", onConfirm: () => onDelete(doc.id) }) })] }));
+}
+/* ── Compact strip chips ────────────────────────────────────────────── */
+function CompactSearchChip({ result, active, onSelect, }) {
+    const { t } = useApp();
+    const id = result.documentId || result.id;
+    const title = result.documentTitle ||
+        t("documentsview.UnknownDocument", {
+            defaultValue: "Unknown Document",
+        });
+    const { ref, agentProps } = useAgentElement({
+        id: `result-${result.id}`,
+        role: "list-item",
+        label: title,
+        group: "documents-results",
+        status: active ? "active" : "inactive",
+        description: `Open search result "${title}"`,
+        onActivate: () => onSelect(id),
+    });
+    return (_jsxs("button", { ref: ref, ...agentProps, type: "button", onClick: () => onSelect(id), className: `inline-flex max-w-[16rem] shrink-0 items-center gap-2 rounded-full border px-3 py-1.5 text-xs font-semibold transition ${active
+            ? "border-accent/45 bg-accent/12 text-accent-fg"
+            : "border-border/30 bg-bg-muted/20 text-muted hover:text-txt"}`, children: [_jsx(FileSearch, { className: "h-3.5 w-3.5", "aria-hidden": true }), _jsx("span", { className: "truncate", children: title })] }));
+}
+function CompactDocChip({ doc, active, onSelect, }) {
+    const { ref, agentProps } = useAgentElement({
+        id: `document-${doc.id}`,
+        role: "list-item",
+        label: doc.filename,
+        group: "documents-list",
+        status: active ? "active" : "inactive",
+        description: `Open document "${doc.filename}"`,
+        onActivate: () => onSelect(doc.id),
+    });
+    return (_jsxs("button", { ref: ref, ...agentProps, type: "button", onClick: () => onSelect(doc.id), className: `inline-flex max-w-[16rem] shrink-0 items-center gap-2 rounded-full border px-3 py-1.5 text-xs font-semibold transition ${active
+            ? "border-accent/45 bg-accent/12 text-accent-fg"
+            : "border-border/30 bg-bg-muted/20 text-muted hover:text-txt"}`, children: [_jsx(FileText, { className: "h-3.5 w-3.5", "aria-hidden": true }), _jsx("span", { className: "truncate", children: doc.filename })] }));
+}
+/* ── Main DocumentsView Component ───────────────────────────────────── */
+export function DocumentsView({ fileInputId, inModal, embedded = false, onDocumentsChange, onSelectedDocumentIdChange, selectedDocumentId, showSelectorRail, } = {}) {
+    const { t } = useApp();
+    const { setActionNotice } = useApp();
+    const setActionNoticeRef = useRef(setActionNotice);
+    setActionNoticeRef.current = setActionNotice;
+    const [searchQuery, setSearchQuery] = useState("");
+    const [scopeFilter, setScopeFilter] = useState("all");
+    // The active view drives the one floating chat composer as its search box:
+    // each keystroke flows in via onQuery, filtering documents in place.
+    const handleSearchQuery = useCallback((value) => {
+        setSearchQuery(value);
+        // Clearing the draft drops out of any live search-results view.
+        setSearchResults((prev) => (prev !== null ? null : prev));
+    }, []);
+    const searchBinding = useMemo(() => ({
+        placeholder: t("documents.ui.searchPlaceholder"),
+        onQuery: handleSearchQuery,
+    }), [t, handleSearchQuery]);
+    useRegisterViewChatBinding(searchBinding);
+    // Seed from the shared cache so a revisit paints the last-known documents
+    // instantly and revalidates silently, instead of flashing a spinner.
+    const documentsCacheKey = `documents:list:${scopeFilter}`;
+    const cachedDocuments = getCached(documentsCacheKey);
+    const [documents, setDocuments] = useState(cachedDocuments?.data ?? []);
+    const [searchResults, setSearchResults] = useState(null);
+    const [loading, setLoading] = useState(!cachedDocuments);
+    const [uploading, setUploading] = useState(false);
+    const [uploadStatus, setUploadStatus] = useState(null);
+    const [deleting, setDeleting] = useState(null);
+    const [internalSelectedDocId, setInternalSelectedDocId] = useState(null);
+    const [loadError, setLoadError] = useState(null);
+    // Set when GET /api/documents 404s — the documents plugin isn't mounted on
+    // this surface (e.g. the mobile/Android agent). Degrade to a calm
+    // "unavailable here" panel instead of a red error + Retry loop.
+    const [documentsUnavailable, setDocumentsUnavailable] = useState(false);
+    const [isServiceLoading, setIsServiceLoading] = useState(false);
+    const serviceRetryRef = useRef(0);
+    const selectedDocId = selectedDocumentId ?? internalSelectedDocId;
+    const setSelectedDocId = useCallback((documentId) => {
+        if (selectedDocumentId === undefined) {
+            setInternalSelectedDocId(documentId);
+        }
+        onSelectedDocumentIdChange?.(documentId);
+    }, [onSelectedDocumentIdChange, selectedDocumentId]);
+    const shouldRenderSelectorRail = showSelectorRail !== false;
+    const useCompactSelectorRail = embedded;
+    const loadData = useCallback(async (options) => {
+        if (!options?.silent)
+            setLoading(true);
+        setLoadError(null);
+        try {
+            const docsRes = await client.listDocuments({
+                limit: 100,
+                ...(scopeFilter !== "all" ? { scope: scopeFilter } : {}),
+            });
+            setDocuments(docsRes.documents);
+            setCached(`documents:list:${scopeFilter}`, docsRes.documents);
+            onDocumentsChange?.(docsRes.documents);
+            setIsServiceLoading(false);
+            setDocumentsUnavailable(false);
+            serviceRetryRef.current = 0;
+        }
+        catch (err) {
+            // A 404 means the documents plugin isn't mounted on this surface
+            // (the mobile/Android agent omits it). Treat it as "unavailable here"
+            // — a calm panel, not a red error + Retry loop.
+            if (isApiError(err) && err.status === 404) {
+                setIsServiceLoading(false);
+                setDocumentsUnavailable(true);
+                return;
+            }
+            const status = err.status;
+            if (status === 503) {
+                setIsServiceLoading(true);
+            }
+            else {
+                setIsServiceLoading(false);
+                const msg = err instanceof Error
+                    ? err.message
+                    : t("documentsview.FailedToLoadDocumentsData", {
+                        defaultValue: "Failed to load Knowledge data",
+                    });
+                setLoadError(msg);
+                setActionNoticeRef.current(msg, "error");
+            }
+        }
+        finally {
+            setLoading(false);
+        }
+    }, [onDocumentsChange, scopeFilter, t]);
+    useEffect(() => {
+        // Revalidate silently when cached documents are already on screen.
+        loadData({
+            silent: getCached(`documents:list:${scopeFilter}`) != null,
+        }).catch(() => {
+            setLoading(false);
+        });
+    }, [loadData, scopeFilter]);
+    useEffect(() => {
+        if (!isServiceLoading) {
+            serviceRetryRef.current = 0;
+            return;
+        }
+        const attempt = serviceRetryRef.current;
+        if (attempt >= 5) {
+            setIsServiceLoading(false);
+            setLoadError(t("documentsview.ServiceDidNotBecomeAvailable", {
+                defaultValue: "Knowledge service did not become available. Please reload the page.",
+            }));
+            return;
+        }
+        const delayMs = 2000 * 1.5 ** attempt; // 2s, 3s, 4.5s, 6.75s, ~10s
+        const timer = setTimeout(() => {
+            serviceRetryRef.current = attempt + 1;
+            loadData();
+        }, delayMs);
+        return () => clearTimeout(timer);
+    }, [isServiceLoading, loadData, t]);
+    const readDocumentFile = useCallback(async (file) => {
+        const reader = new FileReader();
+        return new Promise((resolve, reject) => {
+            reader.onload = () => {
+                const result = reader.result;
+                if (typeof result === "string") {
+                    resolve(result);
+                    return;
+                }
+                if (result instanceof ArrayBuffer) {
+                    const bytes = new Uint8Array(result);
+                    let binary = "";
+                    for (let i = 0; i < bytes.byteLength; i++) {
+                        binary += String.fromCharCode(bytes[i]);
+                    }
+                    resolve(btoa(binary));
+                    return;
+                }
+                reject(new Error(t("documentsview.FailedToReadFile", {
+                    defaultValue: "Failed to read file",
+                })));
+            };
+            reader.onerror = () => reject(reader.error);
+            if (shouldReadDocumentFileAsText(file)) {
+                reader.readAsText(file);
+            }
+            else {
+                reader.readAsArrayBuffer(file);
+            }
+        });
+    }, [t]);
+    const buildDocumentUploadRequest = useCallback(async (file, options) => {
+        const optimizedImage = await maybeCompressDocumentUploadImage(file);
+        const uploadFile = optimizedImage.file;
+        if (isDocumentImageFile(uploadFile) &&
+            uploadFile.size > MAX_DOCUMENT_IMAGE_PROCESSING_BYTES) {
+            throw new Error(t("documentsview.ImageCouldNotBeCompressed", {
+                defaultValue: "Image could not be compressed below {{limit}} for processing.",
+                limit: formatByteSize(MAX_DOCUMENT_IMAGE_PROCESSING_BYTES),
+            }));
+        }
+        const uploadFilename = getDocumentUploadFilename(uploadFile);
+        const content = await readDocumentFile(uploadFile);
+        const request = {
+            content,
+            filename: uploadFilename,
+            contentType: uploadFile.type || "application/octet-stream",
+            scope: options.scope,
+            metadata: {
+                includeImageDescriptions: options.includeImageDescriptions,
+                relativePath: uploadFile.webkitRelativePath || undefined,
+            },
+        };
+        const requestBytes = new TextEncoder().encode(JSON.stringify(request)).length;
+        if (requestBytes > MAX_UPLOAD_REQUEST_BYTES) {
+            throw new Error(t("documentsview.UploadPayloadExceedsLimit", {
+                defaultValue: "Upload payload is {{size}}, which exceeds the current limit ({{limit}}).",
+                size: formatByteSize(requestBytes),
+                limit: formatByteSize(MAX_UPLOAD_REQUEST_BYTES),
+            }));
+        }
+        return {
+            filename: uploadFilename,
+            request,
+            requestBytes,
+        };
+    }, [readDocumentFile, t]);
+    const handleFilesUpload = useCallback(async (files, options) => {
+        const unsupportedFiles = files.filter((file) => !isSupportedDocumentFile(file));
+        const uploadQueue = files.filter((file) => file.size > 0 && isSupportedDocumentFile(file));
+        if (uploadQueue.length === 0) {
+            setActionNotice(unsupportedFiles.length > 0
+                ? t("documentsview.NoSupportedNonEmptyFiles", {
+                    defaultValue: "No supported non-empty files were selected.",
+                })
+                : t("documentsview.NoNonEmptyFiles", {
+                    defaultValue: "No non-empty files were selected.",
+                }), "info", 3000);
+            return;
+        }
+        const largeFiles = uploadQueue.filter((file) => file.size >= LARGE_FILE_WARNING_BYTES);
+        if (largeFiles.length > 0) {
+            const shouldContinue = typeof window === "undefined"
+                ? true
+                : await confirmDesktopAction({
+                    title: t("documentsview.UploadLargeFiles", {
+                        defaultValue: "Upload Large Files",
+                    }),
+                    message: t("documentsview.LargeFilesDetected", {
+                        defaultValue: "{{count}} large file(s) detected.",
+                        count: largeFiles.length,
+                    }),
+                    detail: t("documentsview.UploadLargeFilesDetail", {
+                        defaultValue: "Uploading can take longer and may increase embedding or vision costs.",
+                    }),
+                    confirmLabel: t("common.continue", {
+                        defaultValue: "Continue",
+                    }),
+                    cancelLabel: t("common.cancel", {
+                        defaultValue: "Cancel",
+                    }),
+                    type: "warning",
+                });
+            if (!shouldContinue)
+                return;
+        }
+        const failures = [];
+        const warnings = [];
+        let successful = 0;
+        const normalizeUploadError = (err) => {
+            const message = err instanceof Error
+                ? err.message
+                : t("documentsview.UnknownUploadError", {
+                    defaultValue: "Unknown upload error",
+                });
+            const status = err?.status;
+            return status === 413 || /maximum size|payload is/i.test(message)
+                ? t("documentsview.UploadTooLarge", {
+                    defaultValue: "Upload too large. Try splitting this file.",
+                })
+                : message;
+        };
+        setUploading(true);
+        setUploadStatus({
+            current: 0,
+            total: uploadQueue.length,
+            filename: t("documentsview.Preparing", {
+                defaultValue: "Preparing...",
+            }),
+        });
+        try {
+            let currentBatch = [];
+            let currentBatchBytes = 0;
+            const flushBatch = async () => {
+                if (currentBatch.length === 0)
+                    return;
+                const batchToUpload = currentBatch;
+                currentBatch = [];
+                currentBatchBytes = 0;
+                const batchLabel = batchToUpload[0]?.filename ||
+                    t("documentsview.Batch", { defaultValue: "batch" });
+                setUploadStatus({
+                    current: successful + failures.length,
+                    total: uploadQueue.length,
+                    filename: t("documentsview.UploadingBatchStartingWith", {
+                        defaultValue: "Uploading batch starting with {{label}}",
+                        label: batchLabel,
+                    }),
+                });
+                try {
+                    const result = await client.uploadDocumentsBulk({
+                        documents: batchToUpload.map((item) => item.request),
+                    });
+                    for (const item of result.results) {
+                        const batchItem = batchToUpload[item.index];
+                        const filename = item.filename ||
+                            batchItem?.filename ||
+                            t("documentsview.Document", {
+                                defaultValue: "document",
+                            });
+                        if (item.ok) {
+                            successful += 1;
+                            if (item.warnings?.[0]) {
+                                warnings.push(`${filename}: ${item.warnings[0]}`);
+                            }
+                        }
+                        else {
+                            failures.push(`${filename}: ${item.error ||
+                                t("documentsview.UploadFailed", {
+                                    defaultValue: "Upload failed",
+                                })}`);
+                        }
+                    }
+                }
+                catch (err) {
+                    const message = normalizeUploadError(err);
+                    for (const batchItem of batchToUpload) {
+                        failures.push(`${batchItem.filename}: ${message}`);
+                    }
+                }
+            };
+            for (const [index, file] of uploadQueue.entries()) {
+                const uploadFilename = getDocumentUploadFilename(file);
+                setUploadStatus({
+                    current: index + 1,
+                    total: uploadQueue.length,
+                    filename: t("documentsview.PreparingFile", {
+                        defaultValue: "Preparing: {{filename}}",
+                        filename: uploadFilename,
+                    }),
+                });
+                try {
+                    const prepared = await buildDocumentUploadRequest(file, options);
+                    if (currentBatch.length > 0 &&
+                        (currentBatchBytes + prepared.requestBytes >
+                            BULK_UPLOAD_TARGET_BYTES ||
+                            currentBatch.length >= MAX_BULK_REQUEST_DOCUMENTS)) {
+                        await flushBatch();
+                    }
+                    currentBatch.push(prepared);
+                    currentBatchBytes += prepared.requestBytes;
+                }
+                catch (err) {
+                    failures.push(`${uploadFilename}: ${normalizeUploadError(err)}`);
+                }
+            }
+            await flushBatch();
+            let refreshFailed = false;
+            try {
+                await loadData();
+            }
+            catch {
+                refreshFailed = true;
+            }
+            const skippedSummary = unsupportedFiles.length > 0
+                ? ` Skipped ${unsupportedFiles.length} unsupported file(s).`
+                : "";
+            const refreshSummary = refreshFailed
+                ? " Uploaded, but failed to refresh document list."
+                : "";
+            if (uploadQueue.length === 1 &&
+                successful === 1 &&
+                failures.length === 0) {
+                const onlyFile = getDocumentUploadFilename(uploadQueue[0]);
+                const baseMessage = `Uploaded "${onlyFile}"`;
+                if (warnings.length > 0) {
+                    setActionNotice(`${baseMessage}. ${warnings[0]}`, "info", 6000);
+                }
+                else if (refreshFailed) {
+                    setActionNotice(`${baseMessage}. Uploaded, but failed to refresh document list.`, "info", 6000);
+                }
+                else {
+                    setActionNotice(baseMessage, "success", 3000);
+                }
+                return;
+            }
+            if (failures.length === 0) {
+                setActionNotice(`Uploaded ${successful}/${uploadQueue.length} files.${warnings.length > 0 ? ` ${warnings[0]}` : ""}${skippedSummary}${refreshSummary}`, warnings.length > 0 || refreshFailed || unsupportedFiles.length > 0
+                    ? "info"
+                    : "success", 7000);
+                return;
+            }
+            setActionNotice(`Uploaded ${successful}/${uploadQueue.length} files. ${failures.length} failed.${failures.length > 0 ? ` ${failures[0]}` : ""}${skippedSummary}${refreshSummary}`, successful > 0 ? "info" : "error", 7000);
+        }
+        finally {
+            setUploading(false);
+            setUploadStatus(null);
+        }
+    }, [buildDocumentUploadRequest, loadData, setActionNotice, t]);
+    const handleUrlUpload = useCallback(async (url, options) => {
+        setUploading(true);
+        try {
+            const result = await client.uploadDocumentFromUrl(url, {
+                includeImageDescriptions: options.includeImageDescriptions,
+                scope: options.scope,
+            });
+            const baseMessage = result.isYouTubeTranscript
+                ? `Imported YouTube transcript (${result.fragmentCount} fragments)`
+                : `Imported "${result.filename}" (${result.fragmentCount} fragments)`;
+            if (result.warnings && result.warnings.length > 0) {
+                setActionNotice(`${baseMessage}. ${result.warnings[0]}`, "info", 6000);
+            }
+            else {
+                setActionNotice(baseMessage, "success", 3000);
+            }
+            loadData();
+        }
+        catch (err) {
+            const message = err instanceof Error
+                ? err.message
+                : t("documentsview.UnknownImportError", {
+                    defaultValue: "Unknown import error",
+                });
+            setActionNotice(t("documentsview.FailedToImportFromUrl", {
+                defaultValue: "Failed to import from URL: {{message}}",
+                message,
+            }), "error", 5000);
+        }
+        finally {
+            setUploading(false);
+        }
+    }, [loadData, setActionNotice, t]);
+    const handleTextUpload = useCallback(async (text, title, options) => {
+        setUploading(true);
+        try {
+            const normalizedTitle = title?.trim();
+            const filenameStem = normalizedTitle
+                ?.toLowerCase()
+                .replace(/[^a-z0-9]+/g, "-")
+                .replace(/^-+|-+$/g, "")
+                .slice(0, 80) || "document-note";
+            const filename = `${filenameStem}.txt`;
+            const result = await client.uploadDocument({
+                content: text,
+                filename,
+                contentType: "text/plain",
+                scope: options.scope,
+                metadata: {
+                    source: "upload",
+                    title: normalizedTitle,
+                    textBacked: true,
+                },
+            });
+            setActionNotice(`Saved "${normalizedTitle || filename}" (${result.fragmentCount} fragments)`, "success", 3000);
+            await loadData();
+        }
+        catch (err) {
+            const message = err instanceof Error
+                ? err.message
+                : t("documentsview.UnknownUploadError", {
+                    defaultValue: "Unknown upload error",
+                });
+            setActionNotice(t("documentsview.UploadFailedWithMessage", {
+                defaultValue: "Upload failed: {{message}}",
+                message,
+            }), "error", 5000);
+        }
+        finally {
+            setUploading(false);
+        }
+    }, [loadData, setActionNotice, t]);
+    const handleExternalFileInputChange = useCallback((event) => {
+        const files = event.target.files;
+        if (files && files.length > 0 && !uploading) {
+            void handleFilesUpload(Array.from(files), {
+                includeImageDescriptions: true,
+                scope: DEFAULT_DOCUMENT_UPLOAD_SCOPE,
+            });
+        }
+        event.target.value = "";
+    }, [handleFilesUpload, uploading]);
+    const handleSearch = useCallback(async (query) => {
+        try {
+            const result = await client.searchDocuments(query, {
+                threshold: 0.3,
+                limit: 20,
+                ...(scopeFilter !== "all" ? { scope: scopeFilter } : {}),
+            });
+            setSearchResults(result.results);
+        }
+        catch (err) {
+            const message = err instanceof Error
+                ? err.message
+                : t("documentsview.UnknownSearchError", {
+                    defaultValue: "Unknown search error",
+                });
+            setActionNotice(t("documentsview.SearchFailed", {
+                defaultValue: "Search failed: {{message}}",
+                message,
+            }), "error", 4000);
+            setSearchResults([]);
+        }
+    }, [scopeFilter, setActionNotice, t]);
+    const handleDelete = useCallback(async (documentId) => {
+        setDeleting(documentId);
+        try {
+            const result = await client.deleteDocument(documentId);
+            if (result.ok) {
+                setActionNotice(t("documentsview.DeletedDocument", {
+                    defaultValue: "Deleted document ({{count}} fragments removed)",
+                    count: result.deletedFragments,
+                }), "success", 3000);
+                await loadData();
+            }
+            else {
+                setActionNotice(t("documentsview.FailedToDeleteDocument", {
+                    defaultValue: "Failed to delete document",
+                }), "error", 4000);
+            }
+        }
+        catch (err) {
+            const message = err instanceof Error
+                ? err.message
+                : t("documentsview.UnknownDeleteError", {
+                    defaultValue: "Unknown delete error",
+                });
+            setActionNotice(t("documentsview.FailedToDeleteDocumentWithMessage", {
+                defaultValue: "Failed to delete document: {{message}}",
+                message,
+            }), "error", 5000);
+        }
+        finally {
+            setDeleting(null);
+        }
+    }, [loadData, setActionNotice, t]);
+    const isShowingSearchResults = searchResults !== null;
+    const visibleSearchResults = searchResults ?? [];
+    const filteredDocuments = useMemo(() => {
+        const query = searchQuery.trim().toLowerCase();
+        if (!query || isShowingSearchResults) {
+            return documents;
+        }
+        return documents.filter((doc) => doc.filename.toLowerCase().includes(query) ||
+            doc.contentType?.toLowerCase().includes(query));
+    }, [documents, isShowingSearchResults, searchQuery]);
+    useEffect(() => {
+        if (documents.length === 0) {
+            if (selectedDocId !== null) {
+                setSelectedDocId(null);
+            }
+            return;
+        }
+        const hasSelectedDocument = documents.some((doc) => doc.id === selectedDocId);
+        if (!hasSelectedDocument) {
+            setSelectedDocId(documents[0]?.id ?? null);
+        }
+    }, [documents, selectedDocId, setSelectedDocId]);
+    useEffect(() => {
+        const query = searchQuery.trim();
+        if (!query) {
+            if (searchResults !== null) {
+                setSearchResults(null);
+            }
+            return;
+        }
+        const timer = window.setTimeout(() => {
+            void handleSearch(query);
+        }, 200);
+        return () => window.clearTimeout(timer);
+    }, [handleSearch, searchQuery, searchResults]);
+    /* ── Scope filter chips ────────────────────────────────────────── */
+    const scopeFilterStrip = (_jsx("div", { className: "flex flex-wrap items-center gap-1", children: SCOPE_FILTER_OPTIONS.map(({ value, labelKey, defaultLabel, Icon }) => (_jsx(ScopeFilterChip, { value: value, label: t(labelKey, { defaultValue: defaultLabel }), Icon: Icon, active: scopeFilter === value, onSelect: setScopeFilter }, value))) }));
+    const documentContent = (_jsx("div", { className: "order-2 flex min-w-0 flex-1 lg:order-1", children: _jsx(DocumentViewer, { documentId: selectedDocId, onUpdated: () => {
+                void loadData();
+            } }) }));
+    const selectorRail = (_jsxs("div", { className: `order-1 flex w-full shrink-0 flex-col gap-3 lg:order-2 ${useCompactSelectorRail
+            ? "lg:w-[18.5rem] xl:w-[20rem]"
+            : "lg:w-[22rem] xl:w-[24rem]"}`, children: [_jsx(PagePanel, { variant: "inset", className: `${useCompactSelectorRail ? "p-2" : "p-3"} !rounded-none !border-0 !bg-transparent !shadow-none !ring-0`, children: _jsx(UploadZone, { fileInputId: fileInputId, onFilesUpload: handleFilesUpload, onTextUpload: handleTextUpload, onUrlUpload: handleUrlUpload, uploading: uploading, uploadStatus: uploadStatus }) }), _jsxs(PagePanel, { variant: "inset", className: `flex flex-1 flex-col overflow-hidden p-2.5 !rounded-none !border-0 !bg-transparent !shadow-none !ring-0 ${useCompactSelectorRail ? "min-h-[14rem]" : "min-h-[18rem]"}`, children: [_jsxs("div", { className: "mb-2 flex items-center justify-between gap-3 px-1", children: [_jsx("div", { className: "min-w-0 text-xs font-semibold uppercase tracking-[0.12em] text-muted/70", children: isShowingSearchResults
+                                    ? t("documentsview.SearchResults", {
+                                        defaultValue: "Search results",
+                                    })
+                                    : t("documentsview.Documents", { defaultValue: "Documents" }) }), _jsx("div", { className: "shrink-0 text-2xs text-muted", children: documents.length === 1
+                                    ? t("documentsview.DocumentCountOne", {
+                                        defaultValue: "1 doc",
+                                    })
+                                    : t("documentsview.DocumentCountMany", {
+                                        defaultValue: "{{count}} docs",
+                                        count: documents.length,
+                                    }) })] }), _jsx(ChatSearchHint, { noun: "documents", query: searchQuery, className: "px-1" }), _jsx("div", { className: "mt-2", children: scopeFilterStrip }), _jsxs("div", { className: "custom-scrollbar mt-2 flex min-h-0 flex-1 flex-col gap-1.5 overflow-y-auto px-0.5 py-0.5", children: [loading && !isShowingSearchResults && documents.length === 0 && (_jsx(ListSkeleton, { rows: 6 })), !loading && !isShowingSearchResults && documents.length === 0 && (_jsx(PagePanel.Empty, { variant: "inset", className: "min-h-[12rem] px-0 py-8 !rounded-none !border-0 !bg-transparent !shadow-none !ring-0", description: t("documentsview.UploadFilesOrImpo"), title: t("documentsview.NoDocumentsYet") })), !loading &&
+                                !isShowingSearchResults &&
+                                documents.length > 0 &&
+                                filteredDocuments.length === 0 && (_jsx(PagePanel.Empty, { variant: "inset", className: "min-h-[12rem] px-0 py-8 !rounded-none !border-0 !bg-transparent !shadow-none !ring-0", description: t("documentsview.SearchTips", {
+                                    defaultValue: "Try a filename, topic, or phrase from the document body.",
+                                }), title: t("documentsview.NoMatchingDocuments", {
+                                    defaultValue: "No matching documents",
+                                }) })), isShowingSearchResults && visibleSearchResults.length === 0 && (_jsx(PagePanel.Empty, { variant: "inset", className: "min-h-[12rem] px-0 py-8 !rounded-none !border-0 !bg-transparent !shadow-none !ring-0", description: t("documentsview.SearchTips", {
+                                    defaultValue: "Try a filename, topic, or phrase from the document body.",
+                                }), title: t("documentsview.NoResultsFound") })), isShowingSearchResults
+                                ? visibleSearchResults.map((result) => (_jsx(SearchResultListItem, { result: result, active: selectedDocId === (result.documentId || result.id), onSelect: setSelectedDocId }, result.id)))
+                                : filteredDocuments.map((doc) => (_jsx(DocumentListItem, { doc: doc, active: selectedDocId === doc.id, onSelect: setSelectedDocId, onDelete: handleDelete, deleting: deleting === doc.id }, doc.id)))] })] })] }));
+    const compactDocumentStrip = !shouldRenderSelectorRail ? (_jsxs(PagePanel, { variant: "inset", className: "flex shrink-0 flex-col gap-2 px-0 py-0 !rounded-none !border-0 !bg-transparent !shadow-none !ring-0", children: [_jsxs("div", { className: "flex flex-col gap-2 md:flex-row md:items-center", children: [_jsx(ChatSearchHint, { noun: "documents", query: searchQuery, className: "min-w-0 flex-1" }), fileInputId ? (_jsxs("label", { htmlFor: fileInputId, className: `inline-flex h-9 shrink-0 cursor-pointer items-center justify-center gap-2 rounded-sm border border-accent/35 bg-accent/10 px-3 text-xs font-semibold text-accent-fg transition hover:bg-accent/16 ${uploading ? "pointer-events-none opacity-60" : ""}`, children: [_jsx(FileText, { className: "h-3.5 w-3.5", "aria-hidden": true }), uploading
+                                ? t("documentsview.Uploading", { defaultValue: "Uploading" })
+                                : t("documentsview.AddKnowledge", {
+                                    defaultValue: "Add Knowledge",
+                                })] })) : null] }), _jsx("div", { children: scopeFilterStrip }), _jsx("div", { className: "custom-scrollbar flex gap-2 overflow-x-auto pb-1", children: isShowingSearchResults
+                    ? visibleSearchResults.map((result) => (_jsx(CompactSearchChip, { result: result, active: selectedDocId === (result.documentId || result.id), onSelect: setSelectedDocId }, result.id)))
+                    : filteredDocuments.map((doc) => (_jsx(CompactDocChip, { doc: doc, active: selectedDocId === doc.id, onSelect: setSelectedDocId }, doc.id))) })] })) : null;
+    return (_jsxs("div", { className: `flex flex-1 min-h-0 flex-col gap-4 ${inModal ? "min-h-0" : ""}`, "data-testid": "documents-view", children: [!shouldRenderSelectorRail && fileInputId ? (_jsx("input", { id: fileInputId, type: "file", className: "hidden", multiple: true, accept: DOCUMENT_UPLOAD_ACCEPT, onChange: handleExternalFileInputChange })) : null, isServiceLoading && (_jsxs(PagePanel, { variant: "inset", className: "flex items-center gap-2 px-0 py-3 text-sm text-muted-strong !rounded-none !border-0 !bg-transparent !shadow-none !ring-0", children: [_jsx("span", { className: "h-4 w-4 animate-spin rounded-full border-2 border-accent border-t-transparent" }), t("documentsview.DocumentServiceIs")] })), documentsUnavailable && !isServiceLoading && (_jsx(PagePanel.Notice, { tone: "default", children: t("documentsview.DocumentsUnavailableHere", {
+                    defaultValue: "Knowledge isn't available on this device. Manage documents from the desktop or web app.",
+                }) })), loadError && !documentsUnavailable && !isServiceLoading && (_jsx(PagePanel.Notice, { tone: "danger", actions: _jsx(Button, { variant: "outline", size: "sm", className: "border-danger/30 px-3 text-xs text-danger hover:bg-danger/16", onClick: () => loadData(), children: t("common.retry") }), children: loadError })), compactDocumentStrip, _jsxs("div", { className: "flex min-h-0 flex-1 flex-col gap-4 lg:flex-row", children: [documentContent, shouldRenderSelectorRail ? selectorRail : null] })] }));
+}