@nextclaw/server 0.9.4 → 0.9.5

package/dist/index.d.ts

@@ -5,6 +5,284 @@ import { NcpHttpAgentStreamProvider } from '@nextclaw/ncp-http-agent-server';
 import { Hono } from 'hono';
 import { IncomingMessage } from 'node:http';
 
+type MarketplaceItemType = "plugin" | "skill" | "mcp";
+type MarketplaceSort = "relevance" | "updated";
+type MarketplacePluginInstallKind = "npm";
+type MarketplaceSkillInstallKind = "builtin" | "marketplace";
+type MarketplaceMcpInstallKind = "template";
+type MarketplaceInstallKind = MarketplacePluginInstallKind | MarketplaceSkillInstallKind | MarketplaceMcpInstallKind;
+type MarketplaceInstallSpec = {
+    kind: MarketplaceInstallKind;
+    spec: string;
+    command: string;
+};
+type MarketplaceMcpTemplateInput = {
+    id: string;
+    label: string;
+    description?: string;
+    required?: boolean;
+    secret?: boolean;
+    defaultValue?: string;
+};
+type MarketplaceMcpInstallSpec = MarketplaceInstallSpec & {
+    kind: "template";
+    defaultName: string;
+    transportTypes: Array<"stdio" | "http" | "sse">;
+    template: Record<string, unknown>;
+    inputs: MarketplaceMcpTemplateInput[];
+};
+type MarketplaceLocalizedTextMap = Record<string, string>;
+type MarketplaceItemSummary = {
+    id: string;
+    slug: string;
+    type: MarketplaceItemType;
+    name: string;
+    summary: string;
+    summaryI18n: MarketplaceLocalizedTextMap;
+    tags: string[];
+    author: string;
+    install: MarketplaceInstallSpec;
+    updatedAt: string;
+};
+type MarketplaceItemView = MarketplaceItemSummary & {
+    description?: string;
+    descriptionI18n?: MarketplaceLocalizedTextMap;
+    sourceRepo?: string;
+    homepage?: string;
+    publishedAt: string;
+};
+type MarketplaceSkillContentView = {
+    type: "skill";
+    slug: string;
+    name: string;
+    install: MarketplaceInstallSpec;
+    source: "builtin" | "marketplace" | "remote";
+    raw: string;
+    metadataRaw?: string;
+    bodyRaw: string;
+    sourceUrl?: string;
+};
+type MarketplacePluginContentView = {
+    type: "plugin";
+    slug: string;
+    name: string;
+    install: MarketplaceInstallSpec;
+    source: "npm" | "repo" | "remote";
+    raw?: string;
+    bodyRaw?: string;
+    metadataRaw?: string;
+    sourceUrl?: string;
+};
+type MarketplaceMcpContentView = {
+    type: "mcp";
+    slug: string;
+    name: string;
+    install: MarketplaceMcpInstallSpec;
+    source: "marketplace" | "remote";
+    raw: string;
+    metadataRaw?: string;
+    bodyRaw: string;
+    sourceUrl?: string;
+};
+type MarketplaceListView = {
+    total: number;
+    page: number;
+    pageSize: number;
+    totalPages: number;
+    sort: MarketplaceSort;
+    query?: string;
+    items: MarketplaceItemSummary[];
+};
+type MarketplaceRecommendationView = {
+    type: MarketplaceItemType;
+    sceneId: string;
+    title: string;
+    description?: string;
+    total: number;
+    items: MarketplaceItemSummary[];
+};
+type MarketplaceInstalledRecord = {
+    type: MarketplaceItemType;
+    id?: string;
+    spec: string;
+    label?: string;
+    description?: string;
+    descriptionZh?: string;
+    source?: string;
+    installedAt?: string;
+    enabled?: boolean;
+    runtimeStatus?: string;
+    origin?: string;
+    installPath?: string;
+    transport?: "stdio" | "http" | "sse";
+    scope?: {
+        allAgents: boolean;
+        agents: string[];
+    };
+    catalogSlug?: string;
+    vendor?: string;
+    docsUrl?: string;
+    homepage?: string;
+    trustLevel?: "official" | "verified" | "community";
+    toolCount?: number;
+    accessible?: boolean;
+    lastReadyAt?: string;
+    lastDoctorAt?: string;
+    lastError?: string;
+};
+type MarketplaceInstalledView = {
+    type: MarketplaceItemType;
+    total: number;
+    specs: string[];
+    records: MarketplaceInstalledRecord[];
+};
+type MarketplaceInstallSkillParams = {
+    slug: string;
+    kind?: MarketplaceSkillInstallKind;
+    skill?: string;
+    installPath?: string;
+    force?: boolean;
+};
+type MarketplacePluginInstallRequest = {
+    type?: "plugin";
+    spec: string;
+};
+type MarketplaceSkillInstallRequest = {
+    type?: "skill";
+    spec: string;
+    kind?: MarketplaceSkillInstallKind;
+    skill?: string;
+    installPath?: string;
+    force?: boolean;
+};
+type MarketplaceMcpInstallRequest = {
+    type?: "mcp";
+    spec: string;
+    name?: string;
+    enabled?: boolean;
+    allAgents?: boolean;
+    agents?: string[];
+    inputs?: Record<string, string>;
+    template?: MarketplaceMcpInstallSpec;
+};
+type MarketplacePluginInstallResult = {
+    type: "plugin";
+    spec: string;
+    message: string;
+    output?: string;
+};
+type MarketplaceSkillInstallResult = {
+    type: "skill";
+    spec: string;
+    message: string;
+    output?: string;
+};
+type MarketplaceMcpInstallResult = {
+    type: "mcp";
+    spec: string;
+    name: string;
+    message: string;
+    output?: string;
+};
+type MarketplacePluginManageAction = "enable" | "disable" | "uninstall";
+type MarketplaceSkillManageAction = "uninstall";
+type MarketplaceMcpManageAction = "enable" | "disable" | "remove";
+type MarketplacePluginManageRequest = {
+    type?: "plugin";
+    action: MarketplacePluginManageAction;
+    id?: string;
+    spec?: string;
+};
+type MarketplaceSkillManageRequest = {
+    type?: "skill";
+    action: MarketplaceSkillManageAction;
+    id?: string;
+    spec?: string;
+};
+type MarketplaceMcpManageRequest = {
+    type?: "mcp";
+    action: MarketplaceMcpManageAction;
+    id?: string;
+    spec?: string;
+};
+type MarketplacePluginManageResult = {
+    type: "plugin";
+    action: MarketplacePluginManageAction;
+    id: string;
+    message: string;
+    output?: string;
+};
+type MarketplaceSkillManageResult = {
+    type: "skill";
+    action: MarketplaceSkillManageAction;
+    id: string;
+    message: string;
+    output?: string;
+};
+type MarketplaceMcpManageResult = {
+    type: "mcp";
+    action: MarketplaceMcpManageAction;
+    id: string;
+    message: string;
+    output?: string;
+};
+type MarketplaceMcpDoctorResult = {
+    name: string;
+    enabled: boolean;
+    transport: "stdio" | "http" | "sse";
+    accessible: boolean;
+    toolCount: number;
+    error?: string;
+};
+type MarketplaceInstaller = {
+    installPlugin?: (spec: string) => Promise<{
+        message: string;
+        output?: string;
+    }>;
+    installSkill?: (params: MarketplaceInstallSkillParams) => Promise<{
+        message: string;
+        output?: string;
+    }>;
+    enablePlugin?: (id: string) => Promise<{
+        message: string;
+        output?: string;
+    }>;
+    disablePlugin?: (id: string) => Promise<{
+        message: string;
+        output?: string;
+    }>;
+    uninstallPlugin?: (id: string) => Promise<{
+        message: string;
+        output?: string;
+    }>;
+    uninstallSkill?: (slug: string) => Promise<{
+        message: string;
+        output?: string;
+    }>;
+    installMcp?: (params: MarketplaceMcpInstallRequest) => Promise<{
+        name: string;
+        message: string;
+        output?: string;
+    }>;
+    enableMcp?: (name: string) => Promise<{
+        message: string;
+        output?: string;
+    }>;
+    disableMcp?: (name: string) => Promise<{
+        message: string;
+        output?: string;
+    }>;
+    removeMcp?: (name: string) => Promise<{
+        message: string;
+        output?: string;
+    }>;
+    doctorMcp?: (name: string) => Promise<MarketplaceMcpDoctorResult>;
+};
+type MarketplaceApiConfig = {
+    apiBaseUrl?: string;
+    installer?: MarketplaceInstaller;
+};
+
 type ApiError = {
     code: string;
     message: string;
@@ -190,6 +468,7 @@ type SessionEntryView = {
     updatedAt: string;
     label?: string;
     preferredModel?: string;
+    preferredThinking?: ThinkingLevel | null;
     sessionType: string;
     sessionTypeMutable: boolean;
     messageCount: number;
@@ -634,184 +913,6 @@ type ConfigActionExecuteResult = {
     patch?: Record<string, unknown>;
     nextActions?: string[];
 };
-type MarketplaceItemType = "plugin" | "skill";
-type MarketplaceSort = "relevance" | "updated";
-type MarketplacePluginInstallKind = "npm";
-type MarketplaceSkillInstallKind = "builtin" | "marketplace";
-type MarketplaceInstallKind = MarketplacePluginInstallKind | MarketplaceSkillInstallKind;
-type MarketplaceInstallSpec = {
-    kind: MarketplaceInstallKind;
-    spec: string;
-    command: string;
-};
-type MarketplaceLocalizedTextMap = Record<string, string>;
-type MarketplaceItemSummary = {
-    id: string;
-    slug: string;
-    type: MarketplaceItemType;
-    name: string;
-    summary: string;
-    summaryI18n: MarketplaceLocalizedTextMap;
-    tags: string[];
-    author: string;
-    install: MarketplaceInstallSpec;
-    updatedAt: string;
-};
-type MarketplaceItemView = MarketplaceItemSummary & {
-    description?: string;
-    descriptionI18n?: MarketplaceLocalizedTextMap;
-    sourceRepo?: string;
-    homepage?: string;
-    publishedAt: string;
-};
-type MarketplaceSkillContentView = {
-    type: "skill";
-    slug: string;
-    name: string;
-    install: MarketplaceInstallSpec;
-    source: "builtin" | "marketplace" | "remote";
-    raw: string;
-    metadataRaw?: string;
-    bodyRaw: string;
-    sourceUrl?: string;
-};
-type MarketplacePluginContentView = {
-    type: "plugin";
-    slug: string;
-    name: string;
-    install: MarketplaceInstallSpec;
-    source: "npm" | "repo" | "remote";
-    raw?: string;
-    bodyRaw?: string;
-    metadataRaw?: string;
-    sourceUrl?: string;
-};
-type MarketplaceListView = {
-    total: number;
-    page: number;
-    pageSize: number;
-    totalPages: number;
-    sort: MarketplaceSort;
-    query?: string;
-    items: MarketplaceItemSummary[];
-};
-type MarketplaceRecommendationView = {
-    type: MarketplaceItemType;
-    sceneId: string;
-    title: string;
-    description?: string;
-    total: number;
-    items: MarketplaceItemSummary[];
-};
-type MarketplaceInstalledRecord = {
-    type: MarketplaceItemType;
-    id?: string;
-    spec: string;
-    label?: string;
-    description?: string;
-    descriptionZh?: string;
-    source?: string;
-    installedAt?: string;
-    enabled?: boolean;
-    runtimeStatus?: string;
-    origin?: string;
-    installPath?: string;
-};
-type MarketplaceInstalledView = {
-    type: MarketplaceItemType;
-    total: number;
-    specs: string[];
-    records: MarketplaceInstalledRecord[];
-};
-type MarketplaceInstallSkillParams = {
-    slug: string;
-    kind?: MarketplaceSkillInstallKind;
-    skill?: string;
-    installPath?: string;
-    force?: boolean;
-};
-type MarketplacePluginInstallRequest = {
-    type?: "plugin";
-    spec: string;
-};
-type MarketplaceSkillInstallRequest = {
-    type?: "skill";
-    spec: string;
-    kind?: MarketplaceSkillInstallKind;
-    skill?: string;
-    installPath?: string;
-    force?: boolean;
-};
-type MarketplacePluginInstallResult = {
-    type: "plugin";
-    spec: string;
-    message: string;
-    output?: string;
-};
-type MarketplaceSkillInstallResult = {
-    type: "skill";
-    spec: string;
-    message: string;
-    output?: string;
-};
-type MarketplacePluginManageAction = "enable" | "disable" | "uninstall";
-type MarketplaceSkillManageAction = "uninstall";
-type MarketplacePluginManageRequest = {
-    type?: "plugin";
-    action: MarketplacePluginManageAction;
-    id?: string;
-    spec?: string;
-};
-type MarketplaceSkillManageRequest = {
-    type?: "skill";
-    action: MarketplaceSkillManageAction;
-    id?: string;
-    spec?: string;
-};
-type MarketplacePluginManageResult = {
-    type: "plugin";
-    action: MarketplacePluginManageAction;
-    id: string;
-    message: string;
-    output?: string;
-};
-type MarketplaceSkillManageResult = {
-    type: "skill";
-    action: MarketplaceSkillManageAction;
-    id: string;
-    message: string;
-    output?: string;
-};
-type MarketplaceInstaller = {
-    installPlugin?: (spec: string) => Promise<{
-        message: string;
-        output?: string;
-    }>;
-    installSkill?: (params: MarketplaceInstallSkillParams) => Promise<{
-        message: string;
-        output?: string;
-    }>;
-    enablePlugin?: (id: string) => Promise<{
-        message: string;
-        output?: string;
-    }>;
-    disablePlugin?: (id: string) => Promise<{
-        message: string;
-        output?: string;
-    }>;
-    uninstallPlugin?: (id: string) => Promise<{
-        message: string;
-        output?: string;
-    }>;
-    uninstallSkill?: (slug: string) => Promise<{
-        message: string;
-        output?: string;
-    }>;
-};
-type MarketplaceApiConfig = {
-    apiBaseUrl?: string;
-    installer?: MarketplaceInstaller;
-};
 type UiServerEvent = {
     type: "config.updated";
     payload: {
@@ -956,4 +1057,4 @@ declare function deleteSession(configPath: string, key: string): boolean;
 declare function updateRuntime(configPath: string, patch: RuntimeConfigUpdate): Pick<ConfigView, "agents" | "bindings" | "session">;
 declare function updateSecrets(configPath: string, patch: SecretsConfigUpdate): SecretsView;
 
-export { type AgentBindingView, type AgentProfileView, type ApiError, type ApiResponse, type AppMetaView, type AuthEnabledUpdateRequest, type AuthLoginRequest, type AuthPasswordUpdateRequest, type AuthSetupRequest, type AuthStatusView, type BindingPeerView, type BochaFreshnessValue, type ChannelSpecView, type ChatCapabilitiesView, type ChatCommandOptionView, type ChatCommandView, type ChatCommandsView, type ChatRunListView, type ChatRunState, type ChatRunView, type ChatSessionTypeOptionView, type ChatSessionTypesView, type ChatTurnRequest, type ChatTurnResult, type ChatTurnStopRequest, type ChatTurnStopResult, type ChatTurnStreamEvent, type ChatTurnView, type ConfigActionExecuteRequest, type ConfigActionExecuteResult, type ConfigActionManifest, type ConfigActionType, type ConfigMetaView, type ConfigSchemaResponse, type ConfigUiHint, type ConfigUiHints, type ConfigView, type CronActionResult, type CronEnableRequest, type CronJobStateView, type CronJobView, type CronListView, type CronPayloadView, type CronRunRequest, type CronScheduleView, DEFAULT_SESSION_TYPE, type MarketplaceApiConfig, type MarketplaceInstallKind, type MarketplaceInstallSkillParams, type MarketplaceInstallSpec, type MarketplaceInstalledRecord, type MarketplaceInstalledView, type MarketplaceInstaller, type MarketplaceItemSummary, type MarketplaceItemType, type MarketplaceItemView, type MarketplaceListView, type MarketplaceLocalizedTextMap, type MarketplacePluginContentView, type MarketplacePluginInstallKind, type MarketplacePluginInstallRequest, type MarketplacePluginInstallResult, type MarketplacePluginManageAction, type MarketplacePluginManageRequest, type MarketplacePluginManageResult, type MarketplaceRecommendationView, type MarketplaceSkillContentView, type MarketplaceSkillInstallKind, type MarketplaceSkillInstallRequest, type MarketplaceSkillInstallResult, type MarketplaceSkillManageAction, type MarketplaceSkillManageRequest, type MarketplaceSkillManageResult, type MarketplaceSort, type ProviderAuthImportResult, type ProviderAuthPollRequest, type ProviderAuthPollResult, type ProviderAuthStartRequest, type ProviderAuthStartResult, type ProviderConfigUpdate, type ProviderConfigView, type ProviderConnectionTestRequest, type ProviderConnectionTestResult, type ProviderCreateRequest, type ProviderCreateResult, type ProviderDeleteResult, type ProviderSpecView, type RuntimeConfigUpdate, type SearchConfigUpdate, type SearchConfigView, type SearchProviderConfigView, type SearchProviderName, type SearchProviderSpecView, type SecretProviderEnvView, type SecretProviderExecView, type SecretProviderFileView, type SecretProviderView, type SecretRefView, type SecretSourceView, type SecretsConfigUpdate, type SecretsView, type SessionConfigView, type SessionEntryView, type SessionEventView, type SessionHistoryView, type SessionMessageView, type SessionPatchUpdate, SessionPatchValidationError, type SessionsListView, type UiChatRuntime, type UiNcpAgent, type UiNcpSessionListView, type UiNcpSessionMessagesView, type UiServerEvent, type UiServerHandle, type UiServerOptions, buildConfigMeta, buildConfigSchemaView, buildConfigView, createCustomProvider, createUiRouter, deleteCustomProvider, deleteSession, executeConfigAction, getSessionHistory, listSessions, loadConfigOrDefault, patchSession, startUiServer, testProviderConnection, updateChannel, updateModel, updateProvider, updateRuntime, updateSearch, updateSecrets };
+export { type AgentBindingView, type AgentProfileView, type ApiError, type ApiResponse, type AppMetaView, type AuthEnabledUpdateRequest, type AuthLoginRequest, type AuthPasswordUpdateRequest, type AuthSetupRequest, type AuthStatusView, type BindingPeerView, type BochaFreshnessValue, type ChannelSpecView, type ChatCapabilitiesView, type ChatCommandOptionView, type ChatCommandView, type ChatCommandsView, type ChatRunListView, type ChatRunState, type ChatRunView, type ChatSessionTypeOptionView, type ChatSessionTypesView, type ChatTurnRequest, type ChatTurnResult, type ChatTurnStopRequest, type ChatTurnStopResult, type ChatTurnStreamEvent, type ChatTurnView, type ConfigActionExecuteRequest, type ConfigActionExecuteResult, type ConfigActionManifest, type ConfigActionType, type ConfigMetaView, type ConfigSchemaResponse, type ConfigUiHint, type ConfigUiHints, type ConfigView, type CronActionResult, type CronEnableRequest, type CronJobStateView, type CronJobView, type CronListView, type CronPayloadView, type CronRunRequest, type CronScheduleView, DEFAULT_SESSION_TYPE, type MarketplaceApiConfig, type MarketplaceInstallKind, type MarketplaceInstallSkillParams, type MarketplaceInstallSpec, type MarketplaceInstalledRecord, type MarketplaceInstalledView, type MarketplaceInstaller, type MarketplaceItemSummary, type MarketplaceItemType, type MarketplaceItemView, type MarketplaceListView, type MarketplaceLocalizedTextMap, type MarketplaceMcpContentView, type MarketplaceMcpDoctorResult, type MarketplaceMcpInstallKind, type MarketplaceMcpInstallRequest, type MarketplaceMcpInstallResult, type MarketplaceMcpInstallSpec, type MarketplaceMcpManageAction, type MarketplaceMcpManageRequest, type MarketplaceMcpManageResult, type MarketplaceMcpTemplateInput, type MarketplacePluginContentView, type MarketplacePluginInstallKind, type MarketplacePluginInstallRequest, type MarketplacePluginInstallResult, type MarketplacePluginManageAction, type MarketplacePluginManageRequest, type MarketplacePluginManageResult, type MarketplaceRecommendationView, type MarketplaceSkillContentView, type MarketplaceSkillInstallKind, type MarketplaceSkillInstallRequest, type MarketplaceSkillInstallResult, type MarketplaceSkillManageAction, type MarketplaceSkillManageRequest, type MarketplaceSkillManageResult, type MarketplaceSort, type ProviderAuthImportResult, type ProviderAuthPollRequest, type ProviderAuthPollResult, type ProviderAuthStartRequest, type ProviderAuthStartResult, type ProviderConfigUpdate, type ProviderConfigView, type ProviderConnectionTestRequest, type ProviderConnectionTestResult, type ProviderCreateRequest, type ProviderCreateResult, type ProviderDeleteResult, type ProviderSpecView, type RuntimeConfigUpdate, type SearchConfigUpdate, type SearchConfigView, type SearchProviderConfigView, type SearchProviderName, type SearchProviderSpecView, type SecretProviderEnvView, type SecretProviderExecView, type SecretProviderFileView, type SecretProviderView, type SecretRefView, type SecretSourceView, type SecretsConfigUpdate, type SecretsView, type SessionConfigView, type SessionEntryView, type SessionEventView, type SessionHistoryView, type SessionMessageView, type SessionPatchUpdate, SessionPatchValidationError, type SessionsListView, type UiChatRuntime, type UiNcpAgent, type UiNcpSessionListView, type UiNcpSessionMessagesView, type UiServerEvent, type UiServerHandle, type UiServerOptions, buildConfigMeta, buildConfigSchemaView, buildConfigView, createCustomProvider, createUiRouter, deleteCustomProvider, deleteSession, executeConfigAction, getSessionHistory, listSessions, loadConfigOrDefault, patchSession, startUiServer, testProviderConnection, updateChannel, updateModel, updateProvider, updateRuntime, updateSearch, updateSecrets };

package/dist/index.js

@@ -512,7 +512,7 @@ import {
   SessionManager,
   getWorkspacePathFromConfig,
   normalizeThinkingLevels,
-  parseThinkingLevel as parseThinkingLevel2
+  parseThinkingLevel as parseThinkingLevel3
 } from "@nextclaw/core";
 
 // src/ui/provider-overrides.ts
@@ -639,6 +639,18 @@ function applySessionPreferencePatch(params) {
   return nextMetadata;
 }
 
+// src/ui/session-list-metadata.ts
+import { parseThinkingLevel as parseThinkingLevel2 } from "@nextclaw/core";
+function readSessionListMetadata(metadata) {
+  const rawLabel = typeof metadata.label === "string" ? metadata.label.trim() : "";
+  const rawPreferredModel = typeof metadata.preferred_model === "string" ? metadata.preferred_model.trim() : "";
+  return {
+    label: rawLabel || void 0,
+    preferredModel: rawPreferredModel || void 0,
+    preferredThinking: parseThinkingLevel2(metadata.preferred_thinking) ?? null
+  };
+}
+
 // src/ui/config.ts
 var MASK_MIN_LENGTH = 8;
 var EXTRA_SENSITIVE_PATH_PATTERNS = [/authorization/i, /cookie/i, /session/i, /bearer/i];
@@ -991,7 +1003,7 @@ function normalizeModelThinkingConfig(input) {
     if (supported.length === 0) {
       continue;
     }
-    const defaultLevel = parseThinkingLevel2(rawValue.default);
+    const defaultLevel = parseThinkingLevel3(rawValue.default);
     if (defaultLevel && supported.includes(defaultLevel)) {
       normalized[model] = { supported, default: defaultLevel };
     } else {
@@ -1578,8 +1590,7 @@ function listSessions(configPath, query) {
     const messages = session?.messages ?? [];
     const lastMessage = messages.length > 0 ? messages[messages.length - 1] : null;
     const metadata = item.metadata && typeof item.metadata === "object" ? item.metadata : {};
-    const label = typeof metadata.label === "string" ? metadata.label.trim() : "";
-    const preferredModel = typeof metadata.preferred_model === "string" ? metadata.preferred_model.trim() : "";
+    const { label, preferredModel, preferredThinking } = readSessionListMetadata(metadata);
     const createdAt = typeof item.created_at === "string" ? item.created_at : (/* @__PURE__ */ new Date(0)).toISOString();
     const updatedAt = typeof item.updated_at === "string" ? item.updated_at : createdAt;
     const sessionType = readSessionType({
@@ -1594,8 +1605,9 @@ function listSessions(configPath, query) {
       key,
       createdAt,
       updatedAt,
-      label: label || void 0,
-      preferredModel: preferredModel || void 0,
+      label,
+      preferredModel,
+      preferredThinking,
       sessionType,
       sessionTypeMutable,
       messageCount: messages.length,
@@ -3708,6 +3720,13 @@ async function fetchAllSkillMarketplaceItems(params) {
     query: params.query
   });
 }
+async function fetchAllMcpMarketplaceItems(params) {
+  return fetchAllMarketplaceItems({
+    baseUrl: params.baseUrl,
+    path: "/api/v1/mcp/items",
+    query: params.query
+  });
+}
 function sanitizeMarketplaceListItems(items) {
   return items.map((item) => sanitizeMarketplaceItem(item));
 }
@@ -3715,6 +3734,216 @@ function sanitizeMarketplaceItemView(item) {
   return sanitizeMarketplaceItem(item);
 }
 
+// src/ui/router/marketplace/mcp.controller.ts
+import { McpInstalledViewService } from "@nextclaw/mcp";
+var McpMarketplaceController = class {
+  constructor(options, marketplaceBaseUrl) {
+    this.options = options;
+    this.marketplaceBaseUrl = marketplaceBaseUrl;
+  }
+  getInstalled = (c) => {
+    const service = new McpInstalledViewService({
+      getConfig: () => loadConfigOrDefault(this.options.configPath)
+    });
+    const records = service.listInstalled().map((record) => ({
+      type: "mcp",
+      id: record.name,
+      spec: record.catalogSlug ?? record.name,
+      label: record.displayName ?? record.name,
+      enabled: record.enabled,
+      runtimeStatus: record.enabled ? "enabled" : "disabled",
+      transport: record.transport,
+      scope: record.scope,
+      catalogSlug: record.catalogSlug,
+      vendor: record.vendor,
+      docsUrl: record.docsUrl,
+      homepage: record.homepage,
+      trustLevel: record.trustLevel,
+      source: record.source,
+      installedAt: record.installedAt,
+      toolCount: record.toolCount,
+      accessible: record.accessible,
+      lastReadyAt: record.lastReadyAt,
+      lastDoctorAt: record.lastReadyAt,
+      lastError: record.lastError
+    }));
+    return c.json(ok({
+      type: "mcp",
+      total: records.length,
+      specs: records.map((record) => record.spec),
+      records
+    }));
+  };
+  listItems = async (c) => {
+    const query = c.req.query();
+    const result = await fetchAllMcpMarketplaceItems({
+      baseUrl: this.marketplaceBaseUrl,
+      query: {
+        q: query.q,
+        tag: query.tag,
+        sort: query.sort,
+        page: query.page,
+        pageSize: query.pageSize
+      }
+    });
+    if (!result.ok) {
+      return c.json(err("MARKETPLACE_UNAVAILABLE", result.message), result.status);
+    }
+    const items = sanitizeMarketplaceListItems(result.data.items).map((item) => normalizeMarketplaceItemForUi(item));
+    const pageSize = Math.min(100, toPositiveInt(query.pageSize, 20));
+    const requestedPage = toPositiveInt(query.page, 1);
+    const totalPages = items.length === 0 ? 0 : Math.ceil(items.length / pageSize);
+    const currentPage = totalPages === 0 ? 1 : Math.min(requestedPage, totalPages);
+    return c.json(ok({
+      total: items.length,
+      page: currentPage,
+      pageSize,
+      totalPages,
+      sort: result.data.sort,
+      query: result.data.query,
+      items: items.slice((currentPage - 1) * pageSize, currentPage * pageSize)
+    }));
+  };
+  getItem = async (c) => {
+    const slug = encodeURIComponent(c.req.param("slug"));
+    const result = await fetchMarketplaceData({
+      baseUrl: this.marketplaceBaseUrl,
+      path: `/api/v1/mcp/items/${slug}`
+    });
+    if (!result.ok) {
+      return c.json(err("MARKETPLACE_UNAVAILABLE", result.message), result.status);
+    }
+    return c.json(ok(normalizeMarketplaceItemForUi(sanitizeMarketplaceItemView(result.data))));
+  };
+  getItemContent = async (c) => {
+    const slug = encodeURIComponent(c.req.param("slug"));
+    const result = await fetchMarketplaceData({
+      baseUrl: this.marketplaceBaseUrl,
+      path: `/api/v1/mcp/items/${slug}/content`
+    });
+    if (!result.ok) {
+      return c.json(err("MARKETPLACE_UNAVAILABLE", result.message), result.status);
+    }
+    return c.json(ok(result.data));
+  };
+  install = async (c) => {
+    const body = await readJson(c.req.raw);
+    if (!body.ok || !body.data || typeof body.data !== "object") {
+      return c.json(err("INVALID_BODY", "invalid json body"), 400);
+    }
+    if (body.data.type && body.data.type !== "mcp") {
+      return c.json(err("INVALID_BODY", "body.type does not match route type"), 400);
+    }
+    const slug = typeof body.data.spec === "string" ? body.data.spec.trim() : "";
+    if (!slug) {
+      return c.json(err("INVALID_BODY", "non-empty spec is required"), 400);
+    }
+    const installer = this.options.marketplace?.installer;
+    if (!installer?.installMcp) {
+      return c.json(err("NOT_AVAILABLE", "mcp installer is not configured"), 503);
+    }
+    const itemResult = await fetchMarketplaceData({
+      baseUrl: this.marketplaceBaseUrl,
+      path: `/api/v1/mcp/items/${encodeURIComponent(slug)}`
+    });
+    if (!itemResult.ok) {
+      return c.json(err("MARKETPLACE_UNAVAILABLE", itemResult.message), itemResult.status);
+    }
+    const template = itemResult.data.install;
+    if (template.kind !== "template") {
+      return c.json(err("MARKETPLACE_CONTRACT_MISMATCH", `unsupported mcp install kind: ${template.kind}`), 502);
+    }
+    try {
+      const result = await installer.installMcp({
+        ...body.data,
+        template
+      });
+      this.options.publish({ type: "config.updated", payload: { path: "mcp" } });
+      return c.json(ok({
+        type: "mcp",
+        spec: slug,
+        name: result.name,
+        message: result.message,
+        output: result.output
+      }));
+    } catch (error) {
+      return c.json(err("INSTALL_FAILED", error instanceof Error ? error.message : String(error)), 400);
+    }
+  };
+  manage = async (c) => {
+    const body = await readJson(c.req.raw);
+    if (!body.ok || !body.data || typeof body.data !== "object") {
+      return c.json(err("INVALID_BODY", "invalid json body"), 400);
+    }
+    if (body.data.type && body.data.type !== "mcp") {
+      return c.json(err("INVALID_BODY", "body.type does not match route type"), 400);
+    }
+    const target = typeof body.data.id === "string" && body.data.id.trim().length > 0 ? body.data.id.trim() : typeof body.data.spec === "string" && body.data.spec.trim().length > 0 ? body.data.spec.trim() : "";
+    if (!target) {
+      return c.json(err("INVALID_BODY", "non-empty id/spec is required"), 400);
+    }
+    const installer = this.options.marketplace?.installer;
+    if (!installer) {
+      return c.json(err("NOT_AVAILABLE", "marketplace installer is not configured"), 503);
+    }
+    try {
+      const action = body.data.action;
+      const result = action === "enable" ? await installer.enableMcp?.(target) : action === "disable" ? await installer.disableMcp?.(target) : await installer.removeMcp?.(target);
+      if (!result) {
+        return c.json(err("NOT_AVAILABLE", `mcp ${action} is not configured`), 503);
+      }
+      this.options.publish({ type: "config.updated", payload: { path: "mcp" } });
+      return c.json(ok({
+        type: "mcp",
+        action,
+        id: target,
+        message: result.message,
+        output: result.output
+      }));
+    } catch (error) {
+      return c.json(err("MANAGE_FAILED", error instanceof Error ? error.message : String(error)), 400);
+    }
+  };
+  doctor = async (c) => {
+    const body = await readJson(c.req.raw);
+    if (!body.ok || !body.data || typeof body.data !== "object") {
+      return c.json(err("INVALID_BODY", "invalid json body"), 400);
+    }
+    const target = typeof body.data.name === "string" && body.data.name.trim().length > 0 ? body.data.name.trim() : typeof body.data.id === "string" && body.data.id.trim().length > 0 ? body.data.id.trim() : typeof body.data.spec === "string" && body.data.spec.trim().length > 0 ? body.data.spec.trim() : "";
+    if (!target) {
+      return c.json(err("INVALID_BODY", "name/id/spec is required"), 400);
+    }
+    const installer = this.options.marketplace?.installer;
+    if (!installer?.doctorMcp) {
+      return c.json(err("NOT_AVAILABLE", "mcp doctor is not configured"), 503);
+    }
+    try {
+      const result = await installer.doctorMcp(target);
+      return c.json(ok(result));
+    } catch (error) {
+      return c.json(err("DOCTOR_FAILED", error instanceof Error ? error.message : String(error)), 400);
+    }
+  };
+  getRecommendations = async (c) => {
+    const query = c.req.query();
+    const result = await fetchMarketplaceData({
+      baseUrl: this.marketplaceBaseUrl,
+      path: "/api/v1/mcp/recommendations",
+      query: {
+        scene: query.scene,
+        limit: query.limit
+      }
+    });
+    if (!result.ok) {
+      return c.json(err("MARKETPLACE_UNAVAILABLE", result.message), result.status);
+    }
+    return c.json(ok({
+      ...result.data,
+      items: sanitizeMarketplaceListItems(result.data.items).map((item) => normalizeMarketplaceItemForUi(item))
+    }));
+  };
+};
+
 // src/ui/router/marketplace/installed.ts
 import * as NextclawCore3 from "@nextclaw/core";
 import { buildPluginStatusReport } from "@nextclaw/openclaw-compat";
@@ -4313,6 +4542,32 @@ var PluginMarketplaceController = class {
   };
 };
 
+// src/ui/router/marketplace/routes.ts
+function mountMarketplaceRoutes(app, controllers) {
+  app.get("/api/marketplace/plugins/installed", controllers.plugin.getInstalled);
+  app.get("/api/marketplace/plugins/items", controllers.plugin.listItems);
+  app.get("/api/marketplace/plugins/items/:slug", controllers.plugin.getItem);
+  app.get("/api/marketplace/plugins/items/:slug/content", controllers.plugin.getItemContent);
+  app.post("/api/marketplace/plugins/install", controllers.plugin.install);
+  app.post("/api/marketplace/plugins/manage", controllers.plugin.manage);
+  app.get("/api/marketplace/plugins/recommendations", controllers.plugin.getRecommendations);
+  app.get("/api/marketplace/skills/installed", controllers.skill.getInstalled);
+  app.get("/api/marketplace/skills/items", controllers.skill.listItems);
+  app.get("/api/marketplace/skills/items/:slug", controllers.skill.getItem);
+  app.get("/api/marketplace/skills/items/:slug/content", controllers.skill.getItemContent);
+  app.post("/api/marketplace/skills/install", controllers.skill.install);
+  app.post("/api/marketplace/skills/manage", controllers.skill.manage);
+  app.get("/api/marketplace/skills/recommendations", controllers.skill.getRecommendations);
+  app.get("/api/marketplace/mcp/installed", controllers.mcp.getInstalled);
+  app.get("/api/marketplace/mcp/items", controllers.mcp.listItems);
+  app.get("/api/marketplace/mcp/items/:slug", controllers.mcp.getItem);
+  app.get("/api/marketplace/mcp/items/:slug/content", controllers.mcp.getItemContent);
+  app.post("/api/marketplace/mcp/install", controllers.mcp.install);
+  app.post("/api/marketplace/mcp/manage", controllers.mcp.manage);
+  app.post("/api/marketplace/mcp/doctor", controllers.mcp.doctor);
+  app.get("/api/marketplace/mcp/recommendations", controllers.mcp.getRecommendations);
+}
+
 // src/ui/router/marketplace/skill.controller.ts
 async function installMarketplaceSkill(params) {
   const spec = typeof params.body.spec === "string" ? params.body.spec.trim() : "";
@@ -4620,6 +4875,7 @@ function createUiRouter(options) {
   const ncpSessionController = new NcpSessionRoutesController(options);
   const pluginMarketplaceController = new PluginMarketplaceController(options, marketplaceBaseUrl);
   const skillMarketplaceController = new SkillMarketplaceController(options, marketplaceBaseUrl);
+  const mcpMarketplaceController = new McpMarketplaceController(options, marketplaceBaseUrl);
   app.notFound((c) => c.json(err("NOT_FOUND", "endpoint not found"), 404));
   app.use("/api/*", async (c, next) => {
     const path = c.req.path;
@@ -4688,20 +4944,11 @@ function createUiRouter(options) {
   app.delete("/api/cron/:id", cronController.deleteJob);
   app.put("/api/cron/:id/enable", cronController.enableJob);
   app.post("/api/cron/:id/run", cronController.runJob);
-  app.get("/api/marketplace/plugins/installed", pluginMarketplaceController.getInstalled);
-  app.get("/api/marketplace/plugins/items", pluginMarketplaceController.listItems);
-  app.get("/api/marketplace/plugins/items/:slug", pluginMarketplaceController.getItem);
-  app.get("/api/marketplace/plugins/items/:slug/content", pluginMarketplaceController.getItemContent);
-  app.post("/api/marketplace/plugins/install", pluginMarketplaceController.install);
-  app.post("/api/marketplace/plugins/manage", pluginMarketplaceController.manage);
-  app.get("/api/marketplace/plugins/recommendations", pluginMarketplaceController.getRecommendations);
-  app.get("/api/marketplace/skills/installed", skillMarketplaceController.getInstalled);
-  app.get("/api/marketplace/skills/items", skillMarketplaceController.listItems);
-  app.get("/api/marketplace/skills/items/:slug", skillMarketplaceController.getItem);
-  app.get("/api/marketplace/skills/items/:slug/content", skillMarketplaceController.getItemContent);
-  app.post("/api/marketplace/skills/install", skillMarketplaceController.install);
-  app.post("/api/marketplace/skills/manage", skillMarketplaceController.manage);
-  app.get("/api/marketplace/skills/recommendations", skillMarketplaceController.getRecommendations);
+  mountMarketplaceRoutes(app, {
+    plugin: pluginMarketplaceController,
+    skill: skillMarketplaceController,
+    mcp: mcpMarketplaceController
+  });
   return app;
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nextclaw/server",
-  "version": "0.9.4",
+  "version": "0.9.5",
   "private": false,
   "description": "Nextclaw UI/API server.",
   "type": "module",
@@ -18,11 +18,12 @@
     "@hono/node-server": "^1.13.3",
     "hono": "^4.6.2",
     "ws": "^8.18.0",
+    "@nextclaw/mcp": "0.1.2",
+    "@nextclaw/ncp": "0.3.1",
     "@nextclaw/ncp-http-agent-server": "0.3.1",
-    "@nextclaw/runtime": "0.2.2",
     "@nextclaw/openclaw-compat": "0.3.5",
-    "@nextclaw/core": "0.9.2",
-    "@nextclaw/ncp": "0.3.1"
+    "@nextclaw/runtime": "0.2.2",
+    "@nextclaw/core": "0.9.2"
   },
   "devDependencies": {
     "@types/node": "^20.17.6",