@web-auto/webauto 0.1.3 → 0.1.6

package/bin/webauto.mjs

@@ -37,23 +37,65 @@ function isGlobalInstall() {
          !existsSync(path.join(ROOT, '.git'));
 }
 
-function npmBin() {
-  return process.platform === 'win32' ? 'npm.cmd' : 'npm';
+function resolveOnPath(candidates) {
+  const pathEnv = process.env.PATH || process.env.Path || '';
+  const dirs = pathEnv.split(path.delimiter).filter(Boolean);
+  for (const dir of dirs) {
+    for (const name of candidates) {
+      const full = path.join(dir, name);
+      if (existsSync(full)) return full;
+    }
+  }
+  return null;
+}
+
+function wrapWindowsRunner(cmdPath, prefix = []) {
+  if (process.platform !== 'win32') return { cmd: cmdPath, prefix };
+  const lower = String(cmdPath || '').toLowerCase();
+  if (lower.endsWith('.ps1')) {
+    return {
+      cmd: 'powershell.exe',
+      prefix: ['-NoProfile', '-ExecutionPolicy', 'Bypass', '-File', cmdPath, ...prefix],
+    };
+  }
+  if (lower.endsWith('.cmd') || lower.endsWith('.bat')) {
+    return {
+      cmd: 'cmd.exe',
+      prefix: ['/d', '/s', '/c', cmdPath, ...prefix],
+    };
+  }
+  return { cmd: cmdPath, prefix };
+}
+
+function npmRunner() {
+  if (process.platform !== 'win32') return { cmd: 'npm', prefix: [] };
+  const npmNames = ['npm.cmd', 'npm.exe', 'npm.bat', 'npm.ps1'];
+  const resolved = resolveOnPath(npmNames) || 'npm.cmd';
+  return wrapWindowsRunner(resolved);
+}
+
+function uiConsoleScriptPath() {
+  return path.join(ROOT, 'apps', 'desktop-console', 'entry', 'ui-console.mjs');
 }
 
 function printMainHelp() {
   console.log(`webauto CLI
 
 Usage:
+  webauto               # 直接启动 UI Console
   webauto --help
   webauto account --help
-  webauto ui console --help
+  webauto schedule --help
+  webauto deps --help
+  webauto ui --help
   webauto xhs --help
 
 Core Commands:
   webauto account <list|sync|add|get|update|delete|login|sync-alias> [options]
+  webauto schedule <list|get|add|update|delete|import|export|run|run-due|daemon> [options]
+  webauto deps <check|auto|install|uninstall|reinstall> [options]
   webauto ui console [--build] [--install] [--check]
-  webauto ui test <scenario> [options]
+  webauto ui cli <action> [options]
   webauto xhs install [--download-browser] [--download-geoip] [--ensure-backend]
   webauto xhs unified [xhs options...]
   webauto xhs status [--run-id <id>] [--json]
@@ -61,36 +103,44 @@ Core Commands:
 
 Build & Release:
   webauto build:dev        # Local link mode
-  webauto build:release    # Prepare npm release
+  webauto build:release    # Full release gate (tests/build/pack)
+  webauto build:release -- --skip-tests
+  webauto build:release -- --skip-pack
 
 Examples (standard):
   webauto account add --platform xiaohongshu --alias 主号
   webauto account list
   webauto account login xhs-0001 --url https://www.xiaohongshu.com
   webauto account sync-alias xhs-0001
+  webauto schedule add --name "工作服-半小时" --schedule-type interval --interval-minutes 30 --profile xiaohongshu-batch-1 --keyword "工作服定制" --max-notes 50 --env debug
+  webauto schedule list
+  webauto schedule daemon --interval-sec 30
+  webauto deps install --all
+  webauto deps reinstall --all
   webauto ui console --check
   webauto ui console --build
   webauto ui console --install
-  webauto ui test env-check
-  webauto ui test account-flow --profile test-001
-  webauto ui test config-save --output ./report.json
-  webauto ui test crawl-run --keyword "测试" --target 10
+  webauto ui cli start --build
+  webauto ui cli tab --tab 配置
+  webauto ui cli input --selector "#keyword-input" --value "seedance2.0"
+  webauto ui cli click --selector "#start-btn"
   webauto xhs install --ensure-backend
   webauto xhs unified --profile xiaohongshu-batch-1 --keyword "seedance2.0" --max-notes 100 --do-comments true --persist-comments true --do-likes true --like-keywords "真牛逼" --env debug --tab-count 4
 
 Tips:
   - xhs 命令会转发到 apps/webauto/entry/xhs-*.mjs
   - account 命令会转发到 apps/webauto/entry/account.mjs
+  - schedule 命令会转发到 apps/webauto/entry/schedule.mjs
   - 全量参数请看: webauto xhs --help
 `);
 }
 
 function printUiConsoleHelp() {
-  console.log(`webauto ui console
+  console.log(`webauto ui
 
 Usage:
   webauto ui console [--build] [--install] [--check] [--no-daemon]
-  webauto ui test <scenario> [options]
+  webauto ui cli <action> [options]
 
 Options:
   --check       只检查构建/依赖状态，不启动 UI
@@ -98,27 +148,41 @@ Options:
   --install     缺少依赖时自动安装
   --no-daemon   前台模式运行（不后台守护）
 
-Test Scenarios:
-  env-check     环境检查（camo CLI + 服务健康）
-  account-flow  账户创建/登录流程测试
-  config-save   配置导入/导出测试
-  crawl-run     完整爬取流程测试（dry-run 模式）
-
-Test Options:
-  --profile <id>   测试用 profile ID
-  --keyword <kw>   测试关键词
-  --target <n>     目标数量
-  --headless       无头模式
-  --output <path>  输出 JSON 报告路径
+CLI Actions:
+  start         启动 UI（可配合 --build/--install）
+  status        获取 UI 运行状态（含 runId/错误计数）
+  snapshot      获取 UI 快照（含当前 tab 与关键控件值）
+  tab           切换 tab（--tab config 或 --label 配置）
+  click         点击控件（--selector）
+  focus         聚焦控件（--selector）
+  input         输入文本（--selector --value）
+  select        选择下拉项（--selector --value）
+  press         输入按键（--key Enter/Escape）
+  probe         读取控件状态（exists/count/value/text/checked，可选 --detailed）
+  click-text    按文案点击按钮（无 id 控件）
+  dialogs       控制 alert/confirm/prompt 静默模式
+  wait          等待元素状态（--selector --state visible|exists|hidden|text_contains|text_equals|value_equals|not_disabled）
+  run           按 steps.json 执行动作序列
+  full-cover    真实 UI CLI 全功能覆盖回归（无 mock）
+
+Common Options:
+  --auto-start    未检测到 UI 时自动拉起
+  --host <host>   控制通道 host（默认 127.0.0.1）
+  --port <n>      控制通道端口（默认 7716）
+  --json          输出 JSON
+  --detailed      probe 时返回 rect/style/attributes 等详细信息
 
 Examples:
   webauto ui console --check
   webauto ui console --build
   webauto ui console --install
-  webauto ui test env-check
-  webauto ui test account-flow --profile test-001
-  webauto ui test config-save --output ./report.json
-  webauto ui test crawl-run --keyword "测试" --target 10 --headless
+  webauto ui cli start --build
+  webauto ui cli status --json
+  webauto ui cli tab --tab 配置
+  webauto ui cli input --selector "#keyword-input" --value "春晚"
+  webauto ui cli click --selector "#start-btn"
+  webauto ui cli probe --selector "#start-btn" --detailed
+  webauto ui cli full-cover --build --output ./.tmp/ui-cli-full-cover.json
 `);
 }
 
@@ -126,13 +190,13 @@ function printXhsHelp() {
   console.log(`webauto xhs
 
 Usage:
-  webauto xhs install [--download-browser] [--download-geoip] [--ensure-backend]
+  webauto xhs install [--download-browser] [--download-geoip] [--ensure-backend] [--install|--reinstall|--uninstall] [--browser|--geoip|--all]
   webauto xhs unified --profile <id> --keyword <kw> [options...]
   webauto xhs status [--run-id <id>] [--json]
   webauto xhs orchestrate --profile <id> --keyword <kw> [options...]
 
 Subcommands:
-  install      运行 xhs-install，检查/安装 camoufox、geoip，按需拉起 backend
+  install      运行资源管理（兼容旧入口），支持检查/安装/卸载/重装 camoufox、geoip，按需拉起 backend
   unified      运行统一脚本（搜索 + 打开详情 + 评论抓取 + 点赞）
   status       查询当前任务状态与错误摘要（支持 runId 详情）
   orchestrate  运行编排入口（默认调用 unified 模式）
@@ -227,6 +291,57 @@ Examples:
 `);
 }
 
+function printScheduleHelp() {
+  console.log(`webauto schedule
+
+Usage:
+  webauto schedule --help
+  webauto schedule list [--json]
+  webauto schedule get <taskId> [--json]
+  webauto schedule add [options]
+  webauto schedule update <taskId> [options]
+  webauto schedule delete <taskId> [--json]
+  webauto schedule import [--file <path> | --payload-json <json>] [--json]
+  webauto schedule export [taskId] [--file <path>] [--json]
+  webauto schedule run <taskId> [--json]
+  webauto schedule run-due [--limit <n>] [--json]
+  webauto schedule daemon [--interval-sec <n>] [--limit <n>] [--once] [--json]
+
+Examples:
+  webauto schedule add --name "deepseek-每30分钟" --schedule-type interval --interval-minutes 30 --profile xiaohongshu-batch-1 --keyword deepseek --max-notes 100 --do-comments true --do-likes true --like-keywords 牛逼 --env debug
+  webauto schedule add --name "每天早上任务" --schedule-type daily --run-at 2026-02-20T09:00:00+08:00 --max-runs 30 --profile xiaohongshu-batch-1 --keyword 工作服
+  webauto schedule add --name "每周巡检" --schedule-type weekly --run-at 2026-02-22T10:30:00+08:00 --max-runs 8 --profile xiaohongshu-batch-1 --keyword deepseek
+  webauto schedule list
+  webauto schedule run-due --json
+  webauto schedule daemon --interval-sec 30
+`);
+}
+
+function printDepsHelp() {
+  console.log(`webauto deps
+
+Usage:
+  webauto deps --help
+  webauto deps check [--browser|--geoip|--all] [--json]
+  webauto deps auto [--browser|--geoip|--all] [--json]
+  webauto deps install [--browser|--geoip|--all] [--ensure-backend] [--json]
+  webauto deps uninstall [--browser|--geoip|--all] [--json]
+  webauto deps reinstall [--browser|--geoip|--all] [--ensure-backend] [--json]
+
+Notes:
+  - 不指定资源范围时默认 --all
+  - install/reinstall 默认会追加 --ensure-backend（可用 --no-ensure-backend 关闭）
+  - auto 模式用于 npm 安装后自动补齐缺失资源
+
+Examples:
+  webauto deps check --all --json
+  webauto deps install --all
+  webauto deps install --browser --ensure-backend
+  webauto deps uninstall --geoip
+  webauto deps reinstall --all --json
+`);
+}
+
 function exists(p) {
   try {
     return existsSync(p);
@@ -244,7 +359,14 @@ async function run(cmd, args, options = {}) {
       ...options,
     });
     child.on('error', reject);
-    child.on('exit', (code) => (code === 0 ? resolve() : reject(new Error(`exit ${code}`))));
+    child.on('exit', (code) => {
+      if (code === 0) return resolve();
+      if (process.platform === 'win32' && code === 3221226505) {
+        console.warn(`[webauto] Ignored spurious exit on Windows (code ${code})`);
+        return resolve();
+      }
+      return reject(new Error(`exit ${code}`));
+    });
   });
 }
 
@@ -256,11 +378,19 @@ async function runInDir(dir, cmd, args) {
       stdio: 'inherit',
     });
     child.on('error', reject);
-    child.on('exit', (code) => (code === 0 ? resolve() : reject(new Error(`exit ${code}`))));
+    child.on('exit', (code) => {
+      if (code === 0) return resolve();
+      if (process.platform === 'win32' && code === 3221226505) {
+        console.warn(`[webauto] Ignored spurious exit on Windows (code ${code})`);
+        return resolve();
+      }
+      return reject(new Error(`exit ${code}`));
+    });
   });
 }
 
 function checkDesktopConsoleDeps() {
+  if (isGlobalInstall()) return true;
   // Check for electron in various locations:
   // 1. Global npm root (when installed globally alongside webauto)
   // 2. Package's own node_modules
@@ -291,16 +421,30 @@ async function ensureDepsAndBuild() {
     process.exit(1);
   }
 
+  // Global package should already ship renderer build.
+  if (isGlobalInstall()) {
+    if (!checkDesktopConsoleBuilt()) {
+      console.error('❌ desktop-console dist missing from package. Please reinstall @web-auto/webauto.');
+      process.exit(1);
+    }
+    const pkgJson = JSON.parse(readFileSync(path.join(ROOT, 'package.json'), 'utf-8'));
+    saveState({ initialized: true, version: pkgJson.version });
+    console.log('[webauto] Setup complete!');
+    return;
+  }
+
   // Install deps if needed
   if (!checkDesktopConsoleDeps()) {
     console.log('[webauto] Installing desktop-console dependencies...');
-    await runInDir(appDir, npmBin(), ['install']);
+  const npm = npmRunner();
+  await runInDir(appDir, npm.cmd, [...npm.prefix, 'install']);
   }
 
   // Build if needed  
   if (!checkDesktopConsoleBuilt()) {
     console.log('[webauto] Building desktop-console...');
-    await runInDir(appDir, npmBin(), ['run', 'build']);
+  const npm = npmRunner();
+  await runInDir(appDir, npm.cmd, [...npm.prefix, 'run', 'build']);
   }
 
   // Mark as initialized
@@ -309,7 +453,7 @@ async function ensureDepsAndBuild() {
   console.log('[webauto] Setup complete!');
 }
 
-async function uiConsole({ build, install, checkOnly }) {
+async function uiConsole({ build, install, checkOnly, noDaemon }) {
   const okServices = checkServicesBuilt();
   const okDeps = checkDesktopConsoleDeps();
   const okUiBuilt = checkDesktopConsoleBuilt();
@@ -332,13 +476,14 @@ async function uiConsole({ build, install, checkOnly }) {
     }
   } else {
     // Local dev mode - require explicit build
-  if (!okServices) {
-    if (!build) {
-      console.error('❌ missing dist/ (services/modules). Run: npm run build:services');
-      process.exit(2);
+    if (!okServices) {
+      if (!build) {
+        console.error('❌ missing dist/ (services/modules). Run: npm run build:services');
+        process.exit(2);
+      }
+      const npm = npmRunner();
+      await run(npm.cmd, [...npm.prefix, 'run', 'build:services']);
     }
-    await run(npmBin(), ['run', 'build:services']);
-  }
   }
 
   if (!okDeps) {
@@ -349,7 +494,8 @@ async function uiConsole({ build, install, checkOnly }) {
       process.exit(2);
     }
     if (!isGlobalInstall()) {
-      await runInDir(path.join(ROOT, 'apps', 'desktop-console'), npmBin(), ['install']);
+      const npm = npmRunner();
+      await runInDir(path.join(ROOT, 'apps', 'desktop-console'), npm.cmd, [...npm.prefix, 'install']);
     }
   }
 
@@ -358,16 +504,20 @@ async function uiConsole({ build, install, checkOnly }) {
       console.error('❌ missing apps/desktop-console/dist. Run: npm --prefix apps/desktop-console run build');
       process.exit(2);
     }
-    await runInDir(path.join(ROOT, 'apps', 'desktop-console'), npmBin(), ['run', 'build']);
+    const npm = npmRunner();
+    await runInDir(path.join(ROOT, 'apps', 'desktop-console'), npm.cmd, [...npm.prefix, 'run', 'build']);
   }
 
-  await runInDir(path.join(ROOT, 'apps', 'desktop-console'), npmBin(), ['start']);
+  const uiScript = uiConsoleScriptPath();
+  const uiArgs = [];
+  if (noDaemon) uiArgs.push('--no-daemon');
+  await run(process.execPath, [uiScript, ...uiArgs]);
 }
 
 async function main() {
   const rawArgv = process.argv.slice(2);
   const args = minimist(process.argv.slice(2), {
-    boolean: ['help', 'build', 'install', 'check', 'full', 'link'],
+    boolean: ['help', 'build', 'install', 'check', 'full', 'link', 'skip-tests', 'skip-pack', 'no-daemon'],
     alias: { h: 'help' },
   });
 
@@ -379,7 +529,21 @@ async function main() {
       printAccountHelp();
       return;
     }
-    if (cmd === 'ui' && sub === 'console') {
+  if (cmd === 'weibo') {
+    const script = path.join(ROOT, 'apps', 'webauto', 'entry', 'weibo-unified.mjs');
+    await run(process.execPath, [script, ...rawArgv.slice(1)]);
+    return;
+  }
+
+    if (cmd === 'schedule') {
+      printScheduleHelp();
+      return;
+    }
+    if (cmd === 'deps') {
+      printDepsHelp();
+      return;
+    }
+    if (cmd === 'ui') {
       printUiConsoleHelp();
       return;
     }
@@ -392,28 +556,50 @@ async function main() {
   }
 
   if (!cmd) {
-    printMainHelp();
+    await uiConsole({
+      build: false,
+      install: false,
+      checkOnly: false,
+      noDaemon: args['no-daemon'] === true,
+    });
     return;
   }
 
   // build:dev - local development mode
   if (cmd === 'build:dev') {
     console.log('[webauto] Running local dev setup...');
-    await run(npmBin(), ['run', 'build:services']);
-    await runInDir(path.join(ROOT, 'apps', 'desktop-console'), npmBin(), ['install']);
-    await runInDir(path.join(ROOT, 'apps', 'desktop-console'), npmBin(), ['run', 'build']);
+    const npm = npmRunner();
+    await run(npm.cmd, [...npm.prefix, 'run', 'build:services']);
+    await runInDir(path.join(ROOT, 'apps', 'desktop-console'), npm.cmd, [...npm.prefix, 'install']);
+    await runInDir(path.join(ROOT, 'apps', 'desktop-console'), npm.cmd, [...npm.prefix, 'run', 'build']);
     console.log('[webauto] Dev setup complete');
     return;
   }
 
   // build:release - prepare for npm publish
   if (cmd === 'build:release') {
-    console.log('[webauto] Building release version...');
-    await run(npmBin(), ['run', 'build:services']);
+    const skipTests = args['skip-tests'] === true;
+    const skipPack = args['skip-pack'] === true;
+    console.log('[webauto] Running release gate...');
+    const npm = npmRunner();
+    await run(npm.cmd, [...npm.prefix, 'run', 'prebuild']);
+    if (!skipTests) {
+      await run(npm.cmd, [...npm.prefix, 'run', 'test:ci']);
+      await run(npm.cmd, [...npm.prefix, 'run', 'coverage:ci']);
+    } else {
+      console.log('[webauto] Skipping tests (--skip-tests)');
+    }
+    await run(npm.cmd, [...npm.prefix, 'run', 'build:services']);
+    await run(npm.cmd, [...npm.prefix, '--prefix', 'apps/desktop-console', 'run', 'build']);
+    if (!skipPack) {
+      await run(npm.cmd, [...npm.prefix, 'pack', '--dry-run']);
+    } else {
+      console.log('[webauto] Skipping npm pack validation (--skip-pack)');
+    }
     // Clean up state for fresh install
     saveState({ initialized: false, version: null });
-    console.log('[webauto] Release build complete');
-    console.log('[webauto] Ready to publish');
+    console.log('[webauto] Release gate complete');
+    console.log('[webauto] Ready to publish (npm publish --access public)');
     return;
   }
 
@@ -422,13 +608,20 @@ async function main() {
       build: args.build === true,
       install: args.install === true,
       checkOnly: args.check === true,
+      noDaemon: args['no-daemon'] === true,
     });
     return;
   }
 
+  if (cmd === 'ui' && sub === 'cli') {
+    const script = path.join(ROOT, 'apps', 'desktop-console', 'entry', 'ui-cli.mjs');
+    await run(process.execPath, [script, ...rawArgv.slice(2)]);
+    return;
+  }
 
-  // Delegate to ui-console.mjs for test scenarios
+  // Legacy: keep compatibility for historical `ui test` usage.
   if (cmd === 'ui' && sub === 'test') {
+    console.warn('[webauto] `ui test` 已废弃，建议改用 `webauto ui cli ...`。');
     const uiConsoleScript = path.join(ROOT, 'apps', 'desktop-console', 'entry', 'ui-console.mjs');
     await run(process.execPath, [uiConsoleScript, ...rawArgv.slice(1)]);
     return;
@@ -439,6 +632,60 @@ async function main() {
     return;
   }
 
+  if (cmd === 'weibo') {
+    const script = path.join(ROOT, 'apps', 'webauto', 'entry', 'weibo-unified.mjs');
+    await run(process.execPath, [script, ...rawArgv.slice(1)]);
+    return;
+  }
+
+  if (cmd === 'schedule') {
+    const script = path.join(ROOT, 'apps', 'webauto', 'entry', 'schedule.mjs');
+    await run(process.execPath, [script, ...rawArgv.slice(1)]);
+    return;
+  }
+
+  if (cmd === 'deps') {
+    if (!sub || sub === 'help') {
+      printDepsHelp();
+      return;
+    }
+    const script = path.join(ROOT, 'apps', 'webauto', 'entry', 'xhs-install.mjs');
+    const passthrough = rawArgv.slice(2);
+    const hasSelection = passthrough.some((item) => (
+      item === '--browser'
+      || item === '--geoip'
+      || item === '--all'
+      || item === '--download-browser'
+      || item === '--download-geoip'
+    ));
+    const disableEnsureBackend = passthrough.includes('--no-ensure-backend');
+    const modeArgs = [];
+    if (sub === 'check') {
+      // keep default mode from xhs-install (check).
+    } else if (sub === 'auto') {
+      modeArgs.push('--auto');
+      if (!hasSelection) modeArgs.push('--all');
+    } else if (sub === 'install') {
+      modeArgs.push('--install');
+      if (!hasSelection) modeArgs.push('--all');
+      if (!disableEnsureBackend) modeArgs.push('--ensure-backend');
+    } else if (sub === 'uninstall' || sub === 'remove') {
+      modeArgs.push('--uninstall');
+      if (!hasSelection) modeArgs.push('--all');
+    } else if (sub === 'reinstall') {
+      modeArgs.push('--reinstall');
+      if (!hasSelection) modeArgs.push('--all');
+      if (!disableEnsureBackend) modeArgs.push('--ensure-backend');
+    } else {
+      console.error(`❌ 未知 deps 子命令: ${sub}`);
+      printDepsHelp();
+      process.exit(2);
+    }
+    const forwarded = passthrough.filter((item) => item !== '--no-ensure-backend');
+    await run(process.execPath, [script, ...modeArgs, ...forwarded]);
+    return;
+  }
+
   if (cmd === 'xhs') {
     if (!sub || sub === 'help') {
       printXhsHelp();

package/dist/modules/camo-backend/src/index.js

@@ -270,9 +270,29 @@ async function handleCommand(payload, manager, wsServer, options = {}) {
                 ...(args.ownerPid ? { ownerPid: args.ownerPid } : {}),
             };
             const res = await manager.createSession(opts);
+            const session = manager.getSession(opts.profileId);
+            if (!session) {
+                throw new Error(`session for profile ${opts.profileId} not started`);
+            }
+            let recording = null;
+            if (args.record === true || args.recording === true) {
+                recording = await session.startRecording({
+                    name: args.recordName || args.recordingName,
+                    outputPath: args.recordOutput || args.recordingOutput || args.recordOutputPath,
+                    overlay: typeof args.recordOverlay === 'boolean' ? args.recordOverlay : undefined,
+                });
+            }
             options.onSessionStart?.();
             broadcast('browser:started', { profileId: opts.profileId, sessionId: res.sessionId });
-            return { ok: true, body: { ok: true, sessionId: res.sessionId, profileId: opts.profileId } };
+            return {
+                ok: true,
+                body: {
+                    ok: true,
+                    sessionId: res.sessionId,
+                    profileId: opts.profileId,
+                    ...(recording ? { recording } : {}),
+                },
+            };
         }
         case 'goto': {
             const profileId = args.profileId || 'default';
@@ -324,6 +344,34 @@ async function handleCommand(payload, manager, wsServer, options = {}) {
         case 'getStatus': {
             return { ok: true, body: { ok: true, sessions: manager.listSessions() } };
         }
+        case 'record:start': {
+            const profileId = args.profileId || 'default';
+            const session = manager.getSession(profileId);
+            if (!session)
+                throw new Error(`session for profile ${profileId} not started`);
+            const recording = await session.startRecording({
+                name: args.name || args.recordName,
+                outputPath: args.outputPath || args.output || args.recordOutput,
+                overlay: typeof args.overlay === 'boolean' ? args.overlay : undefined,
+            });
+            return { ok: true, body: { ok: true, profileId, recording } };
+        }
+        case 'record:stop': {
+            const profileId = args.profileId || 'default';
+            const session = manager.getSession(profileId);
+            if (!session)
+                throw new Error(`session for profile ${profileId} not started`);
+            const recording = await session.stopRecording({ reason: String(args.reason || 'manual') });
+            return { ok: true, body: { ok: true, profileId, recording } };
+        }
+        case 'record:status': {
+            const profileId = args.profileId || 'default';
+            const session = manager.getSession(profileId);
+            if (!session)
+                throw new Error(`session for profile ${profileId} not started`);
+            const recording = session.getRecordingStatus();
+            return { ok: true, body: { ok: true, profileId, recording } };
+        }
         case 'system:display': {
             const metrics = getDisplayMetrics();
             return { ok: true, body: { ok: true, metrics: metrics || null } };