nextclaw 0.44.1 → 0.45.0

package/dist/{nextclaw-distribution.utils-BneKclXo.js → nextclaw-distribution.utils-Bba2GRvc.js}

@@ -6,6 +6,7 @@ function createNextclawDistribution(importMetaUrl) {
 	const entrypoint = fileURLToPath(importMetaUrl);
 	const packageRoot = resolve(dirname(entrypoint), "../../..");
 	const { version } = JSON.parse(readFileSync(resolve(packageRoot, "package.json"), "utf-8"));
+	const portableRunnerExecutable = process.platform === "win32" ? "nextclaw-wasmtime-runner.exe" : "nextclaw-wasmtime-runner";
 	return {
 		version: typeof version === "string" ? version : "0.0.0",
 		appEntrypoint: resolve(packageRoot, "dist/cli/app/index.js"),
@@ -15,10 +16,11 @@ function createNextclawDistribution(importMetaUrl) {
 		templatesDir: resolve(packageRoot, "templates"),
 		uiDistDir: resolve(packageRoot, "ui-dist"),
 		runtimeUpdatePublicKeyPath: resolve(packageRoot, "resources/update-bundle-public.pem"),
-		builtInAppsDirectory: resolve(packageRoot, "resources/apps")
+		builtInAppsDirectory: resolve(packageRoot, "resources/apps"),
+		portableServiceRunnerPath: resolve(packageRoot, "resources/native", `${process.platform}-${process.arch}`, portableRunnerExecutable)
 	};
 }
 //#endregion
 export { createNextclawDistribution as t };
 
-//# sourceMappingURL=nextclaw-distribution.utils-BneKclXo.js.map
+//# sourceMappingURL=nextclaw-distribution.utils-Bba2GRvc.js.map

package/dist/nextclaw-distribution.utils-Bba2GRvc.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"nextclaw-distribution.utils-Bba2GRvc.js","names":[],"sources":["../src/cli/shared/lib/distribution/nextclaw-distribution.utils.ts"],"sourcesContent":["import { readFileSync } from \"node:fs\";\nimport { basename, dirname, resolve } from \"node:path\";\nimport { fileURLToPath } from \"node:url\";\nimport type { NextclawDistribution } from \"@nextclaw/service\";\n\nexport function createNextclawDistribution(importMetaUrl: string): NextclawDistribution {\n  const entrypoint = fileURLToPath(importMetaUrl);\n  const packageRoot = resolve(dirname(entrypoint), \"../../..\");\n  const { version } = JSON.parse(readFileSync(resolve(packageRoot, \"package.json\"), \"utf-8\")) as { version?: string };\n  const portableRunnerExecutable = process.platform === \"win32\"\n    ? \"nextclaw-wasmtime-runner.exe\"\n    : \"nextclaw-wasmtime-runner\";\n  return {\n    version: typeof version === \"string\" ? version : \"0.0.0\",\n    appEntrypoint: resolve(packageRoot, \"dist/cli/app/index.js\"),\n    launcherVersion: typeof version === \"string\" ? version : \"0.0.0\",\n    launcherEntrypoint: resolve(dirname(entrypoint), \"../launcher\", basename(entrypoint)),\n    launchedByLauncher: false,\n    templatesDir: resolve(packageRoot, \"templates\"),\n    uiDistDir: resolve(packageRoot, \"ui-dist\"),\n    runtimeUpdatePublicKeyPath: resolve(packageRoot, \"resources/update-bundle-public.pem\"),\n    builtInAppsDirectory: resolve(packageRoot, \"resources/apps\"),\n    portableServiceRunnerPath: resolve(\n      packageRoot,\n      \"resources/native\",\n      `${process.platform}-${process.arch}`,\n      portableRunnerExecutable,\n    )\n  };\n}\n"],"mappings":";;;;AAKA,SAAgB,2BAA2B,eAA6C;CACtF,MAAM,aAAa,cAAc,cAAc;CAC/C,MAAM,cAAc,QAAQ,QAAQ,WAAW,EAAE,WAAW;CAC5D,MAAM,EAAE,YAAY,KAAK,MAAM,aAAa,QAAQ,aAAa,eAAe,EAAE,QAAQ,CAAC;CAC3F,MAAM,2BAA2B,QAAQ,aAAa,UAClD,iCACA;AACJ,QAAO;EACL,SAAS,OAAO,YAAY,WAAW,UAAU;EACjD,eAAe,QAAQ,aAAa,wBAAwB;EAC5D,iBAAiB,OAAO,YAAY,WAAW,UAAU;EACzD,oBAAoB,QAAQ,QAAQ,WAAW,EAAE,eAAe,SAAS,WAAW,CAAC;EACrF,oBAAoB;EACpB,cAAc,QAAQ,aAAa,YAAY;EAC/C,WAAW,QAAQ,aAAa,UAAU;EAC1C,4BAA4B,QAAQ,aAAa,qCAAqC;EACtF,sBAAsB,QAAQ,aAAa,iBAAiB;EAC5D,2BAA2B,QACzB,aACA,oBACA,GAAG,QAAQ,SAAS,GAAG,QAAQ,QAC/B,yBACD;EACF"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nextclaw",
-  "version": "0.44.1",
+  "version": "0.45.0",
   "description": "Powerful AI assistant for coordinating agents, skills, CLI tools, automations, and messaging apps.",
   "private": false,
   "type": "module",
@@ -41,21 +41,22 @@
     "commander": "^12.1.0",
     "jszip": "^3.10.1",
     "yaml": "^2.8.1",
-    "@nextclaw/app-runtime": "0.13.2",
-    "@nextclaw/kernel": "0.10.3",
-    "@nextclaw/mcp": "0.3.37",
-    "@nextclaw/core": "0.17.10",
-    "@nextclaw/nextclaw-hermes-acp-bridge": "0.3.21",
-    "@nextclaw/ncp-toolkit": "0.6.23",
+    "@nextclaw/core": "0.17.11",
+    "@nextclaw/app-runtime": "0.14.0",
+    "@nextclaw/kernel": "0.12.0",
     "@nextclaw/ncp": "0.10.0",
     "@nextclaw/ncp-agent-runtime": "0.4.21",
-    "@nextclaw/ncp-mcp": "0.2.37",
-    "@nextclaw/nextclaw-ncp-runtime-stdio-client": "0.3.37",
+    "@nextclaw/mcp": "0.3.38",
+    "@nextclaw/ncp-mcp": "0.2.38",
+    "@nextclaw/ncp-toolkit": "0.6.23",
     "@nextclaw/nextclaw-ncp-runtime-http-client": "0.3.22",
-    "@nextclaw/service": "0.3.48",
-    "@nextclaw/remote": "0.3.45",
-    "@nextclaw/server": "0.18.3",
-    "@nextclaw/runtime": "0.4.36"
+    "@nextclaw/nextclaw-ncp-runtime-stdio-client": "0.3.38",
+    "@nextclaw/nextclaw-hermes-acp-bridge": "0.3.21",
+    "@nextclaw/runtime": "0.4.37",
+    "@nextclaw/service": "0.4.0",
+    "@nextclaw/remote": "0.3.47",
+    "@nextclaw/shared": "0.4.29",
+    "@nextclaw/server": "0.20.0"
   },
   "devDependencies": {
     "@types/node": "^20.17.6",
@@ -63,7 +64,7 @@
     "tsx": "^4.19.2",
     "typescript": "^5.6.3",
     "vitest": "^4.1.2",
-    "@nextclaw/ui": "0.20.3"
+    "@nextclaw/ui": "0.22.0"
   },
   "scripts": {
     "dev": "tsx watch --tsconfig ../../scripts/dev/dev-runtime.tsconfig.json src/cli/app/index.ts",

package/resources/USAGE.md

@@ -20,6 +20,7 @@ When NextClaw AI needs to operate the product itself (version/status/doctor/serv
 8. **Desktop-installed AI uses the same command names**. When NextClaw Desktop launches the runtime, it exposes a managed `nextclaw` command surface to AI command tools, so self-management commands keep using `nextclaw ...` without requiring a global NPM install.
 9. **Restart live Service App runtimes before live retest**: after modifying a running Service App, use `nextclaw app restart <app-id> --json` before validating through the product UI or panel-to-service action calls.
 10. **Manage App data through the product contract**: list data with `nextclaw app data list --json`; delete only a `retained` entry with the returned data id and an exact `--confirm <app-id>`. Never replace this flow with a recursive filesystem deletion.
+11. **Manage Mini Apps through the product contract**: use `nextclaw app install <app-id|local-dir|bundle.napp>`, `list`, `operations`, `enable`, `disable`, `update`, `rollback`, and `uninstall`. Do not use or recommend another App runtime command.
 
 ---
 
@@ -35,6 +36,7 @@ When NextClaw AI needs to operate the product itself (version/status/doctor/serv
 - [Session management (UI)](#session-management-ui)
 - [Workspace](#workspace)
 - [Publishing Mini Apps](#publishing-mini-apps)
+- [Managing Mini Apps](#managing-mini-apps)
 - [App data and uninstall](#app-data-and-uninstall)
 - [Commands](#commands)
 - [Channels](#channels)
@@ -463,6 +465,9 @@ nextclaw projects create knowledge --path ~/Projects/knowledge --template knowle
 nextclaw sessions rename <session-id> "Research session" --json
 nextclaw sessions set-project <session-id> ~/Projects/research --json
 nextclaw sessions clear-project <session-id> --json
+
+# Permanently delete a session (the confirmation must match the session ID)
+nextclaw sessions delete <session-id> --confirm <session-id> --json
 ```
 
 The UI, CLI, and built-in AI tools all use the same kernel-owned operations. AI exposes them through `projects_list`, `projects_create`, and `sessions_update`. Project creation never overwrites a non-empty directory. Binding an existing directory registers it as a project; binding the default workspace clears the explicit project binding instead.
@@ -473,7 +478,7 @@ This is useful when running multi-agent routing and channel operations long term
 
 NextClaw UI includes a first-class **Chat** tab so you can talk to your agent directly from browser:
 
-- create/switch/delete sessions from the left panel
+- create, switch, rename, pin, or delete sessions from the left panel; press Enter to confirm a deletion or Escape to cancel
 - filter session list by channel in the left panel
 - inspect complete session history in the thread panel
 - choose target agent before sending message
@@ -574,6 +579,22 @@ After validation succeeds, submit the package for review:
 nextclaw app publish <mini-app-dir> --json
 ```
 
+## Managing Mini Apps
+
+Use the same NextClaw command surface for Marketplace Apps, local App directories, and local `.napp` bundles. The Marketplace keeps an App identifier and registry location; its displayed installation command is derived by NextClaw, not stored per App.
+
+```bash
+nextclaw app marketplace search --query notes --json
+nextclaw app marketplace info nextclaw.personal-organizer --json
+nextclaw app install nextclaw.personal-organizer --json
+nextclaw app install ./my-local-app --json
+nextclaw app install ./release/my-local-app.napp --json
+nextclaw app operations --json
+nextclaw app enable nextclaw.personal-organizer --json
+```
+
+Install, update, rollback, and uninstall return a background operation receipt. Check `nextclaw app operations --json` or the Apps page for progress. Schema v2 Apps remain disabled after installation until explicitly enabled.
+
 Personal submissions return `publishStatus: pending` and appear in the public App Marketplace only after approval with `catalogVisibility: listed`. Community Panel-only Apps follow normal review. Schema v2 Service components currently launch host processes with the user's permissions, so their root manifest must declare `runtime.profile: native-process` and enter high-privilege manual review; an administrator may approve them as `listed` or `unlisted`. Installed schema v2 Apps remain disabled until the user explicitly enables them. Schema v2 WASI Service components are not supported yet—changing only the profile does not create a sandbox. Pending or rejected submissions can be corrected and submitted again. Updating an already published personal app is intentionally blocked until version-level review is available, so the current public version remains online.
 
 Use `https://platform.nextclaw.io/apps` to review submission status. The built-in `nextclaw-app-publisher` skill lets NextClaw AI assemble a package from existing Panel/Service directories, run the checks, guide login, and submit it with the same native commands.
@@ -623,11 +644,11 @@ nextclaw app data list --json
 
 The second list verifies that the retained entry is gone. Do not build a data id manually and do not remove managed directories with `rm -rf`.
 
-For the low-level NApp runtime, uninstall keeps data unless `--purge-data` is present:
+Uninstall keeps data unless `--purge-data` is present:
 
 ```bash
-napp uninstall <app-id>
-napp uninstall <app-id> --purge-data
+nextclaw app uninstall <app-id>
+nextclaw app uninstall <app-id> --purge-data --confirm <app-id>
 ```
 
 Service App development gets a separate, deterministic development instance. Resetting it is destructive and therefore requires both the reset flag and an exact manifest id confirmation:
@@ -655,6 +676,17 @@ nextclaw app dev <service-app-dir> --reset-data --confirm <app-id> --json
 | `nextclaw app validate-publish <mini-app-dir>` | Validate a schema v2 Mini App package before Marketplace submission |
 | `nextclaw app publish <mini-app-dir>` | Submit a validated Mini App to the App Marketplace for review |
 | `nextclaw app restart <app-id>` | Restart a live Service App runtime in the running UI before live retest |
+| `nextclaw app marketplace search` | Search Apps available from the official App Marketplace |
+| `nextclaw app marketplace info <app-id>` | Show a Marketplace App and its derived installation command |
+| `nextclaw app list` | List Apps installed in the running NextClaw host |
+| `nextclaw app info <app-id>` | Show the installed App state and versions |
+| `nextclaw app operations` | List durable App lifecycle operations |
+| `nextclaw app install <app-id\|local-dir\|bundle.napp>` | Install an App through the running host |
+| `nextclaw app enable <app-id>` | Enable an installed App |
+| `nextclaw app disable <app-id>` | Disable an installed App |
+| `nextclaw app update <app-id>` | Start a background App update |
+| `nextclaw app rollback <app-id> --version <version>` | Roll back to an installed version |
+| `nextclaw app uninstall <app-id>` | Start a background uninstall; require exact confirmation to purge data |
 | `nextclaw service install-systemd --user` | Install a user-level Linux `systemd` service for NextClaw |
 | `sudo nextclaw service install-systemd --system` | Install a system-wide Linux `systemd` service for NextClaw |
 | `nextclaw service uninstall-systemd --user` | Remove a user-level Linux `systemd` service |

package/resources/apps/nextclaw-personal-organizer/README.md

@@ -18,7 +18,7 @@ Data is stored locally under NextClaw's app data directory. Each panel only decl
 Personal Space is built into supported NextClaw releases. It can also be installed from the official Apps Registry:
 
 ```bash
-napp install nextclaw.personal-organizer
+nextclaw app install nextclaw.personal-organizer
 ```
 
 After installation, open **Apps** in NextClaw and enable Personal Space. You can then launch Todos, Notes, Favorites, or Calendar independently.

package/resources/apps/nextclaw-portable-runtime-lab/README.md

@@ -0,0 +1,34 @@
+# 日常小工具箱
+
+这是 Portable Runtime MVP 的产品化体验包。它不要求体验者理解 WASM、Action 或 Provider，而是先提供四个普通人能直接使用的小应用；每个应用背后对应一条必须验证的运行时主链。
+
+## 先体验产品
+
+| 小应用 | 能做什么 | 背后验证的机制 |
+| --- | --- | --- |
+| 今日清单 | 添加、完成、恢复和删除今天的任务 | Rust/WASM 数据 Action、Host KV 持久化、Panel 与 Agent 共用数据 |
+| 灵感便签 | 随手保存、搜索和删除便签 | 两个独立 Panel 复用同一个数据 Component |
+| 专注小钟 | 开始一轮专注、记录完成点，关掉页面后仍计时 | Resident Component、宿主事件投递、持久恢复 |
+| 联系人整理 | 清理姓名空格、邮箱大小写和重复标签 | Consumer 经宿主调用独立 Provider Component |
+
+应用列表还保留一个「开发者验证台」。它不是普通用户的主入口，只用于查看共享 runner、受控网络、越权拒绝、超时恢复和运行时指标等底层证据。
+
+## Agent 也能使用
+
+「今日清单」和「灵感便签」使用的 Service Action 可以显式授权给 Agent。授权后，Panel 与 Agent 操作的是同一份结构化数据，权限、持久化和错误处理也走同一条主链，没有 Demo 专用旁路。
+
+## 真实调用链
+
+```text
+日常小应用 / Agent
+  → Service Action 授权
+  → ServiceAppManager
+  → wasi-component runtime
+  → 共享 Rust/Wasmtime runner
+  → Host capability / component-call
+  → Rust/WASM Component
+```
+
+## 当前边界
+
+这是单平台技术 MVP：官方 Guest 只覆盖 Rust，不承诺 Python/FastAPI 等现有框架直接编译，也不代表跨平台 runner 分发、签名、升级和生产级资源治理已经完成。

package/resources/apps/nextclaw-portable-runtime-lab/assets/icon.svg

@@ -0,0 +1,12 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 64 64">
+  <defs>
+    <linearGradient id="g" x1="8" y1="8" x2="56" y2="56" gradientUnits="userSpaceOnUse">
+      <stop stop-color="#2dd4bf"/>
+      <stop offset="1" stop-color="#2563eb"/>
+    </linearGradient>
+  </defs>
+  <rect width="64" height="64" rx="16" fill="#07111f"/>
+  <path d="M17 18h30v20a9 9 0 0 1-9 9H26a9 9 0 0 1-9-9V18Z" fill="none" stroke="url(#g)" stroke-width="4"/>
+  <path d="M24 27h16M24 35h10" stroke="#e6fffb" stroke-width="3" stroke-linecap="round"/>
+  <circle cx="46" cy="46" r="7" fill="#60a5fa" stroke="#07111f" stroke-width="3"/>
+</svg>

package/resources/apps/nextclaw-portable-runtime-lab/manifest.json

@@ -0,0 +1,74 @@
+{
+  "schemaVersion": 2,
+  "id": "nextclaw.portable-runtime-lab",
+  "name": "日常小工具箱",
+  "version": "0.5.2",
+  "description": "清单、便签、专注计时和联系人整理，四个能直接使用的日常小应用。",
+  "icon": "assets/icon.svg",
+  "engines": {
+    "nextclaw": ">=0.43.0"
+  },
+  "presentation": {
+    "primaryPanel": "nextclaw-portable-runtime-lab-todos"
+  },
+  "runtime": {
+    "profile": "wasi"
+  },
+  "distribution": {
+    "mode": "universal"
+  },
+  "storage": {
+    "scope": "global",
+    "schemaVersion": 1
+  },
+  "permissions": {
+    "storage": {
+      "namespace": "portable-runtime-lab"
+    },
+    "allowedDomains": [
+      "httpbin.org"
+    ]
+  },
+  "components": [
+    {
+      "kind": "panel",
+      "path": "panels/nextclaw-portable-runtime-lab-todos.panel"
+    },
+    {
+      "kind": "panel",
+      "path": "panels/nextclaw-portable-runtime-lab-notes.panel"
+    },
+    {
+      "kind": "panel",
+      "path": "panels/nextclaw-portable-runtime-lab-focus.panel"
+    },
+    {
+      "kind": "panel",
+      "path": "panels/nextclaw-portable-runtime-lab-contacts.panel"
+    },
+    {
+      "kind": "panel",
+      "path": "panels/nextclaw-portable-runtime-lab-panel.panel"
+    },
+    {
+      "kind": "service",
+      "path": "service-components/nextclaw-portable-runtime-lab-state"
+    },
+    {
+      "kind": "service",
+      "path": "service-components/nextclaw-portable-runtime-lab-capabilities"
+    },
+    {
+      "kind": "service",
+      "path": "service-components/nextclaw-portable-runtime-lab-resident"
+    },
+    {
+      "kind": "service",
+      "path": "service-components/nextclaw-portable-runtime-lab-provider"
+    },
+    {
+      "kind": "service",
+      "path": "service-components/nextclaw-portable-runtime-lab-composition"
+    }
+  ]
+}

package/resources/apps/nextclaw-portable-runtime-lab/marketplace.json

@@ -0,0 +1,21 @@
+{
+  "slug": "portable-runtime-lab",
+  "summary": "Four everyday mini apps powered by portable Rust/WASM services.",
+  "summaryI18n": {
+    "zh-CN": "用清单、便签、专注计时和联系人整理，体验可移植 Service App。",
+    "en-US": "Use todos, notes, a focus timer, and contact cleanup powered by portable Service Apps."
+  },
+  "description": "Product-first demos for persistent data, shared capabilities, resident background work, component composition, and Agent access.",
+  "descriptionI18n": {
+    "zh-CN": "四个普通人能直接使用的小应用，背后覆盖持久数据、能力复用、后台常驻、组件组合与 Agent 调用。",
+    "en-US": "Four approachable mini apps backed by persistence, capability reuse, resident work, component composition, and Agent access."
+  },
+  "author": "NextClaw",
+  "tags": ["productivity", "todo", "notes", "wasm", "experimental"],
+  "sourceRepo": "https://github.com/Peiiii/nextclaw",
+  "homepage": "https://nextclaw.io",
+  "featured": false,
+  "visuals": {
+    "accentColor": "#7C5CFC"
+  }
+}

package/resources/apps/nextclaw-portable-runtime-lab/panels/nextclaw-portable-runtime-lab-contacts.panel/assets/app.js

@@ -0,0 +1,92 @@
+const actionIds = {
+  compose: "nextclaw-portable-runtime-lab-composition.compose_contact",
+  providerStatus: "nextclaw-portable-runtime-lab-provider.provider_status",
+};
+
+const elements = {
+  form: document.querySelector("[data-contact-form]"),
+  name: document.querySelector("[data-name]"),
+  email: document.querySelector("[data-email]"),
+  tags: document.querySelector("[data-tags]"),
+  card: document.querySelector("[data-contact-card]"),
+  placeholder: document.querySelector("[data-placeholder]"),
+  avatar: document.querySelector("[data-avatar]"),
+  displayName: document.querySelector("[data-display-name]"),
+  displayEmail: document.querySelector("[data-display-email]"),
+  displayTags: document.querySelector("[data-display-tags]"),
+  copy: document.querySelector("[data-copy]"),
+  notice: document.querySelector("[data-notice]"),
+  count: document.querySelector("[data-proof-count]"),
+};
+
+let latestContact = null;
+
+function serviceActions() {
+  const bridge = window.nextclaw?.serviceActions;
+  if (!bridge) throw new Error("应用还没有连接到 NextClaw，请刷新后重试。");
+  return bridge;
+}
+
+async function invoke(actionId, input = {}) {
+  return await serviceActions().invoke(actionId, input);
+}
+
+function initials(name) {
+  const parts = name.split(/\s+/).filter(Boolean);
+  return parts.slice(0, 2).map((part) => part[0]?.toUpperCase() ?? "").join("") || "?";
+}
+
+function render(result) {
+  const provider = result.provider ?? {};
+  latestContact = {
+    name: provider.normalizedName ?? "",
+    email: provider.normalizedEmail ?? "",
+    tags: Array.isArray(provider.normalizedTags) ? provider.normalizedTags : [],
+  };
+  elements.placeholder.hidden = true;
+  elements.card.hidden = false;
+  elements.avatar.textContent = initials(latestContact.name);
+  elements.displayName.textContent = latestContact.name;
+  elements.displayEmail.textContent = latestContact.email;
+  elements.displayEmail.href = `mailto:${latestContact.email}`;
+  elements.displayTags.replaceChildren();
+  for (const tag of latestContact.tags) {
+    const chip = document.createElement("span");
+    chip.textContent = tag;
+    elements.displayTags.append(chip);
+  }
+  elements.count.textContent = `${provider.providerCallCount ?? "—"} 次`;
+}
+
+elements.form.addEventListener("submit", (event) => {
+  event.preventDefault();
+  elements.notice.textContent = "正在整理…";
+  elements.notice.dataset.tone = "";
+  void invoke(actionIds.compose, {
+    name: elements.name.value,
+    email: elements.email.value,
+    tags: elements.tags.value.split(",").map((tag) => tag.trim()).filter(Boolean),
+  }).then((result) => {
+    render(result);
+    elements.notice.textContent = "姓名空格、邮箱大小写和重复标签都已整理";
+    elements.notice.dataset.tone = "success";
+  }).catch((error) => {
+    elements.notice.textContent = error instanceof Error ? error.message : String(error);
+    elements.notice.dataset.tone = "error";
+  });
+});
+
+elements.copy.addEventListener("click", () => {
+  if (!latestContact) return;
+  const text = `${latestContact.name} <${latestContact.email}>${latestContact.tags.length ? ` · ${latestContact.tags.join(", ")}` : ""}`;
+  void navigator.clipboard.writeText(text).then(() => {
+    elements.notice.textContent = "联系人已复制";
+    elements.notice.dataset.tone = "success";
+  }).catch(() => {
+    elements.notice.textContent = text;
+  });
+});
+
+void invoke(actionIds.providerStatus).then((status) => {
+  elements.count.textContent = `${status.providerCallCount ?? 0} 次`;
+}).catch(() => undefined);

package/resources/apps/nextclaw-portable-runtime-lab/panels/nextclaw-portable-runtime-lab-contacts.panel/assets/style.css

@@ -0,0 +1,43 @@
+:root { color-scheme: light; font-family: Inter, "PingFang SC", "Microsoft YaHei", sans-serif; color: #282b45; background: #eef1fb; }
+* { box-sizing: border-box; }
+body { margin: 0; min-width: 320px; background: radial-gradient(circle at 85% 10%, #e8dcff 0, transparent 35%), linear-gradient(135deg, #f9faff, #eef2fb); }
+button, input { font: inherit; }
+button { cursor: pointer; }
+.app-shell { width: min(940px, calc(100% - 32px)); margin: 0 auto; padding: 38px 0 52px; }
+.hero { margin-bottom: 26px; }
+.eyebrow { margin: 0 0 8px; color: #725cc7; font-size: 12px; font-weight: 800; letter-spacing: .18em; }
+h1 { margin: 0; font-family: Georgia, "Noto Serif SC", serif; font-size: clamp(36px, 7vw, 58px); letter-spacing: -.04em; }
+.hero > p:last-child { margin: 8px 0 0; color: #74758a; }
+.workspace { display: grid; grid-template-columns: minmax(260px, .9fr) minmax(300px, 1.1fr); gap: 18px; min-height: 370px; }
+.contact-form { display: grid; align-content: start; gap: 16px; padding: 22px; border: 1px solid #dee2f1; border-radius: 22px; background: rgba(255,255,255,.82); box-shadow: 0 20px 60px rgba(58,62,102,.09); }
+.contact-form label { display: grid; gap: 7px; color: #65677c; font-size: 13px; font-weight: 650; }
+.contact-form input { width: 100%; border: 1px solid #d9ddec; border-radius: 11px; outline: 0; padding: 11px 12px; color: #2f314b; background: #fafbff; font-weight: 450; }
+.contact-form input:focus { border-color: #8976d2; box-shadow: 0 0 0 3px rgba(137,118,210,.12); }
+.contact-form button { margin-top: 4px; border: 0; border-radius: 12px; padding: 12px 18px; color: #fff; background: #6650b8; font-weight: 750; }
+.contact-card, .placeholder { border: 1px solid #dcdff0; border-radius: 24px; background: linear-gradient(145deg, rgba(255,255,255,.92), rgba(245,244,255,.9)); box-shadow: 0 24px 70px rgba(59,58,105,.12); }
+.contact-card { position: relative; display: flex; align-items: center; gap: 18px; padding: 32px; overflow: hidden; }
+.contact-card::after { position: absolute; right: -55px; bottom: -75px; width: 190px; height: 190px; border-radius: 50%; background: rgba(150,125,224,.12); content: ""; }
+.contact-card[hidden] { display: none; }
+.avatar { display: grid; flex: 0 0 auto; width: 78px; height: 78px; place-items: center; border-radius: 24px; color: #fff; background: linear-gradient(145deg, #8973d4, #5d4aaf); box-shadow: 0 10px 25px rgba(88,66,173,.25); font-size: 25px; font-weight: 800; }
+.card-copy { min-width: 0; flex: 1; z-index: 1; }
+.card-copy > p { margin: 0 0 5px; color: #77738f; font-size: 12px; }
+.card-copy h2 { margin: 0; overflow-wrap: anywhere; font-size: 24px; }
+.card-copy a { display: inline-block; margin-top: 5px; color: #6653ad; overflow-wrap: anywhere; text-decoration: none; }
+.tags { display: flex; flex-wrap: wrap; gap: 6px; margin-top: 16px; }
+.tags span { padding: 6px 9px; border-radius: 999px; color: #5c4e91; background: #e8e2fb; font-size: 12px; }
+.copy-button { z-index: 1; align-self: flex-start; border: 1px solid #d6d1e8; border-radius: 10px; padding: 8px 11px; color: #615a78; background: rgba(255,255,255,.8); font-size: 12px; }
+.placeholder { display: flex; flex-direction: column; align-items: center; justify-content: center; gap: 12px; padding: 32px; color: #8a8b9e; text-align: center; }
+.placeholder[hidden] { display: none; }
+.placeholder span { color: #8369dc; font-size: 34px; }
+.placeholder p { max-width: 280px; margin: 0; line-height: 1.6; }
+.notice { min-height: 22px; margin: 14px 2px; color: #74758a; font-size: 14px; }
+.notice[data-tone="success"] { color: #42775b; }
+.notice[data-tone="error"] { color: #ad5047; }
+.behind-scenes { margin-top: 26px; padding: 16px 18px; border: 1px solid #dfe2ef; border-radius: 16px; color: #737488; background: rgba(255,255,255,.55); font-size: 13px; }
+.behind-scenes summary { color: #505268; cursor: pointer; font-weight: 700; }
+.behind-scenes p { line-height: 1.65; }
+.behind-scenes dl { display: grid; grid-template-columns: repeat(2, 1fr); gap: 8px; margin: 12px 0 0; }
+.behind-scenes dl div { padding: 10px; border-radius: 10px; background: #fff; }
+.behind-scenes dt { color: #9697a9; font-size: 11px; }
+.behind-scenes dd { margin: 3px 0 0; color: #505268; overflow-wrap: anywhere; }
+@media (max-width: 680px) { .app-shell { width: calc(100% - 22px); padding-top: 24px; } .workspace { grid-template-columns: 1fr; } .contact-card { min-height: 260px; flex-wrap: wrap; } .copy-button { margin-left: auto; } .behind-scenes dl { grid-template-columns: 1fr; } }

package/resources/apps/nextclaw-portable-runtime-lab/panels/nextclaw-portable-runtime-lab-contacts.panel/index.html

@@ -0,0 +1,43 @@
+<!doctype html>
+<html lang="zh-CN">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>联系人整理</title>
+    <link rel="stylesheet" href="assets/style.css" />
+  </head>
+  <body>
+    <main class="app-shell">
+      <header class="hero">
+        <p class="eyebrow">CONTACT CLEANUP</p>
+        <h1>联系人整理</h1>
+        <p>复制来的信息乱七八糟？交给它变成一张干净的联系人卡片。</p>
+      </header>
+
+      <section class="workspace">
+        <form class="contact-form" data-contact-form>
+          <label>姓名<input data-name value="  Ada   Lovelace  " autocomplete="name" /></label>
+          <label>邮箱<input data-email value=" ADA@EXAMPLE.COM " autocomplete="email" /></label>
+          <label>标签<input data-tags value="AI, ai, Math" placeholder="用逗号分隔" /></label>
+          <button type="submit">整理联系人</button>
+        </form>
+
+        <article class="contact-card" data-contact-card hidden>
+          <div class="avatar" data-avatar>AL</div>
+          <div class="card-copy"><p>整理完成</p><h2 data-display-name>—</h2><a data-display-email>—</a><div class="tags" data-display-tags></div></div>
+          <button type="button" class="copy-button" data-copy>复制</button>
+        </article>
+        <div class="placeholder" data-placeholder><span>✦</span><p>填写左边的信息，整理后的联系人会出现在这里。</p></div>
+      </section>
+
+      <p class="notice" data-notice></p>
+
+      <details class="behind-scenes">
+        <summary>这和普通表单有什么不同？</summary>
+        <p>这个 Panel 只负责收集和展示。真正的规范化逻辑由独立 Provider Component 提供，Consumer 通过宿主受控调用进行组合。以后替换联系人规则，页面不用复制一份实现。</p>
+        <dl><div><dt>组合方式</dt><dd>Host mediated component call</dd></div><div><dt>Provider 已处理</dt><dd data-proof-count>等待执行</dd></div></dl>
+      </details>
+    </main>
+    <script src="assets/app.js"></script>
+  </body>
+</html>

package/resources/apps/nextclaw-portable-runtime-lab/panels/nextclaw-portable-runtime-lab-contacts.panel/panel-app.json

@@ -0,0 +1,10 @@
+{
+  "id": "nextclaw-portable-runtime-lab-contacts",
+  "title": "联系人整理",
+  "description": "把乱格式的姓名、邮箱和标签整理成干净联系人卡片。",
+  "entry": "index.html",
+  "actions": [
+    "nextclaw-portable-runtime-lab-composition.compose_contact",
+    "nextclaw-portable-runtime-lab-provider.provider_status"
+  ]
+}