@nextclaw/ui 0.13.12 → 0.14.0

package/src/shared/lib/i18n/locales/zh-CN/remote.json

@@ -0,0 +1,168 @@
+{
+  "remotePageTitle": "远程访问",
+  "remotePageDescription": "让这台设备出现在 NextClaw Platform 的设备列表里，并从网页中打开它。",
+  "remoteOpenWeb": "前往 NextClaw Web",
+  "remoteOpenDeviceList": "前往 NextClaw Web",
+  "remoteOpenWebHint": "开启后，这台设备会出现在 NextClaw Web 中，你可以在那里点击打开并继续使用。",
+  "remoteOpenWebUnavailable": "暂时还没有可用的平台地址，请先完成登录。",
+  "remoteLoading": "正在加载远程访问状态...",
+  "remoteStatusNeedsSignIn": "先登录 NextClaw",
+  "remoteStatusNeedsSignInDescription": "远程访问依赖 NextClaw 账号。登录后，这台设备才能和网页版关联起来。",
+  "remoteStatusNeedsEnable": "还没有开启远程访问",
+  "remoteStatusNeedsEnableDescription": "你已经登录 NextClaw。开启后，这台设备会出现在网页版的设备列表中。",
+  "remoteStatusConnectingTitle": "正在把这台设备接入 NextClaw Web",
+  "remoteStatusConnectingDescription": "后台服务正在建立连接，几秒后刷新即可看到最新状态。",
+  "remoteStatusReadyTitle": "这台设备已经可在网页中打开",
+  "remoteStatusReadyDescription": "你现在可以前往 NextClaw Web，在设备列表中点击打开，继续这条 Agent 链路。",
+  "remoteStatusNeedsServiceTitle": "需要拉起后台服务",
+  "remoteStatusNeedsServiceDescription": "远程访问已经开启，但后台服务没有运行。拉起后才会真正连到网页版。",
+  "remoteStatusReauthorizationTitle": "登录已过期，请重新登录 NextClaw",
+  "remoteStatusReauthorizationDescription": "为了保护你的账号安全，远程访问已暂停。重新登录后会自动恢复，不需要重新配置设备。",
+  "remoteStatusIssueTitle": "远程访问暂时没有连上",
+  "remoteStatusIssueDescription": "设备配置还在，但当前没有稳定连上平台。你可以先重新连接；如果问题持续，再重新登录或稍后再试。",
+  "remoteStatusIssueDetailTitle": "下一步",
+  "remoteStatusRecoveryTitle": "推荐操作",
+  "remoteStatusIssueDetailGeneric": "远程访问暂时不可用。你可以先重新连接；如果问题持续，再重新登录或稍后再试。",
+  "remoteStatusIssueDetailServiceStopped": "后台服务当前没有运行。启动后，这台设备才会重新出现在网页版设备列表里。",
+  "remoteStatusReauthorizationHint": "点击下方按钮后会打开登录页。完成登录后，这台设备会自动恢复远程访问，不需要重新配置。",
+  "remoteSignInAndEnable": "登录并开启远程访问",
+  "remoteEnableNow": "开启远程访问",
+  "remoteReconnectNow": "重新连接",
+  "remoteReauthorizeNow": "重新登录并恢复远程访问",
+  "remoteDisable": "关闭远程访问",
+  "remoteDeviceSummaryTitle": "当前设备",
+  "remoteDeviceSummaryDescription": "普通用户只需要关心账号、设备名、连接状态和网页版入口。",
+  "remoteSignedInAccount": "当前账号",
+  "remoteConnectionStatus": "连接状态",
+  "remoteAdvancedTitle": "高级设置",
+  "remoteAdvancedDescription": "只有在排查或自定义平台地址时，才需要打开这一层。",
+  "remoteAdvancedToggleOpen": "展开高级设置",
+  "remoteAdvancedToggleClose": "收起高级设置",
+  "remoteAdvancedSaved": "高级设置已保存",
+  "remoteEnabledReady": "远程访问已开启，现在可以前往 NextClaw Web 使用",
+  "remoteDisabledDone": "远程访问已关闭",
+  "remoteServiceRecovered": "后台服务已重新接上远程访问",
+  "remoteActionEnabling": "正在开启远程访问...",
+  "remoteActionDisabling": "正在关闭远程访问...",
+  "remoteActionSavingAdvanced": "正在保存高级设置...",
+  "remoteActionStarting": "正在启动后台服务...",
+  "remoteActionRestarting": "正在重启后台服务...",
+  "remoteActionStopping": "正在停止后台服务...",
+  "remoteAccountEntryTitle": "NextClaw 账号",
+  "remoteAccountEntryDisconnected": "未登录，点击连接",
+  "remoteAccountEntryConnected": "已连接到 NextClaw",
+  "remoteAccountEntryManage": "账号",
+  "accountPanelTitle": "NextClaw 账号",
+  "accountPanelDescription": "远程访问依赖这个账号登录。后续 token、授权和更多云端能力也会基于它展开。",
+  "accountPanelSignedInTitle": "账号已连接",
+  "accountPanelSignedInDescription": "这台设备已经和你的 NextClaw 账号关联，可以直接去网页版查看设备。",
+  "accountPanelSignedOutTitle": "通过浏览器完成登录",
+  "accountPanelSignedOutDescription": "点击下方按钮后会打开 NextClaw 网页，在网页中登录或注册，当前设备会自动接入。",
+  "remoteOverviewTitle": "连接总览",
+  "remoteOverviewDescription": "只保留普通用户真正需要知道的信息。",
+  "remoteAccountConnected": "平台已登录",
+  "remoteAccountNotConnected": "平台未登录",
+  "remoteRuntimeMissing": "连接器未运行",
+  "remoteStateConnected": "已连接",
+  "remoteStateConnecting": "连接中",
+  "remoteStateError": "连接异常",
+  "remoteStateDisconnected": "已断开",
+  "remoteStateDisabled": "未启用",
+  "remoteStateReauthorizationRequired": "需要重新登录",
+  "remoteLocalOrigin": "本地服务地址",
+  "remotePublicPlatform": "平台地址",
+  "remoteDeviceId": "设备 ID",
+  "remoteRuntimeUpdatedAt": "状态更新时间",
+  "remoteLastConnectedAt": "上次连接时间",
+  "remoteLastError": "最近错误",
+  "remoteDeviceTitle": "设备配置",
+  "remoteDeviceDescription": "保存远程访问开关、设备名和平台 API Base。",
+  "remoteDeviceSectionTitle": "设备信息",
+  "remoteDeviceSectionDescription": "开启之后，这台设备会在平台网页的设备列表中出现。",
+  "remoteDeviceNameAuto": "未命名设备",
+  "remoteEnabled": "启用远程访问",
+  "remoteEnabledHelp": "保存后需要启动或重启后台服务，新的远程配置才会真正生效。",
+  "remoteDeviceName": "设备名称",
+  "remoteDeviceNamePlaceholder": "例如：PeideMacBook-Pro",
+  "remotePlatformApiBase": "平台 API Base",
+  "remotePlatformApiBaseHelp": "留空可回退到登录时写入的 providers.nextclaw.apiBase。",
+  "remoteSaveSettings": "保存设置",
+  "remoteSettingsSaved": "远程设置已保存",
+  "remoteSettingsSaveFailed": "远程设置保存失败",
+  "remoteSaveHint": "推荐流程：先保存设置，再启动或重启服务，最后运行诊断确认。",
+  "remoteAccountTitle": "平台账号",
+  "remoteAccountDescription": "通过浏览器授权把当前设备安全连接到 NextClaw 平台。",
+  "remoteAccountEmail": "邮箱",
+  "remoteAccountUsername": "用户名",
+  "remoteAccountUsernameRequiredTitle": "发布 skill 前需要先设置用户名",
+  "remoteAccountUsernameRequiredDescription": "平台账号已经登录，但还没有正式用户名。设置后，你的个人 skill 会使用 `@username/skill-name` 作为发布标识。",
+  "remoteAccountUsernamePlaceholder": "例如：alice-dev",
+  "remoteAccountUsernameSave": "保存用户名",
+  "remoteAccountUsernameSaving": "保存中...",
+  "remoteAccountUsernameSetSuccess": "用户名已保存",
+  "remoteAccountUsernameSetFailed": "用户名保存失败",
+  "remoteAccountUsernameLockedHelp": "当前版本先支持首次设置用户名；设置后暂不支持改名。",
+  "remoteAccountRole": "角色",
+  "remoteApiBase": "API Base",
+  "remoteBrowserAuthTitle": "浏览器授权登录",
+  "remoteBrowserAuthDescription": "点击后会打开平台授权页，在浏览器内登录或注册并授权当前设备。",
+  "remoteBrowserAuthAction": "前往浏览器授权",
+  "remoteBrowserAuthActionRetry": "重新发起浏览器登录",
+  "remoteBrowserAuthResume": "重新打开授权页",
+  "remoteBrowserAuthStarting": "正在创建授权会话...",
+  "remoteBrowserAuthAuthorizing": "等待浏览器完成授权...",
+  "remoteBrowserAuthWaiting": "浏览器授权页已打开。请在网页中完成登录或注册，然后此页面会自动接入。",
+  "remoteBrowserAuthCompleted": "浏览器授权完成，正在刷新登录状态。",
+  "remoteBrowserAuthExpired": "授权会话已过期，请重新发起。",
+  "remoteBrowserAuthPopupBlocked": "浏览器没有自动打开，请点击“重新打开授权页”。",
+  "remoteBrowserAuthSession": "授权会话",
+  "remoteBrowserAuthExpiresAt": "授权过期时间",
+  "remoteBrowserAuthHint": "如果你刚修改了上方 Platform API Base，建议先保存设置；未保存时当前页面也会沿用你输入的新地址发起授权。",
+  "remoteBrowserAuthStartFailed": "启动浏览器授权失败",
+  "remoteBrowserAuthPollFailed": "浏览器授权状态检查失败",
+  "remoteEmail": "邮箱",
+  "remotePassword": "密码",
+  "remotePasswordPlaceholder": "请输入你的平台密码",
+  "remoteRegisterIfNeeded": "首次验证自动创建账号",
+  "remoteRegisterIfNeededHelp": "如果邮箱还没有对应账号，平台会在验证码验证成功后自动创建账号并保存登录态。",
+  "remoteLogin": "登录平台",
+  "remoteCreateAccount": "注册并登录",
+  "remoteLoggingIn": "登录中...",
+  "remoteLoginSuccess": "平台登录成功",
+  "remoteLoginFailed": "平台登录失败",
+  "remoteLogout": "退出登录",
+  "remoteLoggingOut": "退出中...",
+  "remoteLogoutSuccess": "已退出平台登录",
+  "remoteLogoutFailed": "退出登录失败",
+  "remoteServiceTitle": "后台服务",
+  "remoteServiceDescription": "直接控制托管当前 UI 的后台服务。",
+  "remoteServiceRunning": "服务运行中",
+  "remoteServiceManagedRunning": "当前就是托管服务",
+  "remoteServiceStopped": "服务未运行",
+  "remoteServicePid": "进程 PID",
+  "remoteServiceUiUrl": "UI 地址",
+  "remoteServiceCurrentProcess": "当前页面是否由该服务提供",
+  "remoteStartService": "启动服务",
+  "remoteRestartService": "重启服务",
+  "remoteStopService": "停止服务",
+  "remoteServiceHint": "如果当前页面本身就是托管服务，停止或重启时页面会短暂断开，这是预期行为。",
+  "remoteServiceActionFailed": "服务操作失败",
+  "remoteDoctorTitle": "远程诊断",
+  "remoteDoctorDescription": "检查开关、平台登录、本地 UI 健康和连接器状态。",
+  "remoteRunDoctor": "运行诊断",
+  "remoteDoctorRunning": "诊断中...",
+  "remoteDoctorCompleted": "诊断完成",
+  "remoteDoctorFailed": "诊断失败",
+  "remoteDoctorGeneratedAt": "生成时间",
+  "remoteDoctorEmpty": "点击上方按钮运行一次诊断。",
+  "remoteCheckPassed": "通过",
+  "remoteCheckFailed": "失败",
+  "connected": "已连接",
+  "disconnected": "未连接",
+  "connecting": "连接中...",
+  "feishuConnecting": "验证 / 连接中...",
+  "statusReady": "就绪",
+  "statusSetup": "待配置",
+  "statusActive": "活跃",
+  "statusInactive": "未启用"
+}

package/src/shared/lib/i18n/locales/zh-CN/runtime-control.json

@@ -0,0 +1,105 @@
+{
+  "runtimePageTitle": "路由与运行时",
+  "runtimePageDescription": "对齐 OpenClaw 的多智能体路由：绑定规则、智能体池、私聊范围。",
+  "dmScopeMain": "统一到主会话",
+  "dmScopePerPeer": "按对端隔离",
+  "dmScopePerChannelPeer": "按渠道和对端隔离",
+  "dmScopePerAccountChannelPeer": "按账号、渠道和对端隔离",
+  "runtimeEntries": "运行时入口",
+  "runtimeEntriesHelp": "统一管理可见的运行时入口与其配置。",
+  "runtimeEntryIdPlaceholder": "入口 ID，例如 hermes",
+  "runtimeEntryLabelPlaceholder": "展示名称，例如 Hermes",
+  "runtimeEntryTypePlaceholder": "运行时类型，例如 narp-stdio",
+  "runtimeEntryConfigJson": "配置 JSON",
+  "addRuntimeEntry": "添加运行时入口",
+  "runtimeEntryIdRequired": "运行时入口 ID 必填，位置：{index}",
+  "runtimeEntryTypeRequired": "运行时入口 \"{id}\" 的类型必填",
+  "runtimeEntryDuplicate": "重复的运行时入口 ID",
+  "runtimeEntryConfigObjectRequired": "运行时入口 \"{id}\" 的配置必须是 JSON 对象。",
+  "peerKindDirect": "私聊",
+  "peerKindGroup": "群组",
+  "peerKindChannel": "频道",
+  "runtimeLoading": "加载运行时配置中...",
+  "runtimeControlTitle": "服务管理",
+  "runtimeControlDescription": "明确当前服务状态，并在宿主允许的范围内执行启动、重启、停止或桌面应用重启。",
+  "runtimePresenceTitle": "运行形态与常驻",
+  "runtimePresenceDescription": "明确当前环境里“关闭窗口/页面”会发生什么，以及哪些后台能力由宿主层负责。",
+  "runtimePresenceLoading": "正在读取常驻状态...",
+  "runtimePresenceLoadFailed": "读取桌面端常驻状态失败",
+  "runtimePresenceBehaviorLabel": "当前关闭行为",
+  "runtimePresenceBehaviorBackground": "关闭窗口时隐藏到后台",
+  "runtimePresenceBehaviorQuit": "关闭窗口时退出应用",
+  "runtimePresenceCloseToBackground": "关闭窗口时继续在后台运行",
+  "runtimePresenceCloseToBackgroundHelp": "开启后，关闭桌面窗口只会隐藏到托盘，不会停止本地 NextClaw 服务。",
+  "runtimePresenceLaunchAtLogin": "登录系统时自动启动 NextClaw",
+  "runtimePresenceLaunchAtLoginHelp": "开启后，桌面端会在登录系统后自动启动，并默认保持后台运行。",
+  "runtimePresenceLaunchAtLoginUnavailable": "当前环境暂不支持在这里配置开机自启。",
+  "runtimePresenceSaved": "桌面端常驻设置已保存",
+  "runtimePresenceSaveFailed": "保存桌面端常驻设置失败",
+  "runtimePresenceManagedLocalTitle": "浏览器只是本地服务控制面",
+  "runtimePresenceManagedLocalDescription": "关闭浏览器标签页不会停止本地 NextClaw 服务。服务生命周期由本地受管服务负责，而不是由页面生命周期决定。",
+  "runtimePresenceSelfHostedTitle": "页面不拥有自托管服务生命周期",
+  "runtimePresenceSelfHostedDescription": "关闭浏览器页面不会影响自托管实例。服务启停和开机常驻应由宿主环境或部署层管理。",
+  "runtimePresenceSharedTitle": "共享网页端只暴露状态，不暴露进程控制",
+  "runtimePresenceSharedDescription": "关闭页面只会结束当前连接或会话，不会影响共享服务本体。服务生命周期由平台托管层负责。",
+  "runtimeControlLoading": "读取运行时控制能力中...",
+  "runtimeControlLoadFailed": "读取运行时控制状态失败",
+  "runtimeControlManagedLocalMessage": "使用此页面管理本地 NextClaw 服务。关闭浏览器不会停止服务。",
+  "runtimeControlManagedLocalHint": "此页面由正在运行的本地服务提供。关闭浏览器不会停止它。",
+  "runtimeControlManagedLocalHintShort": "此页面由正在运行的本地服务提供。",
+  "runtimeControlStartUnavailableHosted": "当前页面已经由运行中的本地服务托管。",
+  "runtimeControlRestartAppDesktopOnly": "只有桌面壳环境支持重启整个应用。",
+  "runtimeControlServiceNotRunning": "本地服务未运行。",
+  "runtimeControlServiceAlreadyStopped": "本地服务已经停止。",
+  "runtimeControlManagedServiceStarted": "本地服务已启动。",
+  "runtimeControlManagedServiceStartScheduled": "本地服务启动已安排。",
+  "runtimeControlRestartScheduled": "重启已安排。此页面可能会短暂断开。",
+  "runtimeControlStopScheduled": "停止已安排。此页面即将断开。",
+  "runtimeControlServiceRunning": "服务运行中",
+  "runtimeControlServiceStopped": "服务已停止",
+  "runtimeControlServiceStarting": "正在启动服务",
+  "runtimeControlServiceStopping": "正在停止服务",
+  "runtimeControlServiceRestarting": "正在重启服务",
+  "runtimeControlServiceUnknown": "服务状态未知",
+  "runtimeControlHealthy": "运行时正常",
+  "runtimeControlStartingService": "正在启动服务",
+  "runtimeControlRestartingService": "正在重启服务",
+  "runtimeControlStoppingService": "正在停止服务",
+  "runtimeControlRestartingApp": "正在重启应用",
+  "runtimeControlRecovering": "正在恢复连接",
+  "runtimeControlFailed": "重启失败",
+  "runtimeControlUnavailable": "当前不可用",
+  "runtimeControlEnvironmentDesktop": "桌面端内嵌运行时",
+  "runtimeControlEnvironmentManagedService": "本地托管服务",
+  "runtimeControlEnvironmentSelfHosted": "自托管网页端",
+  "runtimeControlEnvironmentSharedWeb": "共享网页端",
+  "runtimeControlStartService": "启动服务",
+  "runtimeControlRestartService": "重启服务",
+  "runtimeControlStopService": "停止服务",
+  "runtimeControlRestartApp": "重启应用",
+  "runtimeControlPendingRestartTitle": "待重启",
+  "runtimeControlPendingRestartDescription": "这次改动已经保存，但系统不会自动重启。请在你方便的时候手动重启，重启完成后该提示会自动清空。",
+  "runtimeControlPendingRestartPaths": "待生效项",
+  "runtimeStatusLoadingTitle": "读取状态中",
+  "runtimeStatusLoadingDescription": "正在读取当前系统状态。",
+  "runtimeStatusHealthyTitle": "系统正常",
+  "runtimeStatusHealthyDescription": "当前没有需要你立即处理的系统动作。",
+  "runtimeStatusPendingRestartTitle": "待重启",
+  "runtimeStatusPendingRestartDescription": "这些改动已经保存，但不会自动重启。你可以在这里查看原因，并在方便的时候手动重启。",
+  "runtimeStatusPendingRestartReasonItem": "{path} 改动将在重启后生效。",
+  "runtimeStatusActionHint": "准备好时再执行",
+  "runtimeStatusRestartAction": "立即重启",
+  "runtimeStatusRestartingAction": "重启中...",
+  "runtimeControlStartingServiceHelp": "正在启动 NextClaw 服务，页面可能会在服务恢复后重新连接。",
+  "runtimeControlRestartingServiceHelp": "正在重启 NextClaw 服务，页面可能会短暂断开。",
+  "runtimeControlStoppingServiceHelp": "正在停止 NextClaw 服务，当前页面会很快断开。",
+  "runtimeControlRestartingAppHelp": "正在重新启动桌面应用，当前窗口会短暂关闭并立即拉起。",
+  "runtimeControlRecoveringHelp": "正在等待服务恢复连接...",
+  "runtimeControlRecovered": "运行时已恢复连接",
+  "runtimeControlActionFailed": "服务管理动作失败",
+  "runtimeControlRestartAppConfirm": "这会重启整个 NextClaw 桌面应用，并中断当前窗口。确定继续吗？",
+  "runtimeControlStopServiceConfirm": "这会停止当前 NextClaw 服务，当前页面会立即断开。确定继续吗？",
+  "runtimeRestartAppUnavailable": "当前环境不支持从前端重启整个应用。",
+  "runtimeControlDesktopServiceHint": "桌面端由 Launcher 持有应用生命周期；普通用户无需单独停止内嵌服务。",
+  "runtimeRecoveryTimedOut": "等待运行时恢复超时，请稍后重试或查看日志。"
+}

package/src/shared/lib/i18n/locales/zh-CN/search.json

@@ -0,0 +1,28 @@
+{
+  "searchPageTitle": "搜索渠道",
+  "searchPageDescription": "配置网页搜索提供商",
+  "searchActiveProvider": "当前搜索提供商",
+  "searchDefaultMaxResults": "默认返回条数",
+  "searchProviderSummary": "结果摘要",
+  "searchProviderFreshness": "时间范围",
+  "searchProviderSearchDepth": "搜索深度",
+  "searchProviderIncludeAnswer": "包含回答",
+  "searchProviderBaseUrl": "接口地址",
+  "searchProviderOpenDocs": "查看文档",
+  "searchProviderActivate": "激活",
+  "searchProviderActivated": "已激活",
+  "searchProviderDeactivate": "取消激活",
+  "searchProviderBochaDescription": "更适合中国大陆用户的 AI 搜索。",
+  "searchProviderTavilyDescription": "更适合调研和网页信息整合的搜索 provider。",
+  "searchProviderBraveDescription": "保留 Brave 作为可选 provider。",
+  "searchStatusConfigured": "已配置",
+  "searchStatusNeedsSetup": "待配置",
+  "searchFreshnessNoLimit": "不限",
+  "searchFreshnessOneDay": "一天内",
+  "searchFreshnessOneWeek": "一周内",
+  "searchFreshnessOneMonth": "一个月内",
+  "searchFreshnessOneYear": "一年内",
+  "searchDepthBasic": "基础",
+  "searchDepthAdvanced": "高级",
+  "searchNoProviderSelected": "请选择左侧搜索 provider"
+}

package/src/shared/lib/i18n/runtime/{i18n-language-owner.test.ts → __tests__/i18n-language-owner.test.ts}

@@ -1,5 +1,5 @@
 import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
-import type * as I18nRuntimeModule from './i18n-language-owner';
+import type * as I18nRuntimeModule from '../i18n-language-owner';
 
 type I18nRuntimeOwnerModule = typeof I18nRuntimeModule;
 
@@ -21,7 +21,7 @@ declare global {
 
 async function loadOwner(): Promise<I18nRuntimeOwnerModule> {
   vi.resetModules();
-  return await import('./i18n-language-owner');
+  return await import('../i18n-language-owner');
 }
 
 function createMockStorage(): MockStorage {

package/src/shared/lib/navigation-history/__tests__/navigation-history.utils.test.ts

@@ -0,0 +1,60 @@
+import { describe, expect, it } from 'vitest';
+import {
+  filterNavigationHistoryEntries,
+  pushNavigationHistoryEntry,
+  stepNavigationHistory,
+} from '../navigation-history.utils';
+
+describe('navigation-history utils', () => {
+  it('pushes new entries and truncates forward history after stepping back', () => {
+    const initial = pushNavigationHistoryEntry({ entries: [], index: 0 }, 'a');
+    const second = pushNavigationHistoryEntry(initial, 'b');
+    const third = pushNavigationHistoryEntry(second, 'c');
+    const stepped = stepNavigationHistory(third, 'back');
+
+    expect(stepped?.entry).toBe('b');
+
+    const next = pushNavigationHistoryEntry(stepped!.history, 'd');
+
+    expect(next).toEqual({
+      entries: ['a', 'b', 'd'],
+      index: 2,
+    });
+  });
+
+  it('does not duplicate the current entry when the matcher says it is the same', () => {
+    const history = pushNavigationHistoryEntry(
+      { entries: [{ id: 'a' }], index: 0 },
+      { id: 'a' },
+      (current, next) => current.id === next.id,
+    );
+
+    expect(history.entries).toEqual([{ id: 'a' }]);
+    expect(history.index).toBe(0);
+  });
+
+  it('filters entries while keeping the nearest surviving current position', () => {
+    const history = filterNavigationHistoryEntries(
+      { entries: ['a', 'b', 'c', 'b'], index: 2 },
+      (entry) => entry !== 'b',
+    );
+
+    expect(history).toEqual({
+      entries: ['a', 'c'],
+      index: 1,
+    });
+  });
+
+  it('uses the fallback entry when every entry is filtered out', () => {
+    expect(
+      filterNavigationHistoryEntries(
+        { entries: ['a'], index: 0 },
+        () => false,
+        'home',
+      ),
+    ).toEqual({
+      entries: ['home'],
+      index: 0,
+    });
+  });
+});

package/src/shared/lib/navigation-history/index.ts

@@ -0,0 +1 @@
+export * from './navigation-history.utils';

package/src/shared/lib/navigation-history/navigation-history.utils.ts

@@ -0,0 +1,105 @@
+export type NavigationHistoryDirection = 'back' | 'forward';
+
+export type NavigationHistoryState<Entry> = {
+  entries: readonly Entry[];
+  index: number;
+};
+
+export type NavigationHistoryStep<Entry> = {
+  history: NavigationHistoryState<Entry>;
+  entry: Entry;
+};
+
+export type NavigationHistoryEntryMatcher<Entry> = (
+  current: Entry,
+  next: Entry,
+) => boolean;
+
+export function canGoBackInNavigationHistory<Entry>(
+  history: NavigationHistoryState<Entry>,
+): boolean {
+  return history.index > 0 && history.entries.length > 0;
+}
+
+export function canGoForwardInNavigationHistory<Entry>(
+  history: NavigationHistoryState<Entry>,
+): boolean {
+  return history.index >= 0 && history.index < history.entries.length - 1;
+}
+
+export function pushNavigationHistoryEntry<Entry>(
+  history: NavigationHistoryState<Entry>,
+  entry: Entry,
+  isSameEntry: NavigationHistoryEntryMatcher<Entry> = Object.is,
+): NavigationHistoryState<Entry> {
+  const normalizedIndex = normalizeNavigationHistoryIndex(history);
+  const current = history.entries[normalizedIndex];
+  if (current && isSameEntry(current, entry)) {
+    return {
+      entries: history.entries,
+      index: normalizedIndex,
+    };
+  }
+  const entries = [...history.entries.slice(0, normalizedIndex + 1), entry];
+  return {
+    entries,
+    index: entries.length - 1,
+  };
+}
+
+export function stepNavigationHistory<Entry>(
+  history: NavigationHistoryState<Entry>,
+  direction: NavigationHistoryDirection,
+): NavigationHistoryStep<Entry> | null {
+  const normalizedIndex = normalizeNavigationHistoryIndex(history);
+  const nextIndex = direction === 'back'
+    ? normalizedIndex - 1
+    : normalizedIndex + 1;
+  const entry = history.entries[nextIndex];
+  if (!entry) {
+    return null;
+  }
+  return {
+    history: {
+      entries: history.entries,
+      index: nextIndex,
+    },
+    entry,
+  };
+}
+
+export function filterNavigationHistoryEntries<Entry>(
+  history: NavigationHistoryState<Entry>,
+  shouldKeep: (entry: Entry) => boolean,
+  fallbackEntry?: Entry,
+): NavigationHistoryState<Entry> {
+  const normalizedIndex = normalizeNavigationHistoryIndex(history);
+  const keptEntries = history.entries.filter(shouldKeep);
+  if (keptEntries.length === 0) {
+    return fallbackEntry === undefined
+      ? { entries: [], index: 0 }
+      : { entries: [fallbackEntry], index: 0 };
+  }
+  const keptBeforeOrAtCurrent = history.entries
+    .slice(0, normalizedIndex + 1)
+    .filter(shouldKeep);
+  return {
+    entries: keptEntries,
+    index: Math.min(
+      Math.max(0, keptBeforeOrAtCurrent.length - 1),
+      keptEntries.length - 1,
+    ),
+  };
+}
+
+function normalizeNavigationHistoryIndex<Entry>(
+  history: NavigationHistoryState<Entry>,
+): number {
+  if (history.entries.length === 0) {
+    return 0;
+  }
+  if (!Number.isInteger(history.index)) {
+    return history.entries.length - 1;
+  }
+  return Math.min(Math.max(0, history.index), history.entries.length - 1);
+}

package/src/shared/lib/provider-models/{index.test.ts → __tests__/index.test.ts}

@@ -1,5 +1,5 @@
 import { describe, expect, it } from 'vitest';
-import { buildProviderModelCatalog } from './index';
+import { buildProviderModelCatalog } from '../index';
 
 describe('buildProviderModelCatalog', () => {
   it('keeps empty provider models empty', () => {

package/src/shared/lib/transport/{app-client.test.ts → __tests__/app-client.test.ts}

@@ -11,7 +11,7 @@ describe('appClient runtime detection', () => {
   });
 
   it('imports without triggering an API_BASE initialization cycle', async () => {
-    const { appClient } = await import('./app-client.service');
+    const { appClient } = await import('../app-client.service');
 
     expect(appClient).toBeDefined();
   });
@@ -28,7 +28,7 @@ describe('appClient runtime detection', () => {
     vi.stubGlobal('fetch', fetchMock);
 
     const localRequest = vi.fn().mockResolvedValue({ ok: true } as never);
-    vi.doMock('./local-transport.service', () => ({
+    vi.doMock('../local-transport.service', () => ({
       LocalAppTransport: class {
         request = localRequest;
         openStream = vi.fn();
@@ -36,7 +36,7 @@ describe('appClient runtime detection', () => {
       }
     }));
 
-    const { appClient } = await import('./app-client.service');
+    const { appClient } = await import('../app-client.service');
     const result = await appClient.request<{ ok: boolean }>({
       method: 'GET',
       path: '/api/config'

package/src/shared/lib/transport/{remote.transport.test.ts → __tests__/remote.transport.test.ts}

@@ -1,5 +1,5 @@
 import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
-import { RemoteSessionMultiplexTransport } from './remote-transport.service';
+import { RemoteSessionMultiplexTransport } from '../remote-transport.service';
 
 class MockWebSocket {
   static readonly CONNECTING = 0;

package/src/shared/lib/transport/{sse-stream.test.ts → __tests__/sse-stream.test.ts}

@@ -1,5 +1,5 @@
 import { describe, expect, it } from 'vitest';
-import { readSseStreamResult } from './sse-stream.utils';
+import { readSseStreamResult } from '../sse-stream.utils';
 
 function createSseResponse(frames: string[]): Response {
   const payload = new TextEncoder().encode(frames.join(''));

package/tsconfig.json

@@ -15,11 +15,7 @@
       "@/components/chat/chat-page": ["./src/features/chat/pages/chat-page.tsx"],
       "@/components/config/ChannelsList": ["./src/features/channels/pages/channels-list-page.tsx"],
       "@/components/config/desktop-update-config": ["./src/features/system-status/components/desktop-update-config.tsx"],
-      "@/components/config/ModelConfig": ["./src/shared/components/model-config.tsx"],
-      "@/components/config/ProvidersList": ["./src/shared/components/config/providers-list.tsx"],
       "@/components/config/RuntimeConfig": ["./src/features/system-status/pages/runtime-config-page.tsx"],
-      "@/components/config/SearchConfig": ["./src/shared/components/search-config.tsx"],
-      "@/components/config/SecretsConfig": ["./src/shared/components/config/secrets-config.tsx"],
       "@/components/config/security-config": ["./src/features/system-status/components/security-config.tsx"],
       "@/components/config/SessionsConfig": ["./src/features/chat/pages/sessions-config-page.tsx"],
       "@/components/layout/AppLayout": ["./src/app/components/layout/app-layout.tsx"],
@@ -39,7 +35,8 @@
       "@nextclaw/shared": ["../nextclaw-shared/src/index.ts"],
       "@nextclaw/ncp": ["../ncp-packages/nextclaw-ncp/src/index.ts"],
       "@nextclaw/ncp-http-agent-client": ["../ncp-packages/nextclaw-ncp-http-agent-client/src/index.ts"],
-      "@nextclaw/ncp-react": ["../ncp-packages/nextclaw-ncp-react/src/index.ts"]
+      "@nextclaw/ncp-react": ["../ncp-packages/nextclaw-ncp-react/src/index.ts"],
+      "@nextclaw/ncp-toolkit": ["../ncp-packages/nextclaw-ncp-toolkit/src/index.ts"]
     }
   },
   "include": ["src"]

package/vite.config.ts

@@ -13,11 +13,7 @@ export default defineConfig({
       '@/components/chat/chat-page': path.resolve(__dirname, './src/features/chat/pages/chat-page.tsx'),
       '@/components/config/ChannelsList': path.resolve(__dirname, './src/features/channels/pages/channels-list-page.tsx'),
       '@/components/config/desktop-update-config': path.resolve(__dirname, './src/features/system-status/components/desktop-update-config.tsx'),
-      '@/components/config/ModelConfig': path.resolve(__dirname, './src/shared/components/model-config.tsx'),
-      '@/components/config/ProvidersList': path.resolve(__dirname, './src/shared/components/config/providers-list.tsx'),
       '@/components/config/RuntimeConfig': path.resolve(__dirname, './src/features/system-status/pages/runtime-config-page.tsx'),
-      '@/components/config/SearchConfig': path.resolve(__dirname, './src/shared/components/search-config.tsx'),
-      '@/components/config/SecretsConfig': path.resolve(__dirname, './src/shared/components/config/secrets-config.tsx'),
       '@/components/config/security-config': path.resolve(__dirname, './src/features/system-status/components/security-config.tsx'),
       '@/components/layout/AppLayout': path.resolve(__dirname, './src/app/components/layout/app-layout.tsx'),
       '@/components/marketplace/marketplace-page': path.resolve(__dirname, './src/features/marketplace/components/marketplace-page.tsx'),
@@ -33,6 +29,10 @@ export default defineConfig({
       '@nextclaw/agent-chat-ui': path.resolve(__dirname, '../nextclaw-agent-chat-ui/src/index.ts'),
       '@agent-chat-ui': path.resolve(__dirname, '../nextclaw-agent-chat-ui/src'),
       '@nextclaw/client-sdk': path.resolve(__dirname, '../nextclaw-client-sdk/src/index.ts'),
+      '@nextclaw/ncp': path.resolve(__dirname, '../ncp-packages/nextclaw-ncp/src/index.ts'),
+      '@nextclaw/ncp-http-agent-client': path.resolve(__dirname, '../ncp-packages/nextclaw-ncp-http-agent-client/src/index.ts'),
+      '@nextclaw/ncp-react': path.resolve(__dirname, '../ncp-packages/nextclaw-ncp-react/src/index.ts'),
+      '@nextclaw/ncp-toolkit': path.resolve(__dirname, '../ncp-packages/nextclaw-ncp-toolkit/src/index.ts'),
       '@nextclaw/shared': path.resolve(__dirname, '../nextclaw-shared/src/index.ts')
     }
   },

package/vitest.config.ts

@@ -28,6 +28,10 @@ export default defineConfig({
       '@nextclaw/agent-chat-ui': path.resolve(__dirname, '../nextclaw-agent-chat-ui/src/index.ts'),
       '@agent-chat-ui': path.resolve(__dirname, '../nextclaw-agent-chat-ui/src'),
       '@nextclaw/client-sdk': path.resolve(__dirname, '../nextclaw-client-sdk/src/index.ts'),
+      '@nextclaw/ncp': path.resolve(__dirname, '../ncp-packages/nextclaw-ncp/src/index.ts'),
+      '@nextclaw/ncp-http-agent-client': path.resolve(__dirname, '../ncp-packages/nextclaw-ncp-http-agent-client/src/index.ts'),
+      '@nextclaw/ncp-react': path.resolve(__dirname, '../ncp-packages/nextclaw-ncp-react/src/index.ts'),
+      '@nextclaw/ncp-toolkit': path.resolve(__dirname, '../ncp-packages/nextclaw-ncp-toolkit/src/index.ts'),
       '@nextclaw/shared': path.resolve(__dirname, '../nextclaw-shared/src/index.ts')
     }
   },