@nextclaw/app-runtime 0.4.0 → 0.5.0

package/README.md

@@ -6,6 +6,8 @@
 
 - `napp create <app-dir>`：生成一个最小可跑的微应用骨架
 - `napp inspect <app-dir>`：校验应用目录与 manifest
+- `napp doctor`：检查本机 NApp/WASI HTTP 开发运行环境
+- `napp build <app-dir> --install`：安装模板依赖并构建 TS/WASI HTTP 后端
 - `napp run <app-dir|app-id>`：启动本地宿主，支持目录运行和已安装应用运行
 - `napp dev <app-dir>`：当前等价于 `run`
 - `napp pack <app-dir>`：把应用目录打成 `.napp` bundle
@@ -33,7 +35,7 @@ napp --help
 napp --version
 ```
 
-第一版先聚焦“独立可运行的微应用宿主 + 可分发、可安装、可更新、可授权的 CLI/runtime 闭环”，不接入现有 NextClaw 主产品路由、服务或 GUI app store。
+当前版本先聚焦“独立可运行的微应用宿主 + 可分发、可安装、可更新、可授权的 CLI/runtime 闭环”。普通用户入口推荐通过 NextClaw 的 `nextclaw-app-runtime` skill 编排这些命令。
 
 ## 应用目录
 
@@ -41,6 +43,8 @@ napp --version
 manifest.json
 main/
   app.wasm
+  package.json     # ts-http 模板存在
+  src/             # ts-http 模板存在
 ui/
   index.html
 assets/
@@ -48,11 +52,12 @@ assets/
 
 ## 当前 MVP 范围
 
-- `main` 执行形态：`wasm`
+- `main` 执行形态：`wasm` 或 `wasi-http-component`
 - UI 装载：本地静态服务
 - 宿主桥接：`/__napp/*`
+- WASI HTTP 业务 API：`/api/*`
 - 权限词汇：`documentAccess`、`allowedDomains`、`storage`、`capabilities`
-- 当前 Wasm 执行底座：Node 原生 `WebAssembly`
+- 当前 Wasm 执行底座：Node 原生 `WebAssembly` 与 Wasmtime `serve`
 - 分发包形态：`.napp`（底层为 zip）
 - 安装目录：`~/.nextclaw/apps/packages/<app-id>/<version>/`
 - 用户数据目录：`~/.nextclaw/apps/data/<app-id>/`
@@ -65,8 +70,11 @@ assets/
 开发者工作流：
 
 ```bash
-napp create ./my-first-napp
+napp doctor
+napp create ./my-first-napp --template ts-http
+napp build ./my-first-napp --install
 napp inspect ./my-first-napp
+napp run ./my-first-napp --data ./my-first-napp/.napp/data
 napp pack ./my-first-napp
 napp publish ./my-first-napp
 ```

package/dist/cli/app-runtime-cli.service.d.ts

@@ -8,6 +8,8 @@ declare class AppRuntimeCliService {
   private dispatch;
   private handleCreate;
   private handleInspect;
+  private handleBuild;
+  private handleDoctor;
   private handleRun;
   private handleDev;
   private handlePack;

package/dist/cli/app-runtime-cli.service.js

@@ -14,6 +14,8 @@ import { RegistryCommand } from "../commands/registry.controller.js";
 import { RevokeCommand } from "../commands/revoke.controller.js";
 import { UninstallCommand } from "../commands/uninstall.controller.js";
 import { UpdateCommand } from "../commands/update.controller.js";
+import { AppRuntimeToolchainService } from "../runtime/app-runtime-toolchain.service.js";
+import { AppBuildService } from "../runtime/app-build.service.js";
 import { AppRuntimeOptionsService } from "./app-runtime-options.service.js";
 //#region src/cli/app-runtime-cli.service.ts
 var AppRuntimeCliService = class {
@@ -44,6 +46,12 @@ var AppRuntimeCliService = class {
 			case "inspect":
 				await this.handleInspect(restArgs);
 				return;
+			case "build":
+				await this.handleBuild(restArgs);
+				return;
+			case "doctor":
+				await this.handleDoctor(restArgs);
+				return;
 			case "run":
 				await this.handleRun(restArgs);
 				return;
@@ -93,6 +101,7 @@ var AppRuntimeCliService = class {
 		const options = this.optionsService.readCreateOptions(optionArgs);
 		await new CreateCommand().run({
 			appDirectory: target,
+			template: options.template,
 			json: options.json,
 			write: this.write
 		});
@@ -106,6 +115,46 @@ var AppRuntimeCliService = class {
 			write: this.write
 		});
 	};
+	handleBuild = async (restArgs) => {
+		const { target, optionArgs } = this.optionsService.readTarget("build", restArgs);
+		const options = this.optionsService.readBuildOptions(optionArgs);
+		const result = await new AppBuildService().build({
+			appDirectory: target,
+			install: options.install
+		});
+		if (options.json) {
+			this.write(`${JSON.stringify({
+				ok: true,
+				build: result
+			}, null, 2)}\n`);
+			return;
+		}
+		if (!result.built) {
+			this.write(`Build skipped: ${result.skippedReason ?? result.mainKind}\n`);
+			return;
+		}
+		this.write(`Built ${result.mainKind} app\n`);
+		this.write(`Main: ${result.mainEntryPath}\n`);
+		if (result.installedDependencies) this.write("Dependencies: installed\n");
+	};
+	handleDoctor = async (restArgs) => {
+		const options = this.optionsService.readJsonOnlyOptions(restArgs);
+		const result = await new AppRuntimeToolchainService().doctor();
+		if (options.json) {
+			this.write(`${JSON.stringify({
+				ok: result.ok,
+				doctor: result
+			}, null, 2)}\n`);
+			if (!result.ok) process.exitCode = 1;
+			return;
+		}
+		this.write(`NApp runtime doctor: ${result.ok ? "ok" : "not ready"}\n`);
+		for (const tool of result.tools) {
+			this.write(`${tool.ok ? "ok" : "missing"} ${tool.name}${tool.version ? ` ${tool.version}` : ""}\n`);
+			if (!tool.ok) this.write(`  ${tool.installHint}\n`);
+		}
+		if (!result.ok) process.exitCode = 1;
+	};
 	handleRun = async (restArgs) => {
 		const { target, optionArgs } = this.optionsService.readTarget("run", restArgs);
 		const options = this.optionsService.readRuntimeOptions(optionArgs);
@@ -113,6 +162,7 @@ var AppRuntimeCliService = class {
 			appReference: target,
 			host: options.host,
 			port: options.port,
+			dataDirectory: options.dataDirectory,
 			json: options.json,
 			documentGrantMap: options.documentGrantMap,
 			write: this.write
@@ -125,6 +175,7 @@ var AppRuntimeCliService = class {
 			appReference: target,
 			host: options.host,
 			port: options.port,
+			dataDirectory: options.dataDirectory,
 			json: options.json,
 			documentGrantMap: options.documentGrantMap,
 			write: this.write
@@ -271,9 +322,11 @@ var AppRuntimeCliService = class {
 		});
 	};
 	writeUsage = () => {
-		this.write("Usage: napp create <app-dir> [--json]\n");
+		this.write("Usage: napp create <app-dir> [--template starter|ts-http] [--json]\n");
 		this.write("       napp inspect <app-dir> [--json]\n");
-		this.write("       napp <run|dev> <app-dir|app-id> [--host 127.0.0.1] [--port 3100] [--json] [--document scope=/path]\n");
+		this.write("       napp build <app-dir> [--install] [--json]\n");
+		this.write("       napp doctor [--json]\n");
+		this.write("       napp <run|dev> <app-dir|app-id> [--host 127.0.0.1] [--port 3100] [--data /path] [--json] [--document scope=/path]\n");
 		this.write("       napp pack <app-dir> [--out bundle.napp] [--json]\n");
 		this.write("       napp publish <app-dir> [--meta marketplace.json] [--api-base <url>] [--token <token>] [--json]\n");
 		this.write("       napp install <app-dir|bundle.napp|app-id[@version]> [--registry <url>] [--json]\n");

package/dist/cli/app-runtime-options.service.d.ts

@@ -1,19 +1,26 @@
 import { AppDocumentGrantMap } from "../permissions/app-permissions.types.js";
+import { AppScaffoldTemplate } from "../scaffold/app-scaffold.service.js";
 
 //#region src/cli/app-runtime-options.service.d.ts
 type RuntimeCliOptions = {
   host: string;
   port: number;
+  dataDirectory?: string;
   json: boolean;
   documentGrantMap: AppDocumentGrantMap;
 };
 type CreateCliOptions = {
   json: boolean;
+  template: AppScaffoldTemplate;
 };
 type PackCliOptions = {
   json: boolean;
   outputPath?: string;
 };
+type BuildCliOptions = {
+  json: boolean;
+  install: boolean;
+};
 type JsonOnlyCliOptions = {
   json: boolean;
 };
@@ -50,7 +57,9 @@ declare class AppRuntimeOptionsService {
     optionArgs: string[];
   };
   readCreateOptions: (rawArgs: string[]) => CreateCliOptions;
+  private readCreateTemplate;
   readPackOptions: (rawArgs: string[]) => PackCliOptions;
+  readBuildOptions: (rawArgs: string[]) => BuildCliOptions;
   readJsonOnlyOptions: (rawArgs: string[]) => JsonOnlyCliOptions;
   readInstallOptions: (rawArgs: string[]) => InstallCliOptions;
   readUpdateOptions: (rawArgs: string[]) => UpdateCliOptions;
@@ -64,4 +73,4 @@ declare class AppRuntimeOptionsService {
   private requireOptionValue;
 }
 //#endregion
-export { AppRuntimeOptionsService, CreateCliOptions, GrantCliOptions, InstallCliOptions, JsonOnlyCliOptions, PackCliOptions, PublishCliOptions, RevokeCliOptions, RuntimeCliOptions, UninstallCliOptions, UpdateCliOptions };
+export { AppRuntimeOptionsService, BuildCliOptions, CreateCliOptions, GrantCliOptions, InstallCliOptions, JsonOnlyCliOptions, PackCliOptions, PublishCliOptions, RevokeCliOptions, RuntimeCliOptions, UninstallCliOptions, UpdateCliOptions };

package/dist/cli/app-runtime-options.service.js

@@ -9,18 +9,31 @@ var AppRuntimeOptionsService = class {
 		};
 	};
 	readCreateOptions = (rawArgs) => {
-		const options = { json: false };
-		for (const current of rawArgs) {
+		const options = {
+			json: false,
+			template: "starter"
+		};
+		for (let index = 0; index < rawArgs.length; index += 1) {
+			const current = rawArgs[index];
 			if (!current?.startsWith("--")) throw new Error(`未知参数：${current}`);
+			const nextValue = rawArgs[index + 1];
 			switch (current) {
 				case "--json":
 					options.json = true;
 					break;
+				case "--template":
+					options.template = this.readCreateTemplate(this.requireOptionValue(current, nextValue));
+					index += 1;
+					break;
 				default: throw new Error(`未知参数：${current}`);
 			}
 		}
 		return options;
 	};
+	readCreateTemplate = (rawTemplate) => {
+		if (rawTemplate === "starter" || rawTemplate === "ts-http") return rawTemplate;
+		throw new Error("--template 只支持 starter 或 ts-http。");
+	};
 	readPackOptions = (rawArgs) => {
 		const options = { json: false };
 		for (let index = 0; index < rawArgs.length; index += 1) {
@@ -40,6 +53,25 @@ var AppRuntimeOptionsService = class {
 		}
 		return options;
 	};
+	readBuildOptions = (rawArgs) => {
+		const options = {
+			json: false,
+			install: false
+		};
+		for (const current of rawArgs) {
+			if (!current?.startsWith("--")) throw new Error(`未知参数：${current}`);
+			switch (current) {
+				case "--json":
+					options.json = true;
+					break;
+				case "--install":
+					options.install = true;
+					break;
+				default: throw new Error(`未知参数：${current}`);
+			}
+		}
+		return options;
+	};
 	readJsonOnlyOptions = (rawArgs) => {
 		const options = { json: false };
 		for (const current of rawArgs) {
@@ -118,6 +150,7 @@ var AppRuntimeOptionsService = class {
 		const options = {
 			host: "127.0.0.1",
 			port: 3100,
+			dataDirectory: void 0,
 			json: false,
 			documentGrantMap: {}
 		};
@@ -138,6 +171,10 @@ var AppRuntimeOptionsService = class {
 				case "--json":
 					options.json = true;
 					break;
+				case "--data":
+					options.dataDirectory = this.requireOptionValue(current, nextValue);
+					index += 1;
+					break;
 				case "--document":
 					this.assignDocumentGrant(options.documentGrantMap, this.requireOptionValue(current, nextValue));
 					index += 1;

package/dist/commands/create.controller.d.ts

@@ -1,4 +1,4 @@
-import { AppScaffoldService } from "../scaffold/app-scaffold.service.js";
+import { AppScaffoldService, AppScaffoldTemplate } from "../scaffold/app-scaffold.service.js";
 
 //#region src/commands/create.controller.d.ts
 declare class CreateCommand {
@@ -6,6 +6,7 @@ declare class CreateCommand {
   constructor(scaffoldService?: AppScaffoldService);
   run: (params: {
     appDirectory: string;
+    template: AppScaffoldTemplate;
     json: boolean;
     write: (text: string) => void;
   }) => Promise<void>;

package/dist/commands/create.controller.js

@@ -5,8 +5,8 @@ var CreateCommand = class {
 		this.scaffoldService = scaffoldService;
 	}
 	run = async (params) => {
-		const { appDirectory, json, write } = params;
-		const result = await this.scaffoldService.scaffold(appDirectory);
+		const { appDirectory, template, json, write } = params;
+		const result = await this.scaffoldService.scaffold(appDirectory, { template });
 		if (json) {
 			write(`${JSON.stringify({
 				ok: true,
@@ -15,6 +15,7 @@ var CreateCommand = class {
 			return;
 		}
 		write(`Created app scaffold at ${result.appDirectory}\n`);
+		write(`Template: ${result.template}\n`);
 		write(`Manifest: ${result.manifestPath}\n`);
 		write("Next: napp inspect <app-dir> && napp run <app-dir>\n");
 	};

package/dist/commands/inspect.controller.js

@@ -17,7 +17,8 @@ var InspectCommand = class {
 		}
 		write(`App: ${summary.name} (${summary.id})\n`);
 		write(`Version: ${summary.version}\n`);
-		write(`Action: ${summary.action}\n`);
+		write(`Main Kind: ${summary.mainKind}\n`);
+		if (summary.action) write(`Action: ${summary.action}\n`);
 		write(`Main: ${summary.mainEntryPath}\n`);
 		write(`UI: ${summary.uiEntryPath}\n`);
 	};

package/dist/commands/run.controller.js

@@ -2,6 +2,7 @@ import { AppManifestService } from "../manifest/app-manifest.service.js";
 import { AppHostService } from "../host/app-host.service.js";
 import { AppInstanceService } from "../host/app-instance.service.js";
 import { AppInstallationService } from "../install/app-installation.service.js";
+import { WasmtimeWasiHttpComponentService } from "../runtime/wasmtime-wasi-http-component.service.js";
 //#region src/commands/run.controller.ts
 var RunCommand = class {
 	constructor(manifestService = new AppManifestService(), installationService = new AppInstallationService()) {
@@ -9,19 +10,35 @@ var RunCommand = class {
 		this.installationService = installationService;
 	}
 	run = async (params) => {
-		const { appReference, host, port, json, documentGrantMap, write } = params;
+		const { appReference, host, port, dataDirectory, json, documentGrantMap, write } = params;
 		const launch = await this.installationService.resolveLaunch(appReference, documentGrantMap);
 		const bundle = await this.manifestService.load(launch.appDirectory);
 		const appInstance = new AppInstanceService(bundle);
 		await appInstance.initialize(launch.documentGrantMap, { appId: launch.appId });
 		await this.installationService.persistGrants(launch.appId, launch.documentGrantMap);
-		const appHost = new AppHostService(appInstance);
-		const hostHandle = await appHost.start({
-			host,
-			port
-		});
+		const wasiHttpComponentService = bundle.manifest.main.kind === "wasi-http-component" ? new WasmtimeWasiHttpComponentService() : void 0;
+		const effectiveDataDirectory = dataDirectory ?? launch.dataDirectory;
+		if (wasiHttpComponentService) {
+			if (!effectiveDataDirectory) throw new Error("wasi-http-component 应用需要通过 --data /path 指定后端数据目录。");
+			await wasiHttpComponentService.start({
+				wasmPath: bundle.mainEntryPath,
+				dataDirectory: effectiveDataDirectory
+			});
+		}
+		const appHost = new AppHostService(appInstance, wasiHttpComponentService);
+		let hostHandle;
+		try {
+			hostHandle = await appHost.start({
+				host,
+				port
+			});
+		} catch (error) {
+			await wasiHttpComponentService?.stop();
+			throw error;
+		}
 		const shutdown = async () => {
 			await appHost.stop();
+			await wasiHttpComponentService?.stop();
 			process.exit(0);
 		};
 		process.once("SIGINT", () => {
@@ -36,7 +53,8 @@ var RunCommand = class {
 				host: hostHandle,
 				app: {
 					appId: launch.appId ?? bundle.manifest.id,
-					appDirectory: launch.appDirectory
+					appDirectory: launch.appDirectory,
+					dataDirectory: effectiveDataDirectory
 				}
 			}, null, 2)}\n`);
 			return;

package/dist/host/app-host.service.d.ts

@@ -1,4 +1,5 @@
 import { AppInstanceService } from "./app-instance.service.js";
+import { WasmtimeWasiHttpComponentService } from "../runtime/wasmtime-wasi-http-component.service.js";
 
 //#region src/host/app-host.service.d.ts
 type AppHostStartOptions = {
@@ -13,10 +14,11 @@ type AppHostHandle = {
 };
 declare class AppHostService {
   private readonly appInstance;
+  private readonly wasiHttpComponentService?;
   private server?;
   private readonly bridgeServer;
   private readonly uiServer;
-  constructor(appInstance: AppInstanceService);
+  constructor(appInstance: AppInstanceService, wasiHttpComponentService?: WasmtimeWasiHttpComponentService | undefined);
   start: (options: AppHostStartOptions) => Promise<AppHostHandle>;
   stop: () => Promise<void>;
   private handleRequest;

package/dist/host/app-host.service.js

@@ -6,8 +6,9 @@ var AppHostService = class {
 	server;
 	bridgeServer;
 	uiServer;
-	constructor(appInstance) {
+	constructor(appInstance, wasiHttpComponentService) {
 		this.appInstance = appInstance;
+		this.wasiHttpComponentService = wasiHttpComponentService;
 		this.bridgeServer = new HostBridgeServer(appInstance);
 		this.uiServer = new UiServerService(appInstance.bundle);
 	}
@@ -48,6 +49,9 @@ var AppHostService = class {
 	};
 	handleRequest = async (request, response) => {
 		try {
+			if (this.wasiHttpComponentService) {
+				if (await this.wasiHttpComponentService.handleRequest(request, response)) return;
+			}
 			if (await this.bridgeServer.handle(request, response)) return;
 			await this.uiServer.handle(request, response);
 		} catch (error) {

package/dist/host/app-instance.service.js

@@ -22,6 +22,7 @@ var AppInstanceService = class {
 		return this.permissionsService.summarize(this.bundle, this.getPermissions());
 	};
 	runAction = async (action) => {
+		if (this.bundle.manifest.main.kind !== "wasm") throw new Error("当前应用不支持 __napp/run action，请通过 /api/* 调用 WASI HTTP 后端。");
 		const expectedAction = this.bundle.manifest.main.action;
 		if (action && action !== expectedAction) throw new Error(`当前应用只支持动作 ${expectedAction}。`);
 		const input = await this.collectDocumentSummaryInput();

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { AppDocumentAccessMode, AppDocumentAccessScope, AppMainManifest, AppManifest, AppManifestBundle, AppManifestSummary, AppPermissions, AppUiManifest } from "./manifest/app-manifest.types.js";
+import { AppCoreWasmMainManifest, AppDocumentAccessMode, AppDocumentAccessScope, AppMainManifest, AppManifest, AppManifestBundle, AppManifestSummary, AppPermissions, AppUiManifest, AppWasiHttpComponentMainManifest } from "./manifest/app-manifest.types.js";
 import { AppManifestService } from "./manifest/app-manifest.service.js";
 import { AppBundleChecksums, AppBundleExtractResult, AppBundleMetadata, AppBundlePackResult } from "./bundle/app-bundle.types.js";
 import { AppBundleService } from "./bundle/app-bundle.service.js";
@@ -10,7 +10,9 @@ import { WasmSidecarClientService } from "./sidecar/wasm-sidecar-client.service.
 import { WasmMainRunnerService } from "./runtime/wasm-main-runner.service.js";
 import { AppInstanceService, AppRunResult } from "./host/app-instance.service.js";
 import { HostBridgeServer } from "./bridge/host-bridge.service.js";
-import { AppRuntimeOptionsService, CreateCliOptions, GrantCliOptions, InstallCliOptions, JsonOnlyCliOptions, PackCliOptions, PublishCliOptions, RevokeCliOptions, RuntimeCliOptions, UninstallCliOptions, UpdateCliOptions } from "./cli/app-runtime-options.service.js";
+import { AppScaffoldFile, AppTsHttpScaffoldTemplateService } from "./scaffold/app-ts-http-scaffold-template.service.js";
+import { AppScaffoldResult, AppScaffoldService, AppScaffoldTemplate } from "./scaffold/app-scaffold.service.js";
+import { AppRuntimeOptionsService, BuildCliOptions, CreateCliOptions, GrantCliOptions, InstallCliOptions, JsonOnlyCliOptions, PackCliOptions, PublishCliOptions, RevokeCliOptions, RuntimeCliOptions, UninstallCliOptions, UpdateCliOptions } from "./cli/app-runtime-options.service.js";
 import { AppRuntimeCliService } from "./cli/app-runtime-cli.service.js";
 import { CreateCommand } from "./commands/create.controller.js";
 import { AppHomeService } from "./paths/app-home.service.js";
@@ -31,12 +33,16 @@ import { PermissionsCommand } from "./commands/permissions.controller.js";
 import { AppMarketplaceMetadata, AppPublishFile, AppPublishPayload, AppPublishResult, DEFAULT_APP_MARKETPLACE_API_BASE } from "./publish/app-publish.types.js";
 import { AppMarketplaceClientService } from "./publish/app-marketplace-client.service.js";
 import { AppMarketplaceMetadataService } from "./publish/app-marketplace-metadata.service.js";
+import { PlatformAuthStateService, PlatformPublishAuthState } from "./publish/platform-auth-state.service.js";
 import { AppPublishService } from "./publish/app-publish.service.js";
 import { PublishCommand } from "./commands/publish.controller.js";
 import { RegistryCommand } from "./commands/registry.controller.js";
 import { RevokeCommand } from "./commands/revoke.controller.js";
 import { UpdateCommand } from "./commands/update.controller.js";
 import { UninstallCommand } from "./commands/uninstall.controller.js";
+import { WasmtimeWasiHttpComponentHandle, WasmtimeWasiHttpComponentService, WasmtimeWasiHttpComponentStartOptions } from "./runtime/wasmtime-wasi-http-component.service.js";
 import { AppHostHandle, AppHostService, AppHostStartOptions } from "./host/app-host.service.js";
+import { AppRuntimeCommandResult, AppRuntimeDoctorResult, AppRuntimeToolStatus, AppRuntimeToolchainService } from "./runtime/app-runtime-toolchain.service.js";
+import { AppBuildResult, AppBuildService } from "./runtime/app-build.service.js";
 import { UiServerService } from "./ui/ui-server.service.js";
-export { AppBundleChecksums, AppBundleExtractResult, AppBundleMetadata, AppBundlePackResult, AppBundleService, AppDocumentAccessMode, AppDocumentAccessScope, AppDocumentGrantMap, AppDocumentGrantMutationResult, AppDocumentGrantState, AppGrantService, AppHomeService, AppHostHandle, AppHostService, AppHostStartOptions, AppInfoResult, AppInstallResult, AppInstallSourceKind, AppInstallationService, AppInstalledPermissionState, AppInstanceService, AppLaunchResolution, AppMainManifest, AppManifest, AppManifestBundle, AppManifestService, AppManifestSummary, AppMarketplaceClientService, AppMarketplaceMetadata, AppMarketplaceMetadataService, AppPermissionSummary, AppPermissions, AppPermissionsService, AppPublishFile, AppPublishPayload, AppPublishResult, AppPublishService, AppPublisher, AppRegistry, AppRegistryAppRecord, AppRegistryConfig, AppRegistryConfigService, AppRegistryConfigSnapshot, AppRegistryInstalledVersion, AppRegistryService, AppRemoteRegistryClientService, AppRemoteRegistryDocument, AppRemoteRegistryResolution, AppRemoteRegistryVersion, AppRunResult, AppRuntimeCliService, AppRuntimeOptionsService, AppUiManifest, AppUninstallResult, AppUpdateResult, CreateCliOptions, CreateCommand, DEFAULT_APP_MARKETPLACE_API_BASE, DEFAULT_APP_REGISTRY_URL, GrantCliOptions, GrantCommand, HostBridgeServer, InfoCommand, InstallCliOptions, InstallCommand, InstalledAppListItem, JsonOnlyCliOptions, ListCommand, MainRunRequest, MainRunResult, MainRunnerService, PackCliOptions, PackCommand, PermissionsCommand, PublishCliOptions, PublishCommand, RegistryCommand, ResolvedDocumentGrant, ResolvedPermissions, RevokeCliOptions, RevokeCommand, RuntimeCliOptions, UiServerService, UninstallCliOptions, UninstallCommand, UpdateCliOptions, UpdateCommand, WasmDocumentSummaryInput, WasmMainRunnerService, WasmSidecarClientService };
+export { AppBuildResult, AppBuildService, AppBundleChecksums, AppBundleExtractResult, AppBundleMetadata, AppBundlePackResult, AppBundleService, AppCoreWasmMainManifest, AppDocumentAccessMode, AppDocumentAccessScope, AppDocumentGrantMap, AppDocumentGrantMutationResult, AppDocumentGrantState, AppGrantService, AppHomeService, AppHostHandle, AppHostService, AppHostStartOptions, AppInfoResult, AppInstallResult, AppInstallSourceKind, AppInstallationService, AppInstalledPermissionState, AppInstanceService, AppLaunchResolution, AppMainManifest, AppManifest, AppManifestBundle, AppManifestService, AppManifestSummary, AppMarketplaceClientService, AppMarketplaceMetadata, AppMarketplaceMetadataService, AppPermissionSummary, AppPermissions, AppPermissionsService, AppPublishFile, AppPublishPayload, AppPublishResult, AppPublishService, AppPublisher, AppRegistry, AppRegistryAppRecord, AppRegistryConfig, AppRegistryConfigService, AppRegistryConfigSnapshot, AppRegistryInstalledVersion, AppRegistryService, AppRemoteRegistryClientService, AppRemoteRegistryDocument, AppRemoteRegistryResolution, AppRemoteRegistryVersion, AppRunResult, AppRuntimeCliService, AppRuntimeCommandResult, AppRuntimeDoctorResult, AppRuntimeOptionsService, AppRuntimeToolStatus, AppRuntimeToolchainService, AppScaffoldFile, AppScaffoldResult, AppScaffoldService, AppScaffoldTemplate, AppTsHttpScaffoldTemplateService, AppUiManifest, AppUninstallResult, AppUpdateResult, AppWasiHttpComponentMainManifest, BuildCliOptions, CreateCliOptions, CreateCommand, DEFAULT_APP_MARKETPLACE_API_BASE, DEFAULT_APP_REGISTRY_URL, GrantCliOptions, GrantCommand, HostBridgeServer, InfoCommand, InstallCliOptions, InstallCommand, InstalledAppListItem, JsonOnlyCliOptions, ListCommand, MainRunRequest, MainRunResult, MainRunnerService, PackCliOptions, PackCommand, PermissionsCommand, PlatformAuthStateService, PlatformPublishAuthState, PublishCliOptions, PublishCommand, RegistryCommand, ResolvedDocumentGrant, ResolvedPermissions, RevokeCliOptions, RevokeCommand, RuntimeCliOptions, UiServerService, UninstallCliOptions, UninstallCommand, UpdateCliOptions, UpdateCommand, WasmDocumentSummaryInput, WasmMainRunnerService, WasmSidecarClientService, WasmtimeWasiHttpComponentHandle, WasmtimeWasiHttpComponentService, WasmtimeWasiHttpComponentStartOptions };

package/dist/index.js

@@ -1,6 +1,8 @@
 import { AppManifestService } from "./manifest/app-manifest.service.js";
 import { AppBundleService } from "./bundle/app-bundle.service.js";
 import { HostBridgeServer } from "./bridge/host-bridge.service.js";
+import { AppTsHttpScaffoldTemplateService } from "./scaffold/app-ts-http-scaffold-template.service.js";
+import { AppScaffoldService } from "./scaffold/app-scaffold.service.js";
 import { CreateCommand } from "./commands/create.controller.js";
 import { UiServerService } from "./ui/ui-server.service.js";
 import { AppHostService } from "./host/app-host.service.js";
@@ -15,6 +17,7 @@ import { AppRegistryConfigService } from "./registry/app-registry-config.service
 import { AppRemoteRegistryClientService } from "./registry/app-remote-registry-client.service.js";
 import { AppRegistryService } from "./registry/app-registry.service.js";
 import { AppInstallationService } from "./install/app-installation.service.js";
+import { WasmtimeWasiHttpComponentService } from "./runtime/wasmtime-wasi-http-component.service.js";
 import { AppGrantService } from "./permissions/app-grant.service.js";
 import { GrantCommand } from "./commands/grant.controller.js";
 import { InfoCommand } from "./commands/info.controller.js";
@@ -25,12 +28,15 @@ import { PermissionsCommand } from "./commands/permissions.controller.js";
 import { DEFAULT_APP_MARKETPLACE_API_BASE } from "./publish/app-publish.types.js";
 import { AppMarketplaceClientService } from "./publish/app-marketplace-client.service.js";
 import { AppMarketplaceMetadataService } from "./publish/app-marketplace-metadata.service.js";
+import { PlatformAuthStateService } from "./publish/platform-auth-state.service.js";
 import { AppPublishService } from "./publish/app-publish.service.js";
 import { PublishCommand } from "./commands/publish.controller.js";
 import { RegistryCommand } from "./commands/registry.controller.js";
 import { RevokeCommand } from "./commands/revoke.controller.js";
 import { UninstallCommand } from "./commands/uninstall.controller.js";
 import { UpdateCommand } from "./commands/update.controller.js";
+import { AppRuntimeToolchainService } from "./runtime/app-runtime-toolchain.service.js";
+import { AppBuildService } from "./runtime/app-build.service.js";
 import { AppRuntimeOptionsService } from "./cli/app-runtime-options.service.js";
 import { AppRuntimeCliService } from "./cli/app-runtime-cli.service.js";
-export { AppBundleService, AppGrantService, AppHomeService, AppHostService, AppInstallationService, AppInstanceService, AppManifestService, AppMarketplaceClientService, AppMarketplaceMetadataService, AppPermissionsService, AppPublishService, AppRegistryConfigService, AppRegistryService, AppRemoteRegistryClientService, AppRuntimeCliService, AppRuntimeOptionsService, CreateCommand, DEFAULT_APP_MARKETPLACE_API_BASE, DEFAULT_APP_REGISTRY_URL, GrantCommand, HostBridgeServer, InfoCommand, InstallCommand, ListCommand, MainRunnerService, PackCommand, PermissionsCommand, PublishCommand, RegistryCommand, RevokeCommand, UiServerService, UninstallCommand, UpdateCommand, WasmMainRunnerService, WasmSidecarClientService };
+export { AppBuildService, AppBundleService, AppGrantService, AppHomeService, AppHostService, AppInstallationService, AppInstanceService, AppManifestService, AppMarketplaceClientService, AppMarketplaceMetadataService, AppPermissionsService, AppPublishService, AppRegistryConfigService, AppRegistryService, AppRemoteRegistryClientService, AppRuntimeCliService, AppRuntimeOptionsService, AppRuntimeToolchainService, AppScaffoldService, AppTsHttpScaffoldTemplateService, CreateCommand, DEFAULT_APP_MARKETPLACE_API_BASE, DEFAULT_APP_REGISTRY_URL, GrantCommand, HostBridgeServer, InfoCommand, InstallCommand, ListCommand, MainRunnerService, PackCommand, PermissionsCommand, PlatformAuthStateService, PublishCommand, RegistryCommand, RevokeCommand, UiServerService, UninstallCommand, UpdateCommand, WasmMainRunnerService, WasmSidecarClientService, WasmtimeWasiHttpComponentService };

package/dist/install/app-installation.service.js

@@ -179,6 +179,7 @@ var AppInstallationService = class {
 		return {
 			appDirectory: activeVersion.installDirectory,
 			appId: appRecord.appId,
+			dataDirectory: appRecord.dataDirectory,
 			documentGrantMap: {
 				...appRecord.grants,
 				...explicitDocumentGrantMap

package/dist/install/app-installation.types.d.ts

@@ -52,6 +52,7 @@ type AppUninstallResult = {
 type AppLaunchResolution = {
   appDirectory: string;
   appId?: string;
+  dataDirectory?: string;
   documentGrantMap: AppDocumentGrantMap;
 };
 type AppUpdateResult = AppInstallResult & {

package/dist/manifest/app-manifest.service.js

@@ -27,7 +27,8 @@ var AppManifestService = class {
 			name: bundle.manifest.name,
 			version: bundle.manifest.version,
 			description: bundle.manifest.description,
-			action: bundle.manifest.main.action,
+			mainKind: bundle.manifest.main.kind,
+			action: bundle.manifest.main.kind === "wasm" ? bundle.manifest.main.action : void 0,
 			manifestPath: bundle.manifestPath,
 			mainEntryPath: bundle.mainEntryPath,
 			uiEntryPath: bundle.uiEntryPath,
@@ -54,13 +55,18 @@ var AppManifestService = class {
 	};
 	parseMain = (rawMain) => {
 		const candidate = this.assertObject(rawMain, "main");
-		if (this.readRequiredString(candidate.kind, "main.kind") !== "wasm") throw new Error("当前 main.kind 只支持 wasm。");
-		return {
+		const kind = this.readRequiredString(candidate.kind, "main.kind");
+		if (kind === "wasm") return {
 			kind: "wasm",
 			entry: this.readRequiredString(candidate.entry, "main.entry"),
 			export: this.readRequiredString(candidate.export, "main.export"),
 			action: this.readRequiredString(candidate.action, "main.action")
 		};
+		if (kind === "wasi-http-component") return {
+			kind: "wasi-http-component",
+			entry: this.readRequiredString(candidate.entry, "main.entry")
+		};
+		throw new Error("当前 main.kind 只支持 wasm 或 wasi-http-component。");
 	};
 	parseUi = (rawUi) => {
 		const candidate = this.assertObject(rawUi, "ui");

package/dist/manifest/app-manifest.types.d.ts

@@ -15,12 +15,17 @@ type AppPermissions = {
     hostBridge?: boolean;
   };
 };
-type AppMainManifest = {
+type AppCoreWasmMainManifest = {
   kind: "wasm";
   entry: string;
   export: string;
   action: string;
 };
+type AppWasiHttpComponentMainManifest = {
+  kind: "wasi-http-component";
+  entry: string;
+};
+type AppMainManifest = AppCoreWasmMainManifest | AppWasiHttpComponentMainManifest;
 type AppUiManifest = {
   entry: string;
 };
@@ -50,7 +55,8 @@ type AppManifestSummary = {
   name: string;
   version: string;
   description?: string;
-  action: string;
+  mainKind: AppMainManifest["kind"];
+  action?: string;
   manifestPath: string;
   mainEntryPath: string;
   uiEntryPath: string;
@@ -58,4 +64,4 @@ type AppManifestSummary = {
   permissions: AppPermissions;
 };
 //#endregion
-export { AppDocumentAccessMode, AppDocumentAccessScope, AppMainManifest, AppManifest, AppManifestBundle, AppManifestSummary, AppPermissions, AppUiManifest };
+export { AppCoreWasmMainManifest, AppDocumentAccessMode, AppDocumentAccessScope, AppMainManifest, AppManifest, AppManifestBundle, AppManifestSummary, AppPermissions, AppUiManifest, AppWasiHttpComponentMainManifest };

package/dist/package.js

@@ -1,4 +1,4 @@
 //#region package.json
-var version = "0.4.0";
+var version = "0.5.0";
 //#endregion
 export { version };

package/dist/publish/app-marketplace-client.service.js

@@ -3,8 +3,8 @@ import "./app-publish.types.js";
 var AppMarketplaceClientService = class {
 	publish = async (params) => {
 		const apiBaseUrl = this.normalizeApiBase(params.apiBaseUrl ?? "https://apps-registry.nextclaw.io");
-		const token = params.token?.trim() || process.env.NEXTCLAW_MARKETPLACE_ADMIN_TOKEN?.trim();
-		if (!token) throw new Error("缺少 marketplace admin token，请传 --token 或设置 NEXTCLAW_MARKETPLACE_ADMIN_TOKEN。");
+		const token = params.token?.trim();
+		if (!token) throw new Error("缺少 marketplace publish token。请先登录 NextClaw，或传入 --token。");
 		const response = await fetch(`${apiBaseUrl}/api/v1/apps/publish`, {
 			method: "POST",
 			headers: {