@nextclaw/server 0.5.12 → 0.5.14

package/dist/index.d.ts

@@ -324,37 +324,65 @@ type MarketplaceInstalledView = {
     specs: string[];
     records: MarketplaceInstalledRecord[];
 };
-type MarketplaceInstallRequest = {
-    type: MarketplaceItemType;
-    spec: string;
+type MarketplaceInstallSkillParams = {
+    slug: string;
     kind?: MarketplaceInstallKind;
+    skill?: string;
+    installPath?: string;
     version?: string;
     registry?: string;
     force?: boolean;
 };
-type MarketplaceInstallResult = {
-    type: MarketplaceItemType;
+type MarketplacePluginInstallRequest = {
+    type?: "plugin";
     spec: string;
-    message: string;
-    output?: string;
 };
-type MarketplaceInstallSkillParams = {
-    slug: string;
+type MarketplaceSkillInstallRequest = {
+    type?: "skill";
+    spec: string;
     kind?: MarketplaceInstallKind;
+    skill?: string;
+    installPath?: string;
     version?: string;
     registry?: string;
     force?: boolean;
 };
-type MarketplaceManageAction = "enable" | "disable" | "uninstall";
-type MarketplaceManageRequest = {
-    type: MarketplaceItemType;
-    action: MarketplaceManageAction;
+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 MarketplaceManageResult = {
-    type: MarketplaceItemType;
-    action: MarketplaceManageAction;
+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;
@@ -463,4 +491,4 @@ declare function patchSession(configPath: string, key: string, patch: SessionPat
 declare function deleteSession(configPath: string, key: string): boolean;
 declare function updateRuntime(configPath: string, patch: RuntimeConfigUpdate): Pick<ConfigView, "agents" | "bindings" | "session">;
 
-export { type AgentBindingView, type AgentProfileView, type ApiError, type ApiResponse, type BindingPeerView, type ChannelSpecView, 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, type MarketplaceApiConfig, type MarketplaceInstallKind, type MarketplaceInstallRequest, type MarketplaceInstallResult, type MarketplaceInstallSkillParams, type MarketplaceInstallSpec, type MarketplaceInstalledRecord, type MarketplaceInstalledView, type MarketplaceInstaller, type MarketplaceItemSummary, type MarketplaceItemType, type MarketplaceItemView, type MarketplaceListView, type MarketplaceManageAction, type MarketplaceManageRequest, type MarketplaceManageResult, type MarketplaceRecommendationView, type MarketplaceSort, type ProviderConfigUpdate, type ProviderConfigView, type ProviderSpecView, type RuntimeConfigUpdate, type SessionConfigView, type SessionEntryView, type SessionHistoryView, type SessionMessageView, type SessionPatchUpdate, type SessionsListView, type UiServerEvent, type UiServerHandle, type UiServerOptions, buildConfigMeta, buildConfigSchemaView, buildConfigView, createUiRouter, deleteSession, executeConfigAction, getSessionHistory, listSessions, loadConfigOrDefault, patchSession, startUiServer, updateChannel, updateModel, updateProvider, updateRuntime };
+export { type AgentBindingView, type AgentProfileView, type ApiError, type ApiResponse, type BindingPeerView, type ChannelSpecView, 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, type MarketplaceApiConfig, type MarketplaceInstallKind, type MarketplaceInstallSkillParams, type MarketplaceInstallSpec, type MarketplaceInstalledRecord, type MarketplaceInstalledView, type MarketplaceInstaller, type MarketplaceItemSummary, type MarketplaceItemType, type MarketplaceItemView, type MarketplaceListView, type MarketplacePluginInstallRequest, type MarketplacePluginInstallResult, type MarketplacePluginManageAction, type MarketplacePluginManageRequest, type MarketplacePluginManageResult, type MarketplaceRecommendationView, type MarketplaceSkillInstallRequest, type MarketplaceSkillInstallResult, type MarketplaceSkillManageAction, type MarketplaceSkillManageRequest, type MarketplaceSkillManageResult, type MarketplaceSort, type ProviderConfigUpdate, type ProviderConfigView, type ProviderSpecView, type RuntimeConfigUpdate, type SessionConfigView, type SessionEntryView, type SessionHistoryView, type SessionMessageView, type SessionPatchUpdate, type SessionsListView, type UiServerEvent, type UiServerHandle, type UiServerOptions, buildConfigMeta, buildConfigSchemaView, buildConfigView, createUiRouter, deleteSession, executeConfigAction, getSessionHistory, listSessions, loadConfigOrDefault, patchSession, startUiServer, updateChannel, updateModel, updateProvider, updateRuntime };

package/dist/index.js

@@ -931,10 +931,19 @@ function collectInstalledSkillRecords(options) {
     records
   };
 }
-function collectMarketplaceInstalledView(options, type) {
-  const installed = type === "plugin" ? collectInstalledPluginRecords(options) : collectInstalledSkillRecords(options);
+function collectPluginMarketplaceInstalledView(options) {
+  const installed = collectInstalledPluginRecords(options);
   return {
-    type,
+    type: "plugin",
+    total: installed.records.length,
+    specs: installed.specs,
+    records: installed.records
+  };
+}
+function collectSkillMarketplaceInstalledView(options) {
+  const installed = collectInstalledSkillRecords(options);
+  return {
+    type: "skill",
     total: installed.records.length,
     specs: installed.specs,
     records: installed.records
@@ -993,9 +1002,15 @@ function collectKnownSkillNames(options) {
   const loader = createSkillsLoader(getWorkspacePathFromConfig3(config));
   return new Set((loader?.listSkills(false) ?? []).map((skill) => skill.name));
 }
-function isSupportedMarketplaceItem(item, knownSkillNames) {
-  if (item.type === "plugin") {
-    return item.install.kind === "npm" && isSupportedMarketplacePluginSpec(item.install.spec);
+function isSupportedMarketplacePluginItem(item) {
+  return item.type === "plugin" && item.install.kind === "npm" && isSupportedMarketplacePluginSpec(item.install.spec);
+}
+function isSupportedMarketplaceSkillItem(item, knownSkillNames) {
+  if (item.type !== "skill") {
+    return false;
+  }
+  if (item.install.kind === "git") {
+    return true;
   }
   return item.install.kind === "builtin" && knownSkillNames.has(item.install.spec);
 }
@@ -1033,226 +1048,377 @@ async function fetchAllMarketplaceItems(params) {
     }
   };
 }
-async function installMarketplaceItem(params) {
-  const type = params.body.type;
+async function fetchAllPluginMarketplaceItems(params) {
+  return await fetchAllMarketplaceItems({
+    baseUrl: params.baseUrl,
+    segment: "plugins",
+    query: params.query
+  });
+}
+async function fetchAllSkillMarketplaceItems(params) {
+  return await fetchAllMarketplaceItems({
+    baseUrl: params.baseUrl,
+    segment: "skills",
+    query: params.query
+  });
+}
+async function installMarketplacePlugin(params) {
   const spec = typeof params.body.spec === "string" ? params.body.spec.trim() : "";
-  if (type !== "plugin" && type !== "skill" || !spec) {
-    throw new Error("INVALID_BODY:type and non-empty spec are required");
+  if (!spec) {
+    throw new Error("INVALID_BODY:non-empty spec is required");
   }
   const installer = params.options.marketplace?.installer;
   if (!installer) {
     throw new Error("NOT_AVAILABLE:marketplace installer is not configured");
   }
-  let result;
-  if (type === "plugin") {
-    if (!installer.installPlugin) {
-      throw new Error("NOT_AVAILABLE:plugin installer is not configured");
-    }
-    result = await installer.installPlugin(spec);
-  } else {
-    if (!installer.installSkill) {
-      throw new Error("NOT_AVAILABLE:skill installer is not configured");
-    }
-    result = await installer.installSkill({
-      slug: spec,
-      kind: params.body.kind,
-      version: params.body.version,
-      registry: params.body.registry,
-      force: params.body.force
-    });
+  if (!installer.installPlugin) {
+    throw new Error("NOT_AVAILABLE:plugin installer is not configured");
   }
-  params.options.publish({ type: "config.updated", payload: { path: type === "plugin" ? "plugins" : "skills" } });
+  const result = await installer.installPlugin(spec);
+  params.options.publish({ type: "config.updated", payload: { path: "plugins" } });
   return {
-    type,
+    type: "plugin",
     spec,
     message: result.message,
     output: result.output
   };
 }
-async function manageMarketplaceItem(params) {
-  const type = params.body.type;
+async function installMarketplaceSkill(params) {
+  const spec = typeof params.body.spec === "string" ? params.body.spec.trim() : "";
+  if (!spec) {
+    throw new Error("INVALID_BODY:non-empty spec is required");
+  }
+  const installer = params.options.marketplace?.installer;
+  if (!installer) {
+    throw new Error("NOT_AVAILABLE:marketplace installer is not configured");
+  }
+  if (!installer.installSkill) {
+    throw new Error("NOT_AVAILABLE:skill installer is not configured");
+  }
+  const result = await installer.installSkill({
+    slug: spec,
+    kind: params.body.kind,
+    skill: params.body.skill,
+    installPath: params.body.installPath,
+    version: params.body.version,
+    registry: params.body.registry,
+    force: params.body.force
+  });
+  params.options.publish({ type: "config.updated", payload: { path: "skills" } });
+  return {
+    type: "skill",
+    spec,
+    message: result.message,
+    output: result.output
+  };
+}
+async function manageMarketplacePlugin(params) {
   const action = params.body.action;
   const requestedTargetId = typeof params.body.id === "string" && params.body.id.trim().length > 0 ? params.body.id.trim() : typeof params.body.spec === "string" && params.body.spec.trim().length > 0 ? params.body.spec.trim() : "";
   const rawSpec = typeof params.body.spec === "string" ? params.body.spec.trim() : "";
-  const targetId = type === "plugin" ? resolvePluginManageTargetId(params.options, requestedTargetId, rawSpec) : requestedTargetId;
-  if (type !== "plugin" && type !== "skill" || action !== "enable" && action !== "disable" && action !== "uninstall" || !targetId) {
-    throw new Error("INVALID_BODY:type, action and non-empty id/spec are required");
+  const targetId = resolvePluginManageTargetId(params.options, requestedTargetId, rawSpec);
+  if (action !== "enable" && action !== "disable" && action !== "uninstall" || !targetId) {
+    throw new Error("INVALID_BODY:action and non-empty id/spec are required");
   }
   const installer = params.options.marketplace?.installer;
   if (!installer) {
     throw new Error("NOT_AVAILABLE:marketplace installer is not configured");
   }
   let result;
-  if (type === "plugin") {
-    if (action === "enable") {
-      if (!installer.enablePlugin) {
-        throw new Error("NOT_AVAILABLE:plugin enable is not configured");
-      }
-      result = await installer.enablePlugin(targetId);
-    } else if (action === "disable") {
-      if (!installer.disablePlugin) {
-        throw new Error("NOT_AVAILABLE:plugin disable is not configured");
-      }
-      result = await installer.disablePlugin(targetId);
-    } else {
-      if (!installer.uninstallPlugin) {
-        throw new Error("NOT_AVAILABLE:plugin uninstall is not configured");
-      }
-      result = await installer.uninstallPlugin(targetId);
+  if (action === "enable") {
+    if (!installer.enablePlugin) {
+      throw new Error("NOT_AVAILABLE:plugin enable is not configured");
     }
-  } else {
-    if (action !== "uninstall") {
-      throw new Error("NOT_AVAILABLE:skill only supports uninstall action");
+    result = await installer.enablePlugin(targetId);
+  } else if (action === "disable") {
+    if (!installer.disablePlugin) {
+      throw new Error("NOT_AVAILABLE:plugin disable is not configured");
     }
-    if (!installer.uninstallSkill) {
-      throw new Error("NOT_AVAILABLE:skill uninstall is not configured");
+    result = await installer.disablePlugin(targetId);
+  } else {
+    if (!installer.uninstallPlugin) {
+      throw new Error("NOT_AVAILABLE:plugin uninstall is not configured");
     }
-    result = await installer.uninstallSkill(targetId);
+    result = await installer.uninstallPlugin(targetId);
   }
-  params.options.publish({ type: "config.updated", payload: { path: type === "plugin" ? "plugins" : "skills" } });
+  params.options.publish({ type: "config.updated", payload: { path: "plugins" } });
   return {
-    type,
+    type: "plugin",
     action,
     id: targetId,
     message: result.message,
     output: result.output
   };
 }
-function registerMarketplaceRoutes(app, options, marketplaceBaseUrl) {
-  const typedMarketplaceRoutes = [
-    { segment: "plugins", type: "plugin" },
-    { segment: "skills", type: "skill" }
-  ];
-  for (const route of typedMarketplaceRoutes) {
-    app.get(`/api/marketplace/${route.segment}/installed`, (c) => {
-      return c.json(ok(collectMarketplaceInstalledView(options, route.type)));
-    });
-    app.get(`/api/marketplace/${route.segment}/items`, async (c) => {
-      const query = c.req.query();
-      const result = await fetchAllMarketplaceItems({
-        baseUrl: marketplaceBaseUrl,
-        segment: route.segment,
-        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);
+async function manageMarketplaceSkill(params) {
+  const action = params.body.action;
+  const targetId = typeof params.body.id === "string" && params.body.id.trim().length > 0 ? params.body.id.trim() : typeof params.body.spec === "string" && params.body.spec.trim().length > 0 ? params.body.spec.trim() : "";
+  if (action !== "uninstall" || !targetId) {
+    throw new Error("INVALID_BODY:skill manage requires uninstall action and non-empty id/spec");
+  }
+  const installer = params.options.marketplace?.installer;
+  if (!installer) {
+    throw new Error("NOT_AVAILABLE:marketplace installer is not configured");
+  }
+  if (!installer.uninstallSkill) {
+    throw new Error("NOT_AVAILABLE:skill uninstall is not configured");
+  }
+  const result = await installer.uninstallSkill(targetId);
+  params.options.publish({ type: "config.updated", payload: { path: "skills" } });
+  return {
+    type: "skill",
+    action,
+    id: targetId,
+    message: result.message,
+    output: result.output
+  };
+}
+function registerPluginMarketplaceRoutes(app, options, marketplaceBaseUrl) {
+  app.get("/api/marketplace/plugins/installed", (c) => {
+    return c.json(ok(collectPluginMarketplaceInstalledView(options)));
+  });
+  app.get("/api/marketplace/plugins/items", async (c) => {
+    const query = c.req.query();
+    const result = await fetchAllPluginMarketplaceItems({
+      baseUrl: marketplaceBaseUrl,
+      query: {
+        q: query.q,
+        tag: query.tag,
+        sort: query.sort,
+        page: query.page,
+        pageSize: query.pageSize
       }
-      const knownSkillNames = collectKnownSkillNames(options);
-      const filteredItems = result.data.items.map((item) => sanitizeMarketplaceItem(item)).filter((item) => isSupportedMarketplaceItem(item, knownSkillNames));
-      const pageSize = Math.min(100, toPositiveInt(query.pageSize, 20));
-      const requestedPage = toPositiveInt(query.page, 1);
-      const totalPages = filteredItems.length === 0 ? 0 : Math.ceil(filteredItems.length / pageSize);
-      const currentPage = totalPages === 0 ? 1 : Math.min(requestedPage, totalPages);
-      return c.json(ok({
-        total: filteredItems.length,
-        page: currentPage,
-        pageSize,
-        totalPages,
-        sort: result.data.sort,
-        query: result.data.query,
-        items: filteredItems.slice((currentPage - 1) * pageSize, currentPage * pageSize)
-      }));
     });
-    app.get(`/api/marketplace/${route.segment}/items/:slug`, async (c) => {
-      const slug = encodeURIComponent(c.req.param("slug"));
-      const result = await fetchMarketplaceData({
-        baseUrl: marketplaceBaseUrl,
-        path: `/api/v1/${route.segment}/items/${slug}`
+    if (!result.ok) {
+      return c.json(err("MARKETPLACE_UNAVAILABLE", result.message), result.status);
+    }
+    const filteredItems = result.data.items.map((item) => sanitizeMarketplaceItem(item)).filter((item) => isSupportedMarketplacePluginItem(item));
+    const pageSize = Math.min(100, toPositiveInt(query.pageSize, 20));
+    const requestedPage = toPositiveInt(query.page, 1);
+    const totalPages = filteredItems.length === 0 ? 0 : Math.ceil(filteredItems.length / pageSize);
+    const currentPage = totalPages === 0 ? 1 : Math.min(requestedPage, totalPages);
+    return c.json(ok({
+      total: filteredItems.length,
+      page: currentPage,
+      pageSize,
+      totalPages,
+      sort: result.data.sort,
+      query: result.data.query,
+      items: filteredItems.slice((currentPage - 1) * pageSize, currentPage * pageSize)
+    }));
+  });
+  app.get("/api/marketplace/plugins/items/:slug", async (c) => {
+    const slug = encodeURIComponent(c.req.param("slug"));
+    const result = await fetchMarketplaceData({
+      baseUrl: marketplaceBaseUrl,
+      path: `/api/v1/plugins/items/${slug}`
+    });
+    if (!result.ok) {
+      return c.json(err("MARKETPLACE_UNAVAILABLE", result.message), result.status);
+    }
+    const sanitized = sanitizeMarketplaceItem(result.data);
+    if (!isSupportedMarketplacePluginItem(sanitized)) {
+      return c.json(err("NOT_FOUND", "marketplace item not supported by nextclaw"), 404);
+    }
+    return c.json(ok(sanitized));
+  });
+  app.post("/api/marketplace/plugins/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 !== "plugin") {
+      return c.json(err("INVALID_BODY", "body.type does not match route type"), 400);
+    }
+    try {
+      const payload = await installMarketplacePlugin({
+        options,
+        body: body.data
       });
-      if (!result.ok) {
-        return c.json(err("MARKETPLACE_UNAVAILABLE", result.message), result.status);
+      return c.json(ok(payload));
+    } catch (error) {
+      const message = String(error);
+      if (message.startsWith("INVALID_BODY:")) {
+        return c.json(err("INVALID_BODY", message.slice("INVALID_BODY:".length)), 400);
       }
-      const knownSkillNames = collectKnownSkillNames(options);
-      const sanitized = sanitizeMarketplaceItem(result.data);
-      if (!isSupportedMarketplaceItem(sanitized, knownSkillNames)) {
-        return c.json(err("NOT_FOUND", "marketplace item not supported by nextclaw"), 404);
+      if (message.startsWith("NOT_AVAILABLE:")) {
+        return c.json(err("NOT_AVAILABLE", message.slice("NOT_AVAILABLE:".length)), 503);
       }
-      return c.json(ok(sanitized));
-    });
-    app.post(`/api/marketplace/${route.segment}/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);
+      return c.json(err("INSTALL_FAILED", message), 400);
+    }
+  });
+  app.post("/api/marketplace/plugins/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 !== "plugin") {
+      return c.json(err("INVALID_BODY", "body.type does not match route type"), 400);
+    }
+    try {
+      const payload = await manageMarketplacePlugin({
+        options,
+        body: body.data
+      });
+      return c.json(ok(payload));
+    } catch (error) {
+      const message = String(error);
+      if (message.startsWith("INVALID_BODY:")) {
+        return c.json(err("INVALID_BODY", message.slice("INVALID_BODY:".length)), 400);
       }
-      if (body.data.type && body.data.type !== route.type) {
-        return c.json(err("INVALID_BODY", "body.type does not match route type"), 400);
+      if (message.startsWith("NOT_AVAILABLE:")) {
+        return c.json(err("NOT_AVAILABLE", message.slice("NOT_AVAILABLE:".length)), 503);
       }
-      try {
-        const payload = await installMarketplaceItem({
-          options,
-          body: {
-            ...body.data,
-            type: route.type
-          }
-        });
-        return c.json(ok(payload));
-      } catch (error) {
-        const message = String(error);
-        if (message.startsWith("INVALID_BODY:")) {
-          return c.json(err("INVALID_BODY", message.slice("INVALID_BODY:".length)), 400);
-        }
-        if (message.startsWith("NOT_AVAILABLE:")) {
-          return c.json(err("NOT_AVAILABLE", message.slice("NOT_AVAILABLE:".length)), 503);
-        }
-        return c.json(err("INSTALL_FAILED", message), 400);
+      return c.json(err("MANAGE_FAILED", message), 400);
+    }
+  });
+  app.get("/api/marketplace/plugins/recommendations", async (c) => {
+    const query = c.req.query();
+    const result = await fetchMarketplaceData({
+      baseUrl: marketplaceBaseUrl,
+      path: "/api/v1/plugins/recommendations",
+      query: {
+        scene: query.scene,
+        limit: query.limit
       }
     });
-    app.post(`/api/marketplace/${route.segment}/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 (!result.ok) {
+      return c.json(err("MARKETPLACE_UNAVAILABLE", result.message), result.status);
+    }
+    const filteredItems = result.data.items.map((item) => sanitizeMarketplaceItem(item)).filter((item) => isSupportedMarketplacePluginItem(item));
+    return c.json(ok({
+      ...result.data,
+      total: filteredItems.length,
+      items: filteredItems
+    }));
+  });
+}
+function registerSkillMarketplaceRoutes(app, options, marketplaceBaseUrl) {
+  app.get("/api/marketplace/skills/installed", (c) => {
+    return c.json(ok(collectSkillMarketplaceInstalledView(options)));
+  });
+  app.get("/api/marketplace/skills/items", async (c) => {
+    const query = c.req.query();
+    const result = await fetchAllSkillMarketplaceItems({
+      baseUrl: marketplaceBaseUrl,
+      query: {
+        q: query.q,
+        tag: query.tag,
+        sort: query.sort,
+        page: query.page,
+        pageSize: query.pageSize
       }
-      if (body.data.type && body.data.type !== route.type) {
-        return c.json(err("INVALID_BODY", "body.type does not match route type"), 400);
+    });
+    if (!result.ok) {
+      return c.json(err("MARKETPLACE_UNAVAILABLE", result.message), result.status);
+    }
+    const knownSkillNames = collectKnownSkillNames(options);
+    const filteredItems = result.data.items.map((item) => sanitizeMarketplaceItem(item)).filter((item) => isSupportedMarketplaceSkillItem(item, knownSkillNames));
+    const pageSize = Math.min(100, toPositiveInt(query.pageSize, 20));
+    const requestedPage = toPositiveInt(query.page, 1);
+    const totalPages = filteredItems.length === 0 ? 0 : Math.ceil(filteredItems.length / pageSize);
+    const currentPage = totalPages === 0 ? 1 : Math.min(requestedPage, totalPages);
+    return c.json(ok({
+      total: filteredItems.length,
+      page: currentPage,
+      pageSize,
+      totalPages,
+      sort: result.data.sort,
+      query: result.data.query,
+      items: filteredItems.slice((currentPage - 1) * pageSize, currentPage * pageSize)
+    }));
+  });
+  app.get("/api/marketplace/skills/items/:slug", async (c) => {
+    const slug = encodeURIComponent(c.req.param("slug"));
+    const result = await fetchMarketplaceData({
+      baseUrl: marketplaceBaseUrl,
+      path: `/api/v1/skills/items/${slug}`
+    });
+    if (!result.ok) {
+      return c.json(err("MARKETPLACE_UNAVAILABLE", result.message), result.status);
+    }
+    const knownSkillNames = collectKnownSkillNames(options);
+    const sanitized = sanitizeMarketplaceItem(result.data);
+    if (!isSupportedMarketplaceSkillItem(sanitized, knownSkillNames)) {
+      return c.json(err("NOT_FOUND", "marketplace item not supported by nextclaw"), 404);
+    }
+    return c.json(ok(sanitized));
+  });
+  app.post("/api/marketplace/skills/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 !== "skill") {
+      return c.json(err("INVALID_BODY", "body.type does not match route type"), 400);
+    }
+    try {
+      const payload = await installMarketplaceSkill({
+        options,
+        body: body.data
+      });
+      return c.json(ok(payload));
+    } catch (error) {
+      const message = String(error);
+      if (message.startsWith("INVALID_BODY:")) {
+        return c.json(err("INVALID_BODY", message.slice("INVALID_BODY:".length)), 400);
       }
-      try {
-        const payload = await manageMarketplaceItem({
-          options,
-          body: {
-            ...body.data,
-            type: route.type
-          }
-        });
-        return c.json(ok(payload));
-      } catch (error) {
-        const message = String(error);
-        if (message.startsWith("INVALID_BODY:")) {
-          return c.json(err("INVALID_BODY", message.slice("INVALID_BODY:".length)), 400);
-        }
-        if (message.startsWith("NOT_AVAILABLE:")) {
-          return c.json(err("NOT_AVAILABLE", message.slice("NOT_AVAILABLE:".length)), 503);
-        }
-        return c.json(err("MANAGE_FAILED", message), 400);
+      if (message.startsWith("NOT_AVAILABLE:")) {
+        return c.json(err("NOT_AVAILABLE", message.slice("NOT_AVAILABLE:".length)), 503);
       }
-    });
-    app.get(`/api/marketplace/${route.segment}/recommendations`, async (c) => {
-      const query = c.req.query();
-      const result = await fetchMarketplaceData({
-        baseUrl: marketplaceBaseUrl,
-        path: `/api/v1/${route.segment}/recommendations`,
-        query: {
-          scene: query.scene,
-          limit: query.limit
-        }
+      return c.json(err("INSTALL_FAILED", message), 400);
+    }
+  });
+  app.post("/api/marketplace/skills/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 !== "skill") {
+      return c.json(err("INVALID_BODY", "body.type does not match route type"), 400);
+    }
+    try {
+      const payload = await manageMarketplaceSkill({
+        options,
+        body: body.data
       });
-      if (!result.ok) {
-        return c.json(err("MARKETPLACE_UNAVAILABLE", result.message), result.status);
+      return c.json(ok(payload));
+    } catch (error) {
+      const message = String(error);
+      if (message.startsWith("INVALID_BODY:")) {
+        return c.json(err("INVALID_BODY", message.slice("INVALID_BODY:".length)), 400);
+      }
+      if (message.startsWith("NOT_AVAILABLE:")) {
+        return c.json(err("NOT_AVAILABLE", message.slice("NOT_AVAILABLE:".length)), 503);
+      }
+      return c.json(err("MANAGE_FAILED", message), 400);
+    }
+  });
+  app.get("/api/marketplace/skills/recommendations", async (c) => {
+    const query = c.req.query();
+    const result = await fetchMarketplaceData({
+      baseUrl: marketplaceBaseUrl,
+      path: "/api/v1/skills/recommendations",
+      query: {
+        scene: query.scene,
+        limit: query.limit
       }
-      const knownSkillNames = collectKnownSkillNames(options);
-      const filteredItems = result.data.items.map((item) => sanitizeMarketplaceItem(item)).filter((item) => isSupportedMarketplaceItem(item, knownSkillNames));
-      return c.json(ok({
-        ...result.data,
-        total: filteredItems.length,
-        items: filteredItems
-      }));
     });
-  }
+    if (!result.ok) {
+      return c.json(err("MARKETPLACE_UNAVAILABLE", result.message), result.status);
+    }
+    const knownSkillNames = collectKnownSkillNames(options);
+    const filteredItems = result.data.items.map((item) => sanitizeMarketplaceItem(item)).filter((item) => isSupportedMarketplaceSkillItem(item, knownSkillNames));
+    return c.json(ok({
+      ...result.data,
+      total: filteredItems.length,
+      items: filteredItems
+    }));
+  });
+}
+function registerMarketplaceRoutes(app, options, marketplaceBaseUrl) {
+  registerPluginMarketplaceRoutes(app, options, marketplaceBaseUrl);
+  registerSkillMarketplaceRoutes(app, options, marketplaceBaseUrl);
 }
 function createUiRouter(options) {
   const app = new Hono();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nextclaw/server",
-  "version": "0.5.12",
+  "version": "0.5.14",
   "private": false,
   "description": "Nextclaw UI/API server.",
   "type": "module",
@@ -15,10 +15,10 @@
   ],
   "dependencies": {
     "@hono/node-server": "^1.13.3",
-    "@nextclaw/openclaw-compat": "^0.1.26",
+    "@nextclaw/openclaw-compat": "^0.1.27",
     "hono": "^4.6.2",
     "ws": "^8.18.0",
-    "@nextclaw/core": "^0.6.32"
+    "@nextclaw/core": "^0.6.33"
   },
   "devDependencies": {
     "@types/node": "^20.17.6",