@openviking/react 0.1.2 → 0.1.4

package/dist/n~0.js

@@ -1,6 +1,163 @@
 import { Fragment, jsx, jsxs } from "react/jsx-runtime";
-import { forwardRef, useCallback, useEffect, useImperativeHandle, useRef, useState } from "react";
+import { cloneElement, forwardRef, useCallback, useEffect, useId, useImperativeHandle, useRef, useState } from "react";
+import { createPortal } from "react-dom";
+import { resolveLocale, mergeLabels } from "./nx~0.js";
 import { FolderOpenIcon, FolderIcon, ChevronRightIcon, DocumentIcon } from "./k~0.js";
+import { useOverlayPosition } from "./o~0.js";
+import { searchreact } from "./p~0.js";
+const messages = {
+    search: 'Search files…',
+    refresh: 'Refresh file tree',
+    empty: 'No files yet',
+    error: 'Failed to load',
+    retry: 'Retry',
+    loadMore: 'Load more',
+    loading: 'Loading…',
+    expand: 'Expand {name}',
+    collapse: 'Collapse {name}',
+    info: {
+        description: {
+            userRoot: 'Context data for the current user',
+            memories: 'Long-term memory accumulated across sessions',
+            peers: 'Context isolated per application or workspace',
+            privacy: 'Keys and other sensitive configuration',
+            userResources: 'Private knowledge of this user',
+            sessions: 'Conversation and task execution records',
+            skills: 'Skills and tools available to the agent',
+            profile: 'User identity and background',
+            preferences: 'Personalized user preferences',
+            entities: 'People, projects, organizations and other entities',
+            events: 'Key events archived by date',
+            identity: 'Agent name and persona',
+            soul: 'Agent behaviour guidelines and boundaries',
+            cases: 'Interaction cases used to train experience',
+            trajectories: 'Reusable task execution trajectories',
+            experiences: 'Execution experience distilled automatically',
+            sharedResources: 'External resources the agent can reference',
+            agentRoot: 'Agent capabilities, tools and experience',
+            agentEndpoints: 'Communication endpoints shared across the account',
+            agentPayments: 'Payment capabilities shared across the account',
+            agentSkills: 'Skill definitions callable across the account',
+            agentTools: 'Tool configuration shared across the account',
+            memoryRoot: 'Long-term memory and accumulated information',
+            resourceRoot: 'External knowledge the agent can reference',
+            sessionRoot: 'Raw session records of the user',
+            systemRoot: 'Built-in system resources'
+        },
+        triggerBehavior: {
+            userRoot: 'Created from the current user identity; no manual setup needed',
+            memories: 'Committed sessions, explicit requests to remember, or continuous extraction from sessions',
+            peers: 'Created when connecting as a specific peer, isolating memory and material per peer_id',
+            userResources: 'Imported material, uploaded to this user’s private resource directory',
+            sessions: 'Created when a session calls OpenViking; messages, tool calls and archives are saved continuously',
+            skills: 'Created, installed or imported as a personal skill',
+            profile: 'A stable, explicit user background or working style appears in conversation',
+            preferences: 'The user explicitly states a specific preference, habit or style',
+            entities: 'A person, project or organization worth keeping appears in conversation',
+            events: 'An important decision, commitment, arrangement, progress or result appears in dialogue',
+            identity: 'Initialized on the first memory extraction run; later updated by write operations',
+            soul: 'Initialized on the first memory extraction run; later adjusted by write operations',
+            cases: 'A session with a clear task and an evaluable execution result is committed',
+            trajectories: 'A task containing decisions, tool calls or multi-step execution is committed',
+            experiences: 'Distilled from task cases and execution trajectories',
+            sharedResources: 'Imported material, uploaded to a shared resource space',
+            agentEndpoints: 'Configured when an integration endpoint is registered for the account',
+            agentPayments: 'Configured when a payment capability is enabled for the account',
+            agentSkills: 'Installed or imported as a shared skill available to every agent',
+            agentTools: 'Configured when a tool is registered for the account'
+        },
+        field: {
+            description: "Description",
+            triggerBehavior: 'Trigger',
+            path: 'Path'
+        }
+    }
+};
+const en_US = messages;
+const zh_CN_messages = {
+    search: '搜索文件…',
+    refresh: '刷新文件树',
+    empty: '暂无文件',
+    error: '加载失败',
+    retry: '重试',
+    loadMore: '加载更多',
+    loading: '加载中…',
+    expand: '展开 {name}',
+    collapse: '收起 {name}',
+    info: {
+        description: {
+            userRoot: '当前用户的上下文数据',
+            memories: '跨会话沉淀的长期记忆',
+            peers: '按应用或工作区隔离的上下文',
+            privacy: '密钥等敏感配置',
+            userResources: '该用户的私有知识资料',
+            sessions: '对话与任务运行记录',
+            skills: 'Agent 可用的技能与工具',
+            profile: '用户身份与背景',
+            preferences: '个性化偏好',
+            entities: '人物、项目、组织等实体',
+            events: '按日期归档的关键事件',
+            identity: 'Agent 名称与人设',
+            soul: 'Agent 行为准则与边界',
+            cases: '用于训练经验的交互案例',
+            trajectories: '可复用的任务执行轨迹',
+            experiences: '自动提炼的执行经验',
+            sharedResources: 'Agent 可引用的外部资料',
+            agentRoot: 'Agent 的能力、工具与经验',
+            agentEndpoints: '账号内共享的通信端点配置',
+            agentPayments: '账号内共享的支付能力配置',
+            agentSkills: '账号内可调用的技能定义',
+            agentTools: '账号内共享的工具配置',
+            memoryRoot: '长期记忆与累积信息',
+            resourceRoot: 'Agent 可引用的外部知识',
+            sessionRoot: '用户的原始会话记录',
+            systemRoot: '系统内置资源'
+        },
+        triggerBehavior: {
+            userRoot: '根据当前用户身份自动建立，无需手动创建',
+            memories: '提交会话、主动要求记住信息，或从会话中持续抽取',
+            peers: '以特定 peer 身份连接时建立，按 peer_id 隔离记忆与资料',
+            userResources: '导入资料时上传到该用户的私有资源目录',
+            sessions: '会话调用 OpenViking 时建立，消息、工具调用与归档持续写入',
+            skills: '作为个人技能被创建、安装或导入',
+            profile: '对话中出现稳定、明确的用户背景或工作方式',
+            preferences: '用户明确表达某个偏好、习惯或风格',
+            entities: '对话中出现值得保留的人物、项目或组织',
+            events: '对话中出现重要决定、承诺、安排、进展或结果',
+            identity: '首次记忆抽取时初始化，之后由写入操作更新',
+            soul: '首次记忆抽取时初始化，之后由写入操作调整',
+            cases: '提交了任务明确、执行结果可评估的会话',
+            trajectories: '提交了包含决策、工具调用或多步执行的任务',
+            experiences: '从任务案例与执行轨迹中提炼',
+            sharedResources: '导入资料时上传到共享资源空间',
+            agentEndpoints: '为账号注册集成端点时配置',
+            agentPayments: '为账号开通支付能力时配置',
+            agentSkills: '作为共享技能安装或导入，供所有 Agent 使用',
+            agentTools: '为账号注册工具时配置'
+        },
+        field: {
+            description: '说明',
+            triggerBehavior: '触发行为',
+            path: '路径'
+        }
+    }
+};
+const zh_CN = zh_CN_messages;
+const LOCALES = {
+    'en-US': en_US,
+    'zh-CN': zh_CN
+};
+function resolveFileTreeLabels(locale = 'en-US', labels) {
+    const defaults = resolveLocale(LOCALES, locale);
+    return {
+        ...mergeLabels(defaults, labels),
+        info: {
+            description: mergeLabels(defaults.info.description, labels?.info?.description),
+            triggerBehavior: mergeLabels(defaults.info.triggerBehavior, labels?.info?.triggerBehavior),
+            field: mergeLabels(defaults.info.field, labels?.info?.field)
+        }
+    };
+}
 function FileTreeFolderIcon({ open }) {
     return /*#__PURE__*/ jsxs("span", {
         className: "ov-file-tree__folder",
@@ -59,6 +216,12 @@ const USER_SCOPE_KEY_BY_SEGMENT = {
     sessions: 'sessions',
     skills: 'skills'
 };
+const AGENT_KEY_BY_SEGMENT = {
+    endpoints: 'agentEndpoints',
+    payments: 'agentPayments',
+    skills: 'agentSkills',
+    tools: 'agentTools'
+};
 const MEMORY_KEY_BY_SEGMENT = {
     'profile.md': 'profile',
     preferences: 'preferences',
@@ -96,70 +259,149 @@ function resolveFileTreeInfoKey(uri) {
         if ('resources' === first) return 'sharedResources';
         return ROOT_KEY_BY_SEGMENT[first] ?? null;
     }
+    if (('agent' === first || 'agents' === first) && 2 === segments.length) {
+        const second = segments[1];
+        return second ? AGENT_KEY_BY_SEGMENT[second] ?? null : null;
+    }
     return null;
 }
 function showsInlineDescription(key) {
     return null !== key && !TOOLTIP_ONLY_KEYS.has(key);
 }
-const DESCRIPTION = {
-    userRoot: 'Context data for the current user',
-    memories: 'Long-term memory accumulated across sessions',
-    peers: 'Context isolated per application or workspace',
-    privacy: 'Keys and other sensitive configuration',
-    userResources: 'Private knowledge of this user',
-    sessions: 'Conversation and task execution records',
-    skills: 'Skills and tools available to the agent',
-    profile: 'User identity and background',
-    preferences: 'Personalized user preferences',
-    entities: 'People, projects, organizations and other entities',
-    events: 'Key events archived by date',
-    identity: 'Agent name and persona',
-    soul: 'Agent behaviour guidelines and boundaries',
-    cases: 'Interaction cases used to train experience',
-    trajectories: 'Reusable task execution trajectories',
-    experiences: 'Execution experience distilled automatically',
-    sharedResources: 'External resources the agent can reference',
-    agentRoot: 'Agent capabilities, tools and experience',
-    memoryRoot: 'Long-term memory and accumulated information',
-    resourceRoot: 'External knowledge the agent can reference',
-    sessionRoot: 'Raw session records of the user',
-    systemRoot: 'Built-in system resources'
-};
-const TRIGGER_BEHAVIOR = {
-    userRoot: 'Created from the current user identity; no manual setup needed',
-    memories: 'Committed sessions, explicit requests to remember, or continuous extraction from sessions',
-    peers: 'Created when connecting as a specific peer, isolating memory and material per peer_id',
-    userResources: 'Imported material, uploaded to this user’s private resource directory',
-    sessions: 'Created when a session calls OpenViking; messages, tool calls and archives are saved continuously',
-    skills: 'Created, installed or imported as a personal skill',
-    profile: 'A stable, explicit user background or working style appears in conversation',
-    preferences: 'The user explicitly states a specific preference, habit or style',
-    entities: 'A person, project or organization worth keeping appears in conversation',
-    events: 'An important decision, commitment, arrangement, progress or result appears in dialogue',
-    identity: 'Initialized on the first memory extraction run; later updated by write operations',
-    soul: 'Initialized on the first memory extraction run; later adjusted by write operations',
-    cases: 'A session with a clear task and an evaluable execution result is committed',
-    trajectories: 'A task containing decisions, tool calls or multi-step execution is committed',
-    experiences: 'Distilled from task cases and execution trajectories',
-    sharedResources: 'Imported material, uploaded to a shared resource space'
-};
-const DEFAULT_INFO_LABELS = {
-    description: DESCRIPTION,
-    triggerBehavior: TRIGGER_BEHAVIOR,
-    field: {
-        description: "Description",
-        triggerBehavior: 'Trigger',
-        path: 'Path'
-    }
-};
+const DEFAULT_INFO_LABELS = en_US.info;
 function resolveInfoCopy(key, hostLabels) {
-    const description = hostLabels?.description?.[key] ?? DESCRIPTION[key] ?? void 0;
-    const triggerBehavior = hostLabels?.triggerBehavior?.[key] ?? TRIGGER_BEHAVIOR[key] ?? void 0;
+    const description = hostLabels?.description?.[key] ?? DEFAULT_INFO_LABELS.description?.[key] ?? void 0;
+    const triggerBehavior = hostLabels?.triggerBehavior?.[key] ?? DEFAULT_INFO_LABELS.triggerBehavior?.[key] ?? void 0;
     return {
         description: description || void 0,
         triggerBehavior: triggerBehavior || void 0
     };
 }
+function useMergedRef(ref, target) {
+    return useCallback((node)=>{
+        target.current = node;
+        if ('function' == typeof ref) ref(node);
+        else if (ref) ref.current = node;
+    }, [
+        ref,
+        target
+    ]);
+}
+function Popover({ children, content, placement = 'right', trigger = 'hover', delay = 300, disabled = false, className, style, onOpenChange }) {
+    const [open, setOpen] = useState(false);
+    const triggerRef = useRef(null);
+    const timerRef = useRef(void 0);
+    const [surfaceNode, setSurfaceNode] = useState(null);
+    const id = useId();
+    const position = useOverlayPosition(open, triggerRef, surfaceNode, placement);
+    const change = useCallback((next)=>{
+        setOpen(next);
+        onOpenChange?.(next);
+    }, [
+        onOpenChange
+    ]);
+    const clearTimer = useCallback(()=>{
+        if (void 0 !== timerRef.current) {
+            window.clearTimeout(timerRef.current);
+            timerRef.current = void 0;
+        }
+    }, []);
+    useEffect(()=>clearTimer, [
+        clearTimer
+    ]);
+    useEffect(()=>{
+        if (disabled) {
+            clearTimer();
+            setOpen(false);
+        }
+    }, [
+        disabled,
+        clearTimer
+    ]);
+    useEffect(()=>{
+        if (!open || 'click' !== trigger) return;
+        const onPointerDown = (event)=>{
+            const target = event.target;
+            if (surfaceNode?.contains(target) || triggerRef.current?.contains(target)) return;
+            change(false);
+        };
+        const onKeyDown = (event)=>{
+            if ('Escape' === event.key) change(false);
+        };
+        document.addEventListener('mousedown', onPointerDown);
+        document.addEventListener('keydown', onKeyDown);
+        return ()=>{
+            document.removeEventListener('mousedown', onPointerDown);
+            document.removeEventListener('keydown', onKeyDown);
+        };
+    }, [
+        change,
+        open,
+        surfaceNode,
+        trigger
+    ]);
+    const show = ()=>{
+        if (disabled) return;
+        if ('click' === trigger) return void change(!open);
+        clearTimer();
+        timerRef.current = window.setTimeout(()=>{
+            change(true);
+            timerRef.current = void 0;
+        }, delay);
+    };
+    const hide = ()=>{
+        if ('click' === trigger) return;
+        clearTimer();
+        change(false);
+    };
+    const child = children;
+    const childProps = child.props;
+    const childRef = child.ref;
+    const mergedRef = useMergedRef(childRef, triggerRef);
+    const declaresExpanded = 'aria-expanded' in childProps;
+    const triggerElement = /*#__PURE__*/ cloneElement(child, {
+        ref: mergedRef,
+        ...declaresExpanded ? {} : {
+            'aria-expanded': open
+        },
+        onMouseEnter: (event)=>{
+            childProps.onMouseEnter?.(event);
+            if ('hover' === trigger) show();
+        },
+        onMouseLeave: (event)=>{
+            childProps.onMouseLeave?.(event);
+            if ('hover' === trigger) hide();
+        },
+        onClick: (event)=>{
+            childProps.onClick?.(event);
+            if ('click' === trigger) show();
+        }
+    });
+    const surface = open ? /*#__PURE__*/ createPortal(/*#__PURE__*/ jsx("div", {
+        ref: setSurfaceNode,
+        id: id,
+        role: 'click' === trigger ? 'dialog' : 'note',
+        className: [
+            'ov-popover',
+            className
+        ].filter(Boolean).join(' '),
+        "data-placement": position.placement,
+        style: {
+            top: position.top,
+            left: position.left,
+            ...style
+        },
+        onMouseEnter: 'hover' === trigger ? clearTimer : void 0,
+        onMouseLeave: 'hover' === trigger ? hide : void 0,
+        children: content
+    }), document.body) : null;
+    return /*#__PURE__*/ jsxs(Fragment, {
+        children: [
+            triggerElement,
+            surface
+        ]
+    });
+}
 const DEFAULT_FIELDS = {
     description: "Description",
     triggerBehavior: 'Trigger',
@@ -167,7 +409,8 @@ const DEFAULT_FIELDS = {
 };
 function resolveFileTreeInfoCopy(row, infoLabels) {
     const key = resolveFileTreeInfoKey(row.uri);
-    const builtIn = key ? resolveInfoCopy(key, infoLabels) : {};
+    if (!key) return null;
+    const builtIn = resolveInfoCopy(key, infoLabels);
     const description = row.description ?? builtIn.description;
     if (!description && !builtIn.triggerBehavior) return null;
     return {
@@ -183,14 +426,14 @@ function resolveFileTreeInfoCopy(row, infoLabels) {
 }
 function FileTreeInfoTooltip({ copy }) {
     const { description, fields, path, title, triggerBehavior } = copy;
-    return /*#__PURE__*/ jsxs("span", {
+    return /*#__PURE__*/ jsxs("div", {
         className: "ov-file-tree__info",
         children: [
-            /*#__PURE__*/ jsx("span", {
+            /*#__PURE__*/ jsx("div", {
                 className: "ov-file-tree__info-title",
                 children: title
             }),
-            description ? /*#__PURE__*/ jsxs("span", {
+            description ? /*#__PURE__*/ jsxs("div", {
                 className: "ov-file-tree__info-row",
                 children: [
                     /*#__PURE__*/ jsx("span", {
@@ -203,7 +446,7 @@ function FileTreeInfoTooltip({ copy }) {
                     })
                 ]
             }) : null,
-            triggerBehavior ? /*#__PURE__*/ jsxs("span", {
+            triggerBehavior ? /*#__PURE__*/ jsxs("div", {
                 className: "ov-file-tree__info-row",
                 children: [
                     /*#__PURE__*/ jsx("span", {
@@ -216,7 +459,7 @@ function FileTreeInfoTooltip({ copy }) {
                     })
                 ]
             }) : null,
-            /*#__PURE__*/ jsxs("span", {
+            /*#__PURE__*/ jsxs("div", {
                 className: "ov-file-tree__info-row",
                 children: [
                     /*#__PURE__*/ jsx("span", {
@@ -232,31 +475,22 @@ function FileTreeInfoTooltip({ copy }) {
         ]
     });
 }
-function FileTreeTooltipSurface({ row, infoLabels, renderRowTooltip }) {
+function FileTreeTooltipContent({ row, infoLabels, renderRowTooltip }) {
     if (renderRowTooltip) {
         const custom = renderRowTooltip(row);
         if (null == custom || false === custom) return null;
-        return /*#__PURE__*/ jsx("span", {
-            role: "tooltip",
-            className: "ov-file-tree__tooltip",
-            children: custom
-        });
+        return custom;
     }
     const copy = resolveFileTreeInfoCopy(row, infoLabels);
     if (!copy) return null;
-    return /*#__PURE__*/ jsx("span", {
-        role: "tooltip",
-        className: "ov-file-tree__tooltip",
-        children: /*#__PURE__*/ jsx(FileTreeInfoTooltip, {
-            copy: copy
-        })
+    return /*#__PURE__*/ jsx(FileTreeInfoTooltip, {
+        copy: copy
     });
 }
-const INDENT = 20;
-const CHEVRON_SIZE = 16;
+const INDENT = 'var(--ov-ui-file-tree-indent, 20px)';
 function rowStyle(depth) {
     return {
-        paddingLeft: 8 + depth * INDENT
+        paddingLeft: `calc(2px + ${depth} * ${INDENT})`
     };
 }
 function Guides({ depth }) {
@@ -267,14 +501,14 @@ function Guides({ depth }) {
                 "aria-hidden": "true",
                 className: "ov-file-tree__guide",
                 style: {
-                    left: 8 + level * INDENT + CHEVRON_SIZE / 2
+                    left: `calc(10px + ${level} * ${INDENT})`
                 }
             }, level))
     });
 }
 const FILE_TREE_ROW_ATTRIBUTE = 'data-file-tree-row-id';
 function FileTreeRowView({ row, ctx }) {
-    const { text, selectedId, tooltipRowId, getRowAttributes, renderDashboard, renderRowTooltip, renderRowIcon, onSelect, onToggleExpand, onOpenRetentionSettings, onRowKeyDown, onRowEnter, onRowLeave } = ctx;
+    const { text, selectedId, getRowAttributes, renderDashboard, renderRowTooltip, renderRowIcon, onSelect, onToggleExpand, onOpenRetentionSettings, onRowKeyDown } = ctx;
     const isDirectory = 'directory' === row.type;
     const canExpand = isDirectory && false !== row.hasChildren;
     const isExpanded = Boolean(row.expanded);
@@ -293,7 +527,7 @@ function FileTreeRowView({ row, ctx }) {
         event.stopPropagation();
         onToggleExpand?.(row);
     };
-    return /*#__PURE__*/ jsxs("div", {
+    const rowNode = /*#__PURE__*/ jsxs("div", {
         role: "treeitem",
         tabIndex: 0,
         "aria-level": row.depth + 1,
@@ -315,10 +549,6 @@ function FileTreeRowView({ row, ctx }) {
         },
         onClick: handleClick,
         onKeyDown: (event)=>onRowKeyDown(event, row),
-        onMouseEnter: ()=>onRowEnter(row.id),
-        onMouseLeave: onRowLeave,
-        onFocus: ()=>onRowEnter(row.id),
-        onBlur: onRowLeave,
         children: [
             /*#__PURE__*/ jsx(Guides, {
                 depth: row.depth
@@ -348,6 +578,7 @@ function FileTreeRowView({ row, ctx }) {
             }),
             /*#__PURE__*/ jsxs("span", {
                 className: "ov-file-tree__label-group",
+                "data-description": Boolean(description) || void 0,
                 children: [
                     /*#__PURE__*/ jsx("span", {
                         className: "ov-file-tree__label",
@@ -382,14 +613,23 @@ function FileTreeRowView({ row, ctx }) {
             dashboard ? /*#__PURE__*/ jsx("span", {
                 className: "ov-file-tree__dashboard",
                 children: dashboard
-            }) : null,
-            tooltipRowId === row.id ? /*#__PURE__*/ jsx(FileTreeTooltipSurface, {
-                row: row,
-                infoLabels: ctx.infoLabels,
-                renderRowTooltip: renderRowTooltip
             }) : null
         ]
     });
+    const custom = renderRowTooltip?.(row);
+    const hasContent = renderRowTooltip ? null != custom && false !== custom : null !== resolveFileTreeInfoCopy(row, ctx.infoLabels);
+    if (!hasContent) return rowNode;
+    const tooltipContent = /*#__PURE__*/ jsx(FileTreeTooltipContent, {
+        row: row,
+        infoLabels: ctx.infoLabels,
+        renderRowTooltip: renderRowTooltip
+    });
+    return /*#__PURE__*/ jsx(Popover, {
+        content: tooltipContent,
+        placement: "right",
+        trigger: "hover",
+        children: rowNode
+    });
 }
 function FileTreeStateRow({ row, ctx }) {
     const { text, onLoadMore, onRetry, getRowAttributes, renderSpinner } = ctx;
@@ -567,44 +807,63 @@ function handleRowKeyDown(event, { root, row, onSelect, onToggleExpand }) {
             return;
     }
 }
-const DEFAULT_DELAY = 400;
-function useRowTooltip(delay = DEFAULT_DELAY) {
-    const [tooltipRowId, setTooltipRowId] = useState(null);
-    const timerRef = useRef(void 0);
-    const clear = useCallback(()=>{
-        if (void 0 !== timerRef.current) {
-            window.clearTimeout(timerRef.current);
-            timerRef.current = void 0;
-        }
-    }, []);
-    useEffect(()=>clear, [
-        clear
-    ]);
-    const show = useCallback((rowId)=>{
-        clear();
-        timerRef.current = window.setTimeout(()=>{
-            setTooltipRowId(rowId);
-            timerRef.current = void 0;
-        }, delay);
-    }, [
-        clear,
-        delay
-    ]);
-    const hide = useCallback(()=>{
-        clear();
-        setTooltipRowId(null);
-    }, [
-        clear
-    ]);
-    return {
-        tooltipRowId,
-        show,
-        hide
-    };
+function FileTreeToolbar({ search, refresh, text, refreshing, onSearch, onRefresh }) {
+    if (!search && !refresh) return null;
+    const searchDisabled = !onSearch || 'object' == typeof search && search.disabled;
+    const refreshDisabled = !onRefresh || 'object' == typeof refresh && refresh.disabled;
+    const busy = refreshing || 'object' == typeof refresh && refresh.loading;
+    return /*#__PURE__*/ jsxs("div", {
+        className: "ov-file-tree__controls",
+        children: [
+            search ? /*#__PURE__*/ jsxs("button", {
+                type: "button",
+                className: "ov-file-tree__search",
+                disabled: Boolean(searchDisabled),
+                onClick: onSearch,
+                title: text.search,
+                children: [
+                    /*#__PURE__*/ jsx(searchreact, {
+                        width: 16,
+                        height: 16,
+                        "aria-hidden": "true"
+                    }),
+                    /*#__PURE__*/ jsx("span", {
+                        className: "ov-file-tree__search-label",
+                        children: text.search
+                    })
+                ]
+            }) : null,
+            refresh ? /*#__PURE__*/ jsx("button", {
+                type: "button",
+                className: "ov-file-tree__refresh",
+                "aria-label": text.refresh,
+                title: text.refresh,
+                "aria-busy": Boolean(busy),
+                disabled: Boolean(refreshDisabled || busy),
+                onClick: onRefresh,
+                children: /*#__PURE__*/ jsx("svg", {
+                    "aria-hidden": "true",
+                    width: 14,
+                    height: 14,
+                    viewBox: "0 0 16 16",
+                    fill: "none",
+                    className: busy ? 'ov-file-tree__refresh-spinning' : void 0,
+                    children: /*#__PURE__*/ jsx("path", {
+                        d: "M13 6a5.2 5.2 0 1 0 .15 3.5M13 2.5V6H9.5",
+                        stroke: "currentColor",
+                        strokeWidth: "1.5",
+                        strokeLinecap: "round",
+                        strokeLinejoin: "round"
+                    })
+                })
+            }) : null
+        ]
+    });
 }
 function useFileTreeActions(props) {
     const pending = useRef(new Set());
-    const { select, toggleExpand, loadMore, retry, openRetentionSettings } = props.operations ?? {};
+    const [refreshing, setRefreshing] = useState(false);
+    const { select, toggleExpand, loadMore, retry, openRetentionSettings, search, refresh } = props.operations ?? {};
     async function run(key, execute, notify, value) {
         if (pending.current.has(key)) return;
         pending.current.add(key);
@@ -618,6 +877,13 @@ function useFileTreeActions(props) {
         notify?.(value);
     }
     return {
+        refreshing,
+        onSearch: search ? ()=>void run('search', search, props.onSearch, void 0) : void 0,
+        onRefresh: refresh ? ()=>{
+            if (pending.current.has('refresh')) return;
+            setRefreshing(true);
+            run('refresh', refresh, props.onRefresh, void 0).finally(()=>setRefreshing(false));
+        } : void 0,
         onSelect: select ? (row)=>void run(`select:${row.id}`, select, props.onSelect, row) : void 0,
         onToggleExpand: toggleExpand ? (row)=>void run(`toggle:${row.id}`, toggleExpand, props.onToggleExpand, row) : void 0,
         onLoadMore: loadMore ? (row)=>void run(`load:${row.id}`, loadMore, props.onLoadMore, row) : void 0,
@@ -635,33 +901,21 @@ function FileTreeSpinner({ className, ...rest }) {
         ].filter(Boolean).join(' ')
     });
 }
-const DEFAULT_LABELS = {
-    empty: 'No files yet',
-    error: 'Failed to load',
-    retry: 'Retry',
-    loadMore: 'Load more',
-    loading: 'Loading…',
-    expand: 'Expand {name}',
-    collapse: 'Collapse {name}'
-};
 function findRow(root, id) {
     return root?.querySelector(`[${FILE_TREE_ROW_ATTRIBUTE}="${CSS.escape(id)}"]`) ?? null;
 }
-const file_tree_FileTree = /*#__PURE__*/ forwardRef(function({ rows, operations, selectedId, isReady = true, loadingFallback, errorFallback, emptyFallback, slots, labels, getRowAttributes, renderDashboard, renderRowTooltip, renderRowIcon, onSelect, onToggleExpand, onLoadMore, onRetry, onOpenRetentionSettings, className, ...rest }, ref) {
+const file_tree_FileTree = /*#__PURE__*/ forwardRef(function({ rows, locale, operations, selectedId, search, refresh, isReady = true, loadingFallback, errorFallback, emptyFallback, slots, labels, getRowAttributes, renderDashboard, renderRowTooltip, renderRowIcon, onSelect, onToggleExpand, onLoadMore, onRetry, onOpenRetentionSettings, onSearch, onRefresh, className, ...rest }, ref) {
     const rootRef = useRef(null);
-    const text = {
-        ...DEFAULT_LABELS,
-        ...labels,
-        info: labels?.info ?? DEFAULT_LABELS.info
-    };
-    const tooltip = useRowTooltip();
+    const text = resolveFileTreeLabels(locale, labels);
     const actions = useFileTreeActions({
         operations,
         onSelect,
         onToggleExpand,
         onLoadMore,
         onRetry,
-        onOpenRetentionSettings
+        onOpenRetentionSettings,
+        onSearch,
+        onRefresh
     });
     useImperativeHandle(ref, ()=>({
             getRowElement: (id)=>findRow(rootRef.current, id),
@@ -677,9 +931,8 @@ const file_tree_FileTree = /*#__PURE__*/ forwardRef(function({ rows, operations,
         }), []);
     const ctx = {
         text,
-        infoLabels: labels?.info,
+        infoLabels: text.info,
         selectedId,
-        tooltipRowId: tooltip.tooltipRowId,
         getRowAttributes,
         renderDashboard,
         renderRowTooltip,
@@ -691,9 +944,7 @@ const file_tree_FileTree = /*#__PURE__*/ forwardRef(function({ rows, operations,
                 row,
                 onSelect: actions.onSelect,
                 onToggleExpand: actions.onToggleExpand
-            }),
-        onRowEnter: tooltip.show,
-        onRowLeave: tooltip.hide
+            })
     };
     return /*#__PURE__*/ jsxs("div", {
         ...rest,
@@ -707,6 +958,14 @@ const file_tree_FileTree = /*#__PURE__*/ forwardRef(function({ rows, operations,
                 className: "ov-file-tree__toolbar",
                 children: slots.toolbar
             }) : null,
+            /*#__PURE__*/ jsx(FileTreeToolbar, {
+                search: search,
+                refresh: refresh,
+                text: text,
+                refreshing: actions.refreshing,
+                onSearch: actions.onSearch,
+                onRefresh: actions.onRefresh
+            }),
             /*#__PURE__*/ jsx("div", {
                 role: "tree",
                 "aria-label": rest['aria-label'],