weacpx 0.4.0-beta.3 → 0.4.1

package/dist/cli.js

@@ -2648,7 +2648,7 @@ class DaemonController {
       status
     };
   }
-  async start() {
+  async start(options = {}) {
     const current = await this.getStatus();
     if (current.state === "running") {
       return { state: "already-running", pid: current.pid };
@@ -2657,7 +2657,7 @@ class DaemonController {
       throw new Error(`weacpx daemon process is already running (pid ${current.pid}) but status metadata is missing`);
     }
     await this.statusStore.clear();
-    const pid = await this.deps.spawnDetached();
+    const pid = await this.deps.spawnDetached(options);
     await this.writePid(pid);
     await this.waitForStartupMetadata(pid);
     return { state: "started", pid };
@@ -2782,12 +2782,12 @@ import { spawn as spawn2 } from "node:child_process";
 function createDaemonController(paths, options) {
   return new DaemonController(paths, {
     isProcessRunning: options.isProcessRunning ?? defaultIsProcessRunning2,
-    spawnDetached: async () => {
+    spawnDetached: async (spawnOptions) => {
       await mkdir4(paths.runtimeDir, { recursive: true });
       const stdoutHandle = await open(paths.stdoutLog, "a");
       const stderrHandle = await open(paths.stderrLog, "a");
       try {
-        return await (options.spawnProcess ?? defaultSpawnProcess)(buildSpawnRequest(paths, options, stdoutHandle.fd, stderrHandle.fd));
+        return await (options.spawnProcess ?? defaultSpawnProcess)(buildSpawnRequest(paths, options, stdoutHandle.fd, stderrHandle.fd, spawnOptions));
       } finally {
         await stdoutHandle.close();
         await stderrHandle.close();
@@ -2804,7 +2804,7 @@ function defaultIsProcessRunning2(pid) {
     return false;
   }
 }
-function buildSpawnRequest(paths, options, stdoutFd, stderrFd) {
+function buildSpawnRequest(paths, options, stdoutFd, stderrFd, spawnOptions = {}) {
   const platform = options.platform ?? process.platform;
   if (platform === "win32") {
     return {
@@ -2825,7 +2825,8 @@ function buildSpawnRequest(paths, options, stdoutFd, stderrFd) {
           WEACPX_DAEMON_ARG1: "run",
           WEACPX_DAEMON_CWD: options.cwd,
           WEACPX_DAEMON_STDOUT: paths.stdoutLog,
-          WEACPX_DAEMON_STDERR: paths.stderrLog
+          WEACPX_DAEMON_STDERR: paths.stderrLog,
+          ...spawnOptions.firstRunOnboarding ? { WEACPX_FIRST_RUN_ONBOARDING: spawnOptions.firstRunOnboarding } : {}
         },
         stdio: ["ignore", "pipe", "ignore"],
         windowsHide: true
@@ -2839,7 +2840,10 @@ function buildSpawnRequest(paths, options, stdoutFd, stderrFd) {
     options: {
       cwd: options.cwd,
       detached: true,
-      env: options.env,
+      env: {
+        ...options.env,
+        ...spawnOptions.firstRunOnboarding ? { WEACPX_FIRST_RUN_ONBOARDING: spawnOptions.firstRunOnboarding } : {}
+      },
       stdio: ["ignore", stdoutFd, stderrFd]
     }
   };
@@ -9829,74 +9833,74 @@ var init_state_store = __esm(() => {
   init_types();
 });
 
-// src/channels/cli/weixin-provider.ts
-var weixinCliProvider;
-var init_weixin_provider = __esm(() => {
-  weixinCliProvider = {
-    type: "weixin",
-    displayName: "Weixin",
-    supportsLogin: true,
-    parseAddArgs(args) {
-      if (args.length > 0)
-        return { ok: false, message: `unknown weixin options: ${args.join(" ")}` };
-      return { ok: true, input: {} };
-    },
-    buildDefaultConfig(_input) {
-      return { id: "weixin", type: "weixin", enabled: true };
+// src/config/agent-templates.ts
+function getAgentTemplate(name) {
+  const template = TEMPLATES[name];
+  if (!template) {
+    return null;
+  }
+  return {
+    ...template
+  };
+}
+function listAgentTemplates() {
+  return Object.keys(TEMPLATES);
+}
+var TEMPLATES;
+var init_agent_templates = __esm(() => {
+  TEMPLATES = {
+    codex: {
+      driver: "codex"
     },
-    validateConfig(config2) {
-      const issues = [];
-      if (config2.id !== "weixin")
-        issues.push({ kind: "invalid-config", message: "weixin channel id must be weixin" });
-      if (config2.type !== "weixin")
-        issues.push({ kind: "invalid-config", message: "weixin channel type must be weixin" });
-      return issues;
+    claude: {
+      driver: "claude"
     },
-    renderSummary(config2) {
-      return [`type: ${config2.type}`, `enabled: ${config2.enabled}`];
+    opencode: {
+      driver: "opencode"
     },
-    async promptForMissingFields(input, _io) {
-      return input;
+    gemini: {
+      driver: "gemini"
     }
   };
 });
 
-// src/channels/cli/registry.ts
-function registerChannelCliProvider(provider) {
-  const type = provider.type.trim();
-  if (!type)
-    throw new Error("channel CLI provider type must be non-empty");
-  if (type.includes(":"))
-    throw new Error("channel CLI provider type must not contain ':'");
-  if (cliProviders.has(type)) {
-    throw new Error(`channel CLI provider is already registered: ${type}`);
-  }
-  cliProviders.set(type, provider);
+// src/plugins/plugin-home.ts
+import { mkdir as mkdir6, writeFile as writeFile5 } from "node:fs/promises";
+import { homedir as homedir3 } from "node:os";
+import { join as join3 } from "node:path";
+function resolvePluginHome(input = {}) {
+  if (input.pluginHome?.trim())
+    return input.pluginHome;
+  if (process.env.WEACPX_PLUGIN_HOME?.trim())
+    return process.env.WEACPX_PLUGIN_HOME;
+  const home = input.home ?? process.env.HOME ?? homedir3();
+  return join3(home, ".weacpx", "plugins");
 }
-function hasChannelCliProvider(type) {
-  bootstrapBuiltinChannelCliProviders();
-  return cliProviders.has(type);
+async function ensurePluginHome(pluginHome) {
+  await mkdir6(pluginHome, { recursive: true, mode: 448 });
+  await writeFile5(join3(pluginHome, "package.json"), JSON.stringify({ private: true, type: "module" }, null, 2) + `
+`, { flag: "wx" }).catch((error2) => {
+    if (error2.code !== "EEXIST")
+      throw error2;
+  });
 }
-function bootstrapBuiltinChannelCliProviders() {
-  if (builtinProvidersRegistered)
+var init_plugin_home = () => {};
+
+// src/weixin/storage/ensure-dir.ts
+import fs2 from "node:fs";
+function ensureDirSync(dir) {
+  try {
+    fs2.mkdirSync(dir, { recursive: true });
     return;
-  builtinProvidersRegistered = true;
-  if (!cliProviders.has(weixinCliProvider.type))
-    registerChannelCliProvider(weixinCliProvider);
-}
-function listChannelCliProviders() {
-  bootstrapBuiltinChannelCliProviders();
-  return Array.from(cliProviders.values());
-}
-function getChannelCliProvider(type) {
-  bootstrapBuiltinChannelCliProviders();
-  return cliProviders.get(type) ?? null;
+  } catch (err) {
+    try {
+      if (fs2.statSync(dir).isDirectory())
+        return;
+    } catch {}
+    throw err;
+  }
 }
-var cliProviders, builtinProvidersRegistered = false;
-var init_registry = __esm(() => {
-  init_weixin_provider();
-  cliProviders = new Map;
-});
+var init_ensure_dir = () => {};
 
 // src/weixin/storage/state-dir.ts
 import os from "node:os";
@@ -9907,7 +9911,7 @@ function resolveStateDir() {
 var init_state_dir = () => {};
 
 // src/weixin/auth/accounts.ts
-import fs2 from "node:fs";
+import fs3 from "node:fs";
 import path4 from "node:path";
 function normalizeAccountId(raw) {
   return raw.trim().toLowerCase().replace(/[@.]/g, "-");
@@ -9930,9 +9934,9 @@ function resolveAccountIndexPath() {
 function listIndexedWeixinAccountIds() {
   const filePath = resolveAccountIndexPath();
   try {
-    if (!fs2.existsSync(filePath))
+    if (!fs3.existsSync(filePath))
       return [];
-    const raw = fs2.readFileSync(filePath, "utf-8");
+    const raw = fs3.readFileSync(filePath, "utf-8");
     const parsed = JSON.parse(raw);
     if (!Array.isArray(parsed))
       return [];
@@ -9943,8 +9947,8 @@ function listIndexedWeixinAccountIds() {
 }
 function registerWeixinAccountId(accountId) {
   const dir = resolveWeixinStateDir();
-  fs2.mkdirSync(dir, { recursive: true });
-  fs2.writeFileSync(resolveAccountIndexPath(), JSON.stringify([accountId], null, 2), "utf-8");
+  ensureDirSync(dir);
+  fs3.writeFileSync(resolveAccountIndexPath(), JSON.stringify([accountId], null, 2), "utf-8");
 }
 function resolveAccountsDir() {
   return path4.join(resolveWeixinStateDir(), "accounts");
@@ -9955,9 +9959,9 @@ function resolveAccountPath(accountId) {
 function loadLegacyToken() {
   const legacyPath = path4.join(resolveStateDir(), "credentials", "openclaw-weixin", "credentials.json");
   try {
-    if (!fs2.existsSync(legacyPath))
+    if (!fs3.existsSync(legacyPath))
       return;
-    const raw = fs2.readFileSync(legacyPath, "utf-8");
+    const raw = fs3.readFileSync(legacyPath, "utf-8");
     const parsed = JSON.parse(raw);
     return typeof parsed.token === "string" ? parsed.token : undefined;
   } catch {
@@ -9966,8 +9970,8 @@ function loadLegacyToken() {
 }
 function readAccountFile(filePath) {
   try {
-    if (fs2.existsSync(filePath)) {
-      return JSON.parse(fs2.readFileSync(filePath, "utf-8"));
+    if (fs3.existsSync(filePath)) {
+      return JSON.parse(fs3.readFileSync(filePath, "utf-8"));
     }
   } catch {}
   return null;
@@ -9989,7 +9993,7 @@ function loadWeixinAccount(accountId) {
 }
 function saveWeixinAccount(accountId, update) {
   const dir = resolveAccountsDir();
-  fs2.mkdirSync(dir, { recursive: true });
+  ensureDirSync(dir);
   const existing = loadWeixinAccount(accountId) ?? {};
   const token = update.token?.trim() || existing.token;
   const baseUrl = update.baseUrl?.trim() || existing.baseUrl;
@@ -10000,14 +10004,14 @@ function saveWeixinAccount(accountId, update) {
     ...userId ? { userId } : {}
   };
   const filePath = resolveAccountPath(accountId);
-  fs2.writeFileSync(filePath, JSON.stringify(data, null, 2), "utf-8");
+  fs3.writeFileSync(filePath, JSON.stringify(data, null, 2), "utf-8");
   try {
-    fs2.chmodSync(filePath, 384);
+    fs3.chmodSync(filePath, 384);
   } catch {}
 }
 function clearWeixinAccount(accountId) {
   try {
-    fs2.unlinkSync(resolveAccountPath(accountId));
+    fs3.unlinkSync(resolveAccountPath(accountId));
   } catch {}
 }
 function clearAllWeixinAccounts() {
@@ -10016,7 +10020,7 @@ function clearAllWeixinAccounts() {
     clearWeixinAccount(id);
   }
   try {
-    fs2.writeFileSync(resolveAccountIndexPath(), "[]", "utf-8");
+    fs3.writeFileSync(resolveAccountIndexPath(), "[]", "utf-8");
   } catch {}
 }
 function resolveConfigPath() {
@@ -10028,9 +10032,9 @@ function resolveConfigPath() {
 function loadConfigRouteTag(accountId) {
   try {
     const configPath = resolveConfigPath();
-    if (!fs2.existsSync(configPath))
+    if (!fs3.existsSync(configPath))
       return;
-    const raw = fs2.readFileSync(configPath, "utf-8");
+    const raw = fs3.readFileSync(configPath, "utf-8");
     const cfg = JSON.parse(raw);
     const channels = cfg.channels;
     const section = channels?.["openclaw-weixin"];
@@ -10074,11 +10078,12 @@ function resolveWeixinAccount(accountId) {
 }
 var DEFAULT_BASE_URL = "https://ilinkai.weixin.qq.com", CDN_BASE_URL = "https://novac2c.cdn.weixin.qq.com/c2c";
 var init_accounts = __esm(() => {
+  init_ensure_dir();
   init_state_dir();
 });
 
 // src/weixin/util/logger.ts
-import fs3 from "node:fs";
+import fs4 from "node:fs";
 import os2 from "node:os";
 import path5 from "node:path";
 function resolveMinLevel() {
@@ -10128,10 +10133,10 @@ function writeLog(level, message, accountId) {
   });
   try {
     if (!logDirEnsured) {
-      fs3.mkdirSync(MAIN_LOG_DIR, { recursive: true });
+      fs4.mkdirSync(MAIN_LOG_DIR, { recursive: true });
       logDirEnsured = true;
     }
-    fs3.appendFileSync(resolveMainLogPath(), `${entry}
+    fs4.appendFileSync(resolveMainLogPath(), `${entry}
 `, "utf-8");
   } catch {}
 }
@@ -11967,7 +11972,7 @@ var init_types2 = __esm(() => {
 });
 
 // src/channels/media-store.ts
-import { access as access2, mkdir as mkdir6, readdir, rm as rm4, stat, writeFile as writeFile5 } from "node:fs/promises";
+import { access as access2, mkdir as mkdir7, readdir, rm as rm4, stat, writeFile as writeFile6 } from "node:fs/promises";
 import path6 from "node:path";
 
 class RuntimeMediaStore {
@@ -11985,13 +11990,13 @@ class RuntimeMediaStore {
     const safeMessageId = safePathSegment(input.messageId || "message");
     const baseFileName = sanitizeMediaFileName(input.fileName ?? "attachment", input.mimeType);
     const dir = path6.join(this.rootDir, input.channelId, safeChatKey, safeMessageId);
-    await mkdir6(dir, { recursive: true });
+    await mkdir7(dir, { recursive: true });
     const resolvedRoot = path6.resolve(this.rootDir);
     const resolvedFile = path6.resolve(path6.join(dir, await uniqueFileName(dir, baseFileName)));
     if (!isPathInside(resolvedFile, resolvedRoot)) {
       throw new Error("media path escapes runtime media root");
     }
-    await writeFile5(resolvedFile, input.buffer);
+    await writeFile6(resolvedFile, input.buffer);
     return {
       kind: input.kind,
       filePath: resolvedFile,
@@ -12103,7 +12108,7 @@ var init_media_store = __esm(() => {
 });
 
 // src/channels/outbound-media-safety.ts
-import fs4 from "node:fs/promises";
+import fs5 from "node:fs/promises";
 import path7 from "node:path";
 async function resolveSafeOutboundMediaPath(mediaPath, allowedRoots) {
   if (mediaPath.startsWith("http://") || mediaPath.startsWith("https://")) {
@@ -12114,7 +12119,7 @@ async function resolveSafeOutboundMediaPath(mediaPath, allowedRoots) {
   if (!realCandidate) {
     return null;
   }
-  const stat2 = await fs4.stat(realCandidate).catch(() => null);
+  const stat2 = await fs5.stat(realCandidate).catch(() => null);
   if (!stat2?.isFile()) {
     return null;
   }
@@ -12128,7 +12133,7 @@ async function resolveSafeOutboundMediaPath(mediaPath, allowedRoots) {
 }
 async function realpathOrNull(filePath) {
   try {
-    return await fs4.realpath(filePath);
+    return await fs5.realpath(filePath);
   } catch {
     return null;
   }
@@ -12824,10 +12829,10 @@ var init_cdn_upload = __esm(() => {
 
 // src/weixin/cdn/upload.ts
 import crypto3 from "node:crypto";
-import fs5 from "node:fs/promises";
+import fs6 from "node:fs/promises";
 async function uploadMediaToCdn(params) {
   const { filePath, toUserId, opts, cdnBaseUrl, mediaType, label } = params;
-  const plaintext = await fs5.readFile(filePath);
+  const plaintext = await fs6.readFile(filePath);
   const rawsize = plaintext.length;
   const rawfilemd5 = crypto3.createHash("md5").update(plaintext).digest("hex");
   const filesize = aesEcbPaddedSize(rawsize);
@@ -12947,14 +12952,14 @@ var init_send_media = __esm(() => {
 });
 
 // src/weixin/messaging/debug-mode.ts
-import fs6 from "node:fs";
+import fs7 from "node:fs";
 import path10 from "node:path";
 function resolveDebugModePath() {
   return path10.join(resolveStateDir(), "openclaw-weixin", "debug-mode.json");
 }
 function loadState() {
   try {
-    const raw = fs6.readFileSync(resolveDebugModePath(), "utf-8");
+    const raw = fs7.readFileSync(resolveDebugModePath(), "utf-8");
     const parsed = JSON.parse(raw);
     if (parsed && typeof parsed.accounts === "object")
       return parsed;
@@ -12963,8 +12968,8 @@ function loadState() {
 }
 function saveState(state) {
   const filePath = resolveDebugModePath();
-  fs6.mkdirSync(path10.dirname(filePath), { recursive: true });
-  fs6.writeFileSync(filePath, JSON.stringify(state, null, 2), "utf-8");
+  ensureDirSync(path10.dirname(filePath));
+  fs7.writeFileSync(filePath, JSON.stringify(state, null, 2), "utf-8");
 }
 function toggleDebugMode(accountId) {
   const state = loadState();
@@ -12978,6 +12983,7 @@ function toggleDebugMode(accountId) {
   return next;
 }
 var init_debug_mode = __esm(() => {
+  init_ensure_dir();
   init_state_dir();
   init_logger();
 });
@@ -13130,7 +13136,7 @@ function normalizeMediaArray(media) {
 
 // src/weixin/messaging/handle-weixin-message-turn.ts
 import crypto4 from "node:crypto";
-import fs7 from "node:fs/promises";
+import fs8 from "node:fs/promises";
 import { tmpdir } from "node:os";
 import path11 from "node:path";
 function utf8ByteLength(s) {
@@ -13230,7 +13236,7 @@ function createSaveMediaBuffer(mediaTempDir) {
       throw new Error(`media exceeds ${maxBytes} bytes`);
     }
     const dir = path11.join(resolveMediaTempDir(mediaTempDir), subdir ?? "");
-    await fs7.mkdir(dir, { recursive: true });
+    await fs8.mkdir(dir, { recursive: true });
     let ext = ".bin";
     if (originalFilename) {
       ext = path11.extname(originalFilename) || ".bin";
@@ -13239,7 +13245,7 @@ function createSaveMediaBuffer(mediaTempDir) {
     }
     const name = `${Date.now()}-${crypto4.randomBytes(4).toString("hex")}${ext}`;
     const filePath = path11.join(dir, name);
-    await fs7.writeFile(filePath, buffer);
+    await fs8.writeFile(filePath, buffer);
     return { path: filePath };
   };
 }
@@ -13379,7 +13385,7 @@ async function handleWeixinMessageTurn(full, deps) {
         continue;
       }
       try {
-        const buffer = await fs7.readFile(filePath);
+        const buffer = await fs8.readFile(filePath);
         const mimeType = downloaded.fileMediaType ?? downloaded.voiceMediaType ?? defaultWeixinMime(descriptor.kind);
         media.push(await mediaStore.saveMediaBuffer({
           channelId: "weixin",
@@ -13393,7 +13399,7 @@ async function handleWeixinMessageTurn(full, deps) {
           maxBytes: descriptor.kind === "image" ? DEFAULT_IMAGE_MAX_BYTES : DEFAULT_ATTACHMENT_MAX_BYTES
         }));
       } finally {
-        await fs7.rm(filePath, { force: true }).catch(() => {});
+        await fs8.rm(filePath, { force: true }).catch(() => {});
       }
     } catch (err) {
       deps.errLog(`media download failed: ${String(err)}`);
@@ -13565,7 +13571,7 @@ var init_handle_weixin_message_turn = __esm(() => {
 });
 
 // src/weixin/storage/sync-buf.ts
-import fs8 from "node:fs";
+import fs9 from "node:fs";
 import path12 from "node:path";
 function resolveAccountsDir2() {
   return path12.join(resolveStateDir(), "openclaw-weixin", "accounts");
@@ -13578,7 +13584,7 @@ function getLegacySyncBufDefaultJsonPath() {
 }
 function readSyncBufFile(filePath) {
   try {
-    const raw = fs8.readFileSync(filePath, "utf-8");
+    const raw = fs9.readFileSync(filePath, "utf-8");
     const data = JSON.parse(raw);
     if (typeof data.get_updates_buf === "string") {
       return data.get_updates_buf;
@@ -13602,11 +13608,12 @@ function loadGetUpdatesBuf(filePath) {
 }
 function saveGetUpdatesBuf(filePath, getUpdatesBuf) {
   const dir = path12.dirname(filePath);
-  fs8.mkdirSync(dir, { recursive: true });
-  fs8.writeFileSync(filePath, JSON.stringify({ get_updates_buf: getUpdatesBuf }, null, 0), "utf-8");
+  ensureDirSync(dir);
+  fs9.writeFileSync(filePath, JSON.stringify({ get_updates_buf: getUpdatesBuf }, null, 0), "utf-8");
 }
 var init_sync_buf = __esm(() => {
   init_accounts();
+  init_ensure_dir();
   init_state_dir();
 });
 
@@ -14148,16 +14155,16 @@ var init_deliver_coordinator_message = __esm(() => {
 });
 
 // src/weixin/monitor/consumer-lock.ts
-import { mkdir as mkdir7, open as open2, readFile as readFile6, rm as rm5 } from "node:fs/promises";
-import { dirname as dirname6, join as join3 } from "node:path";
-import { homedir as homedir3 } from "node:os";
+import { mkdir as mkdir8, open as open2, readFile as readFile6, rm as rm5 } from "node:fs/promises";
+import { dirname as dirname6, join as join4 } from "node:path";
+import { homedir as homedir4 } from "node:os";
 function createWeixinConsumerLock(options = {}) {
-  const lockFilePath = options.lockFilePath ?? join3(homedir3(), ".weacpx", "runtime", "weixin-consumer.lock.json");
+  const lockFilePath = options.lockFilePath ?? join4(homedir4(), ".weacpx", "runtime", "weixin-consumer.lock.json");
   const isProcessRunning = options.isProcessRunning ?? defaultIsProcessRunning4;
   const onDiagnostic = options.onDiagnostic;
   return {
     async acquire(meta2) {
-      await mkdir7(dirname6(lockFilePath), { recursive: true });
+      await mkdir8(dirname6(lockFilePath), { recursive: true });
       while (true) {
         try {
           const handle = await open2(lockFilePath, "wx");
@@ -14550,27 +14557,74 @@ var init_create_channel = __esm(() => {
   channelFactories = new Map;
 });
 
-// src/plugins/plugin-home.ts
-import { mkdir as mkdir8, writeFile as writeFile7 } from "node:fs/promises";
-import { homedir as homedir4 } from "node:os";
-import { join as join4 } from "node:path";
-function resolvePluginHome(input = {}) {
-  if (input.pluginHome?.trim())
-    return input.pluginHome;
-  if (process.env.WEACPX_PLUGIN_HOME?.trim())
-    return process.env.WEACPX_PLUGIN_HOME;
-  const home = input.home ?? process.env.HOME ?? homedir4();
-  return join4(home, ".weacpx", "plugins");
+// src/channels/cli/weixin-provider.ts
+var weixinCliProvider;
+var init_weixin_provider = __esm(() => {
+  weixinCliProvider = {
+    type: "weixin",
+    displayName: "Weixin",
+    supportsLogin: true,
+    parseAddArgs(args) {
+      if (args.length > 0)
+        return { ok: false, message: `unknown weixin options: ${args.join(" ")}` };
+      return { ok: true, input: {} };
+    },
+    buildDefaultConfig(_input) {
+      return { id: "weixin", type: "weixin", enabled: true };
+    },
+    validateConfig(config2) {
+      const issues = [];
+      if (config2.id !== "weixin")
+        issues.push({ kind: "invalid-config", message: "weixin channel id must be weixin" });
+      if (config2.type !== "weixin")
+        issues.push({ kind: "invalid-config", message: "weixin channel type must be weixin" });
+      return issues;
+    },
+    renderSummary(config2) {
+      return [`type: ${config2.type}`, `enabled: ${config2.enabled}`];
+    },
+    async promptForMissingFields(input, _io) {
+      return input;
+    }
+  };
+});
+
+// src/channels/cli/registry.ts
+function registerChannelCliProvider(provider) {
+  const type = provider.type.trim();
+  if (!type)
+    throw new Error("channel CLI provider type must be non-empty");
+  if (type.includes(":"))
+    throw new Error("channel CLI provider type must not contain ':'");
+  if (cliProviders.has(type)) {
+    throw new Error(`channel CLI provider is already registered: ${type}`);
+  }
+  cliProviders.set(type, provider);
 }
-async function ensurePluginHome(pluginHome) {
-  await mkdir8(pluginHome, { recursive: true, mode: 448 });
-  await writeFile7(join4(pluginHome, "package.json"), JSON.stringify({ private: true, type: "module" }, null, 2) + `
-`, { flag: "wx" }).catch((error2) => {
-    if (error2.code !== "EEXIST")
-      throw error2;
-  });
+function hasChannelCliProvider(type) {
+  bootstrapBuiltinChannelCliProviders();
+  return cliProviders.has(type);
 }
-var init_plugin_home = () => {};
+function bootstrapBuiltinChannelCliProviders() {
+  if (builtinProvidersRegistered)
+    return;
+  builtinProvidersRegistered = true;
+  if (!cliProviders.has(weixinCliProvider.type))
+    registerChannelCliProvider(weixinCliProvider);
+}
+function listChannelCliProviders() {
+  bootstrapBuiltinChannelCliProviders();
+  return Array.from(cliProviders.values());
+}
+function getChannelCliProvider(type) {
+  bootstrapBuiltinChannelCliProviders();
+  return cliProviders.get(type) ?? null;
+}
+var cliProviders, builtinProvidersRegistered = false;
+var init_registry = __esm(() => {
+  init_weixin_provider();
+  cliProviders = new Map;
+});
 
 // src/channels/plugin.ts
 function registerChannelPlugin(plugin) {
@@ -14833,7 +14887,7 @@ var init_bootstrap = __esm(() => {
 
 // src/logging/app-logger.ts
 import { appendFile, mkdir as mkdir9, readdir as readdir2, rename, rm as rm6, stat as stat2 } from "node:fs/promises";
-import { basename, dirname as dirname7, join as join8 } from "node:path";
+import { basename, dirname as dirname8, join as join9 } from "node:path";
 function createNoopAppLogger() {
   return {
     debug: async () => {},
@@ -14873,7 +14927,7 @@ function createAppLogger(options) {
       return;
     }
     const line = formatLogLine(now(), level, event, message, context);
-    await mkdir9(dirname7(options.filePath), { recursive: true });
+    await mkdir9(dirname8(options.filePath), { recursive: true });
     await rotateIfNeeded(options.filePath, Buffer.byteLength(line), options.maxSizeBytes, options.maxFiles);
     await appendFile(options.filePath, line, "utf8");
   }
@@ -14911,7 +14965,7 @@ async function rotateIfNeeded(filePath, incomingSize, maxSizeBytes, maxFiles) {
   await rename(filePath, `${filePath}.1`);
 }
 async function cleanupExpiredRotatedLogs(filePath, retentionDays, now) {
-  const parentDir = dirname7(filePath);
+  const parentDir = dirname8(filePath);
   const prefix = `${basename(filePath)}.`;
   const cutoff = now().getTime() - retentionDays * 24 * 60 * 60 * 1000;
   let files = [];
@@ -14927,7 +14981,7 @@ async function cleanupExpiredRotatedLogs(filePath, retentionDays, now) {
     if (!file.startsWith(prefix) || !/^\d+$/.test(file.slice(prefix.length))) {
       continue;
     }
-    const candidate = join8(parentDir, file);
+    const candidate = join9(parentDir, file);
     const details = await stat2(candidate);
     if (details.mtime.getTime() < cutoff) {
       await rm6(candidate, { force: true });
@@ -14962,7 +15016,7 @@ var init_app_logger = __esm(() => {
 });
 
 // src/transport/acpx-session-index.ts
-import { readFile as readFile9 } from "node:fs/promises";
+import { readFile as readFile10 } from "node:fs/promises";
 import { homedir as homedir5 } from "node:os";
 import { resolve as resolve2 } from "node:path";
 async function resolveSessionAgentCommandFromIndex(session) {
@@ -14971,7 +15025,7 @@ async function resolveSessionAgentCommandFromIndex(session) {
     return;
   }
   try {
-    const raw = await readFile9(resolve2(home, ".acpx", "sessions", "index.json"), "utf8");
+    const raw = await readFile10(resolve2(home, ".acpx", "sessions", "index.json"), "utf8");
     const parsed = JSON.parse(raw);
     const targetCwd = resolve2(session.cwd);
     const match = parsed.entries?.find((entry) => entry.name === session.transportSession && entry.cwd === targetCwd && typeof entry.agentCommand === "string" && entry.agentCommand.trim().length > 0);
@@ -17285,37 +17339,6 @@ function isPartialPromptOutputError(message) {
   return message.includes("未收到最终回复");
 }
 
-// src/config/agent-templates.ts
-function getAgentTemplate(name) {
-  const template = TEMPLATES[name];
-  if (!template) {
-    return null;
-  }
-  return {
-    ...template
-  };
-}
-function listAgentTemplates() {
-  return Object.keys(TEMPLATES);
-}
-var TEMPLATES;
-var init_agent_templates = __esm(() => {
-  TEMPLATES = {
-    codex: {
-      driver: "codex"
-    },
-    claude: {
-      driver: "claude"
-    },
-    opencode: {
-      driver: "opencode"
-    },
-    gemini: {
-      driver: "gemini"
-    }
-  };
-});
-
 // src/commands/handlers/agent-handler.ts
 function handleAgents(context) {
   return { text: context.config ? renderAgents(context.config) : "No config loaded." };
@@ -17771,11 +17794,11 @@ var init_session_recovery_handler = __esm(() => {
 });
 
 // src/recovery/auto-install-optional-dep.ts
-import { spawn as spawn4 } from "node:child_process";
+import { spawn as spawn5 } from "node:child_process";
 import { createWriteStream } from "node:fs";
 import { mkdir as mkdir10 } from "node:fs/promises";
 import { homedir as homedir6 } from "node:os";
-import { join as join9 } from "node:path";
+import { join as join10 } from "node:path";
 async function autoInstallOptionalDep(pkg, parentPackages, options = {}) {
   const runCli = options.runCli ?? defaultRunCli;
   const openLog = options.openLog ?? defaultLogSink;
@@ -17854,7 +17877,7 @@ function tail(text, lines) {
 }
 var PRECISE_TIMEOUT_MS = 90000, GLOBAL_TIMEOUT_MS = 90000, TAIL_LINES = 10, PRECISE_COMMANDS, defaultRunCli = async (cmd, args, options) => {
   return await new Promise((resolve3) => {
-    const child = spawn4(cmd, args, {
+    const child = spawn5(cmd, args, {
       cwd: options.cwd,
       stdio: ["ignore", "pipe", "pipe"],
       shell: process.platform === "win32"
@@ -17890,10 +17913,10 @@ ${err.message}`, reason: "spawn" });
     });
   });
 }, defaultLogSink = async () => {
-  const dir = join9(homedir6(), ".weacpx", "logs");
+  const dir = join10(homedir6(), ".weacpx", "logs");
   await mkdir10(dir, { recursive: true });
   const timestamp = new Date().toISOString().replace(/[:.]/g, "").replace(/-/g, "");
-  const path13 = join9(dir, `auto-install-${timestamp}.log`);
+  const path13 = join10(dir, `auto-install-${timestamp}.log`);
   const stream = createWriteStream(path13, { flags: "a" });
   return {
     path: path13,
@@ -17915,11 +17938,11 @@ var init_auto_install_optional_dep = __esm(() => {
 });
 
 // src/recovery/discover-parent-package-paths.ts
-import { spawn as spawn5 } from "node:child_process";
+import { spawn as spawn6 } from "node:child_process";
 import { createRequire as createRequire3 } from "node:module";
 import { access as access3 } from "node:fs/promises";
 import { homedir as homedir7 } from "node:os";
-import { dirname as dirname8, join as join10 } from "node:path";
+import { dirname as dirname9, join as join11 } from "node:path";
 function deriveParentPackageName(platformPackage) {
   return platformPackage.replace(/-(?:linux|darwin|win32|windows|freebsd|openbsd|sunos|aix)(?:-(?:x64|arm64|ia32|arm|ppc64|s390x))?(?:-(?:baseline|musl|gnu|gnueabihf|musleabihf|msvc))?$/, "");
 }
@@ -17932,7 +17955,7 @@ async function discoverParentPackagePaths(platformPackage, seedPath, deps = {})
   const queryRoot = deps.queryPackageManagerRoot ?? defaultQueryPackageManagerRoot;
   const parentName = deriveParentPackageName(platformPackage);
   const rawCandidates = [];
-  const bunGlobalRoot = env.BUN_INSTALL ? join10(env.BUN_INSTALL, "install", "global", "node_modules") : join10(home, ".bun", "install", "global", "node_modules");
+  const bunGlobalRoot = env.BUN_INSTALL ? join11(env.BUN_INSTALL, "install", "global", "node_modules") : join11(home, ".bun", "install", "global", "node_modules");
   const [npmRoot, pnpmRoot, yarnRoot] = await Promise.all([
     queryRoot("npm"),
     queryRoot("pnpm"),
@@ -17955,20 +17978,20 @@ async function discoverParentPackagePaths(platformPackage, seedPath, deps = {})
     if (resolved)
       rawCandidates.push({ path: resolved, manager: classify(resolved) });
   }
-  rawCandidates.push({ path: join10(bunGlobalRoot, parentName), manager: "bun" });
+  rawCandidates.push({ path: join11(bunGlobalRoot, parentName), manager: "bun" });
   if (npmRoot)
-    rawCandidates.push({ path: join10(npmRoot, parentName), manager: "npm" });
+    rawCandidates.push({ path: join11(npmRoot, parentName), manager: "npm" });
   if (pnpmRoot)
-    rawCandidates.push({ path: join10(pnpmRoot, parentName), manager: "pnpm" });
+    rawCandidates.push({ path: join11(pnpmRoot, parentName), manager: "pnpm" });
   if (yarnRoot)
-    rawCandidates.push({ path: join10(yarnRoot, parentName), manager: "yarn" });
+    rawCandidates.push({ path: join11(yarnRoot, parentName), manager: "yarn" });
   const seen = new Set;
   const verified = [];
   for (const candidate of rawCandidates) {
     if (seen.has(candidate.path))
       continue;
     seen.add(candidate.path);
-    if (await fsExists(join10(candidate.path, "package.json"))) {
+    if (await fsExists(join11(candidate.path, "package.json"))) {
       verified.push(candidate);
     }
   }
@@ -17992,7 +18015,7 @@ function defaultResolveFromCwd(name, cwd) {
     const pkgJson = require2.resolve(`${name}/package.json`, {
       paths: [cwd, ...require2.resolve.paths(name) ?? []]
     });
-    return dirname8(pkgJson);
+    return dirname9(pkgJson);
   } catch {
     return null;
   }
@@ -18009,7 +18032,7 @@ async function defaultQueryPackageManagerRoot(tool) {
     };
     let child;
     try {
-      child = spawn5(spec.cmd, spec.args, {
+      child = spawn6(spec.cmd, spec.args, {
         stdio: ["ignore", "pipe", "pipe"],
         shell: process.platform === "win32"
       });
@@ -18039,7 +18062,7 @@ async function defaultQueryPackageManagerRoot(tool) {
       const trimmed = stdout2.trim().split(/\r?\n/).pop()?.trim() ?? "";
       if (!trimmed)
         return done(null);
-      done(spec.postfix ? join10(trimmed, spec.postfix) : trimmed);
+      done(spec.postfix ? join11(trimmed, spec.postfix) : trimmed);
     });
   });
 }
@@ -22605,6 +22628,7 @@ async function runConsole(paths, deps) {
   let heartbeatTimer = null;
   let gcResetTimer = null;
   let consumerLockAcquired = false;
+  let daemonRuntimeStarted = false;
   const shutdownController = new AbortController;
   const signalHandler = () => {
     shutdownController.abort();
@@ -22613,6 +22637,9 @@ async function runConsole(paths, deps) {
   addProcessListener("SIGTERM", signalHandler);
   try {
     runtime = await deps.buildApp(paths);
+    if (deps.afterBuild) {
+      await deps.afterBuild(runtime);
+    }
     try {
       await runtime.orchestration.service.purgeExpiredResetCoordinators({
         cutoffDays: 7,
@@ -22620,20 +22647,6 @@ async function runConsole(paths, deps) {
       });
     } catch {}
     consumerLock = deps.consumerLock ?? deps.consumerLockFactory?.(runtime);
-    if (deps.daemonRuntime) {
-      await deps.daemonRuntime.start({
-        configPath: paths.configPath,
-        statePath: paths.statePath
-      });
-      await runtime.orchestration.server.start();
-      heartbeatTimer = setIntervalFn(() => {
-        deps.daemonRuntime?.heartbeat().catch(() => {});
-      }, deps.heartbeatIntervalMs ?? 30000);
-      const runtimeForGc = runtime;
-      gcResetTimer = setIntervalFn(() => {
-        runtimeForGc.orchestration.service.purgeExpiredResetCoordinators({ cutoffDays: 7, trigger: "interval" }).catch(() => {});
-      }, 86400000);
-    }
     if (consumerLock) {
       const lockMeta = {
         pid: processPid,
@@ -22681,6 +22694,24 @@ async function runConsole(paths, deps) {
         throw error2;
       }
     }
+    if (deps.beforeReady) {
+      await deps.beforeReady(runtime);
+    }
+    if (deps.daemonRuntime) {
+      await deps.daemonRuntime.start({
+        configPath: paths.configPath,
+        statePath: paths.statePath
+      });
+      daemonRuntimeStarted = true;
+      await runtime.orchestration.server.start();
+      heartbeatTimer = setIntervalFn(() => {
+        deps.daemonRuntime?.heartbeat().catch(() => {});
+      }, deps.heartbeatIntervalMs ?? 30000);
+      const runtimeForGc = runtime;
+      gcResetTimer = setIntervalFn(() => {
+        runtimeForGc.orchestration.service.purgeExpiredResetCoordinators({ cutoffDays: 7, trigger: "interval" }).catch(() => {});
+      }, 86400000);
+    }
     await deps.channels.startAll({
       agent: runtime.agent,
       abortSignal: shutdownController.signal,
@@ -22699,7 +22730,8 @@ async function runConsole(paths, deps) {
       consumerLock,
       consumerLockAcquired,
       processPid,
-      channels: deps.channels
+      channels: deps.channels,
+      daemonRuntimeStarted
     });
   }
 }
@@ -22734,7 +22766,7 @@ async function runCleanupSequence(input) {
       cleanupError ??= error2;
     }
   }
-  if (input.daemonRuntime) {
+  if (input.daemonRuntime && input.daemonRuntimeStarted) {
     try {
       await input.daemonRuntime.stop();
     } catch (error2) {
@@ -22784,8 +22816,8 @@ function encodeBridgeSessionNoteEvent(event) {
 }
 
 // src/transport/acpx-bridge/acpx-bridge-client.ts
-import { spawn as spawn6 } from "node:child_process";
-import { fileURLToPath as fileURLToPath2 } from "node:url";
+import { spawn as spawn7 } from "node:child_process";
+import { fileURLToPath as fileURLToPath3 } from "node:url";
 import { createInterface } from "node:readline";
 
 class AcpxBridgeClient {
@@ -22905,12 +22937,12 @@ function buildBridgeSpawnSpec(options) {
   };
 }
 async function spawnAcpxBridgeClient(options = {}) {
-  const bridgeEntryPath = options.bridgeEntryPath ?? fileURLToPath2(new URL("../../bridge/bridge-main.ts", import.meta.url));
+  const bridgeEntryPath = options.bridgeEntryPath ?? fileURLToPath3(new URL("../../bridge/bridge-main.ts", import.meta.url));
   const spawnSpec = buildBridgeSpawnSpec({
     execPath: process.execPath,
     bridgeEntryPath
   });
-  const child = spawn6(spawnSpec.command, spawnSpec.args, {
+  const child = spawn7(spawnSpec.command, spawnSpec.args, {
     cwd: options.cwd ?? process.cwd(),
     env: {
       ...process.env,
@@ -23724,12 +23756,12 @@ var init_streaming_prompt = __esm(() => {
 
 // src/transport/acpx-cli/node-pty-helper.ts
 import { chmod as chmodFs } from "node:fs/promises";
-import { dirname as dirname9, join as join11 } from "node:path";
+import { dirname as dirname10, join as join12 } from "node:path";
 function resolveNodePtyHelperPath(packageJsonPath, platform, arch) {
   if (platform === "win32") {
     return null;
   }
-  return join11(dirname9(packageJsonPath), "prebuilds", `${platform}-${arch}`, "spawn-helper");
+  return join12(dirname10(packageJsonPath), "prebuilds", `${platform}-${arch}`, "spawn-helper");
 }
 async function ensureNodePtyHelperExecutable(helperPath, chmod2 = chmodFs) {
   if (!helperPath) {
@@ -23748,10 +23780,10 @@ var init_node_pty_helper = () => {};
 
 // src/transport/acpx-queue-owner-launcher.ts
 import { createHash as createHash3 } from "node:crypto";
-import { spawn as spawn7 } from "node:child_process";
-import { readFile as readFile10, unlink } from "node:fs/promises";
+import { spawn as spawn8 } from "node:child_process";
+import { readFile as readFile11, unlink } from "node:fs/promises";
 import { homedir as homedir8 } from "node:os";
-import { join as join12 } from "node:path";
+import { join as join13 } from "node:path";
 function buildWeacpxMcpServerSpec(input) {
   const { command, args } = splitCommandLine(input.weacpxCommand);
   return {
@@ -23881,7 +23913,7 @@ function stringEnv(env) {
 }
 async function defaultQueueOwnerSpawner(command, args, options) {
   await new Promise((resolve3, reject) => {
-    const child = spawn7(command, args, {
+    const child = spawn8(command, args, {
       detached: true,
       stdio: "ignore",
       env: options.env,
@@ -23903,7 +23935,7 @@ async function terminateAcpxQueueOwner(sessionId) {
   const lockPath = queueLockFilePath(sessionId);
   let owner;
   try {
-    owner = JSON.parse(await readFile10(lockPath, "utf8"));
+    owner = JSON.parse(await readFile11(lockPath, "utf8"));
   } catch {
     return;
   }
@@ -23913,7 +23945,7 @@ async function terminateAcpxQueueOwner(sessionId) {
   await unlink(lockPath).catch(() => {});
 }
 function queueLockFilePath(sessionId) {
-  return join12(homedir8(), ".acpx", "queues", `${shortHash(sessionId, 24)}.lock`);
+  return join13(homedir8(), ".acpx", "queues", `${shortHash(sessionId, 24)}.lock`);
 }
 function shortHash(value, length) {
   return createHash3("sha256").update(value).digest("hex").slice(0, length);
@@ -23952,12 +23984,12 @@ function permissionModeToFlag(permissionMode) {
 
 // src/transport/acpx-cli/acpx-cli-transport.ts
 import { createRequire as createRequire5 } from "node:module";
-import { spawn as spawn8 } from "node:child_process";
+import { spawn as spawn9 } from "node:child_process";
 import { spawn as spawnPty } from "node-pty";
 async function defaultRunner(command, args, options) {
   return await new Promise((resolve3, reject) => {
     const spawnSpec = resolveSpawnCommand(command, args);
-    const child = spawn8(spawnSpec.command, spawnSpec.args, { stdio: ["ignore", "pipe", "pipe"] });
+    const child = spawn9(spawnSpec.command, spawnSpec.args, { stdio: ["ignore", "pipe", "pipe"] });
     let stdout2 = "";
     let stderr = "";
     const onAbort = () => {
@@ -24204,7 +24236,7 @@ ${baseText}` : "" };
   }
   async runStreamingPrompt(command, args, reply, formatToolCalls = false, toolEventMode = "text", replyContext, onSegment, onToolEvent) {
     const hooks = this.streamingHooks;
-    const doSpawn = hooks.spawnPrompt ?? ((cmd, spawnArgs) => spawn8(cmd, spawnArgs, { stdio: ["ignore", "pipe", "pipe"] }));
+    const doSpawn = hooks.spawnPrompt ?? ((cmd, spawnArgs) => spawn9(cmd, spawnArgs, { stdio: ["ignore", "pipe", "pipe"] }));
     const setIntervalFn = hooks.setIntervalFn ?? ((fn, delay) => setInterval(fn, delay));
     const clearIntervalFn = hooks.clearIntervalFn ?? ((timer) => clearInterval(timer));
     const maxSegmentWaitMs = hooks.maxSegmentWaitMs ?? 30000;
@@ -24564,8 +24596,8 @@ __export(exports_main, {
 });
 import { randomUUID as randomUUID3 } from "node:crypto";
 import { homedir as homedir9 } from "node:os";
-import { dirname as dirname10, join as join13 } from "node:path";
-import { fileURLToPath as fileURLToPath3 } from "node:url";
+import { dirname as dirname11, join as join14 } from "node:path";
+import { fileURLToPath as fileURLToPath4 } from "node:url";
 function startProgressHeartbeat(orchestration, config2, logger2, channel) {
   const thresholdSeconds = config2.orchestration.progressHeartbeatSeconds;
   if (thresholdSeconds <= 0) {
@@ -24970,6 +25002,7 @@ async function buildApp(paths, deps = {}) {
     configStore,
     logger: logger2,
     quota,
+    transport,
     orchestration: {
       service: orchestration,
       server: orchestrationServer,
@@ -25019,8 +25052,8 @@ async function main() {
   }
 }
 async function prepareChannelMedia(configPath, config2) {
-  const runtimeDir = join13(dirname10(configPath), "runtime");
-  const mediaRootDir = join13(runtimeDir, "media");
+  const runtimeDir = join14(dirname11(configPath), "runtime");
+  const mediaRootDir = join14(runtimeDir, "media");
   const mediaStore = new RuntimeMediaStore({ rootDir: mediaRootDir });
   await mediaStore.cleanupExpired().catch((error2) => {
     console.error("[weacpx] media cleanup failed:", error2 instanceof Error ? error2.message : String(error2));
@@ -25034,7 +25067,7 @@ function resolveRuntimePaths() {
     throw new Error("Unable to resolve the current user home directory");
   }
   const configPath = process.env.WEACPX_CONFIG ?? `${home}/.weacpx/config.json`;
-  const runtimeDir = join13(dirname10(configPath), "runtime");
+  const runtimeDir = join14(dirname11(configPath), "runtime");
   return {
     configPath,
     statePath: process.env.WEACPX_STATE ?? `${home}/.weacpx/state.json`,
@@ -25043,14 +25076,14 @@ function resolveRuntimePaths() {
 }
 function resolveBridgeEntryPath() {
   if (import.meta.url.includes("/dist/")) {
-    return fileURLToPath3(new URL("./bridge/bridge-main.js", import.meta.url));
+    return fileURLToPath4(new URL("./bridge/bridge-main.js", import.meta.url));
   }
-  return fileURLToPath3(new URL("./bridge/bridge-main.ts", import.meta.url));
+  return fileURLToPath4(new URL("./bridge/bridge-main.ts", import.meta.url));
 }
 function resolveAppLogPath(configPath) {
-  const rootDir = dirname10(configPath);
-  const runtimeDir = join13(rootDir, "runtime");
-  return join13(runtimeDir, "app.log");
+  const rootDir = dirname11(configPath);
+  const runtimeDir = join14(rootDir, "runtime");
+  return join14(runtimeDir, "app.log");
 }
 function resolveOrchestrationSocketPathFromConfigPath(configPath) {
   const runtimeDir = resolveRuntimeDirFromConfigPath(configPath);
@@ -25087,7 +25120,7 @@ var init_main = __esm(async () => {
 });
 
 // src/doctor/checks/acpx-check.ts
-import { spawn as spawn9 } from "node:child_process";
+import { spawn as spawn10 } from "node:child_process";
 async function checkAcpx(options = {}) {
   const runtimePaths = (options.resolveRuntimePaths ?? resolveRuntimePaths)();
   try {
@@ -25134,7 +25167,7 @@ function buildDetails(metadata, version2, verbose) {
 async function defaultRunVersion(command) {
   const spawnSpec = resolveSpawnCommand(command, ["--version"]);
   return await new Promise((resolve3, reject) => {
-    const child = spawn9(spawnSpec.command, spawnSpec.args, {
+    const child = spawn10(spawnSpec.command, spawnSpec.args, {
       stdio: ["ignore", "pipe", "pipe"]
     });
     let stdout2 = "";
@@ -25272,7 +25305,7 @@ var init_config_check = __esm(async () => {
 });
 
 // src/doctor/checks/daemon-check.ts
-import { fileURLToPath as fileURLToPath4 } from "node:url";
+import { fileURLToPath as fileURLToPath5 } from "node:url";
 import { homedir as homedir10 } from "node:os";
 async function checkDaemon(options = {}) {
   const home = options.home ?? process.env.HOME ?? homedir10();
@@ -25362,7 +25395,7 @@ function defaultIsProcessRunning5(pid) {
   }
 }
 function resolveCliEntryPath() {
-  return process.argv[1] ?? fileURLToPath4(import.meta.url);
+  return process.argv[1] ?? fileURLToPath5(import.meta.url);
 }
 function formatError5(error2) {
   return error2 instanceof Error ? error2.message : String(error2);
@@ -25424,7 +25457,7 @@ async function checkOrchestrationHealth(options) {
 // src/doctor/checks/runtime-check.ts
 import { constants } from "node:fs";
 import { access as access4, stat as stat3 } from "node:fs/promises";
-import { dirname as dirname11 } from "node:path";
+import { dirname as dirname12 } from "node:path";
 import { homedir as homedir11 } from "node:os";
 async function checkRuntime(options = {}) {
   const home = options.home ?? process.env.HOME ?? homedir11();
@@ -25521,7 +25554,7 @@ async function checkFileCreatable(label, path14, probe, platform) {
         detail: `${label}: ${path14} (unusable: ${formatError6(error2)})`
       };
     }
-    const parentCheck = await checkCreatableAncestorDirectory(dirname11(path14), probe, platform);
+    const parentCheck = await checkCreatableAncestorDirectory(dirname12(path14), probe, platform);
     if (!parentCheck.ok) {
       return {
         ok: false,
@@ -25557,7 +25590,7 @@ async function checkCreatableAncestorDirectory(path14, probe, platform) {
         blockingPath: path14
       };
     }
-    const parent = dirname11(path14);
+    const parent = dirname12(path14);
     if (parent === path14) {
       return {
         ok: false,
@@ -25980,7 +26013,7 @@ var init_render_doctor = __esm(() => {
 
 // src/doctor/doctor.ts
 import { homedir as homedir12 } from "node:os";
-import { join as join14 } from "node:path";
+import { join as join15 } from "node:path";
 async function runDoctor(options = {}, deps = {}) {
   const home = deps.home ?? process.env.HOME ?? homedir12();
   const runtimePaths = resolveDoctorRuntimePaths(home, deps.resolveRuntimePaths);
@@ -26033,8 +26066,8 @@ function resolveDoctorRuntimePaths(home, resolver) {
     return resolveRuntimePaths();
   }
   return {
-    configPath: join14(home, ".weacpx", "config.json"),
-    statePath: join14(home, ".weacpx", "state.json")
+    configPath: join15(home, ".weacpx", "config.json"),
+    statePath: join15(home, ".weacpx", "state.json")
   };
 }
 function depsUseExplicitRuntimeOverrides() {
@@ -26140,7 +26173,7 @@ init_daemon_files();
 import { randomUUID as randomUUID4 } from "node:crypto";
 import { homedir as homedir13 } from "node:os";
 import { sep } from "node:path";
-import { fileURLToPath as fileURLToPath5 } from "node:url";
+import { fileURLToPath as fileURLToPath6 } from "node:url";
 
 // src/daemon/daemon-runtime.ts
 init_daemon_status();
@@ -38874,7 +38907,7 @@ async function asToolResult(action) {
             text: "Outbound budget exhausted; the action has been recorded as pending and will retry automatically after the next user inbound resets the quota window. No further action required."
           }
         ],
-        structuredContent: { status: "deferred_quota", chatKey: error2.chatKey },
+        structuredContent: { status: "deferred_quota" },
         isError: false
       };
     }
@@ -39085,7 +39118,9 @@ function renderCoordinatorReviewContestedResultSuccess(task, decision) {
 }
 function formatToolError(error2) {
   const message = error2 instanceof Error ? error2.message : String(error2);
-  if (/ECONNREFUSED|ENOENT|server closed without a response|socket hang up|connect /i.test(message)) {
+  const code = typeof error2 === "object" && error2 !== null && "code" in error2 ? error2.code : undefined;
+  const isConnectionError = code === "ECONNREFUSED" || code === "ENOENT" || code === "ECONNRESET" || code === "EPIPE" || /server closed without a response|socket hang up/i.test(message);
+  if (isConnectionError) {
     return `Failed to connect to the orchestration daemon: ${message}`;
   }
   return message;
@@ -39246,9 +39281,9 @@ function createOrchestrationTransport(endpoint, deps = {}) {
       sourceHandle: input.sourceHandle ?? input.coordinatorSession,
       targetAgent: input.targetAgent,
       task: input.task,
-      ...input.workingDirectory ? { cwd: input.workingDirectory } : {},
-      ...input.role ? { role: input.role } : {},
-      ...input.groupId ? { groupId: input.groupId } : {}
+      ...input.workingDirectory !== undefined ? { cwd: input.workingDirectory } : {},
+      ...input.role !== undefined ? { role: input.role } : {},
+      ...input.groupId !== undefined ? { groupId: input.groupId } : {}
     }),
     createGroup: async (input) => await client.createGroup(input),
     getGroup: async (input) => await client.getGroup(input),
@@ -39257,10 +39292,10 @@ function createOrchestrationTransport(endpoint, deps = {}) {
     getTask: async (input) => await client.getTaskForCoordinator(input),
     listTasks: async (input) => await client.listTasks({
       coordinatorSession: input.coordinatorSession,
-      ...input.status ? { status: input.status } : {},
+      ...input.status !== undefined ? { status: input.status } : {},
       ...input.stuck !== undefined ? { stuck: input.stuck } : {},
-      ...input.sort ? { sort: input.sort } : {},
-      ...input.order ? { order: input.order } : {}
+      ...input.sort !== undefined ? { sort: input.sort } : {},
+      ...input.order !== undefined ? { order: input.order } : {}
     }),
     approveTask: async (input) => await client.approveTask(input),
     rejectTask: async (input) => await client.rejectTask(input),
@@ -39376,9 +39411,11 @@ function installMcpStdioShutdownHooks(options) {
   const parentPid = options.parentPid ?? process.ppid;
   const parentCheckIntervalMs = options.parentCheckIntervalMs ?? parseParentCheckIntervalMs(process.env.WEACPX_MCP_PARENT_CHECK_INTERVAL_MS);
   let disposed = false;
+  let triggered = false;
   const triggerShutdown = (reason, context) => {
-    if (disposed)
+    if (disposed || triggered)
       return;
+    triggered = true;
     options.onDiagnostic?.("mcp.stdio.shutdown", { reason, ...context ?? {} });
     options.shutdown();
   };
@@ -39503,18 +39540,18 @@ function sanitizeMcpClientName(input) {
   return normalized.length > 0 ? normalized : "mcp-host";
 }
 
-// src/mcp/parse-coordinator-workspace.ts
-function parseCoordinatorWorkspace(args, env = process.env) {
+// src/mcp/parse-string-flag.ts
+function parseStringFlag(args, env, options) {
   let fromFlag = null;
   for (let index = 0;index < args.length; index += 1) {
-    if (args[index] === "--workspace") {
+    if (args[index] === options.flag) {
       const value = args[index + 1];
       if (value === undefined) {
-        throw new Error("--workspace requires a non-empty value");
+        throw new Error(`${options.flag} requires a non-empty value`);
       }
       const trimmedValue = value.trim();
       if (trimmedValue.length === 0 || trimmedValue.startsWith("-")) {
-        throw new Error("--workspace requires a non-empty value");
+        throw new Error(`${options.flag} requires a non-empty value`);
       }
       fromFlag = value;
     }
@@ -39523,61 +39560,403 @@ function parseCoordinatorWorkspace(args, env = process.env) {
   if (trimmedFlag && trimmedFlag.length > 0) {
     return trimmedFlag;
   }
-  const trimmedEnv = env.WEACPX_COORDINATOR_WORKSPACE?.trim();
+  const trimmedEnv = env[options.envKey]?.trim();
   return trimmedEnv && trimmedEnv.length > 0 ? trimmedEnv : null;
 }
 
+// src/mcp/parse-coordinator-workspace.ts
+function parseCoordinatorWorkspace(args, env = process.env) {
+  return parseStringFlag(args, env, {
+    flag: "--workspace",
+    envKey: "WEACPX_COORDINATOR_WORKSPACE"
+  });
+}
+
 // src/mcp/parse-coordinator-session.ts
 function parseCoordinatorSession(args, env = process.env) {
-  let fromFlag = null;
-  for (let index = 0;index < args.length; index += 1) {
-    if (args[index] === "--coordinator-session") {
-      const value = args[index + 1];
-      if (value === undefined) {
-        throw new Error("--coordinator-session requires a non-empty value");
-      }
-      const trimmedValue = value.trim();
-      if (trimmedValue.length === 0 || trimmedValue.startsWith("-")) {
-        throw new Error("--coordinator-session requires a non-empty value");
-      }
-      fromFlag = value;
-    }
-  }
-  const trimmedFlag = fromFlag?.trim();
-  if (trimmedFlag && trimmedFlag.length > 0) {
-    return trimmedFlag;
-  }
-  const trimmedEnv = env.WEACPX_COORDINATOR_SESSION?.trim();
-  return trimmedEnv && trimmedEnv.length > 0 ? trimmedEnv : null;
+  return parseStringFlag(args, env, {
+    flag: "--coordinator-session",
+    envKey: "WEACPX_COORDINATOR_SESSION"
+  });
 }
 
 // src/mcp/parse-source-handle.ts
 function parseSourceHandle(args, env = process.env) {
-  let fromFlag = null;
-  for (let index = 0;index < args.length; index += 1) {
-    if (args[index] === "--source-handle") {
-      const value = args[index + 1];
-      if (value === undefined) {
-        throw new Error("--source-handle requires a non-empty value");
+  return parseStringFlag(args, env, {
+    flag: "--source-handle",
+    envKey: "WEACPX_SOURCE_HANDLE"
+  });
+}
+
+// src/cli.ts
+init_workspace_path();
+init_state_store();
+
+// src/onboarding.ts
+init_workspace_path();
+init_agent_templates();
+function isFirstUse(config2, state) {
+  return Object.keys(state.sessions ?? {}).length === 0 && Object.keys(config2.workspaces ?? {}).length === 0 && (config2.plugins ?? []).length === 0;
+}
+async function maybeRunFirstUseOnboarding(input) {
+  if (!isFirstUse(input.config, input.state))
+    return { created: false };
+  if (!input.deps.isInteractive())
+    return { created: false };
+  const cwd = normalizeWorkspacePath(input.deps.cwd());
+  const workspaceName = allocateName(sanitizeName(basenameForWorkspacePath(cwd), "workspace"), input.config.workspaces);
+  const yes = (await input.deps.promptText(`检测到首次使用 weacpx。是否将当前目录创建为工作区「${workspaceName}」？[Y/n] `)).trim().toLowerCase();
+  if (yes === "n" || yes === "no")
+    return { created: false };
+  const templateNames = listAgentTemplates();
+  input.deps.print("请选择要添加并创建初始会话的 Agent：");
+  for (let index = 0;index < templateNames.length; index += 1) {
+    input.deps.print(`${index + 1}. ${templateNames[index]}`);
+  }
+  const answer = (await input.deps.promptText("输入数字或名称（默认 1）：")).trim();
+  const agentName = resolveTemplateChoice(answer, templateNames);
+  if (!agentName) {
+    input.deps.print("未选择有效 Agent，已跳过首次初始化。");
+    return { created: false };
+  }
+  const template = getAgentTemplate(agentName);
+  if (!template)
+    return { created: false };
+  const workspaceExisted = Boolean(input.config.workspaces[workspaceName]);
+  const agentExisted = Boolean(input.config.agents[agentName]);
+  input.config.workspaces[workspaceName] = { cwd };
+  input.config.agents[agentName] = template;
+  await input.saveConfig(input.config);
+  const alias = `${workspaceName}:${agentName}`;
+  input.deps.print(`已创建工作区「${workspaceName}」，正在创建初始会话「${alias}」...`);
+  return {
+    created: true,
+    workspace: workspaceName,
+    agent: agentName,
+    alias,
+    rollback: { workspaceExisted, agentExisted }
+  };
+}
+function resolveTemplateChoice(answer, names) {
+  if (!answer)
+    return names[0] ?? null;
+  const index = Number.parseInt(answer, 10);
+  if (Number.isFinite(index) && index >= 1 && index <= names.length)
+    return names[index - 1];
+  return names.includes(answer) ? answer : null;
+}
+function allocateName(base, existing) {
+  if (!existing[base])
+    return base;
+  let suffix = 2;
+  while (existing[`${base}-${suffix}`])
+    suffix += 1;
+  return `${base}-${suffix}`;
+}
+function sanitizeName(input, fallback) {
+  const sanitized = input.trim().replace(/[^a-zA-Z0-9._-]+/g, "-").replace(/^-+|-+$/g, "");
+  return sanitized || fallback;
+}
+
+// src/cli-update.ts
+init_plugin_home();
+import { spawn as spawn4 } from "node:child_process";
+import { readFile as readFile7 } from "node:fs/promises";
+import { dirname as dirname7, join as join6 } from "node:path";
+import { fileURLToPath as fileURLToPath2 } from "node:url";
+
+// src/plugins/package-manager.ts
+import { spawn as spawn3 } from "node:child_process";
+async function defaultRunCommand(command, args, options) {
+  await new Promise((resolve, reject) => {
+    const child = spawn3(command, args, { cwd: options.cwd, stdio: "inherit" });
+    child.on("error", reject);
+    child.on("exit", (code) => {
+      if (code === 0)
+        resolve();
+      else
+        reject(new Error(`${command} ${args.join(" ")} exited with code ${code}`));
+    });
+  });
+}
+async function silentRun(command, args, options) {
+  await new Promise((resolve, reject) => {
+    const child = spawn3(command, args, { cwd: options.cwd, stdio: "ignore" });
+    child.on("error", reject);
+    child.on("exit", (code) => {
+      if (code === 0)
+        resolve();
+      else
+        reject(new Error(`${command} ${args.join(" ")} exited with code ${code}`));
+    });
+  });
+}
+async function detectPackageManager(runCommand) {
+  const override = process.env.WEACPX_PACKAGE_MANAGER?.trim().toLowerCase();
+  if (override === "bun" || override === "npm")
+    return override;
+  const probe = runCommand ?? silentRun;
+  try {
+    await probe("bun", ["--version"], { cwd: process.cwd() });
+    return "bun";
+  } catch {
+    return "npm";
+  }
+}
+async function installPluginPackage(input) {
+  const runCommand = input.runCommand ?? defaultRunCommand;
+  const packageManager = input.packageManager ?? await detectPackageManager();
+  const spec = input.version ? `${input.packageName}@${input.version}` : input.packageName;
+  if (packageManager === "bun") {
+    await runCommand("bun", ["add", spec], { cwd: input.pluginHome });
+    return;
+  }
+  await runCommand("npm", ["install", spec], { cwd: input.pluginHome });
+}
+async function updatePluginPackage(input) {
+  await installPluginPackage(input);
+}
+async function removePluginPackage(input) {
+  const runCommand = input.runCommand ?? defaultRunCommand;
+  const packageManager = input.packageManager ?? await detectPackageManager();
+  if (packageManager === "bun") {
+    await runCommand("bun", ["remove", input.packageName], { cwd: input.pluginHome });
+    return;
+  }
+  await runCommand("npm", ["uninstall", input.packageName], { cwd: input.pluginHome });
+}
+
+// src/cli-update.ts
+init_plugin_loader();
+init_validate_plugin();
+async function handleUpdateCli(args, deps) {
+  let all = false;
+  const explicitTargets = [];
+  for (const arg of args) {
+    if (arg === "--all")
+      all = true;
+    else
+      explicitTargets.push(arg);
+  }
+  if (all && explicitTargets.length > 0)
+    return null;
+  if (explicitTargets.length > 1)
+    return null;
+  const config2 = await deps.loadConfig();
+  const packageName = deps.packageName ?? await readPackageName();
+  const latestOf = deps.getLatestVersion ?? getLatestNpmVersion;
+  const targets = [
+    {
+      kind: "self",
+      name: packageName,
+      currentVersion: deps.readCurrentVersion(),
+      latestVersion: await latestOf(packageName)
+    }
+  ];
+  for (const plugin of config2.plugins ?? []) {
+    targets.push({
+      kind: "plugin",
+      name: plugin.name,
+      currentVersion: plugin.version,
+      pinned: Boolean(plugin.version),
+      latestVersion: await latestOf(plugin.name)
+    });
+  }
+  deps.print("可更新项：");
+  for (let index = 0;index < targets.length; index += 1) {
+    const target = targets[index];
+    deps.print(`${index + 1}. ${formatTarget(target)}`);
+  }
+  const unavailable = targets.filter((target) => !target.latestVersion || target.kind === "plugin" && !target.pinned);
+  if (all && unavailable.length > 0) {
+    deps.print(`以下项目无法检查最新版本，已取消更新：${unavailable.map((target) => target.name).join(", ")}`);
+    return 1;
+  }
+  const candidates = targets.filter((target) => target.latestVersion && (target.kind !== "plugin" || target.pinned) && target.currentVersion !== target.latestVersion);
+  const selected = await selectTargets(targets, candidates, { all, explicitTarget: explicitTargets[0], deps });
+  if (!selected.ok) {
+    deps.print(selected.message);
+    return selected.exitCode;
+  }
+  if (selected.targets.length === 0) {
+    deps.print("没有需要更新的项目。");
+    return 0;
+  }
+  const selfUpdater = deps.updateSelf ?? defaultUpdateSelf;
+  const pluginHome = deps.pluginHome ?? resolvePluginHome();
+  const pluginUpdater = deps.updatePlugin ?? (async (input) => {
+    await ensurePluginHome(pluginHome);
+    await updatePluginPackage({ ...input, pluginHome });
+  });
+  const validatePlugin = deps.validatePlugin ?? validatePluginDefault;
+  const updatedPlugins = [...config2.plugins ?? []];
+  for (const target of selected.targets) {
+    try {
+      if (target.kind === "self") {
+        if (!all && !explicitTargets[0]) {
+          if (!deps.isInteractive()) {
+            deps.print("更新 weacpx 本体需要确认；非交互模式请使用 `weacpx update --all` 或 `weacpx update weacpx`。");
+            return 1;
+          }
+          const answer = (await deps.promptText("确认更新 weacpx 本体？[y/N] ")).trim().toLowerCase();
+          if (answer !== "y" && answer !== "yes") {
+            deps.print("已取消更新 weacpx 本体。");
+            continue;
+          }
+        }
+        await selfUpdater(target.name);
+        deps.print(`weacpx 已更新：${target.latestVersion ?? "latest"}`);
+        continue;
       }
-      const trimmedValue = value.trim();
-      if (trimmedValue.length === 0 || trimmedValue.startsWith("-")) {
-        throw new Error("--source-handle requires a non-empty value");
+      const existing = updatedPlugins.find((plugin) => plugin.name === target.name);
+      const previousVersion = existing?.version;
+      const updateInput = target.latestVersion ? { packageName: target.name, version: target.latestVersion } : { packageName: target.name };
+      await pluginUpdater(updateInput);
+      try {
+        await validatePlugin(target.name, pluginHome);
+      } catch (validationError) {
+        if (previousVersion) {
+          try {
+            await pluginUpdater({ packageName: target.name, version: previousVersion });
+          } catch (rollbackError) {
+            deps.print(`回滚 ${target.name} 到 ${previousVersion} 失败：${rollbackError instanceof Error ? rollbackError.message : String(rollbackError)}`);
+          }
+        }
+        throw validationError;
       }
-      fromFlag = value;
+      if (!existing)
+        throw new Error(`配置中没有找到插件 ${target.name}`);
+      if (existing && target.latestVersion)
+        existing.version = target.latestVersion;
+      deps.print(`插件 ${target.name} 已更新：${target.latestVersion ?? "latest"}`);
+    } catch (error2) {
+      deps.print(`${target.name} 更新失败：${error2 instanceof Error ? error2.message : String(error2)}`);
+      return 1;
     }
   }
-  const trimmedFlag = fromFlag?.trim();
-  if (trimmedFlag && trimmedFlag.length > 0) {
-    return trimmedFlag;
+  if (selected.targets.some((target) => target.kind === "plugin")) {
+    config2.plugins = updatedPlugins;
+    await deps.saveConfig(config2);
   }
-  const trimmedEnv = env.WEACPX_SOURCE_HANDLE?.trim();
-  return trimmedEnv && trimmedEnv.length > 0 ? trimmedEnv : null;
+  return 0;
+}
+function formatTarget(target) {
+  const current = target.currentVersion ?? "未锁定";
+  const latest = target.latestVersion ?? "无法检查";
+  const label = target.kind === "self" ? "weacpx" : `插件 ${target.name}`;
+  return `${label} (${current} -> ${latest})`;
+}
+async function selectTargets(targets, candidates, input) {
+  if (input.explicitTarget) {
+    const target = targets.find((entry) => entry.name === input.explicitTarget || input.explicitTarget === "weacpx" && entry.kind === "self");
+    if (!target)
+      return { ok: false, message: `没有找到更新项：${input.explicitTarget}`, exitCode: 1 };
+    if (!target.latestVersion)
+      return { ok: false, message: `${target.name} 无法检查最新版本，已跳过。`, exitCode: 1 };
+    if (target.kind === "plugin" && !target.pinned)
+      return { ok: false, message: `${target.name} 未记录当前版本；请先使用 \`weacpx plugin update ${target.name}\` 或显式选择版本。`, exitCode: 1 };
+    if (target.currentVersion === target.latestVersion)
+      return { ok: true, targets: [] };
+    return { ok: true, targets: [target] };
+  }
+  if (input.all || targets.length === 1)
+    return { ok: true, targets: candidates };
+  if (!input.deps.isInteractive()) {
+    return { ok: false, message: "检测到已安装插件；非交互模式请使用 `weacpx update --all` 或 `weacpx update <name>`。", exitCode: 1 };
+  }
+  const answer = (await input.deps.promptText("请选择要更新的项目（数字，逗号分隔，a=全部，回车取消）：")).trim().toLowerCase();
+  if (!answer)
+    return { ok: true, targets: [] };
+  if (answer === "a" || answer === "all")
+    return { ok: true, targets: candidates };
+  const selected = [];
+  for (const part of answer.split(",")) {
+    const index = Number.parseInt(part.trim(), 10);
+    if (!Number.isFinite(index) || index < 1 || index > targets.length) {
+      return { ok: false, message: `无效选择：${part.trim()}`, exitCode: 1 };
+    }
+    const target = targets[index - 1];
+    if (!target.latestVersion)
+      return { ok: false, message: `${target.name} 无法检查最新版本，已跳过。`, exitCode: 1 };
+    if (target.kind === "plugin" && !target.pinned)
+      return { ok: false, message: `${target.name} 未记录当前版本；请先使用 \`weacpx plugin update ${target.name}\` 或显式选择版本。`, exitCode: 1 };
+    if (target.currentVersion === target.latestVersion)
+      continue;
+    if (!selected.includes(target))
+      selected.push(target);
+  }
+  return { ok: true, targets: selected };
+}
+async function getLatestNpmVersion(packageName) {
+  const result = await runCapture("npm", ["view", packageName, "version", "--json"]);
+  if (result.code !== 0)
+    return null;
+  const raw = result.stdout.trim();
+  if (!raw)
+    return null;
+  try {
+    const parsed = JSON.parse(raw);
+    return typeof parsed === "string" ? parsed : null;
+  } catch {
+    return raw.replace(/^"|"$/g, "") || null;
+  }
+}
+async function defaultUpdateSelf(packageName) {
+  const manager = process.env.WEACPX_PACKAGE_MANAGER?.trim().toLowerCase() === "bun" ? "bun" : "npm";
+  if (manager === "bun") {
+    await runInherit("bun", ["add", "-g", packageName]);
+    return;
+  }
+  await runInherit("npm", ["install", "-g", packageName]);
+}
+async function runCapture(command, args) {
+  return await new Promise((resolve, reject) => {
+    const child = spawn4(command, args, { stdio: ["ignore", "pipe", "pipe"] });
+    let stdout2 = "";
+    let stderr = "";
+    child.stdout.setEncoding("utf8");
+    child.stderr.setEncoding("utf8");
+    child.stdout.on("data", (chunk) => {
+      stdout2 += chunk;
+    });
+    child.stderr.on("data", (chunk) => {
+      stderr += chunk;
+    });
+    child.on("error", reject);
+    child.on("close", (code) => resolve({ code: code ?? 1, stdout: stdout2, stderr }));
+  });
+}
+async function runInherit(command, args) {
+  await new Promise((resolve, reject) => {
+    const child = spawn4(command, args, { stdio: "inherit" });
+    child.on("error", reject);
+    child.on("exit", (code) => {
+      if (code === 0)
+        resolve();
+      else
+        reject(new Error(`${command} ${args.join(" ")} exited with code ${code}`));
+    });
+  });
+}
+async function readPackageName() {
+  try {
+    const here = dirname7(fileURLToPath2(import.meta.url));
+    for (const candidate of [join6(here, "..", "package.json"), join6(here, "..", "..", "package.json")]) {
+      try {
+        const parsed = JSON.parse(await readFile7(candidate, "utf8"));
+        if (typeof parsed.name === "string" && parsed.name.trim())
+          return parsed.name.trim();
+      } catch {}
+    }
+  } catch {}
+  return "weacpx";
+}
+async function validatePluginDefault(packageName, pluginHome) {
+  const moduleValue = await importPluginFromHome(packageName, pluginHome);
+  validateWeacpxPlugin(moduleValue, packageName);
 }
 
 // src/cli.ts
-init_workspace_path();
-init_state_store();
 init_version();
 
 // src/channels/cli/channel-cli.ts
@@ -40187,71 +40566,8 @@ async function setChannelAccountEnabled(type, accountId, enabled, rawArgs, deps)
 
 // src/plugins/plugin-cli.ts
 init_plugin_home();
-import { readFile as readFile8 } from "node:fs/promises";
-import { isAbsolute, join as join7, resolve } from "node:path";
-
-// src/plugins/package-manager.ts
-import { spawn as spawn3 } from "node:child_process";
-async function defaultRunCommand(command, args, options) {
-  await new Promise((resolve, reject) => {
-    const child = spawn3(command, args, { cwd: options.cwd, stdio: "inherit" });
-    child.on("error", reject);
-    child.on("exit", (code) => {
-      if (code === 0)
-        resolve();
-      else
-        reject(new Error(`${command} ${args.join(" ")} exited with code ${code}`));
-    });
-  });
-}
-async function silentRun(command, args, options) {
-  await new Promise((resolve, reject) => {
-    const child = spawn3(command, args, { cwd: options.cwd, stdio: "ignore" });
-    child.on("error", reject);
-    child.on("exit", (code) => {
-      if (code === 0)
-        resolve();
-      else
-        reject(new Error(`${command} ${args.join(" ")} exited with code ${code}`));
-    });
-  });
-}
-async function detectPackageManager(runCommand) {
-  const override = process.env.WEACPX_PACKAGE_MANAGER?.trim().toLowerCase();
-  if (override === "bun" || override === "npm")
-    return override;
-  const probe = runCommand ?? silentRun;
-  try {
-    await probe("bun", ["--version"], { cwd: process.cwd() });
-    return "bun";
-  } catch {
-    return "npm";
-  }
-}
-async function installPluginPackage(input) {
-  const runCommand = input.runCommand ?? defaultRunCommand;
-  const packageManager = input.packageManager ?? await detectPackageManager();
-  const spec = input.version ? `${input.packageName}@${input.version}` : input.packageName;
-  if (packageManager === "bun") {
-    await runCommand("bun", ["add", spec], { cwd: input.pluginHome });
-    return;
-  }
-  await runCommand("npm", ["install", spec], { cwd: input.pluginHome });
-}
-async function updatePluginPackage(input) {
-  await installPluginPackage(input);
-}
-async function removePluginPackage(input) {
-  const runCommand = input.runCommand ?? defaultRunCommand;
-  const packageManager = input.packageManager ?? await detectPackageManager();
-  if (packageManager === "bun") {
-    await runCommand("bun", ["remove", input.packageName], { cwd: input.pluginHome });
-    return;
-  }
-  await runCommand("npm", ["uninstall", input.packageName], { cwd: input.pluginHome });
-}
-
-// src/plugins/plugin-cli.ts
+import { readFile as readFile9 } from "node:fs/promises";
+import { isAbsolute, join as join8, resolve } from "node:path";
 init_plugin_loader();
 init_validate_plugin();
 
@@ -40260,14 +40576,14 @@ init_channel_scope();
 init_plugin_loader();
 init_validate_plugin();
 init_known_plugins();
-import { readFile as readFile7 } from "node:fs/promises";
-import { join as join6 } from "node:path";
+import { readFile as readFile8 } from "node:fs/promises";
+import { join as join7 } from "node:path";
 function suggestedPluginPackageForChannel(type) {
   return findKnownPluginByChannel(type)?.packageName ?? `<npm-package-that-provides-${type}>`;
 }
 async function readDependencyEntries(pluginHome) {
   try {
-    const raw = await readFile7(join6(pluginHome, "package.json"), "utf8");
+    const raw = await readFile8(join7(pluginHome, "package.json"), "utf8");
     const parsed = JSON.parse(raw);
     const out = {};
     for (const [name, value] of Object.entries(parsed.dependencies ?? {})) {
@@ -40369,7 +40685,7 @@ function looksLikePath(spec) {
 }
 async function readDependencyEntries2(pluginHome) {
   try {
-    const raw = await readFile8(join7(pluginHome, "package.json"), "utf8");
+    const raw = await readFile9(join8(pluginHome, "package.json"), "utf8");
     const parsed = JSON.parse(raw);
     const out = {};
     for (const [name, value] of Object.entries(parsed.dependencies ?? {})) {
@@ -40395,7 +40711,7 @@ async function resolveLocalPluginName(installSpec, pluginHome, namesBeforeInstal
       return name;
   }
   try {
-    const raw = await readFile8(join7(installSpec, "package.json"), "utf8");
+    const raw = await readFile9(join8(installSpec, "package.json"), "utf8");
     const parsed = JSON.parse(raw);
     if (typeof parsed.name === "string" && parsed.name.trim())
       return parsed.name.trim();
@@ -40924,6 +41240,7 @@ var HELP_LINES = [
   "weacpx status - 查看状态",
   "weacpx stop   - 停止服务",
   "weacpx restart - 重启后台服务",
+  "weacpx update [--all|<name>] - 更新 weacpx 和已安装插件",
   "weacpx channel|ch list|show|add|rm|enable|disable [--account <id>] - 管理消息频道（多 bot 用 --account）",
   "weacpx plugin list|add|update|remove|enable|disable|doctor|known - 管理插件",
   "weacpx doctor - 运行诊断",
@@ -40959,8 +41276,28 @@ async function runCli(args, deps = {}) {
       await (deps.logout ?? defaultLogout)();
       return 0;
     case "run":
-      await (deps.run ?? defaultRun)();
+      const onboarding = await runOnboardingBeforeStart({
+        print,
+        cwd: deps.cwd ?? (() => process.cwd()),
+        isInteractive: deps.isInteractive,
+        promptText: deps.promptText
+      });
+      await (deps.run ?? defaultRun)({ firstRunOnboarding: onboarding ?? undefined });
       return 0;
+    case "update": {
+      const result = await (deps.update ?? ((subArgs) => defaultUpdate(subArgs, {
+        print,
+        isInteractive: deps.isInteractive,
+        promptText: deps.promptText,
+        overrides: deps.updateCliDeps
+      })))(args.slice(1));
+      if (result === null) {
+        for (const line of HELP_LINES)
+          print(line);
+        return 1;
+      }
+      return result;
+    }
     case "doctor": {
       const parsed = parseDoctorArgs(args.slice(1));
       if (!parsed.ok) {
@@ -41026,7 +41363,22 @@ async function runCli(args, deps = {}) {
     case "start": {
       const controller = deps.controller ?? createDefaultController();
       try {
-        const result = await controller.start();
+        const status = await controller.getStatus();
+        if (status.state === "running") {
+          print("weacpx 已在后台运行");
+          print(`PID: ${status.pid}`);
+          return 0;
+        }
+        if (status.state === "indeterminate") {
+          throw new Error(`weacpx daemon process is already running (pid ${status.pid}) but status metadata is missing`);
+        }
+        const onboarding2 = await runOnboardingBeforeStart({
+          print,
+          cwd: deps.cwd ?? (() => process.cwd()),
+          isInteractive: deps.isInteractive,
+          promptText: deps.promptText
+        });
+        const result = await controller.start({ firstRunOnboarding: onboarding2 ?? undefined });
         if (result.state === "already-running") {
           print("weacpx 已在后台运行");
           print(`PID: ${result.pid}`);
@@ -41095,6 +41447,44 @@ async function runCli(args, deps = {}) {
       return 1;
   }
 }
+async function defaultUpdate(args, input) {
+  const store = await createCliConfigStore();
+  const deps = {
+    loadConfig: async () => await store.load(),
+    saveConfig: async (config2) => await store.save(config2),
+    readCurrentVersion: readVersion,
+    print: input.print,
+    isInteractive: input.isInteractive ?? (() => Boolean(process.stdin.isTTY && process.stdout.isTTY)),
+    promptText: input.promptText ?? defaultPromptText,
+    ...input.overrides
+  };
+  return await handleUpdateCli(args, deps);
+}
+async function runOnboardingBeforeStart(input) {
+  const runtimePaths = (await init_main().then(() => exports_main)).resolveRuntimePaths();
+  await ensureConfigExists(runtimePaths.configPath);
+  const configStore = new ConfigStore(runtimePaths.configPath);
+  const stateStore = new StateStore(runtimePaths.statePath);
+  const config2 = await configStore.load();
+  const state = await stateStore.load();
+  const result = await maybeRunFirstUseOnboarding({
+    config: config2,
+    state,
+    saveConfig: async (next) => await configStore.save(next),
+    deps: {
+      print: input.print,
+      cwd: input.cwd,
+      isInteractive: input.isInteractive ?? (() => Boolean(process.stdin.isTTY && process.stdout.isTTY)),
+      promptText: input.promptText ?? defaultPromptText
+    }
+  });
+  return result.created ? {
+    alias: result.alias,
+    agent: result.agent,
+    workspace: result.workspace,
+    rollback: result.rollback
+  } : null;
+}
 async function handleWorkspaceCli(args, deps) {
   const subcommand = args[0];
   switch (subcommand) {
@@ -41190,7 +41580,7 @@ async function defaultLoadConfiguredPluginsForChannelCli() {
   const { loadConfiguredPlugins: loadConfiguredPlugins2 } = await Promise.resolve().then(() => (init_plugin_loader(), exports_plugin_loader));
   await loadConfiguredPlugins2({ plugins: config2.plugins });
 }
-async function defaultRun() {
+async function defaultRun(options = {}) {
   const [{ buildApp: buildApp2, resolveRuntimePaths: resolveRuntimePaths2, prepareChannelMedia: prepareChannelMedia2 }, { runConsole: runConsole2 }] = await Promise.all([
     init_main().then(() => exports_main),
     Promise.resolve().then(() => (init_run_console(), exports_run_console))
@@ -41208,11 +41598,15 @@ async function defaultRun() {
   const channelRegistry = new MessageChannelRegistry2(createMessageChannels2(config2.channels, channelDeps));
   const lockCreators = channelRegistry.createConsumerLocks();
   const firstLockCreator = lockCreators[0];
+  const firstRunOnboarding = options.firstRunOnboarding ?? decodeFirstRunOnboarding(process.env.WEACPX_FIRST_RUN_ONBOARDING);
   await runConsole2(runtimePaths, {
     buildApp: (paths) => buildApp2(paths, {
       defaultLoggingLevel: resolveCliEntryPath2().includes(`${sep}src${sep}`) ? "debug" : "info",
       channel: channelRegistry
     }),
+    beforeReady: firstRunOnboarding ? async (runtime) => {
+      await createFirstRunSession(runtime, firstRunOnboarding);
+    } : undefined,
     channels: channelRegistry,
     daemonRuntime,
     ...firstLockCreator ? {
@@ -41225,6 +41619,42 @@ async function defaultRun() {
     } : {}
   });
 }
+async function createFirstRunSession(runtime, plan) {
+  const session = runtime.sessions.resolveSession(plan.alias, plan.agent, plan.workspace, plan.alias);
+  try {
+    await runtime.transport.ensureSession(session);
+    const exists = await runtime.transport.hasSession(session);
+    if (!exists) {
+      throw new Error(`first-run onboarding failed to create transport session: ${plan.alias}`);
+    }
+    await runtime.sessions.attachSession(plan.alias, plan.agent, plan.workspace, session.transportSession);
+  } catch (error2) {
+    await rollbackFirstRunConfig(runtime, plan);
+    throw error2;
+  }
+  await runtime.logger.info("onboarding.session_created", "created first-run transport session", {
+    alias: plan.alias,
+    agent: plan.agent,
+    workspace: plan.workspace
+  });
+}
+async function rollbackFirstRunConfig(runtime, plan) {
+  try {
+    const config2 = await runtime.configStore.load();
+    if (!plan.rollback.workspaceExisted && config2.workspaces[plan.workspace]) {
+      delete config2.workspaces[plan.workspace];
+    }
+    if (!plan.rollback.agentExisted && config2.agents[plan.agent]) {
+      delete config2.agents[plan.agent];
+    }
+    await runtime.configStore.save(config2);
+  } catch (error2) {
+    await runtime.logger.error("onboarding.rollback_failed", "failed to roll back first-run config", {
+      alias: plan.alias,
+      error: error2 instanceof Error ? error2.message : String(error2)
+    });
+  }
+}
 async function defaultDoctor(options) {
   const { main: main3 } = await init_doctor2().then(() => exports_doctor);
   return await main3(options);
@@ -41409,12 +41839,42 @@ async function defaultPromptSecret(message) {
 }
 function createDefaultController() {
   const daemonPaths = resolveDaemonPaths({ home: requireHome2() });
-  return createDaemonController(daemonPaths, {
+  const controller = createDaemonController(daemonPaths, {
     processExecPath: process.execPath,
     cliEntryPath: resolveCliEntryPath2(),
     cwd: process.cwd(),
     env: process.env
   });
+  return {
+    getStatus: () => controller.getStatus(),
+    stop: () => controller.stop(),
+    start: (options) => controller.start({
+      ...options?.firstRunOnboarding ? { firstRunOnboarding: encodeFirstRunOnboarding(options.firstRunOnboarding) } : {}
+    })
+  };
+}
+function encodeFirstRunOnboarding(plan) {
+  return Buffer.from(JSON.stringify(plan), "utf8").toString("base64url");
+}
+function decodeFirstRunOnboarding(raw) {
+  if (!raw)
+    return null;
+  try {
+    const parsed = JSON.parse(Buffer.from(raw, "base64url").toString("utf8"));
+    if (typeof parsed.alias === "string" && typeof parsed.agent === "string" && typeof parsed.workspace === "string") {
+      const rollback = typeof parsed.rollback === "object" && parsed.rollback !== null ? parsed.rollback : {};
+      return {
+        alias: parsed.alias,
+        agent: parsed.agent,
+        workspace: parsed.workspace,
+        rollback: {
+          workspaceExisted: rollback.workspaceExisted === true,
+          agentExisted: rollback.agentExisted === true
+        }
+      };
+    }
+  } catch {}
+  return null;
 }
 function requireHome2() {
   const home = process.env.HOME ?? homedir13();
@@ -41437,7 +41897,7 @@ function resolveCliEntryPath2() {
   if (process.argv[1]) {
     return process.argv[1];
   }
-  return fileURLToPath5(import.meta.url);
+  return fileURLToPath6(import.meta.url);
 }
 function parseDoctorArgs(args) {
   const options = {};