@openviking/react 0.1.3 → 0.1.5

package/dist/l~0.js

@@ -1,9 +1,14 @@
 import { Fragment, jsx, jsxs } from "react/jsx-runtime";
 import { useCallback, useEffect, useId, useMemo, useRef, useState } from "react";
-import { Tooltip, FilePreview as file_preview_FilePreview } from "./30~0.js";
+import { FilePreview as file_preview_FilePreview } from "./3~0.js";
+import { Tooltip } from "./r~0.js";
 import { getFileTypeColor, resolveFileTypeIconKey, FolderIcon, getFileTypeIcon } from "./k~0.js";
+import { FileBrowserEntries } from "./2~0.js";
 import { FileTree as file_tree_FileTree } from "./n~0.js";
-import { OV_PATHS, useOvClient } from "./1~0.js";
+import { resolveLocale } from "./nx~0.js";
+import { OV_PATHS } from "./ck~0.js";
+import { useLocale, LocaleProvider } from "./28~0.js";
+import { useOvClient } from "./ae~0.js";
 function clampResizableWidth(width, min, max) {
     const rounded = Math.round(width);
     const lower = Math.max(min, rounded);
@@ -315,13 +320,14 @@ function directoryIcon() {
         className: "ov-file-tree__file-type-icon"
     });
 }
-function FileBrowserTreePane({ toolbarActions, searchId, browser, treeLabels, searchPlaceholder, refreshLabel, searchLoading, searchEmpty, searchErrorLabel, retryLabel }) {
+function FileBrowserTreePane({ entries, locale, searchId, browser, treeLabels, searchPlaceholder, refreshLabel, searchLoading, searchEmpty, searchErrorLabel, retryLabel }) {
     return /*#__PURE__*/ jsxs(Fragment, {
         children: [
-            toolbarActions ? /*#__PURE__*/ jsx("div", {
-                className: "ov-file-browser__entries",
-                children: toolbarActions
-            }) : null,
+            /*#__PURE__*/ jsx(FileBrowserEntries, {
+                ...entries,
+                locale: locale,
+                className: "ov-file-browser__entries"
+            }),
             /*#__PURE__*/ jsx(FileBrowserToolbar, {
                 searchId: searchId,
                 query: browser.query,
@@ -335,6 +341,7 @@ function FileBrowserTreePane({ toolbarActions, searchId, browser, treeLabels, se
             /*#__PURE__*/ jsx("div", {
                 className: "ov-file-browser__tree-scroll",
                 children: /*#__PURE__*/ jsx(file_tree_FileTree, {
+                    locale: locale,
                     rows: browser.rows,
                     selectedId: browser.selectedId,
                     isReady: browser.isReady,
@@ -373,7 +380,8 @@ function FileBrowserTreePane({ toolbarActions, searchId, browser, treeLabels, se
         ]
     });
 }
-const DEFAULT_LABELS = {
+const messages = {
+    formatCharacterCount: (count)=>`${count.toLocaleString('en-US')} ${1 === count ? 'character' : 'characters'}`,
     empty: 'Select a file to preview',
     error: 'Failed to load the directory',
     retry: 'Retry',
@@ -396,10 +404,39 @@ const DEFAULT_LABELS = {
     summaryEmpty: 'No summary generated yet',
     summaryFailed: 'The summary could not be loaded.'
 };
-function resolveLabels(labels) {
+const en_US = messages;
+const zh_CN_messages = {
+    formatCharacterCount: (count)=>`${count.toLocaleString('zh-CN')} 个字符`,
+    empty: '选择一个文件查看内容',
+    error: '目录加载失败',
+    retry: '重试',
+    refresh: '刷新',
+    searchPlaceholder: '搜索文件 ⌘+K...',
+    searchEmpty: '没有匹配的资源',
+    searchFailed: '搜索失败',
+    loading: '加载中…',
+    searchLoading: '搜索中…',
+    previewMode: '预览',
+    sourceMode: '源码',
+    copyPath: '复制路径',
+    copyContent: '复制正文',
+    download: '下载',
+    history: '版本历史',
+    viewSwitch: '切换视图',
+    resizeTree: '调整目录树宽度',
+    l0Summary: 'L0 摘要',
+    l1Overview: 'L1 总览',
+    summaryEmpty: '暂无生成内容',
+    summaryFailed: '摘要加载失败。'
+};
+const zh_CN = zh_CN_messages;
+const LOCALES = {
+    'en-US': en_US,
+    'zh-CN': zh_CN
+};
+function resolveLabels(labels, locale) {
     return {
-        ...DEFAULT_LABELS,
-        ...labels,
+        ...resolveLocale(LOCALES, locale, labels),
         tree: labels?.tree,
         previewLabels: labels?.preview
     };
@@ -412,84 +449,12 @@ function resolvePreviewLabels(text) {
         ...text.previewLabels
     };
 }
-const TREE_INFO_LABELS_ZH_CN = {
-    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: '路径'
-    }
-};
-function resolveTreeLabels(locale, hostLabels) {
-    if ('zh-CN' !== locale) return hostLabels;
-    const hostInfo = hostLabels?.info;
+function resolveSummaryLabels(locale, labels) {
+    const text = resolveLabels(labels, locale);
     return {
-        ...hostLabels,
-        info: {
-            ...TREE_INFO_LABELS_ZH_CN,
-            ...hostInfo,
-            description: {
-                ...TREE_INFO_LABELS_ZH_CN.description,
-                ...hostInfo?.description
-            },
-            triggerBehavior: {
-                ...TREE_INFO_LABELS_ZH_CN.triggerBehavior,
-                ...hostInfo?.triggerBehavior
-            },
-            field: {
-                ...TREE_INFO_LABELS_ZH_CN.field,
-                ...hostInfo?.field
-            }
-        }
+        l0: text.l0Summary,
+        l1: text.l1Overview,
+        failure: text.summaryFailed
     };
 }
 function useContainerWidth() {
@@ -730,7 +695,7 @@ function toBinaryTab(uri, name, file, icon, openParent) {
         }
     };
 }
-async function readDirectory(client, uri, options, labels, openParent) {
+async function readDirectory(client, uri, options) {
     const read = (path)=>client.request({
             method: 'GET',
             path,
@@ -756,12 +721,12 @@ async function readDirectory(client, uri, options, labels, openParent) {
     if (aborted && !aborted.ok) throw aborted.cause;
     if (!abstractResult.ok && !overviewResult.ok) throw abstractResult.cause;
     const reason = (result)=>result.ok ? void 0 : result.cause instanceof Error ? result.cause.message : String(result.cause);
-    return toDirectoryTab(uri, {
+    return {
         abstract: abstractResult.ok ? abstractResult.text : '',
         overview: overviewResult.ok ? overviewResult.text : '',
         abstractError: reason(abstractResult),
         overviewError: reason(overviewResult)
-    }, labels, openParent, directoryIcon());
+    };
 }
 async function resolveIsDirectory(client, uri, options) {
     try {
@@ -784,22 +749,19 @@ function abortError() {
     return error;
 }
 const MAX_LINES = 2000;
-const DEFAULT_SUMMARY_LABELS = {
-    l0: 'L0 Summary',
-    l1: 'L1 Overview',
-    failure: 'The summary could not be loaded.'
-};
-function useFsPreview({ client, uri, resourceType = 'file', labels = DEFAULT_SUMMARY_LABELS, openParent, generation = 0, requestOptions }) {
+function useFsPreview({ client, uri, resourceType = 'file', labels = resolveSummaryLabels('en-US'), formatCharacterCount = resolveLabels(void 0, 'en-US').formatCharacterCount, openParent, generation = 0, requestOptions }) {
+    const [directory, setDirectory] = useState(null);
     const [tabs, setTabs] = useState(null);
     const [activeKey, setActiveKey] = useState(null);
     const [error, setError] = useState(null);
-    const [footer, setFooter] = useState(void 0);
+    const [characterCount, setCharacterCount] = useState();
     useEffect(()=>{
+        setDirectory(null);
         if (!client || !uri) {
             setTabs(null);
             setActiveKey(null);
             setError(null);
-            setFooter(void 0);
+            setCharacterCount(void 0);
             return;
         }
         const controller = new AbortController();
@@ -809,7 +771,7 @@ function useFsPreview({ client, uri, resourceType = 'file', labels = DEFAULT_SUM
         setActiveKey(uri);
         setActiveKey(null);
         setError(null);
-        setFooter(void 0);
+        setCharacterCount(void 0);
         const options = {
             ...requestOptions,
             signal: controller.signal
@@ -817,16 +779,29 @@ function useFsPreview({ client, uri, resourceType = 'file', labels = DEFAULT_SUM
         const read = (async ()=>{
             const isDir = 'unknown' === resourceType ? await resolveIsDirectory(client, uri, options) : 'directory' === resourceType;
             if (controller.signal.aborted) throw abortError();
-            return isDir ? readDirectory(client, uri, options, labels, openParent) : readFile(client, uri, options, openParent);
+            return isDir ? {
+                summary: await readDirectory(client, uri, options)
+            } : {
+                tab: await readFile(client, uri, options, openParent)
+            };
         })();
-        read.then((tab)=>{
+        read.then((result)=>{
             if (controller.signal.aborted) return;
+            if (result.summary) {
+                setDirectory({
+                    uri,
+                    summary: result.summary
+                });
+                setActiveKey(uri);
+                return;
+            }
+            const tab = result.tab;
             setTabs([
                 tab
             ]);
             setActiveKey(tab.key);
-            const body = 'directory' === tab.kind ? tab.levels[0].source.content ?? '' : 'file' === tab.kind ? tab.source.content ?? '' : '';
-            setFooter(`${body.length} characters`);
+            const body = tab.source.content ?? '';
+            setCharacterCount(body.length);
         }, (cause)=>{
             if (isAbort(cause) || controller.signal.aborted) return;
             setTabs([]);
@@ -837,16 +812,19 @@ function useFsPreview({ client, uri, resourceType = 'file', labels = DEFAULT_SUM
         client,
         uri,
         resourceType,
-        labels,
         openParent,
         generation,
         requestOptions
     ]);
+    const directoryTab = directory?.uri === uri ? toDirectoryTab(directory.uri, directory.summary, labels, openParent, directoryIcon()) : void 0;
+    const count = directoryTab ? (directoryTab.levels[0].source.content ?? '').length : characterCount;
     return {
-        tabs,
+        tabs: directoryTab ? [
+            directoryTab
+        ] : tabs,
         activeKey,
         error,
-        footer,
+        footer: void 0 === count ? void 0 : formatCharacterCount(count),
         setActiveKey
     };
 }
@@ -1262,7 +1240,8 @@ function useFsTree({ client, rootUri, defaultExpandedUri, requestOptions }) {
         ...state
     };
 }
-function useFileBrowser({ rootUri, controlled = false, summaryLabels, defaultExpandedUri, currentUri, requestOptions, onUriChange }) {
+function useFileBrowser({ rootUri, locale: localeProp, controlled = false, summaryLabels, formatCharacterCount, defaultExpandedUri, currentUri, requestOptions, onUriChange }) {
+    const locale = useLocale(localeProp);
     const client = useOvClient();
     const [query, setQuery] = useState('');
     const [pendingUri, setPendingUri] = useState(currentUri);
@@ -1297,7 +1276,8 @@ function useFileBrowser({ rootUri, controlled = false, summaryLabels, defaultExp
         client,
         uri: activeUri,
         resourceType,
-        labels: summaryLabels,
+        labels: summaryLabels ?? resolveSummaryLabels(locale),
+        formatCharacterCount: formatCharacterCount ?? resolveLabels(void 0, locale).formatCharacterCount,
         openParent,
         generation: refreshGeneration,
         requestOptions
@@ -1371,13 +1351,14 @@ function useFileBrowser({ rootUri, controlled = false, summaryLabels, defaultExp
         actions
     };
 }
-function FileBrowser({ uri, defaultUri, rootUri = 'viking://', defaultExpandedUri, locale, toolbarActions, onUriChange, labels, requestOptions, className, style, ...rest }) {
+function FileBrowser({ uri, defaultUri, rootUri = 'viking://', defaultExpandedUri, locale: localeProp, agentConnect, onUriChange, onImportResources, renderImportResources, labels, requestOptions, className, style, ...rest }) {
+    const locale = useLocale(localeProp);
     const [internalUri, setInternalUri] = useState(()=>defaultUri ?? null);
     const [preferredTreeWidth, setPreferredTreeWidth] = useState(352);
     const searchId = useId();
     const isControlled = void 0 !== uri;
     const currentUri = isControlled ? uri : internalUri;
-    const text = resolveLabels(labels);
+    const text = resolveLabels(labels, locale);
     const { ref: layoutRef, width: layoutWidth } = useContainerWidth();
     const treeMaxWidth = resolveTreeMaxWidth(layoutWidth);
     const treeWidth = Math.min(preferredTreeWidth, treeMaxWidth);
@@ -1397,87 +1378,95 @@ function FileBrowser({ uri, defaultUri, rootUri = 'viking://', defaultExpandedUr
         text.l1Overview,
         text.summaryFailed
     ]);
-    const previewLabels = useMemo(()=>resolvePreviewLabels(resolveLabels(labels)), [
-        labels
-    ]);
-    const treeLabels = useMemo(()=>resolveTreeLabels(locale, text.tree), [
-        locale,
-        text.tree
+    const previewLabels = useMemo(()=>resolvePreviewLabels(resolveLabels(labels, locale)), [
+        labels,
+        locale
     ]);
     const browser = useFileBrowser({
         rootUri,
+        locale,
         controlled: isControlled,
         summaryLabels,
+        formatCharacterCount: text.formatCharacterCount,
         defaultExpandedUri,
         currentUri,
         requestOptions,
         onUriChange: changeUri
     });
-    return /*#__PURE__*/ jsxs("div", {
-        ...rest,
-        ref: layoutRef,
-        className: [
-            'ov-file-browser',
-            className
-        ].filter(Boolean).join(' '),
-        style: {
-            ...style,
-            '--ov-file-browser-tree-width': `${treeWidth}px`
-        },
-        children: [
-            /*#__PURE__*/ jsx("div", {
-                className: "ov-file-browser__tree",
-                children: /*#__PURE__*/ jsx(FileBrowserTreePane, {
-                    toolbarActions: toolbarActions,
-                    searchId: searchId,
-                    browser: browser,
-                    treeLabels: treeLabels,
-                    searchPlaceholder: text.searchPlaceholder,
-                    refreshLabel: text.refresh,
-                    searchLoading: text.searchLoading,
-                    searchEmpty: text.searchEmpty,
-                    searchErrorLabel: text.searchFailed,
-                    retryLabel: text.retry
-                })
-            }),
-            /*#__PURE__*/ jsx(ResizableHandle, {
-                label: text.resizeTree,
-                min: 200,
-                max: treeMaxWidth,
-                value: treeWidth,
-                onResize: setPreferredTreeWidth,
-                className: "ov-file-browser__resizer"
-            }),
-            browser.previewTabs && browser.previewTabs.length > 0 ? /*#__PURE__*/ jsx(FileBrowserDetail, {
-                tabs: browser.previewTabs,
-                activeKey: browser.previewKey,
-                locale: locale,
-                labels: previewLabels,
-                footer: browser.previewFooter,
-                viewLabels: {
-                    preview: text.previewMode,
-                    source: text.sourceMode,
-                    copyPath: text.copyPath,
-                    copyContent: text.copyContent,
-                    download: text.download,
-                    viewSwitch: text.viewSwitch
-                },
-                onActiveKeyChange: browser.actions.setPreviewKey
-            }) : browser.currentUri && browser.previewError ? /*#__PURE__*/ jsx("div", {
-                className: "ov-file-browser__detail",
-                children: /*#__PURE__*/ jsx(FileBrowserFailure, {
-                    message: text.error,
-                    detail: browser.previewError.message,
-                    retryLabel: text.retry,
-                    onRetry: ()=>void browser.actions.refresh()
-                })
-            }) : /*#__PURE__*/ jsx("div", {
-                className: "ov-file-browser__detail",
-                children: /*#__PURE__*/ jsx(FileBrowserEmpty, {
-                    label: text.empty
+    return /*#__PURE__*/ jsx(LocaleProvider, {
+        locale: locale,
+        children: /*#__PURE__*/ jsxs("div", {
+            ...rest,
+            ref: layoutRef,
+            className: [
+                'ov-file-browser',
+                className
+            ].filter(Boolean).join(' '),
+            style: {
+                ...style,
+                '--ov-file-browser-tree-width': `${treeWidth}px`
+            },
+            children: [
+                /*#__PURE__*/ jsx("div", {
+                    className: "ov-file-browser__tree",
+                    children: /*#__PURE__*/ jsx(FileBrowserTreePane, {
+                        entries: {
+                            agentConnect,
+                            onImportResources,
+                            renderImportResources,
+                            labels: labels?.entries
+                        },
+                        searchId: searchId,
+                        browser: browser,
+                        treeLabels: text.tree,
+                        locale: locale,
+                        searchPlaceholder: text.searchPlaceholder,
+                        refreshLabel: text.refresh,
+                        searchLoading: text.searchLoading,
+                        searchEmpty: text.searchEmpty,
+                        searchErrorLabel: text.searchFailed,
+                        retryLabel: text.retry
+                    })
+                }),
+                /*#__PURE__*/ jsx(ResizableHandle, {
+                    label: text.resizeTree,
+                    min: 200,
+                    max: treeMaxWidth,
+                    value: treeWidth,
+                    onResize: setPreferredTreeWidth,
+                    className: "ov-file-browser__resizer"
+                }),
+                browser.previewTabs && browser.previewTabs.length > 0 ? /*#__PURE__*/ jsx(FileBrowserDetail, {
+                    tabs: browser.previewTabs,
+                    activeKey: browser.previewKey,
+                    locale: locale,
+                    labels: previewLabels,
+                    footer: browser.previewFooter,
+                    viewLabels: {
+                        preview: text.previewMode,
+                        source: text.sourceMode,
+                        copyPath: text.copyPath,
+                        copyContent: text.copyContent,
+                        download: text.download,
+                        viewSwitch: text.viewSwitch
+                    },
+                    onActiveKeyChange: browser.actions.setPreviewKey
+                }) : browser.currentUri && browser.previewError ? /*#__PURE__*/ jsx("div", {
+                    className: "ov-file-browser__detail",
+                    children: /*#__PURE__*/ jsx(FileBrowserFailure, {
+                        message: text.error,
+                        detail: browser.previewError.message,
+                        retryLabel: text.retry,
+                        onRetry: ()=>void browser.actions.refresh()
+                    })
+                }) : /*#__PURE__*/ jsx("div", {
+                    className: "ov-file-browser__detail",
+                    children: /*#__PURE__*/ jsx(FileBrowserEmpty, {
+                        label: text.empty
+                    })
                 })
-            })
-        ]
+            ]
+        })
     });
 }
 export { FileBrowser, useFileBrowser };

package/dist/modules/console/command-messages.d.ts

@@ -0,0 +1,19 @@
+import type { TuiRecord } from '../../components/tui/index.js';
+import type { Locale } from '../../shared/locale.js';
+import { resolveConsoleLocale } from './labels.js';
+export interface ConsoleMessage {
+    code: keyof ReturnType<typeof resolveConsoleLocale>['messages'];
+    value?: string;
+    usage?: string;
+}
+/** Internal metadata is formatted by the Hook and never exposed in its records. */
+export type ConsoleRecord = TuiRecord & {
+    localMessage?: ConsoleMessage;
+};
+export declare function formatConsoleMessage(message: ConsoleMessage, locale: Locale): string;
+export declare class ConsoleCommandError extends Error implements ConsoleMessage {
+    readonly code: ConsoleMessage['code'];
+    readonly value?: string | undefined;
+    readonly usage?: string | undefined;
+    constructor(code: ConsoleMessage['code'], value?: string | undefined, usage?: string | undefined, locale?: Locale);
+}

package/dist/modules/console/command-parser.d.ts

@@ -0,0 +1,15 @@
+interface CommandToken {
+    value: string;
+    literal: boolean;
+}
+/** Parses arguments as data; never invokes a shell. */
+export declare function tokenize(input: string): CommandToken[];
+export interface Argument {
+    name: string;
+    kind?: 'uri' | 'integer' | 'boolean';
+    optional?: boolean;
+    choices?: readonly string[];
+    min?: number;
+}
+export declare function parseArguments(tokens: readonly CommandToken[], positional: readonly Argument[], flags?: readonly Argument[]): Record<string, string | number | boolean>;
+export {};

package/dist/modules/console/command-specs.d.ts

@@ -0,0 +1,15 @@
+import type enUS from './locales/en-US.js';
+import type { OvRequestSpec } from '../../client/types.js';
+import type { TuiSkeletonKind } from '../../components/tui/index.js';
+import type { Argument } from './command-parser.js';
+type Values = Record<string, string | number | boolean>;
+export interface CommandSpec {
+    name: keyof typeof enUS.commands;
+    positional?: readonly Argument[];
+    flags?: readonly Argument[];
+    skeleton?: TuiSkeletonKind;
+    request?: (values: Values) => OvRequestSpec;
+}
+/** One catalogue drives validation, execution, completion and help. */
+export declare const COMMAND_SPECS: readonly CommandSpec[];
+export {};

package/dist/modules/console/commands.d.ts

@@ -0,0 +1,6 @@
+import type { OvClient, OvRequestOptions } from '../../client/types.js';
+import type { TuiCommandDefinition, TuiRecordContent } from '../../components/tui/index.js';
+import type { Locale } from '../../shared/locale.js';
+export declare function consoleCommands(locale: Locale): readonly TuiCommandDefinition[];
+export declare function createCommandHelp(locale: Locale): TuiRecordContent;
+export declare function executeCommand(input: string, client: OvClient, options: OvRequestOptions, locale: Locale): Promise<TuiRecordContent>;

package/dist/modules/console/console-history.d.ts

@@ -0,0 +1,10 @@
+import type { Locale } from '../../shared/locale.js';
+import type { TuiRecord } from '../../components/tui/index.js';
+import type { consoleLabels } from './labels.js';
+export declare function ConsoleHistory({ records, isExecuting, locale, labels, onRecall, }: {
+    records: readonly TuiRecord[];
+    isExecuting: boolean;
+    locale: Locale;
+    labels: ReturnType<typeof consoleLabels>;
+    onRecall: (command: string) => void;
+}): import("react").JSX.Element;

package/dist/modules/console/console-toolbar.d.ts

@@ -0,0 +1,18 @@
+import type { Locale } from '../../shared/locale.js';
+import type { ReactNode } from 'react';
+import type { TuiRecord } from '../../components/tui/index.js';
+import type { ConsoleMode } from './types.js';
+import type { consoleLabels } from './labels.js';
+export declare function ConsoleToolbar({ mode, panelId, locale, labels, records, isExecuting, onModeChange, onClear, onRecall, children, conversationActions, }: {
+    mode: ConsoleMode;
+    panelId: string;
+    locale: Locale;
+    labels: ReturnType<typeof consoleLabels>;
+    records: readonly TuiRecord[];
+    isExecuting: boolean;
+    onModeChange: (mode: ConsoleMode) => void;
+    onClear: () => void;
+    onRecall: (command: string) => void;
+    children?: ReactNode;
+    conversationActions?: ReactNode;
+}): import("react").JSX.Element;

package/dist/modules/console/console.d.ts

@@ -1,4 +1,2 @@
 import type { ConsoleProps } from './types.js';
-export type { ConsoleLabels, ConsoleMode, ConsoleProps, ConsoleSlots, } from './types.js';
-/** 占位组件：渲染一个带模块名的空容器，真实实现随模块 Hook 与组合视图迁入。 */
-export declare function Console({ className, style, labels }: ConsoleProps): import("react").JSX.Element;
+export declare function Console({ mode, defaultMode, locale: localeProp, quickCommands, scopeKey, requestOptions, onModeChange, onOpenUri, conversation, slots, labels: overrides, className, ...rest }: ConsoleProps): import("react").JSX.Element;

package/dist/modules/console/controller.d.ts

@@ -0,0 +1,17 @@
+import type { Locale } from '../../shared/locale.js';
+import { type ConsoleRecord } from './command-messages.js';
+import type { OvClient, OvRequestOptions } from '../../client/types.js';
+import type { ConsoleState } from './types.js';
+export declare function createConsoleController(client: OvClient, options?: OvRequestOptions): {
+    subscribe: (listener: () => void) => () => void;
+    getSnapshot: () => Omit<ConsoleState, "records"> & {
+        records: readonly ConsoleRecord[];
+    };
+    start(): () => void;
+    execute: (input?: string, locale?: Locale) => Promise<void>;
+    cancel: () => void | undefined;
+    clear: () => void;
+    setCommand: (command: string) => void;
+    setConversationDraft: (conversationDraft: string) => void;
+    retry: (locale: Locale) => Promise<void>;
+};

package/dist/modules/console/index.d.ts

@@ -1 +1,3 @@
 export * from './console.js';
+export { useConsole } from './use-console.js';
+export type { ConsoleLabels, ConsoleMode, ConsoleOptions, ConsoleResult, ConsoleState, ConsoleProps, ConsoleSlots, } from './types.js';