browser-opt 1.0.1

package/dist/cli/commands/browser-opt.js

@@ -0,0 +1,514 @@
+/**
+ * 承载 browser-opt 即时执行、Workflow 管理子命令的参数解析与执行编排。
+ * 文件只协调 CLI 交互，存储、匹配和浏览器执行分别交由对应领域模块处理。
+ */
+import { BrowserOptRunner, browserOptTemplate, extractBrowserOptUrl, } from '../../browser-opt/runner/index.js';
+import { createHash, randomUUID } from 'node:crypto';
+import { spawn } from 'node:child_process';
+import { findBrowserOptWorkflowById, loadBrowserOptWorkflows, matchBrowserOptWorkflows, renderBrowserOptWorkflowFlow, resolveBrowserOptWorkflowDir, saveBrowserOptWorkflow, } from '../../browser-opt/workflow/index.js';
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import * as readline from 'node:readline';
+import { getBooleanFlag, getStringFlag, parseCliArgs, resolveLiveViewport, resolveProfile, resolveStatePath, } from '../utils/args.js';
+import { BROWSER_OPT_USAGE, HANDOFF_DONE_ANSWERS, LIVE_VIEWPORT_DASHBOARD_URL } from '../utils/constants.js';
+import { printBrowserOptResult } from '../utils/output.js';
+import { setupBrowserOpt } from './setup.js';
+const BROWSER_OPT_EXIT_CODE_FAILURE = 1;
+const BROWSER_OPT_EXIT_CODE_HANDOFF = 2;
+const BROWSER_OPT_EXIT_CODE_AMBIGUOUS = 3;
+const BROWSER_OPT_EXIT_CODE_NOT_FOUND = 4;
+const DEFAULT_BROWSER_PROFILE = 'Default';
+const DEFAULT_AUTH_STATE_DIR = '.browser-opt/states';
+const DEFAULT_HANDOFF_RUN_DIR = '.browser-opt/handoffs';
+const HANDOFF_SIGNAL_POLL_INTERVAL_MS = 250;
+export async function cmdBrowserOpt(args) {
+    const parsed = parseCliArgs(args);
+    const [subcommand] = parsed.positionals;
+    const positionalText = parsed.positionals.join(' ').trim();
+    const isImmediateFlow = Boolean(extractBrowserOptUrl(positionalText));
+    if (subcommand === 'setup' && !isImmediateFlow) {
+        setupBrowserOpt({
+            installSystemDependencies: getBooleanFlag(parsed.flags, 'with-deps'),
+            installSkill: !getBooleanFlag(parsed.flags, 'skip-skill'),
+            agent: getStringFlag(parsed.flags, 'agent'),
+            skillsDir: getStringFlag(parsed.flags, 'skills-dir'),
+        });
+        return;
+    }
+    if (subcommand === 'save' && (!isImmediateFlow || getStringFlag(parsed.flags, 'flow'))) {
+        saveWorkflowCommand(parsed.positionals.slice(1).join(' '), parsed.flags);
+        return;
+    }
+    if (subcommand === 'list' && !isImmediateFlow) {
+        listWorkflowCommand(parsed.flags);
+        return;
+    }
+    if (subcommand === 'match' && !isImmediateFlow) {
+        matchWorkflowCommand(parsed.positionals.slice(1).join(' '), parsed.flags);
+        return;
+    }
+    if (subcommand === 'run' && (!isImmediateFlow || getStringFlag(parsed.flags, 'workflow-id'))) {
+        await runWorkflowCommand(parsed.positionals.slice(1).join(' '), parsed.flags);
+        return;
+    }
+    if (subcommand === 'start' && !isImmediateFlow) {
+        startWorkflowCommand(parsed.positionals.slice(1).join(' '), parsed.flags);
+        return;
+    }
+    if (subcommand === 'status' && !isImmediateFlow) {
+        statusWorkflowCommand(parsed.flags);
+        return;
+    }
+    if (subcommand === 'resume' && !isImmediateFlow) {
+        resumeWorkflowCommand(parsed.flags);
+        return;
+    }
+    const text = positionalText;
+    if (!text) {
+        console.log(`${BROWSER_OPT_USAGE}\n\n${browserOptTemplate()}`);
+        process.exit(BROWSER_OPT_EXIT_CODE_FAILURE);
+    }
+    await executeBrowserOptFlow(text, parsed.flags);
+}
+/** 统一执行即时或已保存流程，确保两条入口共享登录态、浏览器和报告参数。 */
+async function executeBrowserOptFlow(text, flags, identity) {
+    const liveViewport = resolveLiveViewport(flags);
+    const requestedProfile = resolveProfile(flags) ?? DEFAULT_BROWSER_PROFILE;
+    const authState = resolveBrowserOptAuthState(flags, requestedProfile);
+    const outputDir = getStringFlag(flags, 'output-dir');
+    const useAgentChat = getBooleanFlag(flags, 'agent-chat');
+    const handoffSignalPath = getStringFlag(flags, 'handoff-signal');
+    const runner = new BrowserOptRunner();
+    const runnerOptions = {
+        sessionId: resolveBrowserOptSessionId(flags, identity ?? text),
+        profile: authState.profile,
+        statePath: authState.statePath,
+        authStateSavePath: authState.authStateSavePath,
+        authStateFallbackProfile: authState.fallbackProfile,
+        liveViewport,
+        outputDir,
+        useAgentChat,
+        handoff: createBrowserOptHandoffOptions(liveViewport, handoffSignalPath),
+    };
+    const result = await runner.run(text, runnerOptions);
+    printBrowserOptResult(result);
+    if (result.passed) {
+        process.exit(0);
+    }
+    process.exit(result.report.handoffTriggered ? BROWSER_OPT_EXIT_CODE_HANDOFF : BROWSER_OPT_EXIT_CODE_FAILURE);
+}
+/** 保存完整自然语言流程；默认拒绝覆盖已有同名 Workflow。 */
+function saveWorkflowCommand(name, flags) {
+    const flow = getStringFlag(flags, 'flow');
+    if (!name.trim() || !flow?.trim()) {
+        console.error('使用方式：npx browser-opt save "<名称>" --flow "<完整自然语言流程>" [--workflow-dir <目录>] [--force]');
+        process.exit(BROWSER_OPT_EXIT_CODE_FAILURE);
+    }
+    const result = saveBrowserOptWorkflow({
+        name,
+        flow,
+        workflowDir: getStringFlag(flags, 'workflow-dir'),
+        force: getBooleanFlag(flags, 'force'),
+    });
+    console.log(`${result.created ? '已保存' : '已更新'} Workflow：${result.workflow.name}`);
+    console.log(`文件：${result.filePath}`);
+}
+/** 列出项目目录第一层的有效 Workflow，JSON 模式供 Skill 和脚本稳定解析。 */
+function listWorkflowCommand(flags) {
+    const workflowDir = getStringFlag(flags, 'workflow-dir');
+    const loaded = loadBrowserOptWorkflows(workflowDir);
+    printWorkflowWarnings(loaded.warnings);
+    if (getBooleanFlag(flags, 'json')) {
+        console.log(JSON.stringify({
+            workflowDir: resolveBrowserOptWorkflowDir(workflowDir),
+            workflows: loaded.workflows,
+            warnings: loaded.warnings,
+        }, null, 2));
+        return;
+    }
+    if (loaded.workflows.length === 0) {
+        console.log(`未找到已保存的 Workflow：${resolveBrowserOptWorkflowDir(workflowDir)}`);
+        return;
+    }
+    console.log(`已保存的 Workflow（${resolveBrowserOptWorkflowDir(workflowDir)}）：`);
+    for (const workflow of loaded.workflows) {
+        console.log(`  - ${workflow.name} [${workflow.id}]`);
+    }
+}
+/** 输出查询解析结果；该命令本身不启动浏览器，供 Skill 决定是否需要用户选择。 */
+function matchWorkflowCommand(query, flags) {
+    if (!query.trim()) {
+        console.error('使用方式：npx browser-opt match "<查询语句>" [--workflow-dir <目录>] [--json]');
+        process.exit(BROWSER_OPT_EXIT_CODE_FAILURE);
+    }
+    const loaded = loadBrowserOptWorkflows(getStringFlag(flags, 'workflow-dir'));
+    const result = matchBrowserOptWorkflows(query, loaded.workflows);
+    printWorkflowWarnings(loaded.warnings);
+    if (getBooleanFlag(flags, 'json')) {
+        console.log(JSON.stringify(toWorkflowMatchOutput(result, loaded.warnings), null, 2));
+        return;
+    }
+    printWorkflowMatch(result);
+}
+/** 先解析查询或指定 ID，只有结果唯一时才进入现有 BrowserOptRunner。 */
+async function runWorkflowCommand(query, flags) {
+    const loaded = loadBrowserOptWorkflows(getStringFlag(flags, 'workflow-dir'));
+    printWorkflowWarnings(loaded.warnings);
+    const workflowId = getStringFlag(flags, 'workflow-id');
+    if (workflowId) {
+        const workflow = findBrowserOptWorkflowById(workflowId, loaded.workflows);
+        if (!workflow) {
+            console.error(`未找到 Workflow ID：${workflowId}`);
+            printAvailableWorkflows(loaded.workflows);
+            process.exit(BROWSER_OPT_EXIT_CODE_NOT_FOUND);
+        }
+        await executeBrowserOptFlow(renderBrowserOptWorkflowFlow(workflow), flags, workflow.id);
+        return;
+    }
+    if (!query.trim()) {
+        console.error('使用方式：npx browser-opt run "<查询语句>" [--workflow-dir <目录>]');
+        process.exit(BROWSER_OPT_EXIT_CODE_FAILURE);
+    }
+    const result = matchBrowserOptWorkflows(query, loaded.workflows);
+    if (result.status === 'ambiguous') {
+        printWorkflowMatch(result);
+        process.exit(BROWSER_OPT_EXIT_CODE_AMBIGUOUS);
+    }
+    if (result.status === 'not-found' || !result.matched) {
+        printWorkflowMatch(result);
+        process.exit(BROWSER_OPT_EXIT_CODE_NOT_FOUND);
+    }
+    await executeBrowserOptFlow(renderBrowserOptWorkflowFlow(result.matched.workflow), flags, result.matched.workflow.id);
+}
+/** 后台启动可跨 Codex turn 恢复的 Workflow，handoff 期间不依赖临时 PTY 会话。 */
+function startWorkflowCommand(query, flags) {
+    const loaded = loadBrowserOptWorkflows(getStringFlag(flags, 'workflow-dir'));
+    printWorkflowWarnings(loaded.warnings);
+    const workflow = resolveWorkflowForExecution(query, flags, loaded.workflows);
+    const runId = randomUUID();
+    const runDir = path.resolve(process.cwd(), DEFAULT_HANDOFF_RUN_DIR, runId);
+    const signalPath = path.join(runDir, 'resume.signal');
+    const outputPath = path.join(runDir, 'output.log');
+    const metadataPath = path.join(runDir, 'run.json');
+    fs.mkdirSync(runDir, { recursive: true });
+    const outputFd = fs.openSync(outputPath, 'a');
+    const child = spawn(process.execPath, buildDetachedWorkflowArgs(workflow.id, signalPath, flags), {
+        detached: true,
+        stdio: ['ignore', outputFd, outputFd],
+        env: {
+            ...process.env,
+            BROWSER_OPT_HANDOFF_RUN_ID: runId,
+        },
+    });
+    fs.closeSync(outputFd);
+    if (!child.pid) {
+        throw new Error('无法启动后台 browser-opt Workflow。');
+    }
+    child.unref();
+    const metadata = {
+        runId,
+        pid: child.pid,
+        workflowId: workflow.id,
+        signalPath,
+        outputPath,
+        startedAt: new Date().toISOString(),
+    };
+    fs.writeFileSync(metadataPath, JSON.stringify(metadata, null, 2));
+    printDetachedRun(metadata, 'RUNNING', getBooleanFlag(flags, 'json'));
+}
+/** 查询后台 Workflow 的稳定状态，并返回最近输出供 Skill 识别 handoff 与最终报告。 */
+function statusWorkflowCommand(flags) {
+    const metadata = loadDetachedRun(flags);
+    const output = readDetachedRunOutput(metadata.outputPath);
+    const status = resolveDetachedRunStatus(metadata.pid, output);
+    printDetachedRun(metadata, status, getBooleanFlag(flags, 'json'), output);
+}
+/** 向后台 Workflow 写入一次性恢复信号，原 runner 会在同一浏览器实例中继续。 */
+function resumeWorkflowCommand(flags) {
+    const metadata = loadDetachedRun(flags);
+    fs.mkdirSync(path.dirname(metadata.signalPath), { recursive: true });
+    fs.writeFileSync(metadata.signalPath, 'done\n');
+    if (getBooleanFlag(flags, 'json')) {
+        console.log(JSON.stringify({ status: 'RESUME_REQUESTED', ...metadata }, null, 2));
+        return;
+    }
+    console.log(`已发送恢复信号：${metadata.runId}`);
+}
+/** start 与 run 共用 Workflow 唯一匹配规则，避免后台入口选择不同的流程。 */
+function resolveWorkflowForExecution(query, flags, workflows) {
+    const workflowId = getStringFlag(flags, 'workflow-id');
+    if (workflowId) {
+        const workflow = findBrowserOptWorkflowById(workflowId, workflows);
+        if (workflow) {
+            return workflow;
+        }
+        throw new Error(`未找到 Workflow ID：${workflowId}`);
+    }
+    if (!query.trim()) {
+        throw new Error('使用方式：npx browser-opt start "<查询语句>" [--workflow-dir <目录>]');
+    }
+    const result = matchBrowserOptWorkflows(query, workflows);
+    if (result.status !== 'matched' || !result.matched) {
+        throw new Error(result.status === 'ambiguous' ? 'Workflow 匹配结果不唯一，请使用 --workflow-id。' : '未找到匹配的 Workflow。');
+    }
+    return result.matched.workflow;
+}
+/** 复用当前 Node/tsx 入口启动子进程，并只透传会影响 Workflow 执行的参数。 */
+function buildDetachedWorkflowArgs(workflowId, signalPath, flags) {
+    const executableName = path.basename(process.argv[1] ?? '');
+    const commandPrefix = executableName.startsWith('browser-opt') ? [] : ['browser-opt'];
+    const childArgs = [
+        ...process.execArgv,
+        process.argv[1] ?? '',
+        ...commandPrefix,
+        'run',
+        '--workflow-id',
+        workflowId,
+        '--handoff-signal',
+        signalPath,
+    ];
+    const excludedFlags = new Set(['workflow-id', 'json', 'run-id', 'handoff-signal']);
+    for (const [key, value] of Object.entries(flags)) {
+        if (excludedFlags.has(key)) {
+            continue;
+        }
+        childArgs.push(`--${key}`);
+        if (typeof value === 'string') {
+            childArgs.push(value);
+        }
+    }
+    return childArgs;
+}
+/** 从固定控制目录读取后台任务元数据，runId 是跨 turn 的唯一恢复凭据。 */
+function loadDetachedRun(flags) {
+    const runId = getStringFlag(flags, 'run-id')?.trim();
+    if (!runId) {
+        throw new Error('缺少 --run-id。');
+    }
+    const metadataPath = path.resolve(process.cwd(), DEFAULT_HANDOFF_RUN_DIR, runId, 'run.json');
+    const parsed = JSON.parse(fs.readFileSync(metadataPath, 'utf-8'));
+    if (parsed.runId !== runId) {
+        throw new Error(`后台 Workflow 元数据与 runId 不一致：${runId}`);
+    }
+    return parsed;
+}
+/** 后台输出只返回尾部，既保留最新 handoff/报告信息，也避免历史日志无限增长。 */
+function readDetachedRunOutput(outputPath) {
+    if (!fs.existsSync(outputPath)) {
+        return '';
+    }
+    return fs.readFileSync(outputPath, 'utf-8').slice(-12_000);
+}
+/** 结合进程存活状态与 CLI 输出判断当前阶段。 */
+function resolveDetachedRunStatus(pid, output) {
+    if (isProcessRunning(pid)) {
+        const handoffIndex = output.lastIndexOf('=== Browser Opt Handoff ===');
+        const resumedIndex = output.lastIndexOf('人工操作完成，恢复 browser-opt 自动化执行。');
+        return handoffIndex > resumedIndex ? 'HANDOFF' : 'RUNNING';
+    }
+    return output.includes('执行成功') ? 'PASS' : 'FAIL';
+}
+/** 只探测后台进程是否仍存在，不发送信号或改变运行状态。 */
+function isProcessRunning(pid) {
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/** 人类输出与 JSON 输出共享同一组后台任务字段。 */
+function printDetachedRun(metadata, status, json, output = '') {
+    if (json) {
+        console.log(JSON.stringify({ status, ...metadata, output }, null, 2));
+        return;
+    }
+    console.log(`Status: ${status}`);
+    console.log(`Run ID: ${metadata.runId}`);
+    console.log(`Output: ${metadata.outputPath}`);
+    if (output.trim()) {
+        console.log(output.trim());
+    }
+}
+/** JSON 输出收敛为候选元数据，避免匹配阶段把完整自动化正文回显给调用方。 */
+function toWorkflowMatchOutput(result, warnings) {
+    const compact = (workflow, score) => ({
+        id: workflow.id,
+        name: workflow.name,
+        ...(workflow.filePath ? { filePath: workflow.filePath } : {}),
+        ...(workflow.filePath ? { displayPath: formatWorkflowDisplayPath(workflow.filePath) } : {}),
+        ...(score === undefined ? {} : { score }),
+    });
+    return {
+        status: result.status,
+        matched: result.matched ? compact(result.matched.workflow, result.matched.score) : null,
+        candidates: result.candidates.map((candidate) => compact(candidate.workflow, candidate.score)),
+        available: result.available.map((workflow) => compact(workflow)),
+        warnings,
+    };
+}
+/** 人类可读输出明确区分唯一命中、需要选择和完全未命中。 */
+function printWorkflowMatch(result) {
+    if (result.status === 'matched' && result.matched) {
+        console.log(`匹配到 Workflow：${result.matched.workflow.name} [${result.matched.workflow.id}]`);
+        return;
+    }
+    if (result.status === 'ambiguous') {
+        const label = result.candidates.length > 1 ? '找到多个相似 Workflow' : '找到相似 Workflow';
+        console.log(`${label}，请选择候选序号，或使用 --workflow-id 执行：`);
+        result.candidates.forEach((candidate, index) => {
+            console.log(`  ${index + 1}. ${formatWorkflowLink(candidate.workflow)} [${candidate.workflow.id}]`);
+        });
+        return;
+    }
+    console.log('未找到匹配的 Workflow，请补充描述或从可用流程中选择。');
+    printAvailableWorkflows(result.available);
+}
+function printAvailableWorkflows(workflows) {
+    if (workflows.length === 0) {
+        console.log('当前项目尚未保存 Workflow。');
+        return;
+    }
+    console.log('可用 Workflow：');
+    for (const workflow of workflows) {
+        console.log(`  - ${formatWorkflowLink(workflow)} [${workflow.id}]`);
+    }
+}
+function printWorkflowWarnings(warnings) {
+    for (const warning of warnings) {
+        console.error(`跳过无效 Workflow：${warning}`);
+    }
+}
+/** 在支持 Markdown 的界面里把候选流程渲染为可点击文件链接，终端里仍保留可读名称。 */
+function formatWorkflowLink(workflow) {
+    if (!workflow.filePath) {
+        return workflow.name;
+    }
+    return `[${escapeMarkdownLinkText(workflow.name)}](<${workflow.filePath}>)`;
+}
+function escapeMarkdownLinkText(text) {
+    return text.replace(/([\\\[\]])/g, '\\$1');
+}
+/** 优先给调用方返回工作区相对路径，便于 VS Code/Copilot 识别为本地文件引用。 */
+function formatWorkflowDisplayPath(filePath) {
+    const relativePath = path.relative(process.cwd(), filePath);
+    if (relativePath && !relativePath.startsWith('..') && !path.isAbsolute(relativePath)) {
+        return relativePath;
+    }
+    return filePath;
+}
+/**
+ * 登录态复用策略：
+ * 1. 默认 state 存在时优先加载，避免每次从完整 Chrome profile 启动。
+ * 2. 默认 state 不存在时由唯一主 agent 使用 profile 打开，并把 cookies/storage 保存成 state。
+ * 3. 默认 state 失效时切换到 profile 窗口，让交互式 handoff 可使用 Chrome 密码管理器。
+ * 4. 显式 --state 保持隔离语义，不自动回退到 profile。
+ */
+function resolveBrowserOptAuthState(flags, profile) {
+    const configuredStatePath = resolveStatePath(flags);
+    const authStateSavePath = configuredStatePath ?? defaultBrowserOptStatePath(profile);
+    if (fs.existsSync(authStateSavePath)) {
+        return {
+            statePath: authStateSavePath,
+            authStateSavePath,
+            fallbackProfile: configuredStatePath ? undefined : profile,
+        };
+    }
+    return {
+        profile,
+        authStateSavePath,
+    };
+}
+/** 默认 state 文件按 profile 分开保存，避免 Work/Default 等登录态互相覆盖。 */
+function defaultBrowserOptStatePath(profile) {
+    const stateDir = process.env.BROWSER_OPT_AUTH_STATE_DIR || path.resolve(process.cwd(), DEFAULT_AUTH_STATE_DIR);
+    const stateName = profile.toLowerCase().replace(/[^a-z0-9._-]+/g, '-').replace(/^-+|-+$/g, '') || 'default';
+    return path.join(stateDir, `browser-opt-${stateName}.json`);
+}
+/** 为同一项目里的同一流程生成稳定 session，便于不同入口一致标识浏览器会话。 */
+function resolveBrowserOptSessionId(flags, identity) {
+    const configuredSession = getStringFlag(flags, 'session')?.trim();
+    if (configuredSession) {
+        return configuredSession;
+    }
+    const seed = `${process.cwd()}\n${identity}`;
+    return `browser-opt-${createHash('sha256').update(seed).digest('hex').slice(0, 16)}`;
+}
+/** 读取终端输入，供 handoff 暂停点等待用户确认继续。 */
+function promptUser(question) {
+    const rl = readline.createInterface({
+        input: process.stdin,
+        output: process.stdout,
+    });
+    return new Promise((resolve) => {
+        rl.question(question, (answer) => {
+            rl.close();
+            resolve(answer.trim());
+        });
+    });
+}
+/** 判断用户是否已确认人工登录或处理动作完成。 */
+function isDoneAnswer(input) {
+    const value = input.trim().toLowerCase();
+    return HANDOFF_DONE_ANSWERS.includes(value);
+}
+/** browser-opt 默认等待终端输入；后台 Workflow 改用信号文件跨 turn 恢复同一个会话。 */
+function createBrowserOptHandoffOptions(liveViewport, handoffSignalPath) {
+    return {
+        onHandoffRequired: async (context) => {
+            console.log('\n=== Browser Opt Handoff ===');
+            console.log(`Reason: ${context.message}`);
+            if (context.sessionId) {
+                console.log(`Session: ${context.sessionId}`);
+            }
+            if (liveViewport) {
+                console.log(`Live viewport: ${LIVE_VIEWPORT_DASHBOARD_URL}`);
+            }
+            console.log('已打开可视浏览器，请手动完成页面要求的操作。');
+            if (handoffSignalPath) {
+                const runId = process.env.BROWSER_OPT_HANDOFF_RUN_ID;
+                console.log(`完成后请恢复后台任务${runId ? ` ${runId}` : ''}，自动化会继续复用当前浏览器。`);
+            }
+            else {
+                console.log('完成后请在这里输入 done（或 ok / 继续 / 完成）以恢复自动化。');
+            }
+            if (context.output.trim()) {
+                console.log(context.output.trim());
+            }
+        },
+        waitForUserResume: handoffSignalPath
+            ? () => waitForBrowserOptHandoffSignal(handoffSignalPath)
+            : waitForBrowserOptHandoffDone,
+        onHandoffCompleted: async () => {
+            console.log('人工操作完成，恢复 browser-opt 自动化执行。\n');
+        },
+    };
+}
+/** 循环等待明确完成信号，避免误触回车后过早恢复自动化。 */
+async function waitForBrowserOptHandoffDone() {
+    while (true) {
+        const answer = await promptUser('请输入 done 继续：\n> ');
+        if (isDoneAnswer(answer)) {
+            return;
+        }
+        console.log('未识别输入，请输入 done / ok / 继续 / 完成。');
+    }
+}
+/** 后台任务轮询一次性信号文件，消费后删除以支持同一 Workflow 多次 handoff。 */
+async function waitForBrowserOptHandoffSignal(signalPath) {
+    const resolvedSignalPath = path.resolve(signalPath);
+    fs.mkdirSync(path.dirname(resolvedSignalPath), { recursive: true });
+    fs.rmSync(resolvedSignalPath, { force: true });
+    while (true) {
+        if (fs.existsSync(resolvedSignalPath)) {
+            const answer = fs.readFileSync(resolvedSignalPath, 'utf-8');
+            if (isDoneAnswer(answer)) {
+                fs.rmSync(resolvedSignalPath, { force: true });
+                return;
+            }
+        }
+        await new Promise((resolve) => setTimeout(resolve, HANDOFF_SIGNAL_POLL_INTERVAL_MS));
+    }
+}
+//# sourceMappingURL=browser-opt.js.map

package/dist/cli/commands/browser-opt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-opt.js","sourceRoot":"","sources":["../../../src/cli/commands/browser-opt.ts"],"names":[],"mappings":"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"}

package/dist/cli/commands/setup.d.ts

@@ -0,0 +1,10 @@
+interface BrowserOptSetupOptions {
+    installSystemDependencies: boolean;
+    installSkill: boolean;
+    agent?: string;
+    skillsDir?: string;
+}
+/** 执行 agent-browser 安装，并在需要时把 browser-opt Skill 放到目标 Agent 的用户级目录。 */
+export declare function setupBrowserOpt(options: BrowserOptSetupOptions): void;
+export {};
+//# sourceMappingURL=setup.d.ts.map

package/dist/cli/commands/setup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/setup.ts"],"names":[],"mappings":"AAUA,UAAU,sBAAsB;IAC9B,yBAAyB,EAAE,OAAO,CAAC;IACnC,YAAY,EAAE,OAAO,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,sEAAsE;AACtE,wBAAgB,eAAe,CAAC,OAAO,EAAE,sBAAsB,GAAG,IAAI,CAmBrE"}

package/dist/cli/commands/setup.js

@@ -0,0 +1,35 @@
+/**
+ * 安装 browser-opt 运行所需的浏览器与 Agent Skill，使调用方只需执行一次 setup。
+ * 该命令只在用户显式调用时写入本机目录，不影响普通工作流执行。
+ */
+import { resolveSkillInstallTarget } from '@browser-automated/browser-core/skill-install';
+import { spawnSync } from 'node:child_process';
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { fileURLToPath } from 'node:url';
+/** 执行 agent-browser 安装，并在需要时把 browser-opt Skill 放到目标 Agent 的用户级目录。 */
+export function setupBrowserOpt(options) {
+    const installArgs = ['install', ...(options.installSystemDependencies ? ['--with-deps'] : [])];
+    const result = spawnSync('agent-browser', installArgs, { stdio: 'inherit' });
+    if (result.error) {
+        throw new Error(`无法启动 agent-browser：${result.error.message}`);
+    }
+    if (result.status !== 0) {
+        throw new Error(`agent-browser install 失败（退出码 ${result.status ?? 'unknown'}）。`);
+    }
+    if (options.installSkill) {
+        const { label, targetDir } = resolveSkillInstallTarget('browser-opt', {
+            agent: options.agent,
+            skillsDir: options.skillsDir,
+        });
+        fs.cpSync(resolveBundledSkillDir(), targetDir, { recursive: true, force: true });
+        console.log(`已安装 ${label}：${targetDir}`);
+    }
+    console.log('browser-opt 已就绪。');
+}
+/** 从编译后的 CLI 位置反查 npm 包内随包发布的 browser-opt Skill。 */
+function resolveBundledSkillDir() {
+    const commandDir = path.dirname(fileURLToPath(import.meta.url));
+    return path.resolve(commandDir, '../../../skills/browser-opt');
+}
+//# sourceMappingURL=setup.js.map

package/dist/cli/commands/setup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup.js","sourceRoot":"","sources":["../../../src/cli/commands/setup.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,yBAAyB,EAAE,MAAM,+CAA+C,CAAC;AAC1F,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC/C,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AASzC,sEAAsE;AACtE,MAAM,UAAU,eAAe,CAAC,OAA+B;IAC7D,MAAM,WAAW,GAAG,CAAC,SAAS,EAAE,GAAG,CAAC,OAAO,CAAC,yBAAyB,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAC/F,MAAM,MAAM,GAAG,SAAS,CAAC,eAAe,EAAE,WAAW,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC;IAC7E,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;QACjB,MAAM,IAAI,KAAK,CAAC,sBAAsB,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;IAChE,CAAC;IACD,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxB,MAAM,IAAI,KAAK,CAAC,gCAAgC,MAAM,CAAC,MAAM,IAAI,SAAS,IAAI,CAAC,CAAC;IAClF,CAAC;IAED,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;QACzB,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,yBAAyB,CAAC,aAAa,EAAE;YACpE,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,SAAS,EAAE,OAAO,CAAC,SAAS;SAC7B,CAAC,CAAC;QACH,EAAE,CAAC,MAAM,CAAC,sBAAsB,EAAE,EAAE,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QACjF,OAAO,CAAC,GAAG,CAAC,OAAO,KAAK,IAAI,SAAS,EAAE,CAAC,CAAC;IAC3C,CAAC;IACD,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC;AAClC,CAAC;AAED,oDAAoD;AACpD,SAAS,sBAAsB;IAC7B,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IAChE,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,6BAA6B,CAAC,CAAC;AACjE,CAAC"}

package/dist/cli/utils/args.d.ts

@@ -0,0 +1,17 @@
+/**
+ * 统一封装 CLI 参数解析与常用 flag 读取逻辑，避免各命令重复处理细节。
+ * 这里仅负责轻量解析，不引入命令语义，让命令文件保持聚焦在业务流程上。
+ */
+export interface CliParseResult {
+    positionals: string[];
+    flags: Record<string, string | boolean>;
+}
+export declare function parseCliArgs(args: string[]): CliParseResult;
+export declare function getStringFlag(flags: Record<string, string | boolean>, key: string): string | undefined;
+export declare function getBooleanFlag(flags: Record<string, string | boolean>, key: string): boolean;
+export declare function resolveProfile(flags: Record<string, string | boolean>): string | undefined;
+export declare function resolveStatePath(flags: Record<string, string | boolean>): string | undefined;
+export declare function resolveReuseRunningBrowser(flags: Record<string, string | boolean>, statePath?: string, defaultValue?: boolean): boolean;
+export declare function resolveLiveViewport(flags: Record<string, string | boolean>): boolean;
+export declare function parseCsv(value?: string): string[];
+//# sourceMappingURL=args.d.ts.map

package/dist/cli/utils/args.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"args.d.ts","sourceRoot":"","sources":["../../../src/cli/utils/args.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,cAAc;IAC7B,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC;CACzC;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,cAAc,CAsB3D;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAGtG;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAE5F;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,MAAM,GAAG,SAAS,CAE1F;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,MAAM,GAAG,SAAS,CAQ5F;AAED,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,EACvC,SAAS,CAAC,EAAE,MAAM,EAClB,YAAY,UAAQ,GACnB,OAAO,CAWT;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,OAAO,CAQpF;AAED,wBAAgB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CASjD"}