nextclaw 0.33.1 → 0.34.0

package/dist/cli/app/index.js

@@ -7,11 +7,13 @@ import { constants, existsSync, mkdirSync, readFileSync, writeFileSync } from "n
 import { randomBytes } from "node:crypto";
 import { execFile } from "node:child_process";
 import path, { join, resolve } from "node:path";
+import { tmpdir } from "node:os";
 import "@nextclaw/server";
 import { NextclawDistributionService, NextclawServiceRuntime, readLearningLoopRuntimeConfig } from "@nextclaw/service";
+import { access, mkdtemp, readFile, rm, stat } from "node:fs/promises";
 import { McpServiceAppRuntimeService, buildServiceActionId, getServiceAppManifestPath, mergeServiceAppRuntimeActions, readServiceAppManifest } from "@nextclaw/kernel";
-import { access, readFile, stat } from "node:fs/promises";
 import { promisify } from "node:util";
+import { AppPublishService, AppPublishValidationService } from "@nextclaw/app-runtime";
 var __commonJSMin = (cb, mod) => () => (mod || cb((mod = { exports: {} }).exports, mod), mod.exports);
 var __require = /* @__PURE__ */ createRequire(import.meta.url);
 //#endregion
@@ -3641,13 +3643,14 @@ var ServiceAppDevService = class {
 		if (!loaded) return this.buildDevReport(appPath, void 0, [], issues);
 		if (this.hasErrors(issues)) return this.buildDevReport(appPath, this.toServiceAppRecord(appPath, loaded.manifest, this.idleRuntimeStatus), [], issues);
 		const runtime = this.createRuntimeService();
+		const dataDirectory = await this.createDevDataDirectory();
 		try {
-			const startRecord = this.toServiceAppRecord(appPath, loaded.manifest, runtime);
+			const startRecord = this.toServiceAppRecord(appPath, loaded.manifest, runtime, dataDirectory);
 			const runtimeActions = await runtime.listActions({
 				app: startRecord,
 				manifest: loaded.manifest
 			});
-			const record = this.toServiceAppRecord(appPath, loaded.manifest, runtime);
+			const record = this.toServiceAppRecord(appPath, loaded.manifest, runtime, dataDirectory);
 			const actions = mergeServiceAppRuntimeActions({
 				record,
 				manifest: loaded.manifest,
@@ -3656,7 +3659,14 @@ var ServiceAppDevService = class {
 			this.collectRuntimeIssues(record, actions, issues);
 			return this.buildDevReport(appPath, record, actions, issues);
 		} finally {
-			await runtime.dispose();
+			try {
+				await runtime.dispose();
+			} finally {
+				await rm(dataDirectory, {
+					recursive: true,
+					force: true
+				});
+			}
 		}
 	};
 	call = async (target, actionName, input) => {
@@ -3676,18 +3686,19 @@ var ServiceAppDevService = class {
 			return this.buildCallReport(appPath, record, void 0, void 0, issues);
 		}
 		const runtime = this.createRuntimeService();
+		const dataDirectory = await this.createDevDataDirectory();
 		try {
-			const record = this.toServiceAppRecord(appPath, loaded.manifest, runtime);
+			const record = this.toServiceAppRecord(appPath, loaded.manifest, runtime, dataDirectory);
 			const result = await runtime.invokeAction({
 				app: record,
 				manifest: loaded.manifest,
 				actionName: action,
 				input
 			});
-			const nextRecord = this.toServiceAppRecord(appPath, loaded.manifest, runtime);
+			const nextRecord = this.toServiceAppRecord(appPath, loaded.manifest, runtime, dataDirectory);
 			return this.buildCallReport(appPath, nextRecord, buildServiceActionId(loaded.manifest.id, action), result, issues);
 		} catch (error) {
-			const record = this.toServiceAppRecord(appPath, loaded.manifest, runtime);
+			const record = this.toServiceAppRecord(appPath, loaded.manifest, runtime, dataDirectory);
 			issues.push({
 				severity: "error",
 				code: "service.runtime.callFailed",
@@ -3695,7 +3706,14 @@ var ServiceAppDevService = class {
 			});
 			return this.buildCallReport(appPath, record, buildServiceActionId(loaded.manifest.id, action), void 0, issues);
 		} finally {
-			await runtime.dispose();
+			try {
+				await runtime.dispose();
+			} finally {
+				await rm(dataDirectory, {
+					recursive: true,
+					force: true
+				});
+			}
 		}
 	};
 	loadServiceApp = async (appPath, issues) => {
@@ -3727,7 +3745,8 @@ var ServiceAppDevService = class {
 		return resolveConfigSecrets(loadConfig(configPath), { configPath });
 	};
 	idleRuntimeStatus = { getStatus: () => ({ status: "idle" }) };
-	toServiceAppRecord = (dirPath, manifest, runtime) => {
+	createDevDataDirectory = async () => await mkdtemp(path.join(tmpdir(), "nextclaw-service-app-dev-data-"));
+	toServiceAppRecord = (dirPath, manifest, runtime, dataDirectory) => {
 		const runtimeStatus = runtime.getStatus(manifest.id);
 		const record = {
 			id: manifest.id,
@@ -3739,7 +3758,8 @@ var ServiceAppDevService = class {
 			cwd: dirPath,
 			enabled: manifest.enabled,
 			protocol: manifest.protocol,
-			status: manifest.enabled ? runtimeStatus.status : "stopped"
+			status: manifest.enabled ? runtimeStatus.status : "stopped",
+			dataDirectory
 		};
 		if (manifest.description) record.description = manifest.description;
 		if (runtimeStatus.lastError) record.lastError = runtimeStatus.lastError;
@@ -4588,13 +4608,165 @@ var AppRestartCommandController = class {
 	};
 };
 //#endregion
+//#region src/cli/app/services/app-publishing.service.ts
+var AppPublishingService = class {
+	constructor(validationService = new AppPublishValidationService(), publishService = new AppPublishService()) {
+		this.validationService = validationService;
+		this.publishService = publishService;
+	}
+	validate = async (params) => {
+		const result = await this.validationService.validate({
+			appDirectory: params.appDirectory,
+			metadataPath: params.metadataPath,
+			mode: "bundle"
+		});
+		if (result.profile !== "components") throw new Error("nextclaw app publish 只支持由 Panel App 或 Service App 组成的 schema v2 Mini App。");
+		if (result.distributionMode !== "bundle") throw new Error("NextClaw Mini App 只支持 bundle 分发。");
+		return result;
+	};
+	publish = async (params) => {
+		const validation = await this.validate(params);
+		if (validation.warnings.length > 0 && !params.allowWarnings) {
+			const warningList = validation.warnings.map((warning) => `[${warning.code}] ${warning.message}`).join("; ");
+			throw new Error(`发布校验包含警告：${warningList}。确认后可使用 --allow-warnings 继续。`);
+		}
+		const tempDirectory = await mkdtemp(path.join(tmpdir(), "nextclaw-app-publish-"));
+		try {
+			const result = await this.publishService.publish({
+				appDirectory: params.appDirectory,
+				metadataPath: params.metadataPath,
+				bundleOutputPath: path.join(tempDirectory, "artifact.napp"),
+				mode: "bundle"
+			});
+			const { item } = result;
+			return {
+				validation,
+				publish: {
+					created: result.created,
+					item: {
+						slug: item.slug,
+						appId: item.appId,
+						ownerScope: item.ownerScope,
+						appName: item.appName,
+						publishStatus: item.publishStatus,
+						name: item.name,
+						latestVersion: item.latestVersion,
+						webUrl: item.publishStatus === "published" ? item.webUrl : void 0
+					},
+					fileCount: result.fileCount
+				}
+			};
+		} catch (error) {
+			const message = error instanceof Error ? error.message : String(error);
+			throw new Error(message.replace(/缺少 marketplace publish token。请先登录 NextClaw，或传入 --token。?/g, "发布需要 NextClaw 平台登录态。请先运行 nextclaw login。").replace(/，或传入 --token。?/g, "。"));
+		} finally {
+			await rm(tempDirectory, {
+				recursive: true,
+				force: true
+			});
+		}
+	};
+};
+//#endregion
+//#region src/cli/app/controllers/app-publish-command.controller.ts
+const PLATFORM_APPS_URL = "https://platform.nextclaw.io/apps";
+var AppPublishCommandController = class {
+	constructor(appPublishingService = new AppPublishingService()) {
+		this.appPublishingService = appPublishingService;
+	}
+	publish = async (target, options) => {
+		const { allowWarnings, json, meta } = options;
+		try {
+			const result = await this.appPublishingService.publish({
+				appDirectory: target,
+				metadataPath: meta,
+				allowWarnings
+			});
+			process.stdout.write(json ? `${JSON.stringify({
+				ok: true,
+				...result
+			}, null, 2)}\n` : this.format(result));
+		} catch (error) {
+			this.writeError(error, Boolean(json));
+			process.exitCode = 1;
+		}
+	};
+	format = (result) => {
+		const { item } = result.publish;
+		if (item.publishStatus === "pending") return [
+			`Submitted ${item.name} (${item.appId}) ${item.latestVersion} for review.`,
+			"Status: pending",
+			"The app will appear in the App Marketplace after approval.",
+			`Manage submissions: ${PLATFORM_APPS_URL}`,
+			""
+		].join("\n");
+		return [
+			`${result.publish.created ? "Published" : "Updated"} ${item.name} (${item.appId}) ${item.latestVersion}.`,
+			"Status: published",
+			item.webUrl ? `Details: ${item.webUrl}` : "",
+			`Manage apps: ${PLATFORM_APPS_URL}`,
+			""
+		].filter((line, index, lines) => line || index === lines.length - 1).join("\n");
+	};
+	writeError = (error, json) => {
+		const message = error instanceof Error ? error.message : String(error);
+		process.stdout.write(json ? `${JSON.stringify({
+			ok: false,
+			error: { message }
+		}, null, 2)}\n` : `Mini App publish failed: ${message}\n`);
+	};
+};
+//#endregion
+//#region src/cli/app/controllers/app-validate-publish-command.controller.ts
+var AppValidatePublishCommandController = class {
+	constructor(appPublishingService = new AppPublishingService()) {
+		this.appPublishingService = appPublishingService;
+	}
+	validate = async (target, options) => {
+		try {
+			const validation = await this.appPublishingService.validate({
+				appDirectory: target,
+				metadataPath: options.meta
+			});
+			process.stdout.write(options.json ? `${JSON.stringify({
+				ok: true,
+				validation
+			}, null, 2)}\n` : this.format(validation));
+		} catch (error) {
+			this.writeError(error, Boolean(options.json));
+			process.exitCode = 1;
+		}
+	};
+	format = (validation) => {
+		const lines = [
+			`Mini App publish validation passed: ${validation.appId}@${validation.version}`,
+			`Components: ${validation.componentCount ?? 0}`,
+			`Bundle size: ${validation.bundleSizeBytes} bytes`,
+			`Metadata: ${validation.metadataPath}`
+		];
+		for (const warning of validation.warnings) lines.push(`Warning [${warning.code}]: ${warning.message}`);
+		return `${lines.join("\n")}\n`;
+	};
+	writeError = (error, json) => {
+		const message = error instanceof Error ? error.message : String(error);
+		process.stdout.write(json ? `${JSON.stringify({
+			ok: false,
+			error: { message }
+		}, null, 2)}\n` : `Mini App publish validation failed: ${message}\n`);
+	};
+};
+//#endregion
 //#region src/cli/app/register-app-commands.ts
 function registerAppCommands(program) {
-	const app = program.command("app").description("Inspect and validate lightweight NextClaw apps");
+	const app = program.command("app").description("Develop, validate, and publish NextClaw apps");
 	const appCheck = new AppCheckCommandController();
 	const appDev = new AppDevCommandController();
 	const appCall = new AppCallCommandController();
 	const appRestart = new AppRestartCommandController();
+	const appValidatePublish = new AppValidatePublishCommandController();
+	const appPublish = new AppPublishCommandController();
+	app.command("validate-publish <app-dir>").description("Validate a NextClaw Mini App before Marketplace submission").option("--meta <path>", "Use a custom marketplace metadata file").option("--json", "Output JSON", false).action(async (target, opts) => appValidatePublish.validate(target, opts));
+	app.command("publish <app-dir>").description("Submit a NextClaw Mini App to the App Marketplace").option("--meta <path>", "Use a custom marketplace metadata file").option("--allow-warnings", "Submit after reviewing validation warnings", false).option("--json", "Output JSON", false).action(async (target, opts) => appPublish.publish(target, opts));
 	app.command("check <app-dir>").description("Check a Panel App or Service App directory").option("--json", "Output JSON", false).action(async (target, opts) => appCheck.check(target, opts));
 	app.command("dev <service-app-dir>").description("Start a Service App through the real runtime and inspect its actions").option("--json", "Output JSON", false).action(async (target, opts) => appDev.dev(target, opts));
 	app.command("call <service-app-dir> <action-name>").description("Call a Service App action through the real runtime").option("--input <json>", "JSON object input for the action").option("--json", "Output JSON", false).action(async (target, actionName, opts) => appCall.call(target, actionName, opts));