@openviking/react 0.1.4 → 0.1.6

package/README.md

@@ -2,9 +2,9 @@
 
 English / [中文](README_CN.md)
 
-All public UI components and composed modules require an explicit `locale: 'zh-CN' | 'en-US'` for built-in Chinese or English copy. Existing `labels` override individual fields; omitted fields follow the current locale and update when it changes. Hosts still provide business content, slots and callback messages.
+Public UI components, composed modules accept optional `locale: 'zh-CN' | 'en-US'`. Props override the nearest module or Provider; without a configured language, they use `en-US`. Existing `labels` override individual fields; omitted fields follow the current locale and update when it changes. Hosts still provide business content, slots and callback messages.
 
-React foundations for OpenViking AI application interfaces: build tooling, documentation, layered directories, and scoped styles. FileTree, Tui and FilePreview provide working views, alongside five file-type icons. FileBrowser supports early layout integration; Console provides a native command panel; ScopeCascade provides a working cascade Hook and composition.
+React foundations for OpenViking AI application interfaces: build tooling, documentation, layered directories, and scoped styles. FileTree, Tui and FilePreview provide working views, alongside five file-type icons. FileBrowser coordinates browsing, previews and dashboards; Console provides a native command panel; ScopeCascade provides an integrated cascade selector.
 
 This package inherits the repository's AGPL-3.0-only license. The release workflow publishes it to npm when a `react@<version>` tag matches the version in this package's manifest.
 
@@ -19,15 +19,15 @@ This package inherits the repository's AGPL-3.0-only license. The release workfl
 | [components/scope-switcher](./src/components/scope-switcher/README.md) | `@openviking/react/components/scope-switcher` | Stateless scope layout and independent ScopeSelector options, panels and search                     |
 | [components/agent-connect](./src/components/agent-connect/README.md)   | `@openviking/react/components/agent-connect`  | Fixed Figma connection view with original icons, built-in copy and clipboard feedback               |
 | [components/viking-bot](./src/components/viking-bot/README.md)         | `@openviking/react/components/viking-bot`     | Controlled conversation views, session controls, Markdown replies and composer                      |
-| [modules](./src/modules/README.md)                                     | `@openviking/react/modules/<module>`          | Console panel and ScopeCascade Hooks and composition, plus one placeholder                          |
+| [modules](./src/modules/README.md)                                     | `@openviking/react/modules/<module>`          | Console panel and ScopeCascade Hooks and composition, plus FileBrowser and independent dashboards   |
 | [client](./src/client/index.ts)                                        | `@openviking/react/client`                    | Framework-neutral request client: `createOvClient`, `OvClient`, `OvClientError`                     |
 | [hooks](./src/hooks/README.md), [utils](./src/utils/README.md)         | Internal only                                 | Cross-module Hooks and pure utilities                                                               |
 
-Components implement their reviewed contracts incrementally. FileTree renders every documented row type with keyboard interaction; FilePreview implements the tab shell, header actions and the plain-text preview and editing foundation, with its body not yet wired to FileViewer. ScopeSwitcher is a stateless layout container; independently rendered ScopeSelector children own visibility, with host-owned per-level data subscriptions, search and requests. Tui renders records, results and the input. AgentConnect follows the Figma layout with built-in bilingual agent and developer integration content, host-provided credentials and locale, optional controlled selection and clipboard feedback. VikingBot provides a working view pending design review. Limits are described in each component's own docs. The package also ships five file-type icons.
+Components implement their reviewed contracts incrementally. FileTree renders every documented row type with keyboard interaction; FilePreview implements the tab shell, header actions and the plain-text preview and editing foundation, with its body not yet wired to FileViewer. ScopeSwitcher is a stateless layout container; independently rendered ScopeSelector children own visibility, with host-owned per-level data subscriptions, search and requests. Tui renders records, results and the input. AgentConnect follows the Figma layout with built-in bilingual agent and developer integration content, host-provided credentials and locale, optional controlled selection and clipboard feedback. VikingBot provides a working view pending design review. Limits are described in each component's own docs. The package also ships five file-type icons, `ArrowRightIcon` and the three scope-level icons (`LibraryIcon`, `SpaceIcon`, `UserIcon`).
 
-Components receive view data and state through props and express user intent through callbacks, following the [component directory conventions](./src/components/AGENTS.md). [modules](./src/modules/README.md) plan Hooks and views per business capability: Hooks load data, hold state and expose operations, and composite views wire them into components. Full pages and product-specific flows belong to the host; the admin console is out of scope for this phase. `console` exports a native command panel; its orchestration Hook stays internal and conversation data and callbacks are supplied by the host. `file-browser` ships placeholder views and types.
+Components receive view data and state through props and express user intent through callbacks, following the [component directory conventions](./src/components/AGENTS.md). [modules](./src/modules/README.md) plan Hooks and views per business capability: Hooks load data, hold state and expose operations, and composite views wire them into components. Full pages and product-specific flows belong to the host; the admin console is out of scope for this phase. `console` exports a native command panel; its orchestration Hook stays internal and conversation data and callbacks are supplied by the host. `file-browser` provides browsing, preview and dashboard coordination.
 
-Modules consume the native OpenViking API through a shared Client by default, with the Provider supplying `baseURL`, headers and other configuration, and modules or standalone Hooks overriding individual fields through `requestOptions`. Standard integration needs no per-module Adapter; nonstandard gateways are adapted at the host's request boundary. The request contract — `OvRequestOptions`, `OvClient` and `OvClientError` — comes from the `@openviking/react/client` subpath, which ships a `fetch`-based `createOvClient`; the Provider is exported from the same subpath; these native API module Hooks are not implemented yet. ScopeCascade instead accepts three host API adapters and needs no Provider. See [request conventions](./src/modules/README.md#request-conventions-and-default-configuration).
+Modules consume the native OpenViking API through a shared Client by default, with the Provider supplying `baseURL`, headers and other configuration, and module views overriding individual fields through `requestOptions`. Standard integration needs no per-module Adapter; nonstandard gateways are adapted at the host's request boundary. The request contract — `OvRequestOptions`, `OvClient` and `OvClientError` — comes from the `@openviking/react/client` subpath, which ships a `fetch`-based `createOvClient`; the Provider is exported from the same subpath. Native module Hooks share this request boundary. ScopeCascade instead accepts three host API adapters and needs no Provider. See [request conventions](./src/modules/README.md#request-conventions-and-default-configuration).
 
 Tui preserves JSON numeric tokens when indenting output. Structured resource links allow only `viking://`, `https://`, and `http://`; other targets render as text. Resource tables retain entry titles, native links and metadata. Output follows updates only near the bottom or after explicit submission. Read-only and disabled consoles cannot submit or insert help commands. `labels.resource` customizes the resource identity column.
 
@@ -41,9 +41,11 @@ The same props are consumed by different hosts. Hosts differ in flows and interf
 - Icons, extension tabs, extra fields and toolbar actions come in as slots or nodes; components bind to no third-party UI library.
 - List components render the rows or items the caller has already expanded; paging, loading, error and empty states come from module Hooks or the host.
 
+`WikiDashboard` is exported from `@openviking/react/components/wiki-dashboard`; `ExperienceDashboard` from `@openviking/react/components/experience-dashboard`. Both are pure UI components receiving display data and state; FileBrowser owns native loading and response adaptation. Components and main Props types also appear at the package root. FileBrowser detects Wiki/experience entries, with `dashboardKinds` and `renderDashboard` for host permissions and gateway data. Each component exports `style.css`; FileBrowser styles include both boards. See the [dashboard docs](../../docs/docs/en/components/index.mdx).
+
 ## Public entries and styles
 
-- The root entry exports each component and each business module placeholder with its main Props type (`<Component>Props`) only — currently `FileTree`, `Tui`, `ScopeSwitcher`, `ScopeSelector`, `ScopeCascade`, `AgentConnect` and Console and the one business module placeholder. Row types, option types, handles and label bags come from the `components/<component>` and `modules/<module>` subpaths. `FilePreview` is not on the root entry: its types reference the optional `@ark-design/ui`, and putting it there would make that peer required. ScopeCascade exports a working three-level composition and per-level subscription Hooks from `modules/scope-cascade`; Console exports its panel from `modules/console` and keeps its orchestration Hook internal; FileBrowser remains a placeholder. No aggregate `@openviking/react/components` or `@openviking/react/modules` JavaScript entry. Package exports are listed explicitly and internal files stay closed.
+- The root entry exports each component and each business module placeholder with its main Props type (`<Component>Props`) only — currently `FileTree`, `Tui`, `ScopeSwitcher`, `ScopeSelector`, `ScopeCascade`, `AgentConnect` and Console, FileBrowser, WikiDashboard and ExperienceDashboard. Row types, option types, handles and label bags come from the `components/<component>` and `modules/<module>` subpaths. `FilePreview` is not on the root entry: its types reference the optional `@ark-design/ui`, and putting it there would make that peer required. ScopeCascade exports a working three-level composition with internal per-level subscriptions from `modules/scope-cascade`; Console exports its panel from `modules/console` and keeps its orchestration Hook internal; FileBrowser provides browsing and dashboard coordination. No aggregate `@openviking/react/components` or `@openviking/react/modules` JavaScript entry. Package exports are listed explicitly and internal files stay closed.
 - Components expose only the explicitly listed layered subpaths, with no legacy path aliases.
 - JS entries share implementations and never load CSS implicitly. Whole-package, component-set and single-module stylesheets are built from the same source, so import the scope you need.
 
@@ -55,7 +57,7 @@ The same props are consumed by different hosts. Hosts differ in flows and interf
 | Business module set    | `@openviking/react/modules/style.css`             |
 | Single business module | `@openviking/react/modules/<module>/style.css`    |
 
-Each CSS entry works standalone, and the whole-package CSS already includes module placeholder styles. Once real capability lands, module CSS must also include the composite view and the styles of the components it uses; using a module Hook alone needs no CSS. Cross-module public Hooks open `@openviking/react/hooks` only after a real implementation; module-specific public Hooks are exported from their module entry, and private Hooks and utilities stay out of public exports.
+Each CSS entry works independently and includes the component styles it depends on. Business Hooks remain internal; no headless Hook entry is exposed.
 
 ```tsx
 import { FileBrowser } from '@openviking/react/modules/file-browser';
@@ -67,7 +69,7 @@ import '@openviking/react/modules/file-browser/style.css';
 />;
 ```
 
-The remaining module exports `Console`; it currently accepts `className`, `style` and `labels`, and needs no Provider or request configuration.
+Console accepts its documented panel props; native command execution uses Provider request configuration and starts only on explicit submission.
 
 Experience dashboards belong to preview extensions; task progress starts inside its owning module; API Key display controls are reused on demand while credential creation and management belong to the host. No separate modules are added for these now.
 
@@ -79,7 +81,7 @@ import { PdfIcon } from '@openviking/react/icons';
 <PdfIcon width={20} height={20} className="file-icon" alt="PDF" />;
 ```
 
-Icons render as 16 × 16 images by default. Decorative icons can keep the empty `alt`, while icons that convey file type can provide a description. SVGs are inlined into the build output, and hosts consume them directly from the package exports.
+Icons render as inline SVG. Decorative icons stay `aria-hidden`, while an icon that conveys meaning on its own can take an `aria-label`. SVGs are inlined into the build output, and hosts consume them directly from the package exports. `LibraryIcon`, `SpaceIcon` and `UserIcon` are the scope-level defaults; `ScopeCascade`'s default view applies them automatically when an adapter returns no `icon`.
 
 React and ReactDOM are peer dependencies (`^18.2.0 || ^19.0.0`), automatically externalized by Rslib. Rslib emits shared ESM JavaScript and declarations, plus independently built CSS entries. The public `@openviking/react/style.css` entry resolves to `dist/style.css`. Styles are scoped and do not reset application styles.
 
@@ -87,10 +89,12 @@ From `frontend/`, run `npm run build:lib` to generate `packages/react/dist/`. Se
 
 ### ScopeCascade
 
-Pass three stable API adapter functions to `useScopeCascade({ loadLibraries, loadSpaces, loadUsers })`, then render `<ScopeCascade controller={controller} />`. Adapters return `{ id, label }` options and receive an `AbortSignal`. The module handles dependent requests, descendant resets, loading, errors, retries and stale responses. Each selector subscribes independently; the Hook caller does not subscribe to request state. Import the Hook and composition from `@openviking/react/modules/scope-cascade` and its CSS from the corresponding `/style.css` entry.
+Pass three stable API adapters directly to `<ScopeCascade {...api} onChange={handleSelection} />`. Adapters return `{ id, label }` options and receive an `AbortSignal`. The component owns requests, descendant resets, loading, retries and stale-response protection. `onChange` reports a complete `{ libraryId, spaceId, userId }` identity or `null` while incomplete. Import the component and Props from `@openviking/react/modules/scope-cascade` and its CSS from the corresponding `/style.css` entry.
 
 ## Maintaining built-in copy
 
 Built-in translations live alongside each component or module in `locales/en-US.ts` and `locales/zh-CN.ts`. The internal `src/shared/locale.ts` contains only shared language types and resolution/override rules, with no business messages or public entry. Modules own workflow copy and reuse the defaults owned by their child components.
 
 Dynamic messages use typed formatter functions; dates and numbers use `Intl`. `npm test` checks matching keys, string placeholders and formatter arity across languages, while type checking validates parameter types. Undefined `labels` entries inherit the selected language; empty strings remain explicit overrides.
+
+Set `locale` on `OpenVikingProvider` for a subtree. Optional module and component Props override the nearest scope, then fall back to `en-US`. Standalone Hooks also inherit the Provider. The private `src/shared/locale-context.tsx` is shared across public entries and remains separate from request-client configuration, so language changes preserve requests and state.

package/dist/28~0.js

@@ -0,0 +1,15 @@
+import { jsx } from "react/jsx-runtime";
+import { createContext, useContext } from "react";
+const LocaleContext = /*#__PURE__*/ createContext('en-US');
+function useLocale(locale) {
+    const inherited = useContext(LocaleContext);
+    return locale ?? inherited;
+}
+function LocaleProvider({ locale, children }) {
+    const value = useLocale(locale);
+    return /*#__PURE__*/ jsx(LocaleContext.Provider, {
+        value: value,
+        children: children
+    });
+}
+export { LocaleProvider, useLocale };

package/dist/2~0.js

@@ -7,6 +7,7 @@ import { __webpack_require__ } from "./rslib-runtime~0.js";
 import { resolveLocale } from "./nx~0.js";
 import { removereact } from "./4~0.js";
 import { usePortalTheme } from "./9~0.js";
+import { useLocale } from "./28~0.js";
 import { AgentConnect } from "./u~0.js";
 import * as __rspack_external_react from "react";
 __webpack_require__.add({
@@ -2274,7 +2275,8 @@ function ImportResourcesIcon() {
         })
     });
 }
-function FileBrowserEntries({ locale = 'en-US', agentConnect, onConnectAgent, onImportResources, renderImportResources, labels, className, ...rest }) {
+function FileBrowserEntries({ locale: localeProp, agentConnect, onConnectAgent, onImportResources, renderImportResources, labels, className, ...rest }) {
+    const locale = useLocale(localeProp);
     const triggerRef = useRef(null);
     const drawerId = useId();
     const [drawerOpen, setDrawerOpen] = useState(false);
@@ -2344,10 +2346,11 @@ function FileBrowserEntries({ locale = 'en-US', agentConnect, onConnectAgent, on
                 closeLabel: text.close,
                 triggerRef: triggerRef,
                 className: "ov-file-browser-entries__drawer",
-                lang: agentConnect.locale,
+                lang: agentConnect.locale ?? locale,
                 onClose: ()=>setDrawerOpen(false),
                 children: /*#__PURE__*/ jsx(AgentConnect, {
-                    ...agentConnect
+                    ...agentConnect,
+                    locale: agentConnect.locale ?? locale
                 })
             }) : null,
             showImport ? /*#__PURE__*/ jsx("span", {

package/dist/37~0.js

@@ -0,0 +1,27 @@
+import { Fragment, jsx, jsxs } from "react/jsx-runtime";
+function DashboardState({ state = {}, empty, loading, failed, retry }) {
+    return /*#__PURE__*/ jsxs("div", {
+        className: "ov-dashboard-state",
+        "aria-busy": state.loading,
+        children: [
+            /*#__PURE__*/ jsx("p", {
+                "aria-live": "polite",
+                children: state.loading ? loading : state.error ? failed : empty
+            }),
+            state.error ? /*#__PURE__*/ jsxs(Fragment, {
+                children: [
+                    /*#__PURE__*/ jsx("p", {
+                        children: state.error.message
+                    }),
+                    /*#__PURE__*/ jsx("button", {
+                        type: "button",
+                        disabled: !state.onRetry,
+                        onClick: state.onRetry,
+                        children: retry
+                    })
+                ]
+            }) : null
+        ]
+    });
+}
+export { DashboardState };

package/dist/3c~0.js

@@ -5,7 +5,8 @@ import remark_gfm from "remark-gfm";
 import { ArrowRightIcon } from "./k~0.js";
 import { resolveLocale } from "./nx~0.js";
 import { checkreact } from "./0~0.js";
-import { Tooltip } from "./r~0.js";
+import { Tooltip } from "./rt~0.js";
+import { useLocale } from "./28~0.js";
 function getTuiCommandInputText(command) {
     return command.inputText?.trim() || command.name;
 }
@@ -964,13 +965,19 @@ function TuiEmptyRegion({ emptyState, commands, labels, disabled, onPick }) {
                                     height: 14,
                                     focusable: "false"
                                 }),
-                                /*#__PURE__*/ jsx("span", {
-                                    className: "ov-tui__empty-name",
-                                    children: command.name
-                                }),
-                                /*#__PURE__*/ jsx("span", {
-                                    className: "ov-tui__empty-desc",
-                                    children: command.summary ?? command.description
+                                /*#__PURE__*/ jsxs("span", {
+                                    className: "ov-tui__empty-content",
+                                    children: [
+                                        /*#__PURE__*/ jsx("span", {
+                                            className: "ov-tui__empty-name",
+                                            children: command.name
+                                        }),
+                                        /*#__PURE__*/ jsx("span", {
+                                            className: "ov-tui__empty-desc",
+                                            title: command.summary ?? command.description,
+                                            children: command.summary ?? command.description
+                                        })
+                                    ]
                                 })
                             ]
                         })
@@ -2073,7 +2080,8 @@ function useTuiCompletion(value, enabled, commands, groups = [], paletteScope =
         showSuggestions: enabled && (query.automatic || null !== query.scope && paletteScope === query.scope)
     };
 }
-function Tui({ records, value, disabled = false, emptyState, quickCommands, locale = 'en-US', commands = [], commandGroups = [], onValueChange, onSubmit, onOpenUri, onCopy, labels, className, ...rest }) {
+function Tui({ records, value, disabled = false, emptyState, quickCommands, locale: localeProp, commands = [], commandGroups = [], onValueChange, onSubmit, onOpenUri, onCopy, labels, className, ...rest }) {
+    const locale = useLocale(localeProp);
     const text = resolveTuiLabels(labels, locale);
     const bodyRef = useRef(null);
     const followOutput = useRef(true);

package/dist/3~0.js

@@ -1,7 +1,8 @@
 import { Fragment, jsx, jsxs } from "react/jsx-runtime";
 import { Fragment as external_react_Fragment, Suspense, forwardRef, lazy, useCallback, useId, useImperativeHandle, useLayoutEffect, useMemo, useRef, useState } from "react";
-import { Tooltip } from "./r~0.js";
+import { Tooltip } from "./rt~0.js";
 import { resolveLocale, mergeLabels } from "./nx~0.js";
+import { useLocale } from "./28~0.js";
 function FilePreviewImageFrame({ children }) {
     const [dimensions, setDimensions] = useState('');
     return /*#__PURE__*/ jsxs("div", {
@@ -1214,7 +1215,8 @@ function useFilePreviewEditing(activeTabKey) {
 function isFileTab(tab) {
     return 'file' === tab.kind;
 }
-const file_preview_FilePreview = /*#__PURE__*/ forwardRef(function({ tabs, activeKey, defaultActiveKey, locale, labels, onActiveKeyChange, className, ...rest }, ref) {
+const file_preview_FilePreview = /*#__PURE__*/ forwardRef(function({ tabs, activeKey, defaultActiveKey, locale: localeProp, labels, onActiveKeyChange, className, ...rest }, ref) {
+    const locale = useLocale(localeProp);
     const text = resolveFilePreviewLabels(locale, labels);
     const [internalKey, setInternalKey] = useState(()=>defaultActiveKey ?? tabs[0].key);
     const currentKey = activeKey ?? internalKey;

package/dist/ae~0.js

@@ -1,5 +1,6 @@
 import { jsx } from "react/jsx-runtime";
 import { createContext, useContext, useMemo } from "react";
+import { LocaleProvider } from "./28~0.js";
 class OvClientError extends Error {
     code;
     statusCode;
@@ -439,7 +440,7 @@ function createOvClient(options = {}) {
     return client;
 }
 const OvClientContext = /*#__PURE__*/ createContext(null);
-function OpenVikingProvider({ baseURL, apiKey, accountId, userId, resourceId, credentials, signal, fetch, children }) {
+function OpenVikingProvider({ baseURL, apiKey, accountId, userId, resourceId, credentials, signal, fetch, locale, children }) {
     const parent = useContext(OvClientContext);
     const value = useMemo(()=>{
         const base = mergeProviderConfig(parent?.base, {
@@ -475,7 +476,10 @@ function OpenVikingProvider({ baseURL, apiKey, accountId, userId, resourceId, cr
     ]);
     return /*#__PURE__*/ jsx(OvClientContext.Provider, {
         value: value,
-        children: children
+        children: /*#__PURE__*/ jsx(LocaleProvider, {
+            locale: locale,
+            children: children
+        })
     });
 }
 function useOvClient() {

package/dist/a~0.js

@@ -3,9 +3,10 @@ import { useEffect, useId, useMemo, useRef, useState, useSyncExternalStore } fro
 import { createPortal } from "react-dom";
 import { resolveLocale, mergeLabels } from "./nx~0.js";
 import { useOvSignal, useOvClient, createOvClient, isOvClientError } from "./ae~0.js";
+import { useLocale, LocaleProvider } from "./28~0.js";
 import { new_sessionreact, historyreact } from "./lg~0.js";
 import { useOverlayPosition } from "./o~0.js";
-import { Tooltip } from "./r~0.js";
+import { Tooltip } from "./rt~0.js";
 import { VikingBotSessionActions, VikingBot } from "./c~0.js";
 import { Tui } from "./3c~0.js";
 const command_specs_uri = {
@@ -842,7 +843,8 @@ function createConsoleController(client, options = {}) {
         retry: (locale)=>state.failedCommand ? execute(state.failedCommand, locale) : Promise.resolve()
     };
 }
-function useConsole({ mode: controlledMode, defaultMode = 'conversation', locale = 'en-US', scopeKey, onModeChange, requestOptions = {} } = {}) {
+function useConsole({ mode: controlledMode, defaultMode = 'conversation', locale: localeProp, scopeKey, onModeChange, requestOptions = {} } = {}) {
+    const locale = useLocale(localeProp);
     const inherited = useOvClient();
     const inheritedSignal = useOvSignal();
     const [fallback] = useState(()=>createOvClient());
@@ -1204,7 +1206,8 @@ const DEFAULT_QUICK_COMMANDS = [
     'read',
     'status'
 ];
-function Console({ mode, defaultMode, locale = 'en-US', quickCommands = DEFAULT_QUICK_COMMANDS, scopeKey, requestOptions, onModeChange, onOpenUri, conversation, slots, labels: overrides, className, ...rest }) {
+function Console({ mode, defaultMode, locale: localeProp, quickCommands = DEFAULT_QUICK_COMMANDS, scopeKey, requestOptions, onModeChange, onOpenUri, conversation, slots, labels: overrides, className, ...rest }) {
+    const locale = useLocale(localeProp);
     const state = useConsole({
         mode,
         defaultMode,
@@ -1215,8 +1218,9 @@ function Console({ mode, defaultMode, locale = 'en-US', quickCommands = DEFAULT_
     });
     const labels = consoleLabels(locale, overrides);
     const { sessions, headerActions, ...conversationProps } = conversation ?? {};
+    const botLocale = conversationProps.locale ?? locale;
     const botLabels = {
-        ...labels.vikingBot,
+        ...consoleLabels(botLocale, overrides).vikingBot,
         ...conversationProps.labels
     };
     const id = useId();
@@ -1227,74 +1231,77 @@ function Console({ mode, defaultMode, locale = 'en-US', quickCommands = DEFAULT_
             preventScroll: true
         });
     };
-    return /*#__PURE__*/ jsxs("div", {
-        ...rest,
-        className: [
-            'ov-console',
-            className
-        ].filter(Boolean).join(' '),
-        children: [
-            /*#__PURE__*/ jsx(ConsoleToolbar, {
-                mode: state.mode,
-                panelId: id,
-                locale: locale,
-                labels: labels,
-                records: state.records,
-                isExecuting: state.isExecuting,
-                onModeChange: (next)=>state.setMode(next),
-                onClear: ()=>{
-                    state.clear();
-                    fillCommand('');
-                },
-                onRecall: fillCommand,
-                conversationActions: /*#__PURE__*/ jsx(VikingBotSessionActions, {
-                    sessions: sessions,
-                    extra: headerActions,
-                    labels: botLabels,
-                    locale: locale
+    return /*#__PURE__*/ jsx(LocaleProvider, {
+        locale: locale,
+        children: /*#__PURE__*/ jsxs("div", {
+            ...rest,
+            className: [
+                'ov-console',
+                className
+            ].filter(Boolean).join(' '),
+            children: [
+                /*#__PURE__*/ jsx(ConsoleToolbar, {
+                    mode: state.mode,
+                    panelId: id,
+                    locale: locale,
+                    labels: labels,
+                    records: state.records,
+                    isExecuting: state.isExecuting,
+                    onModeChange: (next)=>state.setMode(next),
+                    onClear: ()=>{
+                        state.clear();
+                        fillCommand('');
+                    },
+                    onRecall: fillCommand,
+                    conversationActions: /*#__PURE__*/ jsx(VikingBotSessionActions, {
+                        sessions: sessions,
+                        extra: headerActions,
+                        labels: botLabels,
+                        locale: botLocale
+                    }),
+                    children: slots?.toolbar
                 }),
-                children: slots?.toolbar
-            }),
-            /*#__PURE__*/ jsx("div", {
-                id: `${id}-conversation`,
-                className: "ov-console__panel",
-                hidden: 'conversation' !== state.mode,
-                children: 'conversation' === state.mode ? /*#__PURE__*/ jsx(VikingBot, {
-                    ...conversationProps,
-                    onOpenUri: conversationProps.onOpenUri ?? onOpenUri,
-                    messages: conversationProps.messages ?? [],
-                    draft: conversationProps.draft ?? state.conversationDraft,
-                    onDraftChange: void 0 === conversationProps.draft ? (value)=>{
-                        state.setConversationDraft(value);
-                        conversationProps.onDraftChange?.(value);
-                    } : conversationProps.onDraftChange,
-                    footer: slots?.conversationContext ?? conversationProps.footer,
-                    locale: conversationProps.locale ?? locale,
-                    labels: botLabels
-                }) : null
-            }),
-            /*#__PURE__*/ jsxs("div", {
-                id: `${id}-command`,
-                ref: commandPanel,
-                className: "ov-console__panel",
-                hidden: 'command' !== state.mode,
-                children: [
-                    slots?.commandHelp,
-                    /*#__PURE__*/ jsx(Tui, {
-                        records: state.records,
-                        value: state.command,
-                        commands: state.commands,
-                        locale: locale,
-                        disabled: state.isExecuting,
-                        quickCommands: quickCommands,
-                        onValueChange: state.setCommand,
-                        onSubmit: (command)=>void state.execute(command),
-                        onOpenUri: onOpenUri,
-                        labels: labels.tui
-                    })
-                ]
-            })
-        ]
+                /*#__PURE__*/ jsx("div", {
+                    id: `${id}-conversation`,
+                    className: "ov-console__panel",
+                    hidden: 'conversation' !== state.mode,
+                    children: 'conversation' === state.mode ? /*#__PURE__*/ jsx(VikingBot, {
+                        ...conversationProps,
+                        onOpenUri: conversationProps.onOpenUri ?? onOpenUri,
+                        messages: conversationProps.messages ?? [],
+                        draft: conversationProps.draft ?? state.conversationDraft,
+                        onDraftChange: void 0 === conversationProps.draft ? (value)=>{
+                            state.setConversationDraft(value);
+                            conversationProps.onDraftChange?.(value);
+                        } : conversationProps.onDraftChange,
+                        footer: slots?.conversationContext ?? conversationProps.footer,
+                        locale: botLocale,
+                        labels: botLabels
+                    }) : null
+                }),
+                /*#__PURE__*/ jsxs("div", {
+                    id: `${id}-command`,
+                    ref: commandPanel,
+                    className: "ov-console__panel",
+                    hidden: 'command' !== state.mode,
+                    children: [
+                        slots?.commandHelp,
+                        /*#__PURE__*/ jsx(Tui, {
+                            records: state.records,
+                            value: state.command,
+                            commands: state.commands,
+                            locale: locale,
+                            disabled: state.isExecuting,
+                            quickCommands: quickCommands,
+                            onValueChange: state.setCommand,
+                            onSubmit: (command)=>void state.execute(command),
+                            onOpenUri: onOpenUri,
+                            labels: labels.tui
+                        })
+                    ]
+                })
+            ]
+        })
     });
 }
-export { Console, useConsole };
+export { Console };

package/dist/ck~0.js

@@ -1,5 +1,9 @@
 const OV_PATHS = {
     fsLs: '/api/v1/fs/ls',
+    fsAttrs: '/api/v1/fs/attrs',
+    compileConfigs: '/api/v1/compile/configs',
+    experienceTrajectories: '/api/v1/agent-evolution/experiences/trajectories',
+    experienceOutcomes: '/api/v1/agent-evolution/experiences/outcomes',
     fsStat: '/api/v1/fs/stat',
     fsTree: '/api/v1/fs/tree',
     fsMkdir: '/api/v1/fs/mkdir',

package/dist/client/paths.d.ts

@@ -18,6 +18,10 @@
 export declare const OV_PATHS: {
     /** 列出目录内容。List directory contents. */
     readonly fsLs: '/api/v1/fs/ls';
+    readonly fsAttrs: '/api/v1/fs/attrs';
+    readonly compileConfigs: '/api/v1/compile/configs';
+    readonly experienceTrajectories: '/api/v1/agent-evolution/experiences/trajectories';
+    readonly experienceOutcomes: '/api/v1/agent-evolution/experiences/outcomes';
     /** 读取条目状态。Read an entry's status. */
     readonly fsStat: '/api/v1/fs/stat';
     /** 读取目录树。Read a directory tree. */

package/dist/client/provider.d.ts

@@ -1,17 +1,21 @@
 import type { ReactNode } from 'react';
+import type { Locale } from '../shared/locale.js';
 import type { OvClient, OvClientOptions } from './types.js';
 /**
- * {@link OpenVikingProvider} 的属性。字段与 {@link OvClientOptions} 同形：
+ * {@link OpenVikingProvider} 的属性。请求字段与 {@link OvClientOptions} 同形，另可设置界面语言：
  * 服务地址、身份与作用域、Cookie 策略，都按字段传值。
- * Props of {@link OpenVikingProvider}, the same shape as {@link OvClientOptions}:
- * the service address, identity and scope, and the cookie policy are all passed
+ * Props of {@link OpenVikingProvider}: request fields follow {@link OvClientOptions},
+ * with an optional interface locale.
+ * The service address, identity and scope, and the cookie policy are all passed
  * as fields.
  */
 export interface OpenVikingProviderProps extends OvClientOptions {
+    /** 界面语言；省略时继承上层，无配置时默认英文。Subtree locale; inherits or defaults to en-US. */
+    locale?: Locale;
     children?: ReactNode;
 }
 /**
- * 向子树下发请求配置。模块通过内部的 `useOvClient` 取用，宿主只需在应用根部
+ * 向子树下发请求配置与默认语言。模块通过内部的 `useOvClient` 取用，宿主只需在应用根部
  * 配置一次服务地址与身份字段，不必自己组装请求头。
  *
  * 开源版传 `apiKey`、`accountId`、`userId`；商业版由浏览器 Cookie 鉴权，只传
@@ -23,7 +27,7 @@ export interface OpenVikingProviderProps extends OvClientOptions {
  * 不传 `baseURL` 时按浏览器同源请求。挂载本身不发请求，也不读取浏览器里保存
  * 的凭证。
  *
- * Provides request configuration to a subtree. Modules read it through the
+ * Provides request configuration and a default language to a subtree. Modules read it through the
  * internal `useOvClient`, so a host configures the service address and identity
  * fields once at the application root and never assembles headers itself.
  *
@@ -40,7 +44,7 @@ export interface OpenVikingProviderProps extends OvClientOptions {
  * Without `baseURL` it targets the browser's own origin. Mounting it sends no
  * request and reads no credential stored in the browser.
  */
-export declare function OpenVikingProvider({ baseURL, apiKey, accountId, userId, resourceId, credentials, signal, fetch, children, }: OpenVikingProviderProps): import("react").JSX.Element;
+export declare function OpenVikingProvider({ baseURL, apiKey, accountId, userId, resourceId, credentials, signal, fetch, locale, children, }: OpenVikingProviderProps): import("react").JSX.Element;
 /**
  * 读取最近的 Provider 提供的客户端。仅供模块内部使用，不从包入口导出：
  * 调用方不需要知道该发什么请求，也就不会直接用它。

package/dist/components/agent-connect/agent-connect-code-block.d.ts

@@ -0,0 +1,14 @@
+import type { AgentConnectLocale } from './types.js';
+export interface CodeBlockControls {
+    locale: AgentConnectLocale;
+    visibleBlockId: string | null;
+    onReveal: (id: string | null) => void;
+    onCopy?: (text: string) => void;
+}
+interface CodeBlockProps extends CodeBlockControls {
+    display: string;
+    copyText: string;
+    language?: string;
+}
+export declare function AgentConnectCodeBlock({ display, copyText, language, locale, visibleBlockId, onReveal, onCopy, }: CodeBlockProps): import("react").JSX.Element;
+export {};

package/dist/components/agent-connect/agent-connect-copy.d.ts

@@ -7,6 +7,9 @@ export declare function resolveAgentConnectLabels(locale: AgentConnectLocale): {
     instructions: string;
     copy: string;
     copyMarkdown: string;
+    copyCode: string;
+    showApiKey: string;
+    hideApiKey: string;
     copied: string;
     failed: string;
     notice: string;

package/dist/components/agent-connect/agent-connect-design.d.ts

@@ -1,5 +1,5 @@
 import type { AgentConnectLocale } from './types.js';
-export declare function getAgentConnectDesign(locale: AgentConnectLocale): {
+export declare function getAgentConnectDesign(locale: AgentConnectLocale, showOverseasTag?: boolean): {
     tabs: readonly [{
         readonly id: 'mainstream';
         readonly label: string;

package/dist/components/agent-connect/agent-connect-installer.d.ts

@@ -1,3 +1,4 @@
 import type { AgentConnectLocale } from './types.js';
 export declare const INSTALLER_HARNESSES: Partial<Record<string, string>>;
+export declare function getInstallerCommand(harness: string, locale: AgentConnectLocale, apiKey: string, baseUrl: string): string;
 export declare function getInstallerInstructions(name: string, harness: string, locale: AgentConnectLocale, apiKey: string, baseUrl: string): string;

package/dist/components/agent-connect/agent-connect-instructions-view.d.ts

@@ -1,14 +1,12 @@
 import type { AgentConnectLocale } from './types.js';
+import type { getAgentConnectInstructions } from './agent-connect-instructions.js';
 interface InstructionsViewProps {
-    instructions: {
-        fixed: boolean;
-        display: string;
-        copy: string;
-    };
+    instructions: ReturnType<typeof getAgentConnectInstructions>;
+    apiKey: string;
     locale: AgentConnectLocale;
     agreementUrl?: string;
     onCopy?: (text: string) => void;
 }
 /** 由父视图的 key 隔离指南及凭据的复制生命周期。 */
-export declare function AgentConnectInstructionsView({ instructions, locale, agreementUrl, onCopy, }: InstructionsViewProps): import("react").JSX.Element;
+export declare function AgentConnectInstructionsView({ instructions, apiKey, locale, agreementUrl, onCopy, }: InstructionsViewProps): import("react").JSX.Element;
 export {};

package/dist/components/agent-connect/agent-connect-instructions.d.ts

@@ -277,4 +277,17 @@ export declare function getAgentConnectInstructions(id: keyof typeof contentZh,
     fixed: boolean;
     display: string;
     copy: string;
+    command: {
+        display: string;
+        copy: string;
+    };
+    markdown?: undefined;
+    keyToken?: undefined;
+} | {
+    command?: undefined;
+    fixed: boolean;
+    display: string;
+    copy: string;
+    markdown: string;
+    keyToken: string;
 };