@lark-apaas/miaoda-cli 0.1.0-alpha.c783fb5

package/dist/cli/handlers/plugin/index.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.handlePluginListPlugins = exports.handlePluginList = exports.handlePluginInit = exports.handlePluginRemove = exports.handlePluginUpdate = exports.handlePluginInstall = void 0;
+var plugin_1 = require("./plugin");
+Object.defineProperty(exports, "handlePluginInstall", { enumerable: true, get: function () { return plugin_1.handlePluginInstall; } });
+Object.defineProperty(exports, "handlePluginUpdate", { enumerable: true, get: function () { return plugin_1.handlePluginUpdate; } });
+Object.defineProperty(exports, "handlePluginRemove", { enumerable: true, get: function () { return plugin_1.handlePluginRemove; } });
+Object.defineProperty(exports, "handlePluginInit", { enumerable: true, get: function () { return plugin_1.handlePluginInit; } });
+Object.defineProperty(exports, "handlePluginList", { enumerable: true, get: function () { return plugin_1.handlePluginList; } });
+Object.defineProperty(exports, "handlePluginListPlugins", { enumerable: true, get: function () { return plugin_1.handlePluginListPlugins; } });

package/dist/cli/handlers/plugin/plugin-local.js

@@ -0,0 +1,382 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getProjectRoot = getProjectRoot;
+exports.getPluginPath = getPluginPath;
+exports.parsePluginName = parsePluginName;
+exports.readActionPlugins = readActionPlugins;
+exports.writeActionPlugins = writeActionPlugins;
+exports.isPluginInstalled = isPluginInstalled;
+exports.getInstalledPluginVersion = getInstalledPluginVersion;
+exports.getPackageVersion = getPackageVersion;
+exports.readPluginPackageJson = readPluginPackageJson;
+exports.extractTgzToNodeModules = extractTgzToNodeModules;
+exports.checkMissingPeerDeps = checkMissingPeerDeps;
+exports.installMissingDeps = installMissingDeps;
+exports.npmInstall = npmInstall;
+exports.removePluginDirectory = removePluginDirectory;
+exports.capabilitiesDirExists = capabilitiesDirExists;
+exports.readCapability = readCapability;
+exports.readAllCapabilities = readAllCapabilities;
+exports.hydrateCapability = hydrateCapability;
+const node_fs_1 = __importDefault(require("node:fs"));
+const node_path_1 = __importDefault(require("node:path"));
+const node_child_process_1 = require("node:child_process");
+const node_module_1 = require("node:module");
+const error_1 = require("../../../utils/error");
+const logger_1 = require("../../../utils/logger");
+// ── Project paths ──
+function getProjectRoot() {
+    return process.cwd();
+}
+function getPackageJsonPath() {
+    return node_path_1.default.join(getProjectRoot(), "package.json");
+}
+function getPluginPath(pluginName) {
+    return node_path_1.default.join(getProjectRoot(), "node_modules", pluginName);
+}
+// ── Plugin name parsing ──
+function parsePluginName(input) {
+    const match = /^(@[^/]+\/[^@]+)(?:@(.+))?$/.exec(input);
+    if (!match) {
+        throw new error_1.AppError("INVALID_PLUGIN_NAME", `Invalid plugin name format: ${input}. Expected: @scope/name or @scope/name@version`, { next_actions: ["示例：@demo/example-plugin 或 @demo/example-plugin@1.2.3"] });
+    }
+    return { name: match[1], version: match[2] ?? "latest" };
+}
+// ── package.json actionPlugins CRUD ──
+function readPackageJson() {
+    const pkgPath = getPackageJsonPath();
+    if (!node_fs_1.default.existsSync(pkgPath)) {
+        throw new error_1.AppError("PKG_JSON_NOT_FOUND", "package.json not found in current directory", { next_actions: ["在应用项目根目录运行"] });
+    }
+    const content = node_fs_1.default.readFileSync(pkgPath, "utf-8");
+    return JSON.parse(content);
+}
+function writePackageJson(pkg) {
+    const pkgPath = getPackageJsonPath();
+    node_fs_1.default.writeFileSync(pkgPath, JSON.stringify(pkg, null, 2) + "\n", "utf-8");
+}
+function readActionPlugins() {
+    const pkg = readPackageJson();
+    return pkg.actionPlugins ?? {};
+}
+function writeActionPlugins(plugins) {
+    const pkg = readPackageJson();
+    pkg.actionPlugins = plugins;
+    writePackageJson(pkg);
+}
+function isPluginInstalled(pluginName) {
+    const plugins = readActionPlugins();
+    return pluginName in plugins;
+}
+function getInstalledPluginVersion(pluginName) {
+    const plugins = readActionPlugins();
+    return plugins[pluginName] ?? null;
+}
+// ── node_modules operations ──
+function getPackageVersion(pluginName) {
+    const pkgJsonPath = node_path_1.default.join(getPluginPath(pluginName), "package.json");
+    if (!node_fs_1.default.existsSync(pkgJsonPath))
+        return null;
+    try {
+        const content = node_fs_1.default.readFileSync(pkgJsonPath, "utf-8");
+        const pkg = JSON.parse(content);
+        return pkg.version ?? null;
+    }
+    catch {
+        return null;
+    }
+}
+function readPluginPackageJson(pluginPath) {
+    const pkgJsonPath = node_path_1.default.join(pluginPath, "package.json");
+    if (!node_fs_1.default.existsSync(pkgJsonPath))
+        return null;
+    try {
+        const content = node_fs_1.default.readFileSync(pkgJsonPath, "utf-8");
+        return JSON.parse(content);
+    }
+    catch {
+        return null;
+    }
+}
+function extractTgzToNodeModules(tgzPath, pluginName) {
+    const nodeModulesPath = node_path_1.default.join(getProjectRoot(), "node_modules");
+    const targetDir = node_path_1.default.join(nodeModulesPath, pluginName);
+    const scopeDir = node_path_1.default.dirname(targetDir);
+    if (!node_fs_1.default.existsSync(scopeDir)) {
+        node_fs_1.default.mkdirSync(scopeDir, { recursive: true });
+    }
+    if (node_fs_1.default.existsSync(targetDir)) {
+        node_fs_1.default.rmSync(targetDir, { recursive: true });
+    }
+    const tempDir = node_path_1.default.join(nodeModulesPath, ".cache", "miaoda-cli", "extract-temp");
+    if (node_fs_1.default.existsSync(tempDir)) {
+        node_fs_1.default.rmSync(tempDir, { recursive: true });
+    }
+    node_fs_1.default.mkdirSync(tempDir, { recursive: true });
+    try {
+        (0, node_child_process_1.execSync)(`tar -xzf "${tgzPath}" -C "${tempDir}"`, { stdio: "pipe" });
+        const extractedDir = node_path_1.default.join(tempDir, "package");
+        if (node_fs_1.default.existsSync(extractedDir)) {
+            node_fs_1.default.renameSync(extractedDir, targetDir);
+        }
+        else {
+            const files = node_fs_1.default.readdirSync(tempDir);
+            if (files.length === 1) {
+                node_fs_1.default.renameSync(node_path_1.default.join(tempDir, files[0]), targetDir);
+            }
+            else {
+                throw new error_1.AppError("INTERNAL_EXTRACT_FAILED", "Unexpected tgz structure");
+            }
+        }
+        return targetDir;
+    }
+    finally {
+        if (node_fs_1.default.existsSync(tempDir)) {
+            node_fs_1.default.rmSync(tempDir, { recursive: true });
+        }
+    }
+}
+function checkMissingPeerDeps(peerDeps) {
+    if (!peerDeps || Object.keys(peerDeps).length === 0)
+        return [];
+    const missing = [];
+    const nodeModulesPath = node_path_1.default.join(getProjectRoot(), "node_modules");
+    for (const depName of Object.keys(peerDeps)) {
+        const depPath = node_path_1.default.join(nodeModulesPath, depName);
+        if (!node_fs_1.default.existsSync(depPath)) {
+            missing.push(depName);
+        }
+    }
+    return missing;
+}
+function installMissingDeps(deps) {
+    if (deps.length === 0)
+        return;
+    (0, logger_1.log)("plugin", `Installing missing dependencies: ${deps.join(", ")}`);
+    const result = (0, node_child_process_1.spawnSync)("npm", ["install", ...deps, "--no-save", "--no-package-lock"], { cwd: getProjectRoot(), stdio: "inherit" });
+    if (result.error) {
+        throw new error_1.AppError("INTERNAL_NPM_FAILED", `npm install failed: ${result.error.message}`, { next_actions: ["确认本机已安装 npm，可 --verbose 查看执行详情"] });
+    }
+    if (result.status !== 0) {
+        throw new error_1.AppError("INTERNAL_NPM_FAILED", `npm install failed with exit code ${String(result.status)}`, { next_actions: ["检查上方 npm 输出日志定位具体错误"] });
+    }
+}
+function npmInstall(tgzPath) {
+    const result = (0, node_child_process_1.spawnSync)("npm", ["install", tgzPath, "--no-save", "--no-package-lock", "--ignore-scripts"], { cwd: getProjectRoot(), stdio: "inherit" });
+    if (result.error) {
+        throw new error_1.AppError("INTERNAL_NPM_FAILED", `npm install failed: ${result.error.message}`, { next_actions: ["确认本机已安装 npm，可 --verbose 查看执行详情"] });
+    }
+    if (result.status !== 0) {
+        throw new error_1.AppError("INTERNAL_NPM_FAILED", `npm install failed with exit code ${String(result.status)}`, { next_actions: ["检查上方 npm 输出日志定位具体错误"] });
+    }
+}
+function removePluginDirectory(pluginName) {
+    const pluginPath = getPluginPath(pluginName);
+    if (node_fs_1.default.existsSync(pluginPath)) {
+        node_fs_1.default.rmSync(pluginPath, { recursive: true });
+    }
+}
+// ── Capability FS ──
+const CAPABILITIES_DIR = "server/capabilities";
+function getCapabilitiesDir() {
+    return node_path_1.default.join(getProjectRoot(), CAPABILITIES_DIR);
+}
+function capabilitiesDirExists() {
+    return node_fs_1.default.existsSync(getCapabilitiesDir());
+}
+function listCapabilityIds() {
+    const dir = getCapabilitiesDir();
+    if (!node_fs_1.default.existsSync(dir))
+        return [];
+    const files = node_fs_1.default.readdirSync(dir);
+    return files
+        .filter((f) => f.endsWith(".json") && f !== "capabilities.json")
+        .map((f) => f.replace(/\.json$/, ""));
+}
+function readCapability(id) {
+    const filePath = node_path_1.default.join(getCapabilitiesDir(), `${id}.json`);
+    if (!node_fs_1.default.existsSync(filePath)) {
+        throw new error_1.AppError("CAPABILITY_NOT_FOUND", `Capability not found: ${id}`, { next_actions: ["运行 miaoda plugin list 查看所有可用 capability id"] });
+    }
+    try {
+        const content = node_fs_1.default.readFileSync(filePath, "utf-8");
+        return JSON.parse(content);
+    }
+    catch (error) {
+        if (error instanceof SyntaxError) {
+            throw new error_1.AppError("INVALID_JSON", `Invalid JSON in capability file: ${id}.json`, { next_actions: [`检查 server/capabilities/${id}.json 的 JSON 语法`] });
+        }
+        throw error;
+    }
+}
+function readAllCapabilities() {
+    const ids = listCapabilityIds();
+    const capabilities = [];
+    for (const id of ids) {
+        try {
+            const cap = readCapability(id);
+            if (!cap.pluginKey)
+                continue;
+            capabilities.push(cap);
+        }
+        catch {
+            continue;
+        }
+    }
+    return capabilities;
+}
+// ── Capability Hydration ──
+function getPluginManifestPath(pluginKey) {
+    return node_path_1.default.join(getProjectRoot(), "node_modules", pluginKey, "manifest.json");
+}
+function readPluginManifest(pluginKey) {
+    const manifestPath = getPluginManifestPath(pluginKey);
+    if (!node_fs_1.default.existsSync(manifestPath)) {
+        throw new error_1.AppError("MANIFEST_NOT_FOUND", `Plugin not installed: ${pluginKey} (manifest.json not found)`, { next_actions: [`运行 miaoda plugin install ${pluginKey}`] });
+    }
+    try {
+        const content = node_fs_1.default.readFileSync(manifestPath, "utf-8");
+        return JSON.parse(content);
+    }
+    catch (error) {
+        if (error instanceof SyntaxError) {
+            throw new error_1.AppError("INVALID_JSON", `Invalid JSON in plugin manifest: ${pluginKey}/manifest.json`, { next_actions: [`检查 node_modules/${pluginKey}/manifest.json 的 JSON 语法`] });
+        }
+        throw error;
+    }
+}
+function isDynamicSchema(schema) {
+    return (schema !== undefined &&
+        typeof schema === "object" &&
+        "dynamic" in schema &&
+        schema.dynamic === true);
+}
+function hasValidParamsSchema(paramsSchema) {
+    return paramsSchema !== undefined && Object.keys(paramsSchema).length > 0;
+}
+async function loadPlugin(pluginKey) {
+    try {
+        const userRequire = (0, node_module_1.createRequire)(node_path_1.default.join(getProjectRoot(), "package.json"));
+        const resolvedPath = userRequire.resolve(pluginKey);
+        const pluginModule = (await Promise.resolve(`${resolvedPath}`).then(s => __importStar(require(s))));
+        const pluginPackage = (pluginModule.default ?? pluginModule);
+        if (typeof pluginPackage.create !== "function") {
+            throw new error_1.AppError("INTERNAL_PLUGIN_LOAD_FAILED", `Plugin ${pluginKey} does not export a valid create function`, { next_actions: [`该插件包版本可能过旧，尝试 miaoda plugin update ${pluginKey}`] });
+        }
+        return pluginPackage;
+    }
+    catch (error) {
+        if (error.code === "MODULE_NOT_FOUND") {
+            throw new error_1.AppError("PLUGIN_NOT_FOUND", `Plugin not installed: ${pluginKey}`, { next_actions: [`运行 miaoda plugin install ${pluginKey}`] });
+        }
+        throw new error_1.AppError("INTERNAL_PLUGIN_LOAD_FAILED", `Failed to load plugin ${pluginKey}: ${error instanceof Error ? error.message : String(error)}`);
+    }
+}
+async function hydrateCapability(capability) {
+    try {
+        const manifest = readPluginManifest(capability.pluginKey);
+        if (manifest.actions.length === 0) {
+            throw new error_1.AppError("INTERNAL_PLUGIN_LOAD_FAILED", `Plugin ${capability.pluginKey} has no actions defined`);
+        }
+        const hasDynamic = manifest.actions.some((action) => isDynamicSchema(action.inputSchema) ||
+            isDynamicSchema(action.outputSchema));
+        let pluginInstance = null;
+        if (hasDynamic) {
+            const plugin = await loadPlugin(capability.pluginKey);
+            pluginInstance = plugin.create(capability.formValue);
+        }
+        const actions = [];
+        for (let index = 0; index < manifest.actions.length; index++) {
+            const manifestAction = manifest.actions[index];
+            // inputSchema
+            let inputSchema;
+            if (index === 0 && hasValidParamsSchema(capability.paramsSchema)) {
+                inputSchema = capability.paramsSchema;
+            }
+            else if (isDynamicSchema(manifestAction.inputSchema)) {
+                if (!pluginInstance) {
+                    throw new error_1.AppError("INTERNAL_SCHEMA_ERROR", "Plugin instance not available for dynamic schema");
+                }
+                const jsonSchema = pluginInstance.getInputJsonSchema(manifestAction.key);
+                if (!jsonSchema) {
+                    throw new error_1.AppError("INTERNAL_SCHEMA_ERROR", `Failed to get input schema for action: ${manifestAction.key}`, { next_actions: [`检查插件 ${capability.pluginKey} 的 getInputJsonSchema 实现`] });
+                }
+                inputSchema = jsonSchema;
+            }
+            else {
+                inputSchema = manifestAction.inputSchema;
+            }
+            // outputSchema
+            let outputSchema;
+            if (isDynamicSchema(manifestAction.outputSchema)) {
+                if (!pluginInstance) {
+                    throw new error_1.AppError("INTERNAL_SCHEMA_ERROR", "Plugin instance not available for dynamic schema");
+                }
+                const jsonSchema = pluginInstance.getOutputJsonSchema(manifestAction.key, capability.formValue);
+                if (!jsonSchema) {
+                    throw new error_1.AppError("INTERNAL_SCHEMA_ERROR", `Failed to get output schema for action: ${manifestAction.key}`, { next_actions: [`检查插件 ${capability.pluginKey} 的 getOutputJsonSchema 实现`] });
+                }
+                outputSchema = jsonSchema;
+            }
+            else {
+                outputSchema = manifestAction.outputSchema;
+            }
+            actions.push({
+                key: manifestAction.key,
+                inputSchema,
+                outputSchema,
+                outputMode: manifestAction.outputMode || "",
+            });
+        }
+        return {
+            id: capability.id,
+            pluginKey: capability.pluginKey,
+            pluginVersion: capability.pluginVersion,
+            name: capability.name,
+            description: capability.description,
+            actions,
+            createdAt: capability.createdAt,
+            updatedAt: capability.updatedAt,
+        };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        return { ...capability, _hydrateError: message };
+    }
+}