@nextclaw/server 0.11.24 → 0.12.0

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 import * as NextclawCore from '@nextclaw/core';
 import { ThinkingLevel, CronService, Config, ConfigActionExecuteRequest as ConfigActionExecuteRequest$1, ConfigActionExecuteResult as ConfigActionExecuteResult$1 } from '@nextclaw/core';
 import { PluginChannelBinding, PluginUiMetadata } from '@nextclaw/openclaw-compat';
-import { NcpAgentClientEndpoint, NcpSessionSummary, NcpMessage, NcpSessionApi } from '@nextclaw/ncp';
+import { NcpAgentClientEndpoint, NcpSessionSummary, NcpSessionStatus, NcpMessage, NcpSessionApi } from '@nextclaw/ncp';
 import { NcpHttpAgentStreamProvider } from '@nextclaw/ncp-http-agent-server';
 import { IncomingMessage } from 'node:http';
 import { Hono } from 'hono';
@@ -351,6 +351,7 @@ type UiRouterOptions = {
     productVersion?: string;
     publish: (event: UiServerEvent) => void;
     applyLiveConfigReload?: () => Promise<void>;
+    initializeAgentHomeDirectory?: (homeDirectory: string) => void;
     marketplace?: MarketplaceApiConfig;
     cronService?: InstanceType<typeof NextclawCore.CronService>;
     ncpAgent?: UiNcpAgent;
@@ -687,12 +688,28 @@ type RemoteServiceActionResult = {
 type AgentProfileView = {
     id: string;
     default?: boolean;
+    displayName?: string;
+    description?: string;
+    avatar?: string;
+    avatarUrl?: string;
     workspace?: string;
     model?: string;
     engine?: string;
     engineConfig?: Record<string, unknown>;
     contextTokens?: number;
     maxToolIterations?: number;
+    builtIn?: boolean;
+};
+type AgentCreateRequest = {
+    id: string;
+    displayName?: string;
+    description?: string;
+    avatar?: string;
+    home?: string;
+};
+type AgentDeleteResult = {
+    deleted: boolean;
+    agentId: string;
 };
 type BindingPeerView = {
     kind: "direct" | "group" | "channel";
@@ -767,8 +784,8 @@ type SessionSkillEntryView = {
     ref: string;
     name: string;
     path: string;
-    scope: "project" | "workspace";
-    source: "project" | "workspace";
+    scope: "builtin" | "project" | "workspace";
+    source: "builtin" | "project" | "workspace";
     available: boolean;
     description?: string;
     descriptionZh?: string;
@@ -906,6 +923,7 @@ type UiNcpSessionListView = {
 };
 type UiNcpSessionMessagesView = {
     sessionId: string;
+    status: NcpSessionStatus;
     messages: NcpMessage[];
     total: number;
 };
@@ -1140,6 +1158,7 @@ type UiServerOptions = {
     productVersion?: string;
     corsOrigins?: string[] | "*";
     staticDir?: string;
+    initializeAgentHomeDirectory?: (homeDirectory: string) => void;
     marketplace?: MarketplaceApiConfig;
     cronService?: CronService;
     ncpAgent?: UiNcpAgent;
@@ -1217,4 +1236,4 @@ declare function getUiBridgeSecretPath(): string;
 declare function readUiBridgeSecret(): string | null;
 declare function ensureUiBridgeSecret(): string;
 
-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 BootstrapPhase, type BootstrapRemoteState, type BootstrapStageState, type BootstrapStatusView, type ChannelAuthPollRequest, type ChannelAuthPollResult, type ChannelAuthStartRequest, type ChannelAuthStartResult, type ChannelSpecView, type ChatSessionTypeCtaView, type ChatSessionTypeOptionView, type ChatSessionTypesView, 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 NcpSessionSkillsView, 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 RemoteAccessView, type RemoteAccountView, type RemoteBrowserAuthPollRequest, type RemoteBrowserAuthPollResult, type RemoteBrowserAuthStartRequest, type RemoteBrowserAuthStartResult, type RemoteDoctorCheckView, type RemoteDoctorView, type RemoteLoginRequest, type RemoteRuntimeView, type RemoteServiceAction, type RemoteServiceActionResult, type RemoteServiceView, type RemoteSettingsUpdateRequest, type RemoteSettingsView, 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 ServerPathBreadcrumbView, type ServerPathBrowseView, type ServerPathEntryView, type SessionConfigView, type SessionEntryView, type SessionEventView, type SessionHistoryView, type SessionMessageView, type SessionPatchUpdate, SessionPatchValidationError, type SessionSkillEntryView, type SessionTypeDescribeParams, type SessionsListView, type UiNcpAgent, type UiNcpAssetPutView, type UiNcpAssetView, type UiNcpSessionListView, type UiNcpSessionMessagesView, type UiNcpSessionService, type UiNcpStoredAssetRecord, type UiRemoteAccessHost, type UiServerEvent, type UiServerHandle, type UiServerOptions, buildConfigMeta, buildConfigSchemaView, buildConfigView, createCustomProvider, createUiRouter, deleteCustomProvider, deleteSession, ensureUiBridgeSecret, executeConfigAction, getSessionHistory, getUiBridgeSecretPath, listSessions, loadConfigOrDefault, patchSession, readUiBridgeSecret, startUiServer, testProviderConnection, updateChannel, updateModel, updateProvider, updateRuntime, updateSearch, updateSecrets };
+export { type AgentBindingView, type AgentCreateRequest, type AgentDeleteResult, type AgentProfileView, type ApiError, type ApiResponse, type AppMetaView, type AuthEnabledUpdateRequest, type AuthLoginRequest, type AuthPasswordUpdateRequest, type AuthSetupRequest, type AuthStatusView, type BindingPeerView, type BochaFreshnessValue, type BootstrapPhase, type BootstrapRemoteState, type BootstrapStageState, type BootstrapStatusView, type ChannelAuthPollRequest, type ChannelAuthPollResult, type ChannelAuthStartRequest, type ChannelAuthStartResult, type ChannelSpecView, type ChatSessionTypeCtaView, type ChatSessionTypeOptionView, type ChatSessionTypesView, 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 NcpSessionSkillsView, 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 RemoteAccessView, type RemoteAccountView, type RemoteBrowserAuthPollRequest, type RemoteBrowserAuthPollResult, type RemoteBrowserAuthStartRequest, type RemoteBrowserAuthStartResult, type RemoteDoctorCheckView, type RemoteDoctorView, type RemoteLoginRequest, type RemoteRuntimeView, type RemoteServiceAction, type RemoteServiceActionResult, type RemoteServiceView, type RemoteSettingsUpdateRequest, type RemoteSettingsView, 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 ServerPathBreadcrumbView, type ServerPathBrowseView, type ServerPathEntryView, type SessionConfigView, type SessionEntryView, type SessionEventView, type SessionHistoryView, type SessionMessageView, type SessionPatchUpdate, SessionPatchValidationError, type SessionSkillEntryView, type SessionTypeDescribeParams, type SessionsListView, type UiNcpAgent, type UiNcpAssetPutView, type UiNcpAssetView, type UiNcpSessionListView, type UiNcpSessionMessagesView, type UiNcpSessionService, type UiNcpStoredAssetRecord, type UiRemoteAccessHost, type UiServerEvent, type UiServerHandle, type UiServerOptions, buildConfigMeta, buildConfigSchemaView, buildConfigView, createCustomProvider, createUiRouter, deleteCustomProvider, deleteSession, ensureUiBridgeSecret, executeConfigAction, getSessionHistory, getUiBridgeSecretPath, listSessions, loadConfigOrDefault, patchSession, readUiBridgeSecret, startUiServer, testProviderConnection, updateChannel, updateModel, updateProvider, updateRuntime, updateSearch, updateSecrets };

package/dist/index.js

@@ -333,7 +333,86 @@ var UiAuthService = class {
 import { Hono } from "hono";
 import { mountNcpHttpAgentRoutes } from "@nextclaw/ncp-http-agent-server";
 
-// src/ui/router/response.ts
+// src/ui/agents.ts
+import {
+  createAgentProfile,
+  findEffectiveAgentProfile,
+  loadConfig as loadConfig2,
+  readAgentAvatarContent,
+  removeAgentProfile,
+  resolveEffectiveAgentProfiles
+} from "@nextclaw/core";
+function listAgents(configPath) {
+  const config = loadConfig2(configPath);
+  return resolveEffectiveAgentProfiles(config).map((profile) => toAgentProfileView(config, profile.id));
+}
+function createAgent(configPath, input, options = {}) {
+  const created = createAgentProfile(
+    {
+      id: input.id,
+      displayName: input.displayName,
+      description: input.description,
+      avatar: input.avatar,
+      home: input.home
+    },
+    {
+      configPath,
+      initializeHomeDirectory: options.initializeAgentHomeDirectory
+    }
+  );
+  const config = loadConfig2(configPath);
+  return toAgentProfileView(config, created.id);
+}
+function deleteAgent(configPath, agentId) {
+  const deleted = removeAgentProfile(agentId, { configPath });
+  if (!deleted) {
+    return null;
+  }
+  return {
+    deleted: true,
+    agentId: agentId.trim().toLowerCase()
+  };
+}
+function readAgentAvatar(configPath, agentId) {
+  const config = loadConfig2(configPath);
+  return readAgentAvatarContent({ config, agentId });
+}
+function toAgentProfileView(config, agentId) {
+  const profile = findEffectiveAgentProfile(config, agentId);
+  if (!profile) {
+    throw new Error(`unknown agent: ${agentId}`);
+  }
+  return {
+    id: profile.id,
+    default: profile.default,
+    displayName: profile.displayName,
+    description: profile.description,
+    avatar: profile.avatar,
+    avatarUrl: buildAgentAvatarUrl(profile.id, profile.avatar),
+    workspace: profile.workspace,
+    model: profile.model,
+    engine: profile.engine,
+    engineConfig: profile.engineConfig,
+    contextTokens: profile.contextTokens,
+    maxToolIterations: profile.maxToolIterations,
+    builtIn: profile.builtIn === true
+  };
+}
+function buildAgentAvatarUrl(agentId, avatar) {
+  const normalized = typeof avatar === "string" ? avatar.trim() : "";
+  if (!normalized) {
+    return void 0;
+  }
+  if (normalized.startsWith("http://") || normalized.startsWith("https://")) {
+    return normalized;
+  }
+  if (normalized.startsWith("home://")) {
+    return `/api/agents/${encodeURIComponent(agentId)}/avatar`;
+  }
+  return void 0;
+}
+
+// src/ui/ui-routes/response.ts
 function ok(data) {
   return { ok: true, data };
 }
@@ -380,7 +459,68 @@ function formatUserFacingError(error, maxChars = 320) {
   return `${normalized.slice(0, Math.max(0, maxChars - 3)).trimEnd()}...`;
 }
 
-// src/ui/router/app.controller.ts
+// src/ui/ui-routes/agents.controller.ts
+var AgentsRoutesController = class {
+  constructor(options) {
+    this.options = options;
+  }
+  publishAgentUpdates = async (paths) => {
+    for (const path of paths) {
+      this.options.publish({ type: "config.updated", payload: { path } });
+    }
+    await this.options.applyLiveConfigReload?.();
+  };
+  listAgents = (c) => {
+    return c.json(ok({ agents: listAgents(this.options.configPath) }));
+  };
+  createAgent = async (c) => {
+    const body = await readJson(c.req.raw);
+    if (!body.ok) {
+      return c.json(err("INVALID_BODY", "invalid json body"), 400);
+    }
+    try {
+      const agent = createAgent(this.options.configPath, body.data, {
+        initializeAgentHomeDirectory: this.options.initializeAgentHomeDirectory
+      });
+      await this.publishAgentUpdates(["agents.list"]);
+      return c.json(ok(agent));
+    } catch (error) {
+      return c.json(err("AGENT_CREATE_FAILED", error instanceof Error ? error.message : String(error)), 400);
+    }
+  };
+  deleteAgent = async (c) => {
+    const agentId = c.req.param("agentId");
+    try {
+      const result = deleteAgent(this.options.configPath, agentId);
+      if (!result) {
+        return c.json(err("NOT_FOUND", `agent not found: ${agentId}`), 404);
+      }
+      await this.publishAgentUpdates(["agents.list"]);
+      return c.json(ok(result));
+    } catch (error) {
+      return c.json(err("AGENT_DELETE_FAILED", error instanceof Error ? error.message : String(error)), 400);
+    }
+  };
+  getAgentAvatar = (c) => {
+    const agentId = c.req.param("agentId");
+    try {
+      const avatar = readAgentAvatar(this.options.configPath, agentId);
+      if (!avatar) {
+        return c.json(err("NOT_FOUND", `avatar not found for agent: ${agentId}`), 404);
+      }
+      return new Response(avatar.bytes, {
+        headers: {
+          "content-type": avatar.mimeType,
+          "cache-control": "public, max-age=300"
+        }
+      });
+    } catch (error) {
+      return c.json(err("AGENT_AVATAR_FAILED", error instanceof Error ? error.message : String(error)), 400);
+    }
+  };
+};
+
+// src/ui/ui-routes/app.controller.ts
 function buildAppMetaView(options) {
   const productVersion = options.productVersion?.trim();
   return {
@@ -455,7 +595,7 @@ function ensureUiBridgeSecret() {
   return secret;
 }
 
-// src/ui/router/auth.controller.ts
+// src/ui/ui-routes/auth.controller.ts
 function isAuthenticationRequiredError(message) {
   return message === "Authentication required.";
 }
@@ -568,7 +708,7 @@ var AuthRoutesController = class {
 
 // src/ui/config.ts
 import {
-  loadConfig as loadConfig2,
+  loadConfig as loadConfig3,
   saveConfig as saveConfig2,
   ConfigSchema as ConfigSchema2,
   DEFAULT_WORKSPACE_PATH,
@@ -1409,7 +1549,7 @@ async function executeConfigAction(configPath, actionId, request) {
   };
 }
 function loadConfigOrDefault(configPath) {
-  return loadConfig2(configPath);
+  return loadConfig3(configPath);
 }
 function updateModel(configPath, patch) {
   const config = loadConfigOrDefault(configPath);
@@ -2129,7 +2269,7 @@ import { homedir } from "os";
 import { isAbsolute, resolve } from "path";
 import {
   ConfigSchema as ConfigSchema3,
-  loadConfig as loadConfig3,
+  loadConfig as loadConfig4,
   saveConfig as saveConfig4
 } from "@nextclaw/core";
 var authSessions = /* @__PURE__ */ new Map();
@@ -2324,7 +2464,7 @@ function readFieldAsString(source, fieldName) {
   return trimmed.length > 0 ? trimmed : null;
 }
 function setProviderApiKey(params) {
-  const config = loadConfig3(params.configPath);
+  const config = loadConfig4(params.configPath);
   const providers = config.providers;
   if (!providers[params.provider]) {
     providers[params.provider] = createDefaultProviderConfig();
@@ -2655,7 +2795,7 @@ async function importProviderAuthFromCli(configPath, providerName) {
   };
 }
 
-// src/ui/router/config.controller.ts
+// src/ui/ui-routes/config.controller.ts
 var ConfigRoutesController = class {
   constructor(options) {
     this.options = options;
@@ -2947,7 +3087,7 @@ var ConfigRoutesController = class {
   };
 };
 
-// src/ui/router/cron.controller.ts
+// src/ui/ui-routes/cron.controller.ts
 function toIsoTime(value) {
   if (typeof value !== "number" || !Number.isFinite(value)) {
     return null;
@@ -3047,7 +3187,7 @@ var CronRoutesController = class {
   };
 };
 
-// src/ui/router/ncp-attachment.controller.ts
+// src/ui/ui-routes/ncp-attachment.controller.ts
 import { readFile as readFile2 } from "fs/promises";
 var ASSET_CONTENT_BASE_PATH = "/api/ncp/assets/content";
 function buildAssetContentUrl(assetUri) {
@@ -3182,7 +3322,7 @@ function isSessionProjectRootValidationError(error) {
 // src/ui/session-project/session-skills.ts
 import * as NextclawCore from "@nextclaw/core";
 
-// src/ui/router/marketplace/constants.ts
+// src/ui/ui-routes/marketplace/constants.ts
 var DEFAULT_MARKETPLACE_API_BASE = "https://marketplace-api.nextclaw.io";
 var NEXTCLAW_PLUGIN_NPM_PREFIX = "@nextclaw/channel-plugin-";
 var BUILTIN_CHANNEL_PLUGIN_ID_PREFIX = "builtin-channel-";
@@ -3266,7 +3406,8 @@ var MARKETPLACE_ZH_COPY_BY_SLUG = {
 // src/ui/session-project/session-skills.ts
 var SCOPE_SORT_ORDER = {
   project: 0,
-  workspace: 1
+  workspace: 1,
+  builtin: 2
 };
 var SessionSkillsViewBuilder = class {
   constructor(options) {
@@ -3321,7 +3462,7 @@ var SessionSkillsViewBuilder = class {
   };
 };
 
-// src/ui/router/ncp-session.controller.ts
+// src/ui/ui-routes/ncp-session.controller.ts
 function readPositiveInt(value) {
   if (typeof value !== "string") {
     return void 0;
@@ -3429,6 +3570,7 @@ var NcpSessionRoutesController = class {
     });
     const payload = {
       sessionId,
+      status: session.status ?? "idle",
       messages,
       total: messages.length
     };
@@ -3519,7 +3661,7 @@ var NcpSessionRoutesController = class {
   };
 };
 
-// src/ui/router/marketplace/marketplace-network-retry.ts
+// src/ui/ui-routes/marketplace/marketplace-network-retry.ts
 var MARKETPLACE_NETWORK_RETRY_ATTEMPTS = 5;
 var MARKETPLACE_NETWORK_RETRY_BASE_MS = 350;
 function sleepMs(ms) {
@@ -3562,7 +3704,7 @@ async function runWithMarketplaceNetworkRetry(action) {
   throw lastError;
 }
 
-// src/ui/router/marketplace/catalog.ts
+// src/ui/ui-routes/marketplace/catalog.ts
 function normalizeMarketplaceBaseUrl(options) {
   const configured = options.marketplace?.apiBaseUrl?.trim();
   if (!configured) {
@@ -3777,7 +3919,7 @@ function sanitizeMarketplaceItemView(item) {
   return sanitizeMarketplaceItem(item);
 }
 
-// src/ui/router/marketplace/mcp.controller.ts
+// src/ui/ui-routes/marketplace/mcp.controller.ts
 import { McpInstalledViewService } from "@nextclaw/mcp";
 var McpMarketplaceController = class {
   constructor(options, marketplaceBaseUrl) {
@@ -3987,11 +4129,11 @@ var McpMarketplaceController = class {
   };
 };
 
-// src/ui/router/marketplace/installed.ts
+// src/ui/ui-routes/marketplace/installed.ts
 import * as NextclawCore2 from "@nextclaw/core";
 import { discoverPluginStatusReport } from "@nextclaw/openclaw-compat";
 
-// src/ui/router/marketplace/spec.ts
+// src/ui/ui-routes/marketplace/spec.ts
 function normalizePluginNpmSpec(rawSpec) {
   const spec = rawSpec.trim();
   if (!spec.startsWith("@")) {
@@ -4094,7 +4236,7 @@ function dedupeInstalledPluginRecordsByCanonicalSpec(records) {
   return Array.from(deduped.values());
 }
 
-// src/ui/router/marketplace/installed.ts
+// src/ui/ui-routes/marketplace/installed.ts
 var getWorkspacePathFromConfig4 = NextclawCore2.getWorkspacePathFromConfig;
 function createSkillsLoader(workspace) {
   const ctor = NextclawCore2.SkillsLoader;
@@ -4296,7 +4438,7 @@ function collectInstalledSkillRecords(options) {
   const listedSkills = skillsLoader?.listSkills(false) ?? [];
   const records = listedSkills.map((skill) => {
     const enabled = availableSkillSet.has(skill.name);
-    const metadata = skillsLoader?.getSkillMetadata?.(skill.name);
+    const metadata = skillsLoader?.getSkillMetadata?.(skill);
     const description = readNonEmptyString(metadata?.description);
     const descriptionZh = readNonEmptyString(metadata?.description_zh) ?? readNonEmptyString(metadata?.descriptionZh) ?? readNonEmptyString(MARKETPLACE_ZH_COPY_BY_SLUG[skill.name]?.description);
     return {
@@ -4387,7 +4529,7 @@ function findUnsupportedSkillInstallKind(items) {
   return null;
 }
 
-// src/ui/router/marketplace/plugin.controller.ts
+// src/ui/ui-routes/marketplace/plugin.controller.ts
 async function loadPluginReadmeFromNpm(spec) {
   const encodedSpec = encodeURIComponent(spec);
   const registryUrl = `https://registry.npmjs.org/${encodedSpec}`;
@@ -4650,7 +4792,7 @@ var PluginMarketplaceController = class {
   };
 };
 
-// src/ui/router/marketplace/routes.ts
+// src/ui/ui-routes/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);
@@ -4676,7 +4818,7 @@ function mountMarketplaceRoutes(app, controllers) {
   app.get("/api/marketplace/mcp/recommendations", controllers.mcp.getRecommendations);
 }
 
-// src/ui/router/marketplace/skill.controller.ts
+// src/ui/ui-routes/marketplace/skill.controller.ts
 async function installMarketplaceSkill(params) {
   const spec = typeof params.body.spec === "string" ? params.body.spec.trim() : "";
   if (!spec) {
@@ -4900,7 +5042,7 @@ var SkillMarketplaceController = class {
   };
 };
 
-// src/ui/router/remote.controller.ts
+// src/ui/ui-routes/remote.controller.ts
 var REMOTE_SERVICE_ACTIONS = /* @__PURE__ */ new Set(["start", "restart", "stop"]);
 function readTrimmedString(value) {
   return typeof value === "string" ? value.trim() : void 0;
@@ -5121,7 +5263,7 @@ function isServerPathBrowseError(error) {
   return error instanceof ServerPathBrowseError;
 }
 
-// src/ui/router/server-path.controller.ts
+// src/ui/ui-routes/server-path.controller.ts
 function readIncludeFilesFlag(value) {
   return value === "1" || value === "true";
 }
@@ -5152,6 +5294,12 @@ function registerAuthRoutes(app, authController) {
   app.put("/api/auth/enabled", authController.updateEnabled);
   app.post("/api/auth/bridge", authController.issueBridgeSession);
 }
+function registerAgentRoutes(app, agentsController) {
+  app.get("/api/agents", agentsController.listAgents);
+  app.post("/api/agents", agentsController.createAgent);
+  app.delete("/api/agents/:agentId", agentsController.deleteAgent);
+  app.get("/api/agents/:agentId/avatar", agentsController.getAgentAvatar);
+}
 function registerConfigRoutes(app, configController) {
   app.get("/api/config", configController.getConfig);
   app.get("/api/config/meta", configController.getConfigMeta);
@@ -5220,6 +5368,7 @@ function createUiRouter(options) {
   const marketplaceBaseUrl = normalizeMarketplaceBaseUrl(options);
   const authService = options.authService ?? new UiAuthService(options.configPath);
   const appController = new AppRoutesController(options);
+  const agentsController = new AgentsRoutesController(options);
   const authController = new AuthRoutesController(authService);
   const configController = new ConfigRoutesController(options);
   const cronController = new CronRoutesController(options);
@@ -5248,6 +5397,7 @@ function createUiRouter(options) {
   app.get("/api/app/meta", appController.appMeta);
   app.get("/api/runtime/bootstrap-status", appController.bootstrapStatus);
   registerAuthRoutes(app, authController);
+  registerAgentRoutes(app, agentsController);
   registerConfigRoutes(app, configController);
   registerNcpSessionRoutes(app, ncpSessionController);
   registerServerPathRoutes(app, serverPathController);
@@ -5358,6 +5508,7 @@ function startUiServer(options) {
       productVersion: options.productVersion,
       publish,
       applyLiveConfigReload: options.applyLiveConfigReload,
+      initializeAgentHomeDirectory: options.initializeAgentHomeDirectory,
       marketplace: options.marketplace,
       cronService: options.cronService,
       ncpAgent: options.ncpAgent,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nextclaw/server",
-  "version": "0.11.24",
+  "version": "0.12.0",
   "private": false,
   "description": "Nextclaw UI/API server.",
   "type": "module",
@@ -18,12 +18,12 @@
     "@hono/node-server": "^1.13.3",
     "hono": "^4.6.2",
     "ws": "^8.18.0",
-    "@nextclaw/core": "0.11.17",
-    "@nextclaw/ncp-http-agent-server": "0.3.11",
-    "@nextclaw/ncp": "0.4.6",
-    "@nextclaw/openclaw-compat": "0.3.58",
-    "@nextclaw/mcp": "0.1.64",
-    "@nextclaw/runtime": "0.2.31"
+    "@nextclaw/core": "0.12.0",
+    "@nextclaw/mcp": "0.1.65",
+    "@nextclaw/ncp": "0.5.0",
+    "@nextclaw/ncp-http-agent-server": "0.3.12",
+    "@nextclaw/openclaw-compat": "1.0.0",
+    "@nextclaw/runtime": "0.2.32"
   },
   "devDependencies": {
     "@types/node": "^20.17.6",