@vertesia/ui 1.5.0-dev.20260714.072725Z → 1.5.0-dev.20260717.131047Z

package/src/features/document-viewer/index.ts

@@ -0,0 +1 @@
+export * from './UniversalDocumentViewer.js';

package/src/features/index.ts

@@ -1,5 +1,6 @@
 export * from './activity-doc/index.js';
 export * from './agent';
+export * from './document-viewer/index.js';
 export * from './errors/index.js';
 export * from './facets/index.js';
 export * from './layout/index.js';

package/src/features/permissions/UserPermissionsProvider.tsx

@@ -1,7 +1,7 @@
-import { type Permission, PrincipalType, type SystemRoleDefinition } from '@vertesia/common';
+import { type AuthTokenPayload, type Permission, PrincipalType, type SystemRoleDefinition } from '@vertesia/common';
 import { ErrorBox, errorMessage, useFetch } from '@vertesia/ui/core';
 import { useUITranslation } from '@vertesia/ui/i18n';
-import { type UserSession, useUserSession } from '@vertesia/ui/session';
+import { useUserSession } from '@vertesia/ui/session';
 import { createContext, useContext, useMemo } from 'react';
 import { isAnyOf } from './helpers';
 
@@ -12,39 +12,18 @@ export class UserPermissions {
     roles: Set<string>; // all roles of the current user
     permissions: Set<string>; // all permissions of the current user
 
-    constructor(session: UserSession, roles: ListRolesResponse) {
-        if (!session.authToken) {
-            throw new Error('No auth token found in user session');
-        }
+    constructor(authToken: AuthTokenPayload, roles: ListRolesResponse = []) {
         this.system_roles = roles;
-        const userRoles = new Set<string>(session.authToken.account_roles || []);
-        if (session.authToken.project_roles) {
-            for (const role of session.authToken.project_roles) {
-                userRoles.add(role);
-            }
-        }
+        const roleNames = [...(authToken.account_roles || []), ...(authToken.project_roles || [])];
+        const userRoles = new Set<string>(roleNames);
         this.roles = userRoles;
-        // build a temporary role to permissions map
-        const map: Record<string, Permission[]> = {};
-        for (const role of roles) {
-            map[role.name] = role.permissions;
-        }
+        const rolePermissions = authToken.permissions ?? getPermissionsForRolesFromMappings(roleNames, roles);
+        // OAuth access tokens are capped to the permissions granted to the token (its scopes).
         const permissionCap =
-            session.authToken.type === PrincipalType.OAuthAccess
-                ? new Set<string>(session.authToken.permissions ?? [])
-                : undefined;
-        const permissions = new Set<string>();
-        for (const role of userRoles) {
-            const rolePermissions = map[role];
-            if (rolePermissions) {
-                for (const permission of rolePermissions) {
-                    if (!permissionCap || permissionCap.has(permission)) {
-                        permissions.add(permission);
-                    }
-                }
-            }
-        }
-        this.permissions = permissions;
+            authToken.type === PrincipalType.OAuthAccess ? new Set<string>(authToken.permissions ?? []) : undefined;
+        this.permissions = new Set(
+            permissionCap ? rolePermissions.filter((permission) => permissionCap.has(permission)) : rolePermissions,
+        );
     }
 
     hasPermission(permission: string | string[]) {
@@ -64,6 +43,17 @@ export class UserPermissions {
     }
 }
 
+function getPermissionsForRolesFromMappings(roleNames: Iterable<string>, roles: ListRolesResponse): Permission[] {
+    const permissionsByRole = new Map(roles.map((role) => [role.name, role.permissions]));
+    const permissions = new Set<Permission>();
+    for (const role of roleNames) {
+        for (const permission of permissionsByRole.get(role) ?? []) {
+            permissions.add(permission);
+        }
+    }
+    return Array.from(permissions);
+}
+
 const UserPermissionsContext = createContext<UserPermissions | undefined>(undefined);
 
 export { UserPermissionsContext };
@@ -82,21 +72,28 @@ interface UserPermissionProviderProps {
 export function UserPermissionProvider({ children }: UserPermissionProviderProps) {
     const { t } = useUITranslation();
     const session = useUserSession();
+    const authToken = session.authToken;
+    const shouldFetchRoleMappings = Boolean(authToken && !authToken.permissions);
     const { data, error, isLoading } = useFetch<ListRolesResponse | undefined>(() => {
-        if (session.user) {
+        if (shouldFetchRoleMappings) {
             return session.client.iam.roles.listSystem();
-        } else {
-            return Promise.resolve(undefined);
         }
-    }, [session.user]);
+        return Promise.resolve(undefined);
+    }, [session, shouldFetchRoleMappings]);
 
     const perms = useMemo(() => {
-        if (session.authToken && data && !isLoading) {
-            return new UserPermissions(session, data);
+        if (authToken) {
+            if (authToken.permissions || !shouldFetchRoleMappings) {
+                return new UserPermissions(authToken);
+            }
+            if (data && !isLoading) {
+                return new UserPermissions(authToken, data);
+            }
         } else {
             return undefined;
         }
-    }, [session, data, isLoading]);
+        return undefined;
+    }, [authToken, data, isLoading, shouldFetchRoleMappings]);
 
     if (error) {
         return <ErrorBox title={t('store.failedToFetchRoleMappings')}>{errorMessage(error)}</ErrorBox>;

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

@@ -25,12 +25,16 @@ import {
 import { useUITranslation } from '@vertesia/ui/i18n';
 import { NavLink } from '@vertesia/ui/router';
 import { useUserSession } from '@vertesia/ui/session';
-import { JSONDisplay, MarkdownRenderer, Progress, XMLViewer } from '@vertesia/ui/widgets';
+import { JSONDisplay, Progress } from '@vertesia/ui/widgets';
 import { AlertTriangle, Copy, Download, FileSearch, SquarePen } from 'lucide-react';
-import { memo, type RefObject, useEffect, useRef, useState } from 'react';
+import { memo, type RefObject, useEffect, useMemo, useRef, useState } from 'react';
+import {
+    type UniversalDocumentConverter,
+    type UniversalDocumentSource,
+    UniversalDocumentViewer,
+} from '../../../document-viewer/UniversalDocumentViewer.js';
 import { MagicPdfView } from '../../../magic-pdf';
 import { AudioPanel, ImagePanel, VideoPanel } from '../../../media-viewer';
-import { SimplePdfViewer } from '../../../pdf-viewer';
 import { SecureButton } from '../../../permissions/SecureButton.js';
 import { getWorkflowStatusColor, getWorkflowStatusName, isPreviewableAsPdf } from '../../../utils/index.js';
 import { PropertiesEditorModal } from './PropertiesEditorModal';
@@ -59,11 +63,12 @@ interface TextPanelProps {
 }
 
 interface OfficePdfPreviewPanelProps {
+    object: ContentObject;
     pdfRendition?: { content?: { source?: string } };
     officePdfUrl?: string;
+    converters: UniversalDocumentConverter[];
     officePdfConverting: boolean;
     officePdfError?: string;
-    onConvert: () => void;
 }
 
 interface OfficePdfActionsProps {
@@ -320,6 +325,7 @@ function DataPanel({
     handleCopyContent: (content: string, type: 'text' | 'properties') => Promise<void>;
     refetch?: () => Promise<unknown>;
 }) {
+    const { client } = useUserSession();
     const { t } = useUITranslation();
     const isImage = object?.metadata?.type === ContentNature.Image;
     const isVideo = object?.metadata?.type === ContentNature.Video;
@@ -392,6 +398,38 @@ function DataPanel({
         triggerConversion: triggerOfficePdfConversion,
     } = useOfficePdfConversion(object.id, isPreviewableAsPdfDoc);
 
+    const officePdfConverters = useMemo<UniversalDocumentConverter[]>(
+        () => [
+            {
+                id: 'office-pdf-rendition',
+                target: 'pdf',
+                canConvert: ({ contentType, extension }) =>
+                    isPreviewableAsPdfDoc ||
+                    (contentType ? isPreviewableAsPdf(contentType) : false) ||
+                    ['doc', 'docx', 'ppt', 'pptx'].includes(extension),
+                convert: async () => {
+                    const response = await client.objects.getRendition(object.id, {
+                        format: MarkdownRenditionFormat.pdf,
+                        generate_if_missing: true,
+                        sign_url: true,
+                        block_on_generation: true,
+                    });
+
+                    if (response.status === 'found' && response.renditions?.length) {
+                        return {
+                            url: response.renditions[0],
+                            contentType: 'application/pdf',
+                            fileName: `${object.name || 'document'}.pdf`,
+                        };
+                    }
+
+                    return null;
+                },
+            },
+        ],
+        [client, isPreviewableAsPdfDoc, object.id, object.name],
+    );
+
     // Load text once processing completes without triggering a full object refetch
     // (which would flash the page-level loading spinner).
     useEffect(() => {
@@ -539,11 +577,12 @@ function DataPanel({
             {isPreviewableAsPdfDoc && keepPdfPreviewMounted && (
                 <div className={getPanelVisibility(showPdfPreviewPanel)}>
                     <OfficePdfPreviewPanel
+                        object={object}
                         pdfRendition={pdfRendition}
                         officePdfUrl={officePdfUrl}
+                        converters={officePdfConverters}
                         officePdfConverting={officePdfConverting}
                         officePdfError={officePdfError}
-                        onConvert={triggerOfficePdfConversion}
                     />
                 </div>
             )}
@@ -743,18 +782,24 @@ function TextActions({ object, text, fullText, handleCopyContent, onToggleEdit,
 
 const TextPanel = memo(({ object, text, isTextCropped, textContainerRef }: TextPanelProps) => {
     const { t } = useUITranslation();
-    const content = object.content;
     const isCreatedOrProcessing = isCreatedOrProcessingStatus(object?.status);
-
-    // Check content processor type for XML
     const contentProcessorType = getContentProcessorType(object);
     const isXml = contentProcessorType === 'xml';
 
     // Check if content type is markdown or plain text
-    const isMarkdownOrText = content?.type && (content.type === 'text/markdown' || content.type === 'text/plain');
+    const isMarkdownOrText =
+        object.content?.type && (object.content.type === 'text/markdown' || object.content.type === 'text/plain');
 
     // Render as markdown if it's markdown/text type OR if text looks like markdown (but not if XML)
     const shouldRenderAsMarkdown = !isXml && (isMarkdownOrText || looksLikeMarkdown(text));
+    const source: UniversalDocumentSource = {
+        id: object.id,
+        title: object.name,
+        fileName: object.content?.name || object.name,
+        contentType: isXml ? 'text/xml' : shouldRenderAsMarkdown ? 'text/markdown' : object.content?.type,
+        content: text,
+        sourcePath: object.content?.source,
+    };
 
     return text ? (
         <>
@@ -767,17 +812,12 @@ const TextPanel = memo(({ object, text, isTextCropped, textContainerRef }: TextP
                 </div>
             )}
             <div className={`max-w-7xl px-2 h-full overflow-auto`} ref={textContainerRef}>
-                {isXml ? (
-                    <div className="px-4 py-2">
-                        <XMLViewer xml={text} collapsible />
-                    </div>
-                ) : shouldRenderAsMarkdown ? (
-                    <div className="vprose prose-sm p-1">
-                        <MarkdownRenderer components={createMarkdownComponents()}>{text}</MarkdownRenderer>
-                    </div>
-                ) : (
-                    <pre className="text-wrap bg-muted text-muted p-2">{text}</pre>
-                )}
+                <UniversalDocumentViewer
+                    source={source}
+                    className="h-full"
+                    bodyClassName="overflow-auto"
+                    markdownComponents={createMarkdownComponents()}
+                />
             </div>
         </>
     ) : (
@@ -921,9 +961,17 @@ function OfficePdfActions({ object, pdfRendition, officePdfUrl }: OfficePdfActio
 }
 
 function PdfPreviewPanel({ object }: { object: ContentObject }) {
+    const source: UniversalDocumentSource = {
+        id: object.id,
+        title: object.name,
+        fileName: object.content?.name || object.name,
+        contentType: object.content?.type,
+        sourcePath: object.content?.source,
+    };
+
     return (
         <div className="h-full">
-            <SimplePdfViewer object={object} className="h-full" />
+            <UniversalDocumentViewer source={source} className="h-full" />
         </div>
     );
 }
@@ -933,11 +981,12 @@ function PdfPreviewPanel({ object }: { object: ContentObject }) {
  * Handles the various states: converting, error, showing PDF.
  */
 function OfficePdfPreviewPanel({
+    object,
     pdfRendition,
     officePdfUrl,
+    converters,
     officePdfConverting,
     officePdfError,
-    onConvert,
 }: OfficePdfPreviewPanelProps) {
     const { t } = useUITranslation();
     if (officePdfConverting) {
@@ -959,24 +1008,48 @@ function OfficePdfPreviewPanel({
     }
 
     if (pdfRendition?.content?.source) {
+        const source: UniversalDocumentSource = {
+            id: object.id,
+            title: object.name,
+            fileName: `${object.name || 'document'}.pdf`,
+            contentType: 'application/pdf',
+            sourcePath: pdfRendition.content.source,
+        };
+
         return (
             <div className="h-full">
-                <SimplePdfViewer source={pdfRendition.content.source} className="h-full" />
+                <UniversalDocumentViewer source={source} className="h-full" />
             </div>
         );
     }
 
     if (officePdfUrl) {
+        const source: UniversalDocumentSource = {
+            id: object.id,
+            title: object.name,
+            fileName: `${object.name || 'document'}.pdf`,
+            contentType: 'application/pdf',
+            url: officePdfUrl,
+        };
+
         return (
             <div className="h-full">
-                <SimplePdfViewer url={officePdfUrl} className="h-full" />
+                <UniversalDocumentViewer source={source} className="h-full" />
             </div>
         );
     }
 
+    const source: UniversalDocumentSource = {
+        id: object.id,
+        title: object.name,
+        fileName: object.content?.name || object.name,
+        contentType: object.content?.type,
+        sourcePath: object.content?.source,
+    };
+
     return (
-        <div className="flex flex-col justify-center items-center flex-1 gap-2">
-            <Button onClick={onConvert}>Convert to PDF</Button>
+        <div className="h-full">
+            <UniversalDocumentViewer source={source} converters={converters} className="h-full" />
         </div>
     );
 }

package/src/i18n/locales/ar.json

@@ -128,6 +128,7 @@
   "agent.noPlanAvailable": "لا توجد خطة متاحة",
   "agent.noPlanDetected": "لم يتم اكتشاف أي خطة بعد",
   "agent.olderPlan": "خطة أقدم",
+  "agent.onlySystemArtifacts": "Only system files in this run. Enable \"System files\" to view them.",
   "agent.openDocument": "فتح المستند",
   "agent.openInNewTab": "فتح في علامة تبويب جديدة",
   "agent.panelRenderError": "تعذر عرض {{name}}",
@@ -175,6 +176,7 @@
   "agent.showLess": "عرض أقل",
   "agent.showMore": "عرض المزيد",
   "agent.showSidebar": "عرض الشريط الجانبي",
+  "agent.showSystemArtifacts": "System files",
   "agent.staged": "مُعدّ",
   "agent.startAgent": "بدء الوكيل",
   "agent.startingAgent": "جارٍ بدء الوكيل...",

package/src/i18n/locales/de.json

@@ -124,6 +124,7 @@
   "agent.noPlanAvailable": "Kein Plan verfügbar",
   "agent.noPlanDetected": "Noch kein Plan erkannt",
   "agent.olderPlan": "Älterer Plan",
+  "agent.onlySystemArtifacts": "Only system files in this run. Enable \"System files\" to view them.",
   "agent.openDocument": "Dokument öffnen",
   "agent.openInNewTab": "In neuem Tab öffnen",
   "agent.panelRenderError": "{{name}} konnte nicht gerendert werden",
@@ -171,6 +172,7 @@
   "agent.showLess": "Weniger anzeigen",
   "agent.showMore": "Mehr anzeigen",
   "agent.showSidebar": "Seitenleiste anzeigen",
+  "agent.showSystemArtifacts": "System files",
   "agent.staged": "Bereitgestellt",
   "agent.startAgent": "Agent starten",
   "agent.startingAgent": "Agent wird gestartet...",

package/src/i18n/locales/en.json

@@ -124,6 +124,7 @@
   "agent.noPlanAvailable": "No plan",
   "agent.noPlanDetected": "No plan has been detected yet",
   "agent.olderPlan": "Previous revision",
+  "agent.onlySystemArtifacts": "Only system files in this run. Enable \"System files\" to view them.",
   "agent.openDocument": "Open document",
   "agent.openInNewTab": "Open in new tab",
   "agent.panelRenderError": "{{name}} could not be rendered",
@@ -171,6 +172,7 @@
   "agent.showLess": "Show less",
   "agent.showMore": "Show more",
   "agent.showSidebar": "Show Sidebar",
+  "agent.showSystemArtifacts": "System files",
   "agent.staged": "Staged",
   "agent.startAgent": "Start Agent",
   "agent.startingAgent": "Starting agent...",

package/src/i18n/locales/es.json

@@ -125,6 +125,7 @@
   "agent.noPlanAvailable": "Sin plan disponible",
   "agent.noPlanDetected": "Aún no se ha detectado ningún plan",
   "agent.olderPlan": "Plan anterior",
+  "agent.onlySystemArtifacts": "Only system files in this run. Enable \"System files\" to view them.",
   "agent.openDocument": "Abrir documento",
   "agent.openInNewTab": "Abrir en nueva pestaña",
   "agent.panelRenderError": "No se pudo renderizar {{name}}",
@@ -172,6 +173,7 @@
   "agent.showLess": "Mostrar menos",
   "agent.showMore": "Mostrar más",
   "agent.showSidebar": "Mostrar panel",
+  "agent.showSystemArtifacts": "System files",
   "agent.staged": "Preparado",
   "agent.startAgent": "Iniciar agente",
   "agent.startingAgent": "Iniciando agente...",

package/src/i18n/locales/fr.json

@@ -125,6 +125,7 @@
   "agent.noPlanAvailable": "Aucun plan disponible",
   "agent.noPlanDetected": "Aucun plan détecté pour le moment",
   "agent.olderPlan": "Plan précédent",
+  "agent.onlySystemArtifacts": "Only system files in this run. Enable \"System files\" to view them.",
   "agent.openDocument": "Ouvrir le document",
   "agent.openInNewTab": "Ouvrir dans un nouvel onglet",
   "agent.panelRenderError": "{{name}} n'a pas pu être affiché",
@@ -172,6 +173,7 @@
   "agent.showLess": "Afficher moins",
   "agent.showMore": "Afficher plus",
   "agent.showSidebar": "Afficher le panneau",
+  "agent.showSystemArtifacts": "System files",
   "agent.staged": "En attente",
   "agent.startAgent": "Démarrer l'agent",
   "agent.startingAgent": "Démarrage de l'agent...",

package/src/i18n/locales/it.json

@@ -125,6 +125,7 @@
   "agent.noPlanAvailable": "Nessun piano disponibile",
   "agent.noPlanDetected": "Nessun piano rilevato",
   "agent.olderPlan": "Piano precedente",
+  "agent.onlySystemArtifacts": "Only system files in this run. Enable \"System files\" to view them.",
   "agent.openDocument": "Apri documento",
   "agent.openInNewTab": "Apri in nuova scheda",
   "agent.panelRenderError": "Impossibile renderizzare {{name}}",
@@ -172,6 +173,7 @@
   "agent.showLess": "Mostra meno",
   "agent.showMore": "Mostra altro",
   "agent.showSidebar": "Mostra pannello",
+  "agent.showSystemArtifacts": "System files",
   "agent.staged": "In attesa",
   "agent.startAgent": "Avvia agente",
   "agent.startingAgent": "Avvio dell'agente...",

package/src/i18n/locales/ja.json

@@ -124,6 +124,7 @@
   "agent.noPlanAvailable": "利用可能なプランなし",
   "agent.noPlanDetected": "まだプランが検出されていません",
   "agent.olderPlan": "古いプラン",
+  "agent.onlySystemArtifacts": "Only system files in this run. Enable \"System files\" to view them.",
   "agent.openDocument": "ドキュメントを開く",
   "agent.openInNewTab": "新しいタブで開く",
   "agent.panelRenderError": "{{name}} を表示できませんでした",
@@ -171,6 +172,7 @@
   "agent.showLess": "表示を減らす",
   "agent.showMore": "さらに表示",
   "agent.showSidebar": "サイドバーを表示",
+  "agent.showSystemArtifacts": "System files",
   "agent.staged": "ステージ済み",
   "agent.startAgent": "エージェントを開始",
   "agent.startingAgent": "エージェントを起動中...",

package/src/i18n/locales/ko.json

@@ -124,6 +124,7 @@
   "agent.noPlanAvailable": "사용 가능한 계획 없음",
   "agent.noPlanDetected": "아직 계획이 감지되지 않았습니다",
   "agent.olderPlan": "이전 계획",
+  "agent.onlySystemArtifacts": "Only system files in this run. Enable \"System files\" to view them.",
   "agent.openDocument": "문서 열기",
   "agent.openInNewTab": "새 탭에서 열기",
   "agent.panelRenderError": "{{name}}을(를) 렌더링할 수 없습니다",
@@ -171,6 +172,7 @@
   "agent.showLess": "덜 보기",
   "agent.showMore": "더 보기",
   "agent.showSidebar": "사이드바 표시",
+  "agent.showSystemArtifacts": "System files",
   "agent.staged": "준비됨",
   "agent.startAgent": "에이전트 시작",
   "agent.startingAgent": "에이전트 시작 중...",

package/src/i18n/locales/pt.json

@@ -125,6 +125,7 @@
   "agent.noPlanAvailable": "Sem plano disponível",
   "agent.noPlanDetected": "Nenhum plano detectado ainda",
   "agent.olderPlan": "Plano anterior",
+  "agent.onlySystemArtifacts": "Only system files in this run. Enable \"System files\" to view them.",
   "agent.openDocument": "Abrir documento",
   "agent.openInNewTab": "Abrir em nova aba",
   "agent.panelRenderError": "Não foi possível renderizar {{name}}",
@@ -172,6 +173,7 @@
   "agent.showLess": "Mostrar menos",
   "agent.showMore": "Mostrar mais",
   "agent.showSidebar": "Mostrar painel",
+  "agent.showSystemArtifacts": "System files",
   "agent.staged": "Preparado",
   "agent.startAgent": "Iniciar agente",
   "agent.startingAgent": "Iniciando agente...",

package/src/i18n/locales/ru.json

@@ -126,6 +126,7 @@
   "agent.noPlanAvailable": "План недоступен",
   "agent.noPlanDetected": "План пока не обнаружен",
   "agent.olderPlan": "Более старый план",
+  "agent.onlySystemArtifacts": "Only system files in this run. Enable \"System files\" to view them.",
   "agent.openDocument": "Открыть документ",
   "agent.openInNewTab": "Открыть в новой вкладке",
   "agent.panelRenderError": "Не удалось отобразить {{name}}",
@@ -173,6 +174,7 @@
   "agent.showLess": "Показать меньше",
   "agent.showMore": "Показать больше",
   "agent.showSidebar": "Показать боковую панель",
+  "agent.showSystemArtifacts": "System files",
   "agent.staged": "Подготовлено",
   "agent.startAgent": "Запустить агента",
   "agent.startingAgent": "Запуск агента...",

package/src/i18n/locales/tr.json

@@ -124,6 +124,7 @@
   "agent.noPlanAvailable": "Plan mevcut değil",
   "agent.noPlanDetected": "Henüz bir plan algılanmadı",
   "agent.olderPlan": "Daha eski plan",
+  "agent.onlySystemArtifacts": "Only system files in this run. Enable \"System files\" to view them.",
   "agent.openDocument": "Belgeyi aç",
   "agent.openInNewTab": "Yeni sekmede aç",
   "agent.panelRenderError": "{{name}} işlenemedi",
@@ -171,6 +172,7 @@
   "agent.showLess": "Daha az göster",
   "agent.showMore": "Daha fazla göster",
   "agent.showSidebar": "Kenar çubuğunu göster",
+  "agent.showSystemArtifacts": "System files",
   "agent.staged": "Hazırlandı",
   "agent.startAgent": "Ajanı başlat",
   "agent.startingAgent": "Ajan başlatılıyor...",

package/src/i18n/locales/zh-TW.json

@@ -124,6 +124,7 @@
   "agent.noPlanAvailable": "暫無計劃",
   "agent.noPlanDetected": "尚未偵測到計劃",
   "agent.olderPlan": "較舊的計劃",
+  "agent.onlySystemArtifacts": "Only system files in this run. Enable \"System files\" to view them.",
   "agent.openDocument": "開啟文件",
   "agent.openInNewTab": "在新分頁中開啟",
   "agent.panelRenderError": "無法呈現 {{name}}",
@@ -171,6 +172,7 @@
   "agent.showLess": "顯示較少",
   "agent.showMore": "顯示更多",
   "agent.showSidebar": "顯示側邊欄",
+  "agent.showSystemArtifacts": "System files",
   "agent.staged": "已暫存",
   "agent.startAgent": "啟動代理",
   "agent.startingAgent": "正在啟動代理...",

package/src/i18n/locales/zh.json

@@ -124,6 +124,7 @@
   "agent.noPlanAvailable": "暂无计划",
   "agent.noPlanDetected": "尚未检测到计划",
   "agent.olderPlan": "较旧的计划",
+  "agent.onlySystemArtifacts": "Only system files in this run. Enable \"System files\" to view them.",
   "agent.openDocument": "打开文档",
   "agent.openInNewTab": "在新标签页中打开",
   "agent.panelRenderError": "无法渲染 {{name}}",
@@ -171,6 +172,7 @@
   "agent.showLess": "显示更少",
   "agent.showMore": "显示更多",
   "agent.showSidebar": "显示侧边栏",
+  "agent.showSystemArtifacts": "System files",
   "agent.staged": "已暂存",
   "agent.startAgent": "启动代理",
   "agent.startingAgent": "正在启动代理...",

package/src/router/HistoryNavigator.ts

@@ -1,5 +1,5 @@
 import { PathWithParams } from './PathWithParams';
-import { joinPath } from './path';
+import { joinPath, withMountBasename } from './path';
 
 const BASE_PATH = Symbol('BASE_PATH');
 
@@ -149,6 +149,9 @@ export class HistoryNavigator {
             to = joinPath(basePath, to);
         }
         to = this.addStickyParams(to);
+        // Keep absolute app routes under the served `<base href>` mount instead of resolving them
+        // against the bare origin (which collapses the URL off the mount). No-op when origin-served.
+        to = withMountBasename(to);
         this._navigate(new URL(to, window.location.href), 'navigate', options);
     }
 

package/src/router/Nav.tsx

@@ -1,4 +1,5 @@
 import type { SyntheticEvent } from 'react';
+import { withMountBasename } from './path';
 import { useNavigate, useRouterContext } from './Router';
 
 /**
@@ -75,7 +76,12 @@ export function NavLink({
     const isAnchorOrEmpty = !href || href.startsWith('#');
     const isExternal = /^[a-z][a-z0-9+.-]*:/i.test(href) || href.startsWith('//') || (!!target && target !== '_self');
     const isInternal = !isAnchorOrEmpty && !isExternal;
-    const resolvedHref = !skipStickyParams && isInternal ? router.getTopRouter().navigator.addStickyParams(href) : href;
+    // Keep the rendered href under the served `<base href>` mount (correct middle-click / hover /
+    // open-in-new-tab); the onClick navigates via the router which applies the same rule. No-op when
+    // origin-served (Studio UI). Click handler below passes the raw `href` — navigate() re-bases it.
+    const resolvedHref = isInternal
+        ? withMountBasename(!skipStickyParams ? router.getTopRouter().navigator.addStickyParams(href) : href)
+        : href;
     const _onClick = (ev: SyntheticEvent) => {
         if (ev.defaultPrevented || !isInternal) {
             return;