nextclaw 0.44.0 → 0.44.2

package/dist/cli/app/index.js

@@ -3,7 +3,7 @@ import { t as createNextclawDistribution } from "../../nextclaw-distribution.uti
 import { NextclawDistributionService } from "@nextclaw/service";
 //#region src/cli/app/index.ts
 NextclawDistributionService.configureRuntime(createNextclawDistribution(import.meta.url));
-const { nextclawCliProgram } = await import("../../nextclaw-cli-app-scOxgGRP.js");
+const { nextclawCliProgram } = await import("../../nextclaw-cli-app-B_ffeXOD.js");
 await nextclawCliProgram.parseAsync(process.argv);
 //#endregion
 export {};

package/dist/{nextclaw-cli-app-scOxgGRP.js → nextclaw-cli-app-B_ffeXOD.js}

@@ -12,6 +12,7 @@ import { access, mkdtemp, readFile, rm, stat } from "node:fs/promises";
 import { AppBundleService, AppHomeService, AppInstanceInventoryService, AppInstanceStorageService, AppPlatformTargetService, AppPublishService, AppPublishValidationService } from "@nextclaw/app-runtime";
 import { McpServiceAppRuntimeService, NextclawHarnessError, buildServiceActionId, getServiceAppManifestPath, mergeServiceAppRuntimeActions, readServiceAppManifest } from "@nextclaw/kernel";
 import { format, promisify } from "node:util";
+import { formatNextClawAppInstallCommand } from "@nextclaw/shared";
 var __commonJSMin = (cb, mod) => () => (mod || cb((mod = { exports: {} }).exports, mod), mod.exports);
 var __require = /* @__PURE__ */ createRequire(import.meta.url);
 //#endregion
@@ -4874,6 +4875,179 @@ var AppValidatePublishCommandController = class {
 	};
 };
 //#endregion
+//#region src/cli/app/services/app-packages/app-marketplace-query.service.ts
+const DEFAULT_APPS_MARKETPLACE_API_BASE = "https://apps-registry.nextclaw.io";
+var AppMarketplaceQueryService = class {
+	constructor(params = {}) {
+		this.params = params;
+	}
+	search = async (options = {}) => {
+		const search = new URLSearchParams();
+		if (options.query?.trim()) search.set("q", options.query.trim());
+		if (options.tag?.trim()) search.set("tag", options.tag.trim());
+		if (options.cursor?.trim()) search.set("cursor", options.cursor.trim());
+		search.set("limit", String(this.normalizeLimit(options.limit)));
+		return this.normalizeSearchResult(await this.request(`/api/v2/apps/items?${search.toString()}`));
+	};
+	info = async (selector) => {
+		const normalized = selector.trim();
+		if (!normalized) throw new Error("Marketplace app selector is required.");
+		return this.normalizeItem(await this.request(`/api/v1/apps/items/${encodeURIComponent(normalized)}`));
+	};
+	request = async (pathname) => {
+		const response = await (this.params.fetchImpl ?? fetch)(`${this.apiBaseUrl}${pathname}`, { headers: { accept: "application/json" } });
+		const payload = await response.json().catch(() => null);
+		if (!response.ok || !payload?.ok) throw new Error(`Apps marketplace request failed: ${response.status} ${response.statusText}`);
+		return payload.data;
+	};
+	normalizeSearchResult = (result) => ({
+		...result,
+		items: result.items.map((item) => this.normalizeItem(item))
+	});
+	normalizeItem = (item) => ({
+		...item,
+		install: {
+			spec: item.install.spec,
+			registry: item.install.registry
+		}
+	});
+	get apiBaseUrl() {
+		return (this.params.apiBaseUrl ?? DEFAULT_APPS_MARKETPLACE_API_BASE).replace(/\/+$/, "");
+	}
+	normalizeLimit = (limit) => {
+		if (limit === void 0) return 24;
+		if (!Number.isInteger(limit) || limit < 1 || limit > 100) throw new Error("--limit must be an integer between 1 and 100.");
+		return limit;
+	};
+};
+//#endregion
+//#region src/cli/app/services/local-api/app-package-live.service.ts
+var AppPackageLiveService = class {
+	constructor(params = {}) {
+		this.params = params;
+	}
+	list = async () => await this.requireApiClient().request({ path: "/api/app-packages" });
+	info = async (appId) => await this.requireApiClient().request({ path: `/api/app-packages/${encodeURIComponent(this.requireId(appId))}` });
+	listOperations = async () => await this.requireApiClient().request({ path: "/api/app-package-operations" });
+	install = async (source, registryUrl) => await this.requireApiClient().request({
+		path: "/api/app-package-operations/install",
+		method: "POST",
+		body: {
+			source: this.requireSource(source),
+			registryUrl
+		}
+	});
+	enable = async (appId) => await this.changeEnabled(appId, "enable");
+	disable = async (appId) => await this.changeEnabled(appId, "disable");
+	update = async (appId, options) => await this.requireApiClient().request({
+		path: `/api/app-package-operations/${encodeURIComponent(this.requireId(appId))}/update`,
+		method: "POST",
+		body: options
+	});
+	rollback = async (appId, version) => await this.requireApiClient().request({
+		path: `/api/app-package-operations/${encodeURIComponent(this.requireId(appId))}/rollback`,
+		method: "POST",
+		body: { version: this.requireVersion(version) }
+	});
+	uninstall = async (appId, purgeData) => await this.requireApiClient().request({
+		path: `/api/app-package-operations/${encodeURIComponent(this.requireId(appId))}/uninstall`,
+		method: "POST",
+		body: { purgeData }
+	});
+	changeEnabled = async (appId, action) => await this.requireApiClient().request({
+		path: `/api/app-packages/${encodeURIComponent(this.requireId(appId))}/${action}`,
+		method: "POST"
+	});
+	requireApiClient = () => {
+		const client = this.params.createApiClient ? this.params.createApiClient() : createLocalUiApiClient();
+		if (!client) throw new Error("NextClaw UI runtime is not running; start NextClaw before managing Apps.");
+		return client;
+	};
+	requireId = (value) => this.requireValue(value, "App id");
+	requireSource = (value) => this.requireValue(value, "App install source");
+	requireVersion = (value) => this.requireValue(value, "App version");
+	requireValue = (value, name) => {
+		const normalized = value.trim();
+		if (!normalized) throw new Error(`${name} is required.`);
+		return normalized;
+	};
+};
+//#endregion
+//#region src/cli/app/controllers/app-packages/app-package-command.controller.ts
+var AppPackageCommandController = class {
+	constructor(liveService = new AppPackageLiveService(), marketplaceService = new AppMarketplaceQueryService()) {
+		this.liveService = liveService;
+		this.marketplaceService = marketplaceService;
+	}
+	searchMarketplace = async (options) => {
+		const { query, tag, cursor, limit } = options;
+		const result = await this.marketplaceService.search({
+			query,
+			tag,
+			cursor,
+			limit: limit === void 0 ? void 0 : Number(limit)
+		});
+		this.write(result, options, this.formatMarketplaceSearch);
+	};
+	marketplaceInfo = async (selector, options) => this.write(await this.marketplaceService.info(selector), options, this.formatMarketplaceInfo);
+	list = async (options) => this.write(await this.liveService.list(), options, this.formatList);
+	info = async (appId, options) => this.write(await this.liveService.info(appId), options, this.formatApp);
+	operations = async (options) => this.write(await this.liveService.listOperations(), options, this.formatOperations);
+	install = async (source, options) => this.write(await this.liveService.install(source, options.registry), options, this.formatOperation);
+	enable = async (appId, options) => this.write(await this.liveService.enable(appId), options, this.formatApp);
+	disable = async (appId, options) => this.write(await this.liveService.disable(appId), options, this.formatApp);
+	update = async (appId, options) => this.write(await this.liveService.update(appId, {
+		version: options.version,
+		registryUrl: options.registry
+	}), options, this.formatOperation);
+	rollback = async (appId, options) => this.write(await this.liveService.rollback(appId, options.version), options, this.formatOperation);
+	uninstall = async (appId, options) => {
+		const { purgeData, confirm } = options;
+		if (purgeData) this.requirePurgeConfirmation(appId, confirm);
+		this.write(await this.liveService.uninstall(appId, purgeData === true), options, this.formatOperation);
+	};
+	write = (result, options, format) => {
+		process.stdout.write(options.json ? `${JSON.stringify(result, null, 2)}\n` : format(result));
+	};
+	formatMarketplaceSearch = (result) => {
+		if (result.items.length === 0) return "No Marketplace Apps found.\n";
+		return `${result.items.map((item) => this.formatMarketplaceInfo(item).trim()).join("\n\n")}\n`;
+	};
+	formatMarketplaceInfo = (item) => [
+		`${item.name} (${item.appId})`,
+		`  summary: ${item.summary}`,
+		`  version: ${item.latestVersion}`,
+		`  author: ${item.author}`,
+		`  tags: ${item.tags.join(", ") || "-"}`,
+		`  install: ${formatNextClawAppInstallCommand(item.install.spec)}`
+	].join("\n") + "\n";
+	formatList = (result) => {
+		if (result.entries.length === 0) return "Apps: none\n";
+		return `${result.entries.map((app) => this.formatApp(app).trim()).join("\n\n")}\n`;
+	};
+	formatApp = (app) => [
+		`${app.name} (${app.id})`,
+		`  version: ${app.activeVersion}`,
+		`  enabled: ${app.enabled ? "yes" : "no"}`,
+		`  built-in: ${app.builtIn ? "yes" : "no"}`,
+		`  versions: ${app.installedVersions.join(", ")}`
+	].join("\n") + "\n";
+	formatOperations = (result) => {
+		if (result.entries.length === 0) return "App operations: none\n";
+		return `${result.entries.map((operation) => this.formatOperation(operation).trim()).join("\n\n")}\n`;
+	};
+	formatOperation = (operation) => [
+		`App operation ${operation.id}`,
+		`  action: ${operation.action}`,
+		`  status: ${operation.status}`,
+		`  app: ${operation.appId ?? operation.source ?? "-"}`,
+		operation.error ? `  error: ${operation.error}` : ""
+	].filter(Boolean).join("\n") + "\n";
+	requirePurgeConfirmation = (appId, confirmation) => {
+		if (confirmation?.trim() !== appId.trim()) throw new Error("--purge-data requires --confirm <app-id> matching the exact App id.");
+	};
+};
+//#endregion
 //#region src/cli/app/register-app-commands.ts
 function registerAppCommands(program) {
 	const app = program.command("app").description("Develop, validate, and publish NextClaw apps");
@@ -4885,6 +5059,7 @@ function registerAppCommands(program) {
 	const appPack = new AppPackCommandController();
 	const appValidatePublish = new AppValidatePublishCommandController();
 	const appPublish = new AppPublishCommandController();
+	const appPackages = new AppPackageCommandController();
 	app.command("pack <app-dir>").description("Pack one declared platform target as a NextClaw App artifact").requiredOption("--target <target-key>", "Pack a declared platform target").requiredOption("--out <path>", "Write the .napp artifact to a specific path").option("--json", "Output JSON", false).action(async (target, opts) => appPack.pack(target, opts));
 	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("--artifacts <dir>", "Use target-keyed .napp artifacts from a directory").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("--artifacts <dir>", "Publish target-keyed .napp artifacts from a directory").option("--allow-warnings", "Submit after reviewing validation warnings", false).option("--json", "Output JSON", false).action(async (target, opts) => appPublish.publish(target, opts));
@@ -4895,6 +5070,21 @@ function registerAppCommands(program) {
 	data.command("delete <data-id>").description("Permanently delete a retained App data instance").requiredOption("--confirm <app-id>", "Confirm the exact App id").option("--json", "Output JSON", false).action(async (dataId, opts) => appData.deleteRetained(dataId, 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));
 	app.command("restart <app-id>").description("Restart a live Service App runtime in the running NextClaw UI").option("--json", "Output JSON", false).action(async (appId, opts) => appRestart.restart(appId, opts));
+	registerAppPackageCommands(app, appPackages);
+}
+function registerAppPackageCommands(app, appPackages) {
+	const marketplace = app.command("marketplace").description("Browse NextClaw App Marketplace");
+	marketplace.command("search").description("Search Apps in NextClaw App Marketplace").option("-q, --query <text>", "Search text").option("--tag <tag>", "Filter by tag").option("--cursor <cursor>", "Continue from a marketplace cursor").option("--limit <n>", "Maximum number of items").option("--json", "Output JSON", false).action(async (opts) => appPackages.searchMarketplace(opts));
+	marketplace.command("info <selector>").description("Show an App Marketplace item").option("--json", "Output JSON", false).action(async (selector, opts) => appPackages.marketplaceInfo(selector, opts));
+	app.command("list").description("List Apps installed in the running NextClaw host").option("--json", "Output JSON", false).action(async (opts) => appPackages.list(opts));
+	app.command("info <app-id>").description("Show an App installed in the running NextClaw host").option("--json", "Output JSON", false).action(async (appId, opts) => appPackages.info(appId, opts));
+	app.command("operations").description("List App install, update, rollback, and uninstall operations").option("--json", "Output JSON", false).action(async (opts) => appPackages.operations(opts));
+	app.command("install <source>").description("Install an App through the running NextClaw host").option("--registry <url>", "Registry URL for an App id").option("--json", "Output JSON", false).action(async (source, opts) => appPackages.install(source, opts));
+	app.command("enable <app-id>").description("Enable an installed App").option("--json", "Output JSON", false).action(async (appId, opts) => appPackages.enable(appId, opts));
+	app.command("disable <app-id>").description("Disable an installed App").option("--json", "Output JSON", false).action(async (appId, opts) => appPackages.disable(appId, opts));
+	app.command("update <app-id>").description("Update an App through the running NextClaw host").option("--version <version>", "Target version").option("--registry <url>", "Registry URL").option("--json", "Output JSON", false).action(async (appId, opts) => appPackages.update(appId, opts));
+	app.command("rollback <app-id>").description("Roll back an App to an installed version").requiredOption("--version <version>", "Installed version to activate").option("--json", "Output JSON", false).action(async (appId, opts) => appPackages.rollback(appId, opts));
+	app.command("uninstall <app-id>").description("Uninstall an App through the running NextClaw host").option("--purge-data", "Permanently delete App data", false).option("--confirm <app-id>", "Confirm the exact App id when purging data").option("--json", "Output JSON", false).action(async (appId, opts) => appPackages.uninstall(appId, opts));
 }
 //#endregion
 //#region src/cli/app/register-project-commands.ts
@@ -4913,6 +5103,7 @@ function registerSessionCommands(program, nextclaw) {
 	sessions.command("rename <session-id> <label>").description("Rename a session").option("--json", "Output JSON", false).action((sessionId, label, options) => commands.rename(sessionId, label, options));
 	sessions.command("set-project <session-id> <directory>").description("Bind a session to an existing project directory").option("--json", "Output JSON", false).action((sessionId, directory, options) => commands.setProject(sessionId, directory, options));
 	sessions.command("clear-project <session-id>").description("Clear a session project binding").option("--json", "Output JSON", false).action((sessionId, options) => commands.clearProject(sessionId, options));
+	sessions.command("delete <session-id>").description("Permanently delete a session").requiredOption("--confirm <session-id>", "Confirm the exact session id").option("--json", "Output JSON", false).action((sessionId, options) => commands.delete(sessionId, options));
 }
 //#endregion
 //#region src/cli/app/controllers/exec-command.controller.ts
@@ -5164,4 +5355,4 @@ program.command("usage").description("Show observed LLM usage snapshots, history
 //#endregion
 export { program as nextclawCliProgram };
 
-//# sourceMappingURL=nextclaw-cli-app-scOxgGRP.js.map
+//# sourceMappingURL=nextclaw-cli-app-B_ffeXOD.js.map