@nextclaw/server 0.4.16 → 0.4.17

package/dist/index.d.ts

@@ -214,6 +214,98 @@ type ConfigActionExecuteResult = {
     patch?: Record<string, unknown>;
     nextActions?: string[];
 };
+type MarketplaceItemType = "plugin" | "skill";
+type MarketplaceSort = "relevance" | "updated" | "downloads";
+type MarketplaceInstallKind = "npm" | "clawhub" | "git";
+type MarketplaceInstallSpec = {
+    kind: MarketplaceInstallKind;
+    spec: string;
+    command: string;
+};
+type MarketplaceItemMetrics = {
+    downloads30d?: number;
+    stars?: number;
+};
+type MarketplaceItemSummary = {
+    id: string;
+    slug: string;
+    type: MarketplaceItemType;
+    name: string;
+    summary: string;
+    tags: string[];
+    author: string;
+    install: MarketplaceInstallSpec;
+    metrics?: MarketplaceItemMetrics;
+    updatedAt: string;
+};
+type MarketplaceItemView = MarketplaceItemSummary & {
+    description?: string;
+    sourceRepo?: string;
+    homepage?: string;
+    publishedAt: string;
+};
+type MarketplaceListView = {
+    total: number;
+    page: number;
+    pageSize: number;
+    totalPages: number;
+    sort: MarketplaceSort;
+    query?: string;
+    items: MarketplaceItemSummary[];
+};
+type MarketplaceRecommendationView = {
+    sceneId: string;
+    title: string;
+    description?: string;
+    total: number;
+    items: MarketplaceItemSummary[];
+};
+type MarketplaceInstalledRecord = {
+    type: MarketplaceItemType;
+    spec: string;
+    label?: string;
+    source?: string;
+    installedAt?: string;
+};
+type MarketplaceInstalledView = {
+    total: number;
+    pluginSpecs: string[];
+    skillSpecs: string[];
+    records: MarketplaceInstalledRecord[];
+};
+type MarketplaceInstallRequest = {
+    type: MarketplaceItemType;
+    spec: string;
+    version?: string;
+    registry?: string;
+    force?: boolean;
+};
+type MarketplaceInstallResult = {
+    type: MarketplaceItemType;
+    spec: string;
+    message: string;
+    output?: string;
+};
+type MarketplaceInstallSkillParams = {
+    slug: string;
+    version?: string;
+    registry?: string;
+    force?: boolean;
+};
+type MarketplaceInstaller = {
+    installPlugin?: (spec: string) => Promise<{
+        message: string;
+        output?: string;
+    }>;
+    installSkill?: (params: MarketplaceInstallSkillParams) => Promise<{
+        message: string;
+        output?: string;
+    }>;
+};
+type MarketplaceApiConfig = {
+    apiBaseUrl?: string;
+    installer?: MarketplaceInstaller;
+};
 type UiServerEvent = {
     type: "config.updated";
     payload: {
@@ -238,6 +330,7 @@ type UiServerOptions = {
     configPath: string;
     corsOrigins?: string[] | "*";
     staticDir?: string;
+    marketplace?: MarketplaceApiConfig;
 };
 type UiServerHandle = {
     host: string;
@@ -251,6 +344,7 @@ declare function startUiServer(options: UiServerOptions): UiServerHandle;
 type UiRouterOptions = {
     configPath: string;
     publish: (event: UiServerEvent) => void;
+    marketplace?: MarketplaceApiConfig;
 };
 declare function createUiRouter(options: UiRouterOptions): Hono;
 
@@ -284,4 +378,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 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 MarketplaceApiConfig, type MarketplaceInstallKind, type MarketplaceInstallRequest, type MarketplaceInstallResult, type MarketplaceInstallSkillParams, type MarketplaceInstallSpec, type MarketplaceInstalledRecord, type MarketplaceInstalledView, type MarketplaceInstaller, type MarketplaceItemMetrics, type MarketplaceItemSummary, type MarketplaceItemType, type MarketplaceItemView, type MarketplaceListView, 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 };

package/dist/index.js

@@ -3,12 +3,13 @@ import { Hono as Hono2 } from "hono";
 import { cors } from "hono/cors";
 import { serve } from "@hono/node-server";
 import { WebSocketServer, WebSocket } from "ws";
-import { existsSync, readFileSync } from "fs";
+import { existsSync as existsSync2, readFileSync } from "fs";
 import { readFile, stat } from "fs/promises";
-import { join } from "path";
+import { join as join2 } from "path";
 
 // src/ui/router.ts
 import { Hono } from "hono";
+import { expandHome } from "@nextclaw/core";
 
 // src/ui/config.ts
 import {
@@ -568,6 +569,9 @@ function updateRuntime(configPath, patch) {
 }
 
 // src/ui/router.ts
+import { existsSync, readdirSync } from "fs";
+import { join, resolve } from "path";
+var DEFAULT_MARKETPLACE_API_BASE = "https://nextclaw-marketplace-api.15353764479037.workers.dev";
 function ok(data) {
   return { ok: true, data };
 }
@@ -582,8 +586,251 @@ async function readJson(req) {
     return { ok: false };
   }
 }
+function isRecord(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function readErrorMessage(value, fallback) {
+  if (!isRecord(value)) {
+    return fallback;
+  }
+  const maybeError = value.error;
+  if (!isRecord(maybeError)) {
+    return fallback;
+  }
+  return typeof maybeError.message === "string" && maybeError.message.trim().length > 0 ? maybeError.message : fallback;
+}
+function normalizeMarketplaceBaseUrl(options) {
+  const fromOptions = options.marketplace?.apiBaseUrl?.trim();
+  const fromEnv = process.env.NEXTCLAW_MARKETPLACE_API_BASE?.trim();
+  const value = fromOptions || fromEnv || DEFAULT_MARKETPLACE_API_BASE;
+  return value.endsWith("/") ? value.slice(0, -1) : value;
+}
+function toMarketplaceUrl(baseUrl, path, query = {}) {
+  const url = new URL(path, `${baseUrl}/`);
+  for (const [key, value] of Object.entries(query)) {
+    if (typeof value === "string" && value.trim().length > 0) {
+      url.searchParams.set(key, value);
+    }
+  }
+  return url.toString();
+}
+async function fetchMarketplaceData(params) {
+  const url = toMarketplaceUrl(params.baseUrl, params.path, params.query ?? {});
+  try {
+    const response = await fetch(url, {
+      method: "GET",
+      headers: {
+        Accept: "application/json"
+      }
+    });
+    let payload = null;
+    try {
+      payload = await response.json();
+    } catch {
+      payload = null;
+    }
+    if (!response.ok) {
+      return {
+        ok: false,
+        status: response.status,
+        message: readErrorMessage(payload, `marketplace request failed: ${response.status}`)
+      };
+    }
+    if (!isRecord(payload) || payload.ok !== true || !Object.prototype.hasOwnProperty.call(payload, "data")) {
+      return {
+        ok: false,
+        status: 502,
+        message: "invalid marketplace response"
+      };
+    }
+    return {
+      ok: true,
+      data: payload.data
+    };
+  } catch (error) {
+    return {
+      ok: false,
+      status: 502,
+      message: `marketplace fetch failed: ${String(error)}`
+    };
+  }
+}
+function collectMarketplaceInstalledView(options) {
+  const config = loadConfigOrDefault(options.configPath);
+  const pluginRecordsMap = config.plugins.installs ?? {};
+  const pluginRecords = [];
+  const pluginSpecSet = /* @__PURE__ */ new Set();
+  for (const [pluginId, installRecord] of Object.entries(pluginRecordsMap)) {
+    const normalizedSpec = typeof installRecord.spec === "string" && installRecord.spec.trim().length > 0 ? installRecord.spec.trim() : pluginId;
+    pluginRecords.push({
+      type: "plugin",
+      spec: normalizedSpec,
+      label: pluginId,
+      source: installRecord.source,
+      installedAt: installRecord.installedAt
+    });
+    pluginSpecSet.add(normalizedSpec);
+  }
+  const pluginEntries = config.plugins.entries ?? {};
+  for (const pluginId of Object.keys(pluginEntries)) {
+    if (!pluginSpecSet.has(pluginId)) {
+      pluginRecords.push({
+        type: "plugin",
+        spec: pluginId,
+        label: pluginId,
+        source: "config"
+      });
+      pluginSpecSet.add(pluginId);
+    }
+  }
+  const workspacePath = resolve(expandHome(config.agents.defaults.workspace));
+  const skillsPath = join(workspacePath, "skills");
+  const skillSpecSet = /* @__PURE__ */ new Set();
+  const skillRecords = [];
+  if (existsSync(skillsPath)) {
+    const entries = readdirSync(skillsPath, { withFileTypes: true });
+    for (const entry of entries) {
+      if (!entry.isDirectory()) {
+        continue;
+      }
+      const skillSlug = entry.name;
+      const skillFile = join(skillsPath, skillSlug, "SKILL.md");
+      if (!existsSync(skillFile)) {
+        continue;
+      }
+      skillRecords.push({
+        type: "skill",
+        spec: skillSlug,
+        label: skillSlug,
+        source: "workspace"
+      });
+      skillSpecSet.add(skillSlug);
+    }
+  }
+  const records = [...pluginRecords, ...skillRecords].sort((left, right) => {
+    if (left.type !== right.type) {
+      return left.type.localeCompare(right.type);
+    }
+    return left.spec.localeCompare(right.spec);
+  });
+  return {
+    total: records.length,
+    pluginSpecs: Array.from(pluginSpecSet).sort((left, right) => left.localeCompare(right)),
+    skillSpecs: Array.from(skillSpecSet).sort((left, right) => left.localeCompare(right)),
+    records
+  };
+}
+async function installMarketplaceItem(params) {
+  const type = params.body.type;
+  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");
+  }
+  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,
+      version: params.body.version,
+      registry: params.body.registry,
+      force: params.body.force
+    });
+  }
+  params.options.publish({ type: "config.updated", payload: { path: type === "plugin" ? "plugins" : "skills" } });
+  return {
+    type,
+    spec,
+    message: result.message,
+    output: result.output
+  };
+}
+function registerMarketplaceRoutes(app, options, marketplaceBaseUrl) {
+  app.get("/api/marketplace/installed", (c) => {
+    return c.json(ok(collectMarketplaceInstalledView(options)));
+  });
+  app.get("/api/marketplace/items", async (c) => {
+    const query = c.req.query();
+    const result = await fetchMarketplaceData({
+      baseUrl: marketplaceBaseUrl,
+      path: "/api/v1/items",
+      query: {
+        q: query.q,
+        type: query.type,
+        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);
+    }
+    return c.json(ok(result.data));
+  });
+  app.get("/api/marketplace/items/:slug", async (c) => {
+    const slug = encodeURIComponent(c.req.param("slug"));
+    const type = c.req.query("type");
+    const result = await fetchMarketplaceData({
+      baseUrl: marketplaceBaseUrl,
+      path: `/api/v1/items/${slug}`,
+      query: {
+        type
+      }
+    });
+    if (!result.ok) {
+      return c.json(err("MARKETPLACE_UNAVAILABLE", result.message), result.status);
+    }
+    return c.json(ok(result.data));
+  });
+  app.get("/api/marketplace/recommendations", async (c) => {
+    const query = c.req.query();
+    const result = await fetchMarketplaceData({
+      baseUrl: marketplaceBaseUrl,
+      path: "/api/v1/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));
+  });
+  app.post("/api/marketplace/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);
+    }
+    try {
+      const payload = await installMarketplaceItem({ 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 (message.startsWith("NOT_AVAILABLE:")) {
+        return c.json(err("NOT_AVAILABLE", message.slice("NOT_AVAILABLE:".length)), 503);
+      }
+      return c.json(err("INSTALL_FAILED", message), 400);
+    }
+  });
+}
 function createUiRouter(options) {
   const app = new Hono();
+  const marketplaceBaseUrl = normalizeMarketplaceBaseUrl(options);
   app.notFound((c) => c.json(err("NOT_FOUND", "endpoint not found"), 404));
   app.get("/api/health", (c) => c.json(ok({ status: "ok" })));
   app.get("/api/config", (c) => {
@@ -719,6 +966,7 @@ function createUiRouter(options) {
     }
     return c.json(ok(result.data));
   });
+  registerMarketplaceRoutes(app, options, marketplaceBaseUrl);
   return app;
 }
 
@@ -750,17 +998,18 @@ function startUiServer(options) {
     "/",
     createUiRouter({
       configPath: options.configPath,
-      publish
+      publish,
+      marketplace: options.marketplace
     })
   );
   const staticDir = options.staticDir;
-  if (staticDir && existsSync(join(staticDir, "index.html"))) {
-    const indexHtml = readFileSync(join(staticDir, "index.html"), "utf-8");
+  if (staticDir && existsSync2(join2(staticDir, "index.html"))) {
+    const indexHtml = readFileSync(join2(staticDir, "index.html"), "utf-8");
     app.use(
       "/*",
       serveStatic({
         root: staticDir,
-        join,
+        join: join2,
         getContent: async (path) => {
           try {
             return await readFile(path);
@@ -802,9 +1051,9 @@ function startUiServer(options) {
     host: options.host,
     port: options.port,
     publish,
-    close: () => new Promise((resolve) => {
+    close: () => new Promise((resolve2) => {
       wss.close(() => {
-        server.close(() => resolve());
+        server.close(() => resolve2());
       });
     })
   };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nextclaw/server",
-  "version": "0.4.16",
+  "version": "0.4.17",
   "private": false,
   "description": "Nextclaw UI/API server.",
   "type": "module",