@nextclaw/server 0.4.1 → 0.4.2

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import { Hono } from 'hono';
-import { Config } from '@nextclaw/core';
+import { Config, ConfigActionExecuteRequest as ConfigActionExecuteRequest$1, ConfigActionExecuteResult as ConfigActionExecuteResult$1 } from '@nextclaw/core';
 
 type ApiError = {
     code: string;
@@ -91,9 +91,57 @@ type ConfigUiHints = Record<string, ConfigUiHint>;
 type ConfigSchemaResponse = {
     schema: Record<string, unknown>;
     uiHints: ConfigUiHints;
+    actions: ConfigActionManifest[];
     version: string;
     generatedAt: string;
 };
+type ConfigActionType = "httpProbe" | "oauthStart" | "webhookVerify" | "openUrl" | "copyToken";
+type ConfigActionManifest = {
+    id: string;
+    version: string;
+    scope: string;
+    title: string;
+    description?: string;
+    type: ConfigActionType;
+    trigger: "manual" | "afterSave";
+    requires?: string[];
+    request: {
+        method: "GET" | "POST" | "PUT";
+        path: string;
+        timeoutMs?: number;
+    };
+    success?: {
+        message?: string;
+    };
+    failure?: {
+        message?: string;
+    };
+    saveBeforeRun?: boolean;
+    savePatch?: Record<string, unknown>;
+    resultMap?: Record<string, string>;
+    policy?: {
+        roles?: string[];
+        rateLimitKey?: string;
+        cooldownMs?: number;
+        audit?: boolean;
+    };
+};
+type ConfigActionExecuteRequest = {
+    scope?: string;
+    draftConfig?: Record<string, unknown>;
+    context?: {
+        actor?: string;
+        traceId?: string;
+    };
+};
+type ConfigActionExecuteResult = {
+    ok: boolean;
+    status: "success" | "failed";
+    message: string;
+    data?: Record<string, unknown>;
+    patch?: Record<string, unknown>;
+    nextActions?: string[];
+};
 type UiServerEvent = {
     type: "config.updated";
     payload: {
@@ -134,12 +182,22 @@ type UiRouterOptions = {
 };
 declare function createUiRouter(options: UiRouterOptions): Hono;
 
+type ExecuteActionResult = {
+    ok: true;
+    data: ConfigActionExecuteResult$1;
+} | {
+    ok: false;
+    code: string;
+    message: string;
+    details?: Record<string, unknown>;
+};
 declare function buildConfigView(config: Config): ConfigView;
 declare function buildConfigMeta(config: Config): ConfigMetaView;
 declare function buildConfigSchemaView(_config: Config): ConfigSchemaResponse;
+declare function executeConfigAction(configPath: string, actionId: string, request: ConfigActionExecuteRequest$1): Promise<ExecuteActionResult>;
 declare function loadConfigOrDefault(configPath: string): Config;
 declare function updateModel(configPath: string, model: string): ConfigView;
 declare function updateProvider(configPath: string, providerName: string, patch: ProviderConfigUpdate): ProviderConfigView | null;
 declare function updateChannel(configPath: string, channelName: string, patch: Record<string, unknown>): Record<string, unknown> | null;
 
-export { type ApiError, type ApiResponse, type ChannelSpecView, type ConfigMetaView, type ConfigSchemaResponse, type ConfigUiHint, type ConfigUiHints, type ConfigView, type ProviderConfigUpdate, type ProviderConfigView, type ProviderSpecView, type UiServerEvent, type UiServerHandle, type UiServerOptions, buildConfigMeta, buildConfigSchemaView, buildConfigView, createUiRouter, loadConfigOrDefault, startUiServer, updateChannel, updateModel, updateProvider };
+export { type ApiError, type ApiResponse, 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 UiServerEvent, type UiServerHandle, type UiServerOptions, buildConfigMeta, buildConfigSchemaView, buildConfigView, createUiRouter, executeConfigAction, loadConfigOrDefault, startUiServer, updateChannel, updateModel, updateProvider };

package/dist/index.js

@@ -15,6 +15,7 @@ import {
   loadConfig,
   saveConfig,
   ConfigSchema,
+  probeFeishu,
   PROVIDERS,
   buildConfigSchema,
   findProviderByName,
@@ -80,6 +81,132 @@ function sanitizePublicConfigValue(value, prefix, hints) {
   }
   return output;
 }
+function isObject(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function deepMerge(base, patch) {
+  if (!isObject(base) || !isObject(patch)) {
+    return patch;
+  }
+  const result = { ...base };
+  for (const [key, value] of Object.entries(patch)) {
+    const previous = result[key];
+    result[key] = deepMerge(previous, value);
+  }
+  return result;
+}
+function getPathValue(source, path) {
+  if (!source || typeof source !== "object") {
+    return void 0;
+  }
+  const segments = path.split(".");
+  let current = source;
+  for (const segment of segments) {
+    if (!current || typeof current !== "object") {
+      return void 0;
+    }
+    current = current[segment];
+  }
+  return current;
+}
+function setPathValue(target, path, value) {
+  const segments = path.split(".");
+  if (segments.length === 0) {
+    return;
+  }
+  let current = target;
+  for (let index = 0; index < segments.length - 1; index += 1) {
+    const segment = segments[index];
+    const next = current[segment];
+    if (!isObject(next)) {
+      current[segment] = {};
+    }
+    current = current[segment];
+  }
+  current[segments[segments.length - 1]] = value;
+}
+function isMissingRequiredValue(value) {
+  if (value === void 0 || value === null) {
+    return true;
+  }
+  if (typeof value === "string") {
+    return value.trim().length === 0;
+  }
+  if (Array.isArray(value)) {
+    return value.length === 0;
+  }
+  return false;
+}
+function resolveRuntimeConfig(config, draftConfig) {
+  if (!draftConfig || Object.keys(draftConfig).length === 0) {
+    return config;
+  }
+  const merged = deepMerge(config, draftConfig);
+  return ConfigSchema.parse(merged);
+}
+function getActionById(config, actionId) {
+  const actions = buildConfigSchemaView(config).actions;
+  return actions.find((item) => item.id === actionId) ?? null;
+}
+function messageOrDefault(action, kind, fallback) {
+  const text = kind === "success" ? action.success?.message : action.failure?.message;
+  return text?.trim() ? text : fallback;
+}
+async function runFeishuVerifyAction(params) {
+  const appId = String(params.config.channels.feishu.appId ?? "").trim();
+  const appSecret = String(params.config.channels.feishu.appSecret ?? "").trim();
+  if (!appId || !appSecret) {
+    return {
+      ok: false,
+      status: "failed",
+      message: messageOrDefault(params.action, "failure", "Verification failed: missing credentials"),
+      data: {
+        error: "missing credentials (appId, appSecret)"
+      },
+      nextActions: []
+    };
+  }
+  const result = await probeFeishu(appId, appSecret);
+  if (!result.ok) {
+    return {
+      ok: false,
+      status: "failed",
+      message: `${messageOrDefault(params.action, "failure", "Verification failed")}: ${result.error}`,
+      data: {
+        error: result.error,
+        appId: result.appId ?? appId
+      },
+      nextActions: []
+    };
+  }
+  const responseData = {
+    appId: result.appId,
+    botName: result.botName ?? null,
+    botOpenId: result.botOpenId ?? null
+  };
+  const patch = {};
+  for (const [targetPath, sourcePath] of Object.entries(params.action.resultMap ?? {})) {
+    const mappedValue = sourcePath.startsWith("response.data.") ? responseData[sourcePath.slice("response.data.".length)] : void 0;
+    if (mappedValue !== void 0) {
+      setPathValue(patch, targetPath, mappedValue);
+    }
+  }
+  return {
+    ok: true,
+    status: "success",
+    message: messageOrDefault(
+      params.action,
+      "success",
+      "Verified. Please finish Feishu event subscription and app publishing before using."
+    ),
+    data: responseData,
+    patch: Object.keys(patch).length > 0 ? patch : void 0,
+    nextActions: []
+  };
+}
+var ACTION_HANDLERS = {
+  "channels.feishu.verifyConnection": runFeishuVerifyAction
+};
 function buildUiHints(config) {
   return buildConfigSchemaView(config).uiHints;
 }
@@ -156,6 +283,58 @@ function buildConfigMeta(config) {
 function buildConfigSchemaView(_config) {
   return buildConfigSchema({ version: getPackageVersion() });
 }
+async function executeConfigAction(configPath, actionId, request) {
+  const baseConfig = loadConfigOrDefault(configPath);
+  const action = getActionById(baseConfig, actionId);
+  if (!action) {
+    return {
+      ok: false,
+      code: "ACTION_NOT_FOUND",
+      message: `unknown action: ${actionId}`
+    };
+  }
+  if (request.scope && request.scope !== action.scope) {
+    return {
+      ok: false,
+      code: "ACTION_SCOPE_MISMATCH",
+      message: `scope mismatch: expected ${action.scope}, got ${request.scope}`,
+      details: {
+        expectedScope: action.scope,
+        requestScope: request.scope
+      }
+    };
+  }
+  const runtimeConfig = resolveRuntimeConfig(baseConfig, request.draftConfig);
+  for (const requiredPath of action.requires ?? []) {
+    const requiredValue = getPathValue(runtimeConfig, requiredPath);
+    if (isMissingRequiredValue(requiredValue)) {
+      return {
+        ok: false,
+        code: "ACTION_PRECONDITION_FAILED",
+        message: `required field missing: ${requiredPath}`,
+        details: {
+          path: requiredPath
+        }
+      };
+    }
+  }
+  const handler = ACTION_HANDLERS[action.id];
+  if (!handler) {
+    return {
+      ok: false,
+      code: "ACTION_EXECUTION_FAILED",
+      message: `action handler not found for type ${action.type}`
+    };
+  }
+  const result = await handler({
+    config: runtimeConfig,
+    action
+  });
+  return {
+    ok: true,
+    data: result
+  };
+}
 function loadConfigOrDefault(configPath) {
   return loadConfig(configPath);
 }
@@ -209,7 +388,6 @@ function updateChannel(configPath, channelName, patch) {
 }
 
 // src/ui/router.ts
-import { probeFeishu } from "@nextclaw/core";
 function ok(data) {
   return { ok: true, data };
 }
@@ -275,23 +453,17 @@ function createUiRouter(options) {
     options.publish({ type: "config.updated", payload: { path: `channels.${channel}` } });
     return c.json(ok(result));
   });
-  app.post("/api/channels/feishu/probe", async (c) => {
-    const config = loadConfigOrDefault(options.configPath);
-    const feishu = config.channels.feishu;
-    if (!feishu?.appId || !feishu?.appSecret) {
-      return c.json(err("MISSING_CREDENTIALS", "Feishu appId/appSecret not configured"), 400);
+  app.post("/api/config/actions/:actionId/execute", async (c) => {
+    const actionId = c.req.param("actionId");
+    const body = await readJson(c.req.raw);
+    if (!body.ok) {
+      return c.json(err("INVALID_BODY", "invalid json body"), 400);
     }
-    const result = await probeFeishu(String(feishu.appId), String(feishu.appSecret));
+    const result = await executeConfigAction(options.configPath, actionId, body.data ?? {});
     if (!result.ok) {
-      return c.json(err("PROBE_FAILED", result.error), 400);
+      return c.json(err(result.code, result.message, result.details), 400);
     }
-    return c.json(
-      ok({
-        appId: result.appId,
-        botName: result.botName ?? null,
-        botOpenId: result.botOpenId ?? null
-      })
-    );
+    return c.json(ok(result.data));
   });
   return app;
 }
@@ -388,6 +560,7 @@ export {
   buildConfigSchemaView,
   buildConfigView,
   createUiRouter,
+  executeConfigAction,
   loadConfigOrDefault,
   startUiServer,
   updateChannel,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nextclaw/server",
-  "version": "0.4.1",
+  "version": "0.4.2",
   "private": false,
   "description": "Nextclaw UI/API server.",
   "type": "module",
@@ -17,7 +17,7 @@
     "@hono/node-server": "^1.13.3",
     "hono": "^4.6.2",
     "ws": "^8.18.0",
-    "@nextclaw/core": "^0.6.1"
+    "@nextclaw/core": "^0.6.5"
   },
   "devDependencies": {
     "@types/node": "^20.17.6",