@nextclaw/ui 0.12.23 → 0.12.25

package/src/shared/components/ui/select.tsx

@@ -7,10 +7,14 @@ const Select = SelectPrimitive.Root
 const SelectGroup = SelectPrimitive.Group
 const SelectValue = SelectPrimitive.Value
 
+type SelectTriggerProps = React.ComponentPropsWithoutRef<typeof SelectPrimitive.Trigger> & {
+    indicator?: React.ReactNode
+}
+
 const SelectTrigger = React.forwardRef<
     React.ElementRef<typeof SelectPrimitive.Trigger>,
-    React.ComponentPropsWithoutRef<typeof SelectPrimitive.Trigger>
->(({ className, children, ...props }, ref) => (
+    SelectTriggerProps
+>(({ className, children, indicator, ...props }, ref) => (
     <SelectPrimitive.Trigger
         ref={ref}
         className={cn(
@@ -21,7 +25,7 @@ const SelectTrigger = React.forwardRef<
     >
         {children}
         <SelectPrimitive.Icon asChild>
-            <ChevronDown className="h-4 w-4 opacity-50" />
+            {indicator ?? <ChevronDown className="h-4 w-4 opacity-50" />}
         </SelectPrimitive.Icon>
     </SelectPrimitive.Trigger>
 ))
@@ -55,15 +59,19 @@ const SelectScrollDownButton = React.forwardRef<
 ))
 SelectScrollDownButton.displayName = SelectPrimitive.ScrollDownButton.displayName
 
+type SelectContentProps = React.ComponentPropsWithoutRef<typeof SelectPrimitive.Content> & {
+    viewportClassName?: string
+}
+
 const SelectContent = React.forwardRef<
     React.ElementRef<typeof SelectPrimitive.Content>,
-    React.ComponentPropsWithoutRef<typeof SelectPrimitive.Content>
->(({ className, children, position = "popper", ...props }, ref) => (
+    SelectContentProps
+>(({ className, children, position = "popper", viewportClassName, ...props }, ref) => (
     <SelectPrimitive.Portal>
         <SelectPrimitive.Content
             ref={ref}
             className={cn(
-                "relative z-50 max-h-96 min-w-[8rem] overflow-hidden rounded-md border bg-popover text-popover-foreground shadow-md data-[state=open]:animate-in data-[state=closed]:animate-out data-[state=closed]:fade-out-0 data-[state=open]:fade-in-0 data-[state=closed]:zoom-out-95 data-[state=open]:zoom-in-95 data-[side=bottom]:slide-in-from-top-2 data-[side=left]:slide-in-from-right-2 data-[side=right]:slide-in-from-left-2 data-[side=top]:slide-in-from-bottom-2 bg-white",
+                "relative z-[var(--z-popover,50)] max-h-96 min-w-[8rem] overflow-hidden rounded-md border bg-popover text-popover-foreground shadow-md data-[state=open]:animate-in data-[state=closed]:animate-out data-[state=closed]:fade-out-0 data-[state=open]:fade-in-0 data-[state=closed]:zoom-out-95 data-[state=open]:zoom-in-95 data-[side=bottom]:slide-in-from-top-2 data-[side=left]:slide-in-from-right-2 data-[side=right]:slide-in-from-left-2 data-[side=top]:slide-in-from-bottom-2 bg-white",
                 position === "popper" &&
                 "data-[side=bottom]:translate-y-1 data-[side=left]:-translate-x-1 data-[side=right]:translate-x-1 data-[side=top]:-translate-y-1",
                 className
@@ -73,7 +81,11 @@ const SelectContent = React.forwardRef<
         >
             <SelectScrollUpButton />
             <SelectPrimitive.Viewport
-                className={cn("p-1", position === "popper" && "h-[var(--radix-select-trigger-height)] w-full min-w-[var(--radix-select-trigger-width)]")}
+                className={cn(
+                    "p-1",
+                    position === "popper" && "h-[var(--radix-select-trigger-height)] w-full min-w-[var(--radix-select-trigger-width)]",
+                    viewportClassName
+                )}
             >
                 {children}
             </SelectPrimitive.Viewport>

package/src/shared/lib/api/channel-auth.types.ts

@@ -1,6 +1,7 @@
 export type ChannelAuthStartRequest = {
   accountId?: string;
   baseUrl?: string;
+  domain?: string;
 };
 
 export type ChannelAuthStartResult = {

package/src/shared/lib/api/ncp-session-query-cache.test.ts

@@ -14,14 +14,18 @@ function createSessionsList(): NcpSessionsListView {
       {
         sessionId: 'session-1',
         messageCount: 1,
+        createdAt: '2026-03-29T08:00:00.000Z',
         updatedAt: '2026-03-29T10:00:00.000Z',
+        lastMessageAt: '2026-03-29T10:00:00.000Z',
         status: 'idle',
         metadata: {}
       },
       {
         sessionId: 'session-2',
         messageCount: 2,
+        createdAt: '2026-03-29T07:00:00.000Z',
         updatedAt: '2026-03-29T09:00:00.000Z',
+        lastMessageAt: '2026-03-29T09:00:00.000Z',
         status: 'idle',
         metadata: {}
       }
@@ -31,11 +35,13 @@ function createSessionsList(): NcpSessionsListView {
 }
 
 describe('ncp-session-query-cache', () => {
-  it('upserts summaries and keeps the list sorted by updatedAt descending', () => {
+  it('upserts summaries and keeps the list sorted by last message time descending', () => {
     const updated = upsertNcpSessionSummaryList(createSessionsList(), {
       sessionId: 'session-2',
       messageCount: 3,
+      createdAt: '2026-03-29T07:00:00.000Z',
       updatedAt: '2026-03-29T11:00:00.000Z',
+      lastMessageAt: '2026-03-29T11:00:00.000Z',
       status: 'running',
       metadata: { label: 'Latest' }
     });
@@ -48,6 +54,23 @@ describe('ncp-session-query-cache', () => {
     });
   });
 
+  it('does not reorder when only session metadata updatedAt changes', () => {
+    const updated = upsertNcpSessionSummaryList(createSessionsList(), {
+      sessionId: 'session-2',
+      messageCount: 2,
+      createdAt: '2026-03-29T07:00:00.000Z',
+      updatedAt: '2026-03-29T12:00:00.000Z',
+      lastMessageAt: '2026-03-29T09:00:00.000Z',
+      status: 'idle',
+      metadata: { ui_last_read_at: '2026-03-29T09:00:00.000Z' }
+    });
+
+    expect(updated?.sessions.map((session) => session.sessionId)).toEqual(['session-1', 'session-2']);
+    expect(updated?.sessions[1]?.metadata).toEqual({
+      ui_last_read_at: '2026-03-29T09:00:00.000Z'
+    });
+  });
+
   it('ignores stale summaries that would move a session back to an older running state', () => {
     const updated = upsertNcpSessionSummaryList(createSessionsList(), {
       sessionId: 'session-1',
@@ -128,7 +151,9 @@ describe('ncp-session-query-cache', () => {
         summary: {
           sessionId: 'session-3',
           messageCount: 1,
+          createdAt: '2026-03-29T12:00:00.000Z',
           updatedAt: '2026-03-29T12:00:00.000Z',
+          lastMessageAt: '2026-03-29T12:00:00.000Z',
           status: 'running',
           metadata: {}
         }

package/src/shared/lib/api/ncp-session-query-cache.ts

@@ -1,8 +1,12 @@
 import type { QueryClient } from '@tanstack/react-query';
 import type { NcpSessionSummaryView, NcpSessionsListView, WsEvent } from '@/shared/lib/api';
 
+function readSessionActivityAt(summary: NcpSessionSummaryView): string {
+  return summary.lastMessageAt ?? summary.createdAt ?? summary.updatedAt;
+}
+
 function sortSessionSummaries(summaries: readonly NcpSessionSummaryView[]): NcpSessionSummaryView[] {
-  return [...summaries].sort((left, right) => right.updatedAt.localeCompare(left.updatedAt));
+  return [...summaries].sort((left, right) => readSessionActivityAt(right).localeCompare(readSessionActivityAt(left)));
 }
 
 function shouldReplaceSessionSummary(

package/src/shared/lib/api/ncp-session.types.ts

@@ -31,6 +31,13 @@ export type SessionContextWindowView = {
   updatedAt: string;
 };
 
+export type SessionActivityPreviewView = {
+  state: "running" | "completed" | "failed" | "idle";
+  timestamp: string;
+  statusText?: string;
+  replyText?: string;
+};
+
 export type SessionEntryView = {
   key: string;
   createdAt: string;
@@ -52,9 +59,11 @@ export type SessionEntryView = {
   parentSessionId?: string | null;
   spawnedByRequestId?: string | null;
   contextWindow?: SessionContextWindowView | null;
+  activityPreview?: SessionActivityPreviewView;
   messageCount: number;
   lastRole?: string;
   lastTimestamp?: string;
+  status?: NcpSessionStatus;
 };
 
 export type SessionMessageView = {

package/src/shared/lib/api/types.ts

@@ -1,5 +1,5 @@
 import type { NcpSessionStatus } from '@nextclaw/ncp';
-import type { SessionEntryView, RuntimeEntryView, SessionTypeIconView, SessionMessageView, SessionEventView, NcpSessionSummaryView } from './ncp-session.types';
+import type { RuntimeEntryView, NcpSessionSummaryView } from './ncp-session.types';
 export type { SessionEntryView, RuntimeEntryView, SessionTypeIconView, SessionMessageView, SessionEventView, NcpSessionSummaryView, NcpSessionsListView, NcpMessageView, NcpSessionMessagesView, SessionContextWindowView } from './ncp-session.types';
 
 // API Types - matching backend response format
@@ -776,6 +776,17 @@ export type MarketplaceRecommendationView = {
   items: MarketplaceItemSummary[];
 };
 
+export type MarketplaceSceneView = {
+  scene: string;
+  title: string;
+  description?: string;
+  count?: number;
+};
+
+export type MarketplaceScenesView = {
+  scenes: MarketplaceSceneView[];
+};
+
 export type MarketplaceInstalledRecord = {
   type: MarketplaceItemType;
   id?: string;

package/src/shared/lib/api/utils/marketplace.utils.ts

@@ -1,4 +1,4 @@
-import { nextclawClient } from '../managers/client.manager';
+import { nextclawClient } from '@/shared/lib/api/managers/client.manager';
 import type {
   MarketplaceInstallRequest,
   MarketplaceInstallResult,
@@ -11,6 +11,7 @@ import type {
   MarketplaceItemView,
   MarketplaceListView,
   MarketplaceRecommendationView,
+  MarketplaceScenesView,
   MarketplaceSort
 } from '@/shared/lib/api/types';
 
@@ -18,6 +19,7 @@ export type MarketplaceListParams = {
   type: MarketplaceItemType;
   q?: string;
   tag?: string;
+  scene?: string;
   sort?: MarketplaceSort;
   page?: number;
   pageSize?: number;
@@ -49,6 +51,10 @@ export async function fetchMarketplaceRecommendations(
   return await nextclawClient.marketplace.fetchRecommendations(type, params);
 }
 
+export async function fetchMarketplaceSkillScenes(): Promise<MarketplaceScenesView> {
+  return await nextclawClient.marketplace.fetchSkillScenes();
+}
+
 export async function installMarketplaceItem(request: MarketplaceInstallRequest): Promise<MarketplaceInstallResult> {
   return await nextclawClient.marketplace.install(
     request as Parameters<typeof nextclawClient.marketplace.install>[0]

package/src/shared/lib/cron/cron-job-view.utils.ts

@@ -0,0 +1,59 @@
+import type { CronJobView } from "@/shared/lib/api";
+import { formatDateTime } from "@/shared/lib/i18n";
+
+export function formatCronDate(value?: string | null): string {
+  return formatDateTime(value ?? undefined);
+}
+
+function formatDateFromMs(value?: number | null): string {
+  if (typeof value !== "number" || !Number.isFinite(value)) {
+    return "-";
+  }
+  return formatDateTime(new Date(value));
+}
+
+function formatEveryDuration(ms?: number | null): string {
+  if (typeof ms !== "number" || !Number.isFinite(ms)) {
+    return "-";
+  }
+  const seconds = Math.round(ms / 1000);
+  if (seconds < 60) return `${seconds}s`;
+  const minutes = Math.round(seconds / 60);
+  if (minutes < 60) return `${minutes}m`;
+  const hours = Math.round(minutes / 60);
+  if (hours < 24) return `${hours}h`;
+  const days = Math.round(hours / 24);
+  return `${days}d`;
+}
+
+export function describeCronSchedule(job: CronJobView): string {
+  const { schedule } = job;
+  if (schedule.kind === "cron") {
+    return schedule.expr ? `cron ${schedule.expr}` : "cron";
+  }
+  if (schedule.kind === "every") {
+    return `every ${formatEveryDuration(schedule.everyMs)}`;
+  }
+  if (schedule.kind === "at") {
+    return `at ${formatDateFromMs(schedule.atMs)}`;
+  }
+  return "-";
+}
+
+export function describeCronDelivery(job: CronJobView): string {
+  if (!job.payload.deliver) {
+    return "-";
+  }
+  const channel = job.payload.channel ?? "-";
+  const target = job.payload.to ?? "-";
+  return `${channel}:${target}`;
+}
+
+export function describeCronSession(job: CronJobView): string {
+  return job.payload.sessionId?.trim() || `cron:${job.id}`;
+}
+
+export function isCronJobForSession(job: CronJobView, sessionKey: string | null | undefined): boolean {
+  const normalizedSessionKey = sessionKey?.trim();
+  return Boolean(normalizedSessionKey && job.payload.sessionId?.trim() === normalizedSessionKey);
+}

package/src/shared/lib/cron/index.ts

@@ -0,0 +1 @@
+export * from "./cron-job-view.utils";

package/src/shared/lib/i18n/{channel-auth.ts → channel-auth.constants.ts}

@@ -38,5 +38,36 @@ export const CHANNEL_AUTH_LABELS: Record<string, { zh: string; en: string }> = {
   weixinAuthAdvancedDescription: {
     zh: '仅在你需要自定义接口地址、账号映射或白名单时再展开这些字段。',
     en: 'Expand these fields only when you need to customize the API base URL, account mapping, or allowlist.'
+  },
+  feishuAuthTitle: { zh: '扫码连接飞书', en: 'Connect Feishu by QR' },
+  feishuAuthDescription: { zh: '飞书渠道使用扫码创建自建应用，不再要求手动复制应用凭证。', en: 'Feishu uses QR-based app registration, so you no longer need to copy app credentials manually.' },
+  feishuAuthHint: {
+    zh: '点击按钮后用飞书扫码确认，连接成功后会自动保存应用凭证并启用 WebSocket 收发。',
+    en: 'Start the flow, scan with Feishu, and the app credentials will be saved automatically for WebSocket messaging.'
+  },
+  feishuAuthCapabilityHint: {
+    zh: '连接成功后，Agent 可以通过飞书自建应用收发私聊和群聊消息。',
+    en: 'After connecting, the agent can send and receive Feishu direct and group messages through the registered app.'
+  },
+  feishuAuthDisabledHint: {
+    zh: '当前飞书应用已完成扫码连接，但渠道处于未启用状态。打开 Enabled 后才会开始收发消息。',
+    en: 'This Feishu app is connected, but the channel is inactive. Turn on Enabled before it can send or receive messages.'
+  },
+  feishuAuthConnect: { zh: '扫码连接飞书', en: 'Scan QR to connect Feishu' },
+  feishuAuthQrAlt: { zh: '飞书应用注册二维码', en: 'Feishu app registration QR code' },
+  feishuAuthScanPrompt: { zh: '请用飞书扫码，并按页面提示完成应用创建授权。', en: 'Scan with Feishu and follow the prompts to finish app registration.' },
+  feishuAuthReadyTitle: { zh: '准备连接飞书', en: 'Ready to connect Feishu' },
+  feishuAuthReadyDescription: {
+    zh: '点击左侧按钮后，这里会显示应用注册二维码。首配流程默认不需要进入开放平台手动建应用。',
+    en: 'After you start the flow, the app registration QR code will appear here. First-time setup does not require manually creating an app in the developer console.'
+  },
+  feishuAuthAdvancedTitle: { zh: '高级设置', en: 'Advanced settings' },
+  feishuAuthAdvancedDescription: {
+    zh: '仅在你需要切换 Feishu/Lark 域名、指定默认账号、白名单或群聊策略时再展开这些字段。',
+    en: 'Expand these fields only when you need to switch Feishu/Lark domains, choose a default account, or adjust allowlist and group policies.'
+  },
+  feishuAuthDomain: {
+    zh: '飞书域名',
+    en: 'Feishu domain'
   }
 };

package/src/shared/lib/i18n/chat-labels.utils.ts

@@ -38,11 +38,10 @@ export const CHAT_LABELS: Record<string, { zh: string; en: string }> = {
   },
   chatSessionLabel: { zh: '当前会话', en: 'Current Session' },
   chatNoSession: { zh: '未选择会话', en: 'No session selected' },
-  chatNoSessionHint: { zh: '创建一个会话并发送第一条消息。', en: 'Create a session and send your first message.' },
   chatHistoryLoading: { zh: '加载会话历史中...', en: 'Loading session history...' },
-  chatNoMessages: { zh: '暂无消息，发送一条开始对话。', en: 'No messages yet. Send one to start.' },
   chatBackToParent: { zh: '返回父会话', en: 'Back to parent' },
   chatSessionOpenChildSessions: { zh: '查看子会话', en: 'View child sessions' },
+  chatSessionOpenCronJobs: { zh: '查看本会话定时任务', en: 'View session cron jobs' },
   chatChildSessionLoading: { zh: '正在加载子会话…', en: 'Loading child session…' },
   chatChildSessionEmpty: { zh: '子会话还没有消息。', en: 'No child session messages yet.' },
   chatWorkspaceClosePanel: { zh: '关闭工作区侧栏', en: 'Close workspace panel' },
@@ -56,6 +55,8 @@ export const CHAT_LABELS: Record<string, { zh: string; en: string }> = {
   chatWorkspacePreviewEmpty: { zh: '当前没有可显示的文件内容。', en: 'No file content is available for preview.' },
   chatWorkspaceDiffEmpty: { zh: '当前没有可显示的 diff 内容。', en: 'No diff content is available.' },
   chatWorkspacePreviewTruncated: { zh: '内容已截断', en: 'Preview truncated' },
+  chatWorkspaceSessionCronJobs: { zh: '本会话定时任务', en: 'Session cron jobs' },
+  chatWorkspaceCronJobEmpty: { zh: '这个会话暂无定时任务。', en: 'This session has no cron jobs.' },
   chatSessionUnread: { zh: '会话有未读更新', en: 'Session has unread updates' },
   chatTyping: { zh: 'Agent 正在思考...', en: 'Agent is thinking...' },
   chatRuntimeInitializing: {

package/src/shared/lib/i18n/index.ts

@@ -1,6 +1,6 @@
 import { AGENT_LABELS } from './agents';
 import { CHANNEL_LABELS } from './channels';
-import { CHANNEL_AUTH_LABELS } from './channel-auth';
+import { CHANNEL_AUTH_LABELS } from './channel-auth.constants';
 import { CHAT_LABELS } from './chat-labels.utils';
 import {
   getLanguage,
@@ -17,7 +17,7 @@ import { MARKETPLACE_LABELS } from './marketplace';
 import { PATH_PICKER_LABELS } from './runtime/i18n.path-picker';
 import { PWA_LABELS } from './pwa';
 import { REMOTE_LABELS } from './remote';
-import { RUNTIME_CONTROL_LABELS } from './runtime-control';
+import { RUNTIME_CONTROL_LABELS } from './runtime-control-labels.utils';
 import { SEARCH_LABELS } from './search';
 export type { I18nLanguage };
 export { getLanguage, getLocale, initializeI18n, LANGUAGE_OPTIONS, resolveInitialLanguage, setLanguage, subscribeLanguageChange };
@@ -113,7 +113,7 @@ export const LABELS: Record<string, { zh: string; en: string }> = {
     en: 'If the model is not listed, type a custom model ID directly.'
   },
   modelIdentifierHelp: {
-    zh: 'Agent 默认模型标识，使用带 provider 前缀的格式。例如：openai/gpt-5.1、anthropic/claude-opus-4-1、deepseek/deepseek-chat、minimax/MiniMax-M2.5、openrouter/openai/gpt-5.3-codex。',
+    zh: '智能体默认模型标识，使用带提供商前缀的格式。例如：openai/gpt-5.1、anthropic/claude-opus-4-1、deepseek/deepseek-chat、minimax/MiniMax-M2.5、openrouter/openai/gpt-5.3-codex。',
     en: 'Default model identifier used by the agent. Use provider-prefixed format. Examples: openai/gpt-5.1 · anthropic/claude-opus-4-1 · deepseek/deepseek-chat · minimax/MiniMax-M2.5 · openrouter/openai/gpt-5.3-codex.'
   },
   maxToolIterations: { zh: '最大工具迭代次数', en: 'Max Tool Iterations' },
@@ -132,7 +132,7 @@ export const LABELS: Record<string, { zh: string; en: string }> = {
   providersSelectPlaceholder: { zh: '选择提供商', en: 'Select Provider' },
   providersSelectTitle: { zh: '选择左侧提供商开始配置', en: 'Select a provider from the left to configure' },
   providersSelectDescription: { zh: '你可以连续切换多个提供商并逐个保存配置。', en: 'Switch between providers continuously and save each configuration.' },
-  providersDefaultDescription: { zh: '为你的 Agent 配置 AI 服务', en: 'Configure AI services for your agents' },
+  providersDefaultDescription: { zh: '为你的智能体配置 AI 服务', en: 'Configure AI services for your agents' },
   providersEmptyTitle: { zh: '尚未配置提供商', en: 'No providers configured' },
   providersEmptyDescription: { zh: '添加一个 AI 提供商后即可开始使用。', en: 'Add an AI provider to start using the platform.' },
   apiKey: { zh: 'API 密钥', en: 'API Key' },
@@ -346,32 +346,32 @@ export const LABELS: Record<string, { zh: string; en: string }> = {
   authSessionMemoryNotice: { zh: '当前版本的会话只保存在服务端内存里。NextClaw UI 进程重启后，需要重新登录。', en: 'Sessions are stored only in server memory for now. You will need to sign in again after the NextClaw UI process restarts.' },
   dmScope: { zh: '私聊范围', en: 'DM Scope' },
   dmScopeHelp: { zh: '控制私聊会话如何隔离。', en: 'Control how direct-message sessions are isolated.' },
-  defaultContextTokens: { zh: '默认上下文 Token', en: 'Default Context Tokens' },
-  defaultContextTokensHelp: { zh: '当 Agent 未设置单独值时使用该上下文预算。', en: 'Input context budget for agents when no per-agent override is set.' },
+  defaultContextTokens: { zh: '默认上下文额度', en: 'Default Context Tokens' },
+  defaultContextTokensHelp: { zh: '当智能体未设置单独值时使用该上下文预算。', en: 'Input context budget for agents when no per-agent override is set.' },
   runtimeCompanionEnabled: { zh: '桌宠 Companion', en: 'Companion' },
   runtimeCompanionEnabledHelp: { zh: '开启后会自动拉起悬浮 Companion；关闭后会立即停止，并在下次启动时保持关闭。', en: 'When enabled, NextClaw auto-starts the floating companion. When disabled, it stops immediately and stays off after restart.' },
-  defaultEngine: { zh: '默认 Runtime', en: 'Default Runtime' },
-  defaultEngineHelp: { zh: '默认使用的 Agent Runtime，例如 native、codex 或 claude。', en: 'Default agent runtime, for example native, codex, or claude.' },
-  agentList: { zh: 'Agent 列表', en: 'Agent List' },
-  agentListHelp: { zh: '在同一个网关进程中运行多个固定角色 Agent。', en: 'Run multiple fixed-role agents in one gateway process.' },
+  defaultEngine: { zh: '默认运行时', en: 'Default Runtime' },
+  defaultEngineHelp: { zh: '默认使用的智能体运行时，例如 native、codex 或 claude。', en: 'Default agent runtime, for example native, codex, or claude.' },
+  agentList: { zh: '智能体列表', en: 'Agent List' },
+  agentListHelp: { zh: '在同一个网关进程中运行多个固定角色智能体。', en: 'Run multiple fixed-role agents in one gateway process.' },
   bindings: { zh: '绑定规则', en: 'Bindings' },
-  bindingsHelp: { zh: '根据渠道 + 账号 + 对端将入站消息路由到目标 Agent。', en: 'Route inbound message by channel + account + peer to target agent.' },
+  bindingsHelp: { zh: '根据渠道 + 账号 + 对端将入站消息路由到目标智能体。', en: 'Route inbound message by channel + account + peer to target agent.' },
   agentIdRequiredError: { zh: 'agents.list[{index}].id 必填', en: 'agents.list[{index}].id is required' },
-  duplicateAgentId: { zh: '重复的 agent id', en: 'Duplicate agent id' },
+  duplicateAgentId: { zh: '重复的智能体 ID', en: 'Duplicate agent id' },
   bindingAgentIdRequired: { zh: 'bindings[{index}].agentId 必填', en: 'bindings[{index}].agentId is required' },
   bindingAgentIdNotFound: { zh: 'bindings[{index}].agentId 未在 agents.list/main 中找到', en: "bindings[{index}].agentId not found in agents.list/main" },
   bindingChannelRequired: { zh: 'bindings[{index}].match.channel 必填', en: 'bindings[{index}].match.channel is required' },
   bindingPeerIdRequired: { zh: '设置 peer.kind 时，bindings[{index}].match.peer.id 必填', en: 'bindings[{index}].match.peer.id is required when peer.kind is set' },
-  agentIdPlaceholder: { zh: 'Agent ID（例如 engineer）', en: 'Agent ID (e.g. engineer)' },
+  agentIdPlaceholder: { zh: '智能体 ID（例如 engineer）', en: 'Agent ID (e.g. engineer)' },
   workspaceOverridePlaceholder: { zh: '工作空间覆盖（可选）', en: 'Workspace override (optional)' },
   modelOverridePlaceholder: { zh: '模型覆盖（可选）', en: 'Model override (optional)' },
-  defaultEnginePlaceholder: { zh: '默认 Runtime（如 native 或 codex）', en: 'Default runtime (e.g. native or codex)' },
-  engineOverridePlaceholder: { zh: 'Runtime 覆盖（可选）', en: 'Runtime override (optional)' },
-  contextTokensPlaceholder: { zh: '上下文 tokens', en: 'Context tokens' },
+  defaultEnginePlaceholder: { zh: '默认运行时（如 native 或 codex）', en: 'Default runtime (e.g. native or codex)' },
+  engineOverridePlaceholder: { zh: '运行时覆盖（可选）', en: 'Runtime override (optional)' },
+  contextTokensPlaceholder: { zh: '上下文额度', en: 'Context tokens' },
   maxToolsPlaceholder: { zh: '最大工具次数', en: 'Max tools' },
-  defaultAgent: { zh: '默认 Agent', en: 'Default agent' },
-  addAgent: { zh: '添加 Agent', en: 'Add Agent' },
-  targetAgentIdPlaceholder: { zh: '目标 Agent ID', en: 'Target agent ID' },
+  defaultAgent: { zh: '默认智能体', en: 'Default agent' },
+  addAgent: { zh: '添加智能体', en: 'Add Agent' },
+  targetAgentIdPlaceholder: { zh: '目标智能体 ID', en: 'Target agent ID' },
   channelPlaceholder: { zh: '渠道（例如 discord）', en: 'Channel (e.g. discord)' },
   accountIdOptionalPlaceholder: { zh: '账号 ID（可选）', en: 'Account ID (optional)' },
   peerKindOptional: { zh: '对端类型（可选）', en: 'Peer kind (optional)' },
@@ -415,51 +415,12 @@ export const LABELS: Record<string, { zh: string; en: string }> = {
   secretProviderAlias: { zh: 'Provider 别名', en: 'Provider Alias' },
   addSecretRef: { zh: '添加 Ref', en: 'Add Ref' },
 
-  // Sessions
-  sessionsPageTitle: { zh: '会话管理', en: 'Sessions' },
-  sessionsPageDescription: {
-    zh: '管理会话：筛选、按渠道分组、查看历史、改标签/偏好模型、清空和删除。',
-    en: 'Manage sessions: filter, group by channel, inspect history, edit metadata, clear, and delete.'
-  },
-  sessionsFiltersTitle: { zh: '筛选', en: 'Filters' },
-  sessionsFiltersDescription: { zh: '按关键词、活跃窗口和分组方式筛选会话。', en: 'Filter sessions by query, activity window, and grouping mode.' },
-  sessionsSearchPlaceholder: { zh: '搜索 key 或标签', en: 'Search session key or label' },
-  sessionsActiveMinutesPlaceholder: { zh: '活跃分钟（0=不限）', en: 'Active minutes (0 = no limit)' },
-  sessionsLimitPlaceholder: { zh: '展示上限', en: 'Limit' },
-  sessionsGroupModeLabel: { zh: '分组方式', en: 'Grouping' },
-  sessionsGroupModeAll: { zh: '不分组 / 全部', en: 'All (No grouping)' },
-  sessionsGroupModeByChannel: { zh: '按渠道分组', en: 'Group by channel' },
-  sessionsListTitle: { zh: '会话列表', en: 'Session list' },
-  sessionsTotalLabel: { zh: '总数', en: 'Total' },
-  sessionsCurrentLabel: { zh: '当前展示', en: 'Showing' },
+  // Session labels shared by the main chat workspace.
   sessionsLoading: { zh: '加载会话中...', en: 'Loading sessions...' },
   sessionsEmpty: { zh: '暂无会话。', en: 'No sessions yet.' },
-  sessionsKeyLabel: { zh: '键', en: 'Key' },
-  sessionsChannelLabel: { zh: '渠道', en: 'Channel' },
-  sessionsMessagesLabel: { zh: '消息数', en: 'Messages' },
-  sessionsUpdatedLabel: { zh: '更新时间', en: 'Updated' },
-  sessionsLastRoleLabel: { zh: '最后角色', en: 'Last Role' },
   sessionsLabelPlaceholder: { zh: '会话标签（可选）', en: 'Session label (optional)' },
-  sessionsModelPlaceholder: { zh: '偏好模型（可选）', en: 'Preferred model (optional)' },
-  sessionsShowHistory: { zh: '查看历史', en: 'View history' },
-  sessionsHideHistory: { zh: '隐藏历史', en: 'Hide history' },
-  sessionsSaveMeta: { zh: '保存元信息', en: 'Save metadata' },
-  sessionsClearHistory: { zh: '清空历史', en: 'Clear history' },
-  sessionsDeleteConfirm: { zh: '确认删除会话', en: 'Delete session' },
-  sessionsHistoryTitle: { zh: '历史', en: 'History' },
-  sessionsHistoryDescription: { zh: '最近 200 条消息（展示窗口）。', en: 'Latest 200 messages (display window).' },
-  sessionsHistoryLoading: { zh: '加载历史中...', en: 'Loading history...' },
-  sessionsApplyingChanges: { zh: '正在应用会话变更...', en: 'Applying session changes...' },
-  sessionsUnknownChannel: { zh: '未知渠道', en: 'Unknown channel' },
-  sessionsAllChannels: { zh: '全部渠道', en: 'All Channels' },
   sessionsRunStatusRunning: { zh: '运行中', en: 'Running' },
   sessionsRunStatusQueued: { zh: '排队中', en: 'Queued' },
-  sessionsMetadata: { zh: '元信息', en: 'Metadata' },
-  sessionsNoSelectionTitle: { zh: '未选择会话', en: 'No Session Selected' },
-  sessionsNoSelectionDescription: {
-    zh: '从左侧列表选择一个会话以查看聊天历史并配置其元信息。',
-    en: 'Select a session from the list on the left to view its chat history and configure its metadata.'
-  },
   // Chat
   ...AGENT_LABELS,
   ...CHAT_LABELS,

package/src/shared/lib/i18n/{runtime-control.ts → runtime-control-labels.utils.ts}

@@ -1,9 +1,27 @@
 export const RUNTIME_CONTROL_LABELS: Record<string, { zh: string; en: string }> = {
   runtimePageTitle: { zh: '路由与运行时', en: 'Routing & Runtime' },
   runtimePageDescription: {
-    zh: '对齐 OpenClaw 的多 Agent 路由：绑定规则、Agent 池、私聊范围。',
+    zh: '对齐 OpenClaw 的多智能体路由：绑定规则、智能体池、私聊范围。',
     en: 'Align multi-agent routing with OpenClaw: bindings, agent pool, and DM scope.'
   },
+  dmScopeMain: { zh: '统一到主会话', en: 'Main session' },
+  dmScopePerPeer: { zh: '按对端隔离', en: 'Per peer' },
+  dmScopePerChannelPeer: { zh: '按渠道和对端隔离', en: 'Per channel and peer' },
+  dmScopePerAccountChannelPeer: { zh: '按账号、渠道和对端隔离', en: 'Per account, channel, and peer' },
+  runtimeEntries: { zh: '运行时入口', en: 'Runtime Entries' },
+  runtimeEntriesHelp: { zh: '统一管理可见的运行时入口与其配置。', en: 'Manage visible runtime entries and their configuration in one place.' },
+  runtimeEntryIdPlaceholder: { zh: '入口 ID，例如 hermes', en: 'Entry ID, for example hermes' },
+  runtimeEntryLabelPlaceholder: { zh: '展示名称，例如 Hermes', en: 'Display name, for example Hermes' },
+  runtimeEntryTypePlaceholder: { zh: '运行时类型，例如 narp-stdio', en: 'Runtime type, for example narp-stdio' },
+  runtimeEntryConfigJson: { zh: '配置 JSON', en: 'Config JSON' },
+  addRuntimeEntry: { zh: '添加运行时入口', en: 'Add Runtime Entry' },
+  runtimeEntryIdRequired: { zh: '运行时入口 ID 必填，位置：{index}', en: 'Runtime entry id is required at index {index}.' },
+  runtimeEntryTypeRequired: { zh: '运行时入口 "{id}" 的类型必填', en: 'Runtime entry type is required for "{id}".' },
+  runtimeEntryDuplicate: { zh: '重复的运行时入口 ID', en: 'Duplicate runtime entry id' },
+  runtimeEntryConfigObjectRequired: { zh: '运行时入口 "{id}" 的配置必须是 JSON 对象。', en: 'Runtime entry config for "{id}" must be a JSON object.' },
+  peerKindDirect: { zh: '私聊', en: 'Direct' },
+  peerKindGroup: { zh: '群组', en: 'Group' },
+  peerKindChannel: { zh: '频道', en: 'Channel' },
   runtimeLoading: { zh: '加载运行时配置中...', en: 'Loading runtime settings...' },
   runtimeControlTitle: { zh: '服务管理', en: 'Service Management' },
   runtimeControlDescription: {
@@ -53,6 +71,17 @@ export const RUNTIME_CONTROL_LABELS: Record<string, { zh: string; en: string }>
   },
   runtimeControlLoading: { zh: '读取运行时控制能力中...', en: 'Loading runtime control capabilities...' },
   runtimeControlLoadFailed: { zh: '读取运行时控制状态失败', en: 'Failed to load runtime control state' },
+  runtimeControlManagedLocalMessage: { zh: '使用此页面管理本地 NextClaw 服务。关闭浏览器不会停止服务。', en: 'Use this page to manage the local NextClaw service. Closing the browser does not stop the service.' },
+  runtimeControlManagedLocalHint: { zh: '此页面由正在运行的本地服务提供。关闭浏览器不会停止它。', en: 'This page is served by the running local service. Closing the browser does not stop it.' },
+  runtimeControlManagedLocalHintShort: { zh: '此页面由正在运行的本地服务提供。', en: 'This page is served by the running local service.' },
+  runtimeControlStartUnavailableHosted: { zh: '当前页面已经由运行中的本地服务托管。', en: 'This page is already hosted by the running local service.' },
+  runtimeControlRestartAppDesktopOnly: { zh: '只有桌面壳环境支持重启整个应用。', en: 'App restart is only available in the desktop shell.' },
+  runtimeControlServiceNotRunning: { zh: '本地服务未运行。', en: 'The local service is not running.' },
+  runtimeControlServiceAlreadyStopped: { zh: '本地服务已经停止。', en: 'The local service is already stopped.' },
+  runtimeControlManagedServiceStarted: { zh: '本地服务已启动。', en: 'Managed service started.' },
+  runtimeControlManagedServiceStartScheduled: { zh: '本地服务启动已安排。', en: 'Managed service start scheduled.' },
+  runtimeControlRestartScheduled: { zh: '重启已安排。此页面可能会短暂断开。', en: 'Restart scheduled. This page may disconnect for a few seconds.' },
+  runtimeControlStopScheduled: { zh: '停止已安排。此页面即将断开。', en: 'Stop scheduled. This page will disconnect shortly.' },
   runtimeControlServiceRunning: { zh: '服务运行中', en: 'Service running' },
   runtimeControlServiceStopped: { zh: '服务已停止', en: 'Service stopped' },
   runtimeControlServiceStarting: { zh: '正在启动服务', en: 'Starting service' },

package/src/shared/lib/provider-models/index.test.ts

@@ -0,0 +1,39 @@
+import { describe, expect, it } from 'vitest';
+import { buildProviderModelCatalog } from './index';
+
+describe('buildProviderModelCatalog', () => {
+  it('does not resurrect an OpenRouter model removed from config models', () => {
+    const catalog = buildProviderModelCatalog({
+      onlyConfigured: true,
+      meta: {
+        providers: [
+          {
+            name: 'openrouter',
+            displayName: 'OpenRouter',
+            modelPrefix: 'openrouter',
+            defaultModels: [
+              'openrouter/deepseek/deepseek-v3.2',
+              'openrouter/openai/gpt-5.3-codex'
+            ],
+            keywords: [],
+            envKey: 'OPENROUTER_API_KEY'
+          }
+        ],
+        search: [],
+        channels: []
+      },
+      config: {
+        providers: {
+          openrouter: {
+            enabled: true,
+            apiKeySet: true,
+            models: ['openai/gpt-5.3-codex']
+          }
+        }
+      } as never
+    });
+
+    expect(catalog).toHaveLength(1);
+    expect(catalog[0]?.models).toEqual(['openai/gpt-5.3-codex']);
+  });
+});

package/src/shared/lib/provider-models/index.ts

@@ -189,11 +189,9 @@ export function buildProviderModelCatalog(params: {
     const providerConfig = config?.providers?.[spec.name];
     const prefix = (spec.modelPrefix || spec.name || '').trim();
     const aliases = normalizeStringList([spec.modelPrefix || '', spec.name || '']);
-    const defaultModels = normalizeStringList((spec.defaultModels ?? []).map((model) => toProviderLocalModel(model, aliases)));
-    const customModels = normalizeStringList(
+    const models = normalizeStringList(
       (providerConfig?.models ?? []).map((model) => toProviderLocalModel(model, aliases))
     );
-    const models = normalizeStringList([...defaultModels, ...customModels]);
     const modelThinking = normalizeModelThinkingMap(providerConfig?.modelThinking, aliases);
     const configDisplayName = providerConfig?.displayName?.trim();
     const configured = isProviderConfigured(providerConfig);

package/src/shared/lib/ui-document-title/index.ts

@@ -19,7 +19,6 @@ const ROUTE_TITLE_KEYS: Array<{ prefix: string; key: string }> = [
   { prefix: '/updates', key: 'runtimeUpdatesPageTitle' },
   { prefix: '/remote', key: 'remotePageTitle' },
   { prefix: '/security', key: 'authSecurityTitle' },
-  { prefix: '/sessions', key: 'sessionsPageTitle' },
   { prefix: '/secrets', key: 'secretsPageTitle' }
 ];
 

package/tsconfig.json

@@ -34,6 +34,7 @@
       "@/*": ["./src/*"],
       "@nextclaw/agent-chat": ["../nextclaw-agent-chat/src/index.ts"],
       "@nextclaw/agent-chat-ui": ["../nextclaw-agent-chat-ui/src/index.ts"],
+      "@agent-chat-ui/*": ["../nextclaw-agent-chat-ui/src/*"],
       "@nextclaw/client-sdk": ["../nextclaw-client-sdk/src/index.ts"],
       "@nextclaw/shared": ["../nextclaw-shared/src/index.ts"],
       "@nextclaw/ncp": ["../ncp-packages/nextclaw-ncp/src/index.ts"],