@qing3a/flow-rpa-engine 0.1.0

package/dist/export.js

@@ -0,0 +1,234 @@
+import { mkdirSync, readFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { writeJsonAtomic } from './atomic.js';
+import { maskKeywordInText, maskKeywords, maskInputValue, maskUrl, PLACEHOLDER_COMPANY, PLACEHOLDER_KEYWORD, PLACEHOLDER_PERSON, PLACEHOLDER_JOB, } from './mask.js';
+import { nowIso, RunStore } from './storage.js';
+/**
+ * 脱敏导出 + 观察包 + 本地模拟平台（移植自 Rust `export.rs` + A2 失败类型学 + D-N 编号元素）。
+ *
+ * 双通道（ARCHITECTURE #6）：
+ *   - **统计通道**（对外默认契约）：聚合指标（成功率/选择器命中率/关键词精准率），
+ *     绝无单条明细；最小样本门槛（<5 不上传）；标识符清洗（<company>/<keyword>/<person>/<job>）。
+ *   - **观察通道**（开发期默认全开）：run.json + DOM 快照 + manifest。
+ *
+ * A2 失败类型学（EXECUTION-SPEC 第五节）：公共失败分类 7 类 ——
+ * redirect / verify / selector_miss / timeout / network / parse / unknown。
+ * `classifyError` 是统计通道 failure_modes 与 L2 学习信号的公共分类；executor 错误产生处
+ * 标注 category（D-F3），本模块的 classifyError 按 D-F2 映射表兜底分类（错误文案级）。
+ *
+ * D-N 编号元素（EXECUTION-SPEC 第六节）：DomSnapshot 含 textSummary + elements（el#N）。
+ * 真实浏览器模式 run 后自动 snapshot_dom（D-N1），export_observation 优先用快照（D-N2）。
+ */
+// mask.ts 复用 re-export（MIGRATION-NODE：export.ts 复用 Masker）
+export { maskInputValue, maskKeywordInText, maskKeywords, maskUrl, PLACEHOLDER_COMPANY, PLACEHOLDER_KEYWORD, PLACEHOLDER_PERSON, PLACEHOLDER_JOB };
+/** 最小样本门槛：样本 < 此值不上传（与 L2 成熟度门槛 <5 同构） */
+export const MIN_SAMPLE_THRESHOLD = 5;
+/** 引擎版本（manifest 用；迁移期标注 TS 版） */
+export const ENGINE_VERSION = '0.1.0-ts';
+export const FAILURE_CATEGORIES = [
+    'redirect',
+    'verify',
+    'selector_miss',
+    'timeout',
+    'network',
+    'parse',
+    'unknown',
+];
+/**
+ * 失败分类（D-F2 映射表）：错误 → 类别。
+ * - 错误对象带 category（executor 标注）→ 直接用（优先）
+ * - 否则按错误消息关键词映射：
+ *   含「超时」/ timeout → timeout
+ *   含「选择器未命中」「点击目标不存在」「等待选择器…超时」（选择器层）→ selector_miss
+ *   网络/连接/econn → network
+ *   解析/parse/json → parse
+ *   登录态/重定向/未登录 → redirect
+ *   含「验证失败」/ 页面文本不含 → verify
+ *   其他 → unknown
+ */
+export function classifyError(e) {
+    // 错误对象带 category（executor 标注，D-F3）
+    if (e && typeof e === 'object' && 'category' in e) {
+        const c = e.category;
+        if (typeof c === 'string' && FAILURE_CATEGORIES.includes(c)) {
+            return c;
+        }
+    }
+    const msg = e instanceof Error ? e.message : String(e);
+    const m = msg.toLowerCase();
+    if (m.includes('超时') || m.includes('timeout'))
+        return 'timeout';
+    if (m.includes('选择器未命中') || m.includes('点击目标不存在') || m.includes('等待选择器'))
+        return 'selector_miss';
+    if (m.includes('econn') || m.includes('网络') || m.includes('连接'))
+        return 'network';
+    if (m.includes('解析') || m.includes('parse') || m.includes('json'))
+        return 'parse';
+    if (m.includes('重定向') || m.includes('未登录') || m.includes('登录'))
+        return 'redirect';
+    if (m.includes('验证失败') || m.includes('页面文本不含') || m.includes('变量缺失'))
+        return 'verify';
+    return 'unknown';
+}
+/**
+ * 聚合执行记录。records 为空返回 undefined（无样本）。
+ * 失败类别用 A2 classifyError（替代 Rust 私有 categorize_error；公共分类）。
+ */
+export function buildStats(records) {
+    if (records.length === 0)
+        return undefined;
+    const sampleCount = records.length;
+    const done = records.filter((r) => r.status === 'done').length;
+    const successRate = done / sampleCount;
+    // 选择器命中率：verify wait_selector 通过的占比
+    let selTotal = 0;
+    let selHit = 0;
+    // 关键词精准率：input 步骤 textContains 通过的占比
+    let kwTotal = 0;
+    let kwHit = 0;
+    let totalDuration = 0;
+    const failureMap = new Map();
+    for (const rec of records) {
+        totalDuration += rec.steps.reduce((a, s) => a + s.durationMs, 0);
+        for (const step of rec.steps) {
+            if (step.verify) {
+                if (step.verify.waitSelector !== undefined) {
+                    selTotal++;
+                    if (step.verify.passed)
+                        selHit++;
+                }
+                if (step.error) {
+                    if (step.error.includes('页面文本不含') || step.error.includes('变量缺失')) {
+                        kwTotal++;
+                        if (!step.error.includes('不含'))
+                            kwHit++;
+                    }
+                }
+            }
+            if (step.status === 'failed') {
+                const err = step.error ?? '';
+                const cat = classifyError(err);
+                const vtype = step.verify
+                    ? step.verify.waitSelector !== undefined
+                        ? 'wait_selector'
+                        : 'other'
+                    : 'none';
+                const key = `${step.type ?? ''}|${vtype}|${cat}`;
+                failureMap.set(key, (failureMap.get(key) ?? 0) + 1);
+            }
+        }
+    }
+    // 失败模式按出现次数降序
+    const modes = [...failureMap.entries()]
+        .map(([key, count]) => {
+        const [stepType, verifyType, errorCategory] = key.split('|');
+        return { stepType: stepType ?? '', verifyType: verifyType ?? '', errorCategory: errorCategory ?? '', count };
+    })
+        .sort((a, b) => b.count - a.count);
+    return {
+        sampleCount,
+        successRate,
+        selectorHitRate: selTotal > 0 ? selHit / selTotal : 0,
+        keywordPrecisionRate: kwTotal > 0 ? kwHit / kwTotal : 0,
+        avgDurationMs: Math.floor(totalDuration / sampleCount),
+        failureModes: modes,
+    };
+}
+/** 摘要长度（前后各保留字符数） */
+const SUMMARY_CAP = 300;
+/** 生成文本快照摘要（脱敏：截断） */
+export function textSummary(text) {
+    const clean = text.split(/\s+/).filter(Boolean).join(' ');
+    if (clean.length <= SUMMARY_CAP)
+        return clean;
+    const half = Math.floor(SUMMARY_CAP / 2);
+    const head = clean.slice(0, half);
+    const tail = clean.slice(clean.length - half);
+    return `${head} … ${tail}`;
+}
+/** 生成编号元素（交互元素按文档序编号；文本截断 ≤40 字符） */
+export function snapshotFromWeb(text, rawElements) {
+    const elements = rawElements.map(([tag, t], i) => ({
+        index: i + 1,
+        tag,
+        text: [...t].slice(0, 40).join(''),
+    }));
+    return { textSummary: textSummary(text), elements, capturedAt: nowIso() };
+}
+/** 从纯文本生成快照（无编号元素；mock 页面用） */
+export function snapshotFromText(text) {
+    return snapshotFromWeb(text, []);
+}
+/** 极简哈希（FNV-1a 64 位，与 Rust simple_hash 同算法，UTF-8 字节）：用于 source_hash */
+export function simpleHash(s) {
+    let h = 0xcbf29ce484222325n;
+    for (const b of Buffer.from(s, 'utf8')) {
+        h ^= BigInt(b);
+        h = (h * 0x100000001b3n) & 0xffffffffffffffffn;
+    }
+    return h.toString(16).padStart(16, '0');
+}
+/** 从一次执行构建观察报告包（run + 可选 DOM 快照 + 统计通道聚合）。 */
+export function buildObservation(rec, allRuns, domText, domSnapshot) {
+    const stats = buildStats(allRuns);
+    const snapshot = domSnapshot ?? snapshotFromText(domText ?? '');
+    const sourceHash = simpleHash(`${rec.flowId}:${rec.startedAt}`);
+    return {
+        flowId: rec.flowId,
+        flowVersion: rec.flowVersion,
+        runId: rec.runId,
+        stats: stats && stats.sampleCount >= MIN_SAMPLE_THRESHOLD ? stats : undefined,
+        domSnapshot: snapshot,
+        run: rec,
+        manifest: {
+            engineVersion: ENGINE_VERSION,
+            flowVersion: rec.flowVersion,
+            sourceHash,
+            createdAt: nowIso(),
+        },
+    };
+}
+// ---- 本地模拟平台 ----
+/** 本地模拟平台：把观察报告包落盘到 outbox 目录，并维护上传台账状态机。 */
+export class LocalPlatform {
+    root;
+    store;
+    constructor(root) {
+        this.root = root;
+        mkdirSync(join(root, 'outbox'), { recursive: true });
+        this.store = new RunStore(root);
+    }
+    /** 观察包目录：observations/<flow_id>_v<version>_<run_id>/ */
+    obsDir(flowId, version, runId) {
+        return join(this.root, 'outbox', `${flowId}_v${version}_${runId}`);
+    }
+    /**
+     * 组装并「上传」观察包（本地模拟平台）：先落盘 run（登记台账 Pending），
+     * 再落包 + 标记 Uploaded。allRuns 为流程历史记录（统计通道聚合），
+     * domText 为页面文本快照，domSnapshot 为已采集快照（D-N2 优先用）。
+     * 返回包目录路径。
+     */
+    deliver(rec, allRuns, domText, domSnapshot) {
+        this.store.saveRun(rec);
+        const bundle = buildObservation(rec, allRuns, domText, domSnapshot);
+        const dir = this.obsDir(rec.flowId, rec.flowVersion, rec.runId);
+        mkdirSync(dir, { recursive: true });
+        // 对齐 md-forge 观察包契约：manifest.json / run.json / dom_snapshot.json 必选
+        writeJsonAtomic(join(dir, 'stats.json'), bundle.stats ?? null);
+        writeJsonAtomic(join(dir, 'manifest.json'), bundle.manifest);
+        writeJsonAtomic(join(dir, 'run.json'), bundle.run);
+        writeJsonAtomic(join(dir, 'dom_snapshot.json'), bundle.domSnapshot);
+        // 台账：标记已上传（本地模拟平台「上传成功」）
+        this.store.markUploaded(rec.runId, true);
+        return dir;
+    }
+    /** 待上传 run_id（台账 Pending/Failed，断网重试入口） */
+    pending() {
+        return this.store.pendingUploads();
+    }
+    /** 台账状态查询（诊断用） */
+    ledgerState(runId) {
+        return this.store.loadLedger().entries.find((e) => e.runId === runId)?.state;
+    }
+}
+//# sourceMappingURL=export.js.map

package/dist/export.js.map

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

package/dist/gate.d.ts

@@ -0,0 +1,56 @@
+/**
+ * 冷却 + 同站闸门 —— 防封铁律代码化（移植自 Rust `gate.rs`）。
+ * 两层：
+ *   - **任务内冷却（30~60s）**：`CooldownGate` 持久化最近冷却锚点（cool-ledger.json）。
+ *     key = flow#step#coolKey（D-C2 台账约定）；executor 的 wait 步骤读取 coolKey 写入
+ *     StepResult.cooldownKey，server 层在 run 结束后对每个带 cooldownKey 的步骤记账。
+ *   - **任务间全局节流（≥10 分钟）**：`SiteGate` 同站两次执行间隔 `GLOBAL_INTER_MIN_SECS`，
+ *     server 侧强制（acquire），跨站互不阻塞。
+ * 本模块不阻塞自身：acquire 失败返回「还需等待秒数」，由调用方决定呈现。
+ */
+/** 任务内冷却区间（秒）：流程定义未指定 coolMs 时的默认 */
+export declare const COOLDOWN_MIN_SECS = 30;
+export declare const COOLDOWN_MAX_SECS = 60;
+/** 任务间同站全局节流（秒）：≥10 分钟 */
+export declare const GLOBAL_INTER_MIN_SECS = 600;
+/** 冷却台账：key(flow#step#coolKey) → unix 秒 */
+export interface CooldownLedger {
+    entries: Record<string, number>;
+}
+/** 任务间同站闸门状态：host → 上次执行结束时间（unix 秒） */
+export interface SiteGateState {
+    lastFinish: Record<string, number>;
+}
+/** 从 URL 提取域名（含端口；port 缺省时按 scheme 推断） */
+export declare function hostOf(url: string): string;
+/** 任务内冷却台账（持久化 cool-ledger.json） */
+export declare class CooldownGate {
+    private readonly path;
+    constructor(root: string);
+    private load;
+    private save;
+    /** 记录一次冷却锚点（wait 步骤执行后调用；key = flow#step#coolKey） */
+    record(key: string): void;
+    /** 查询最近冷却锚点时间（无记录返回 undefined） */
+    lastAt(key: string): number | undefined;
+    /** 距上次冷却锚点已过秒数（无记录返回 undefined） */
+    elapsedSince(key: string): number | undefined;
+}
+/** 任务间同站闸门（持久化 site-gate.json；server 侧强制） */
+export declare class SiteGate {
+    private readonly path;
+    constructor(root: string);
+    private load;
+    private save;
+    /**
+     * 尝试获取执行许可：距上次同站执行已 ≥ 间隔 → 通过并更新状态；
+     * 否则返回 Err(还需等待秒数)。跨站（不同 host）互不影响。
+     */
+    acquire(host: string): void | number;
+    /** 检查是否可执行（不修改状态；用于展示剩余等待） */
+    check(host: string): void | number;
+    /** 上次执行时间（诊断） */
+    lastFinishAt(host: string): number | undefined;
+}
+/** 等待持续时长（供诊断/统计） */
+export declare function waitDurationLabel(secs: number): string;

package/dist/gate.js

@@ -0,0 +1,144 @@
+import { mkdirSync, readFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { writeJsonAtomic } from './atomic.js';
+/**
+ * 冷却 + 同站闸门 —— 防封铁律代码化（移植自 Rust `gate.rs`）。
+ * 两层：
+ *   - **任务内冷却（30~60s）**：`CooldownGate` 持久化最近冷却锚点（cool-ledger.json）。
+ *     key = flow#step#coolKey（D-C2 台账约定）；executor 的 wait 步骤读取 coolKey 写入
+ *     StepResult.cooldownKey，server 层在 run 结束后对每个带 cooldownKey 的步骤记账。
+ *   - **任务间全局节流（≥10 分钟）**：`SiteGate` 同站两次执行间隔 `GLOBAL_INTER_MIN_SECS`，
+ *     server 侧强制（acquire），跨站互不阻塞。
+ * 本模块不阻塞自身：acquire 失败返回「还需等待秒数」，由调用方决定呈现。
+ */
+/** 任务内冷却区间（秒）：流程定义未指定 coolMs 时的默认 */
+export const COOLDOWN_MIN_SECS = 30;
+export const COOLDOWN_MAX_SECS = 60;
+/** 任务间同站全局节流（秒）：≥10 分钟 */
+export const GLOBAL_INTER_MIN_SECS = 600;
+const unixSecs = () => Math.floor(Date.now() / 1000);
+/** 从 URL 提取域名（含端口；port 缺省时按 scheme 推断） */
+export function hostOf(url) {
+    const rest = url.includes('://') ? url.slice(url.indexOf('://') + 3) : url;
+    const hostPort = rest.split(/[/?#]/)[0] ?? '';
+    // 分离 host 与 port；host 小写
+    let host = hostPort;
+    let port;
+    const idx = hostPort.lastIndexOf(':');
+    if (idx !== -1) {
+        const p = hostPort.slice(idx + 1);
+        if (/^[0-9]+$/.test(p)) {
+            host = hostPort.slice(0, idx);
+            port = p;
+        }
+    }
+    host = host.toLowerCase();
+    if (port === undefined) {
+        if (url.startsWith('https://'))
+            port = '443';
+        else if (url.startsWith('http://'))
+            port = '80';
+        else
+            port = '';
+    }
+    return port ? `${host}:${port}` : host;
+}
+/** 任务内冷却台账（持久化 cool-ledger.json） */
+export class CooldownGate {
+    path;
+    constructor(root) {
+        this.path = join(root, 'cool-ledger.json');
+        mkdirSync(root, { recursive: true });
+    }
+    load() {
+        try {
+            const v = JSON.parse(readFileSync(this.path, 'utf8'));
+            if (v && typeof v === 'object' && typeof v.entries === 'object')
+                return v;
+            return { entries: {} };
+        }
+        catch {
+            return { entries: {} };
+        }
+    }
+    save(ledger) {
+        writeJsonAtomic(this.path, ledger);
+    }
+    /** 记录一次冷却锚点（wait 步骤执行后调用；key = flow#step#coolKey） */
+    record(key) {
+        const l = this.load();
+        l.entries[key] = unixSecs();
+        this.save(l);
+    }
+    /** 查询最近冷却锚点时间（无记录返回 undefined） */
+    lastAt(key) {
+        return this.load().entries[key];
+    }
+    /** 距上次冷却锚点已过秒数（无记录返回 undefined） */
+    elapsedSince(key) {
+        const t = this.lastAt(key);
+        return t === undefined ? undefined : Math.max(0, unixSecs() - t);
+    }
+}
+/** 任务间同站闸门（持久化 site-gate.json；server 侧强制） */
+export class SiteGate {
+    path;
+    constructor(root) {
+        this.path = join(root, 'site-gate.json');
+        mkdirSync(root, { recursive: true });
+    }
+    load() {
+        try {
+            const v = JSON.parse(readFileSync(this.path, 'utf8'));
+            if (v && typeof v === 'object' && typeof v.lastFinish === 'object')
+                return v;
+            return { lastFinish: {} };
+        }
+        catch {
+            return { lastFinish: {} };
+        }
+    }
+    save(state) {
+        writeJsonAtomic(this.path, state);
+    }
+    /**
+     * 尝试获取执行许可：距上次同站执行已 ≥ 间隔 → 通过并更新状态；
+     * 否则返回 Err(还需等待秒数)。跨站（不同 host）互不影响。
+     */
+    acquire(host) {
+        const s = this.load();
+        const now = unixSecs();
+        const last = s.lastFinish[host];
+        if (last !== undefined) {
+            const elapsed = Math.max(0, now - last);
+            if (elapsed < GLOBAL_INTER_MIN_SECS) {
+                return GLOBAL_INTER_MIN_SECS - elapsed;
+            }
+        }
+        s.lastFinish[host] = now;
+        this.save(s);
+    }
+    /** 检查是否可执行（不修改状态；用于展示剩余等待） */
+    check(host) {
+        const s = this.load();
+        const now = unixSecs();
+        const last = s.lastFinish[host];
+        if (last !== undefined) {
+            const elapsed = Math.max(0, now - last);
+            if (elapsed < GLOBAL_INTER_MIN_SECS) {
+                return GLOBAL_INTER_MIN_SECS - elapsed;
+            }
+        }
+    }
+    /** 上次执行时间（诊断） */
+    lastFinishAt(host) {
+        return this.load().lastFinish[host];
+    }
+}
+/** 等待持续时长（供诊断/统计） */
+export function waitDurationLabel(secs) {
+    if (secs >= 60)
+        return `${Math.floor(secs / 60)} 分钟 ${secs % 60} 秒`;
+    return `${secs} 秒`;
+}
+//# sourceMappingURL=gate.js.map

package/dist/gate.js.map

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

package/dist/hello.d.ts

@@ -0,0 +1,5 @@
+/**
+ * M1 骨架占位：验证 tsx 直跑链路（Rust → TypeScript 迁移脚手架）。
+ * 正式模块（schema/executor/storage/…）在 M2 起按 MIGRATION-NODE 模块映射落地。
+ */
+export declare function engineHello(): string;

package/dist/hello.js

@@ -0,0 +1,13 @@
+import { pathToFileURL } from 'node:url';
+/**
+ * M1 骨架占位：验证 tsx 直跑链路（Rust → TypeScript 迁移脚手架）。
+ * 正式模块（schema/executor/storage/…）在 M2 起按 MIGRATION-NODE 模块映射落地。
+ */
+export function engineHello() {
+    return 'engine hello from flow-rpa (tsx)';
+}
+// 直接运行（pnpm hello）时打印；被测试 import 时无副作用
+if (process.argv[1] && import.meta.url === pathToFileURL(process.argv[1]).href) {
+    console.log(engineHello());
+}
+//# sourceMappingURL=hello.js.map

package/dist/hello.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hello.js","sourceRoot":"","sources":["../src/hello.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AAExC;;;GAGG;AACH,MAAM,UAAU,WAAW;IACzB,OAAO,kCAAkC,CAAA;AAC3C,CAAC;AAED,uCAAuC;AACvC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,KAAK,aAAa,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IAC/E,OAAO,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC,CAAA;AAC5B,CAAC"}

package/dist/human.d.ts

@@ -0,0 +1,162 @@
+import type { SimProfile } from './simprofile.js';
+import { type Rng } from './simprofile.js';
+/**
+ * 人类行为模拟层 —— 从 hr-rpa-mcp `src/core/human.mjs` 完整移植（Rust `human.rs` 已 1:1 复刻，
+ * TS 按 Rust 语义翻译，三者一致）。
+ *
+ * 算法（不改写）：
+ *   - mouseMove: steps = clamp(ceil(dist/10), 6, 100) · jitter · smoothstep 缓动 · 每步对数正态延迟
+ *   - mouseClick: 预移动(>6px) · 悬停 150~400ms · 30% 过冲 2~6px · 按下中位 120ms(σ.45) · 可选双击
+ *   - mouseWheel: 惯性递减（比例 .7~.85，6~12 段）或均匀（3~6 段）· 段间 20~60ms · ±1px 抖动
+ *   - mouseDrag: 预移动 → 按下 → 按住拖动 → 释放（各段对数正态节奏）
+ *   - keyboardInput: WPM 180~280 · 2% 打错重打 · 5% 思考停顿(500~1500ms) · 收尾 200ms
+ *
+ * 解耦：Human 通过 `InputSink` 接口发送 CDP 事件（不直接依赖 CDP 实现），
+ * 拟人算法可用 mock sink 完整单测。
+ */
+/** 坐标点（内部 f64；dispatch 时四舍五入） */
+export interface Point {
+    x: number;
+    y: number;
+}
+export declare const point: (x: number, y: number) => Point;
+/** 矩形（randomClickIn / randomPointIn 用） */
+export interface Rect {
+    x: number;
+    y: number;
+    w: number;
+    h: number;
+}
+/** 拟人操作错误 */
+export declare class HumanError extends Error {
+    readonly kind: 'sink' | 'timeout' | 'stopped';
+    constructor(kind: 'sink' | 'timeout' | 'stopped', message: string);
+    static sink(msg: string): HumanError;
+    static timeout(op: string): HumanError;
+    static stopped(): HumanError;
+}
+/** CDP 事件发送抽象：真实浏览器用 CDP 客户端实现，测试用 mock 实现 */
+export interface InputSink {
+    /** 发送 CDP 命令（如 Input.dispatchMouseEvent） */
+    send(method: string, params: Record<string, unknown>): Promise<void>;
+    /** 页面求值（randomClickIn 获取元素矩形等） */
+    evaluate(expr: string): Promise<unknown>;
+    /** 视口尺寸（Page.getLayoutMetrics → visualViewport；失败回退 1440x900） */
+    viewport(): Promise<[number, number]>;
+}
+/** 插件: clamp(e,t,s){return Math.max(t,Math.min(s,e))} */
+export declare function clamp<T>(v: T, min: T, max: T): T;
+/** 插件: randBetween(e,t,s=Math.random){return e+s()*(t-e)} */
+export declare function randBetween(a: number, b: number, rng: Rng): number;
+/** 插件: sampleLogNormal —— Box-Muller 对数正态，clamp 8~600ms */
+export declare function sampleLogNormal(median: number, sigma: number, rng: Rng): number;
+/** 插件: easeInOut(e){return e*e*(3-2*e)} */
+export declare function easeInOut(t: number): number;
+export declare function getRandomErrorChar(ch: string, rng: Rng): string;
+export interface MoveOpts {
+    from?: Point;
+    clamp?: boolean;
+    jitter?: number;
+    seed?: number;
+    timeoutMs?: number;
+    /** 停止标志：true 时中止（对应插件 throwIfAborted 的 stopCheck） */
+    stop?: {
+        stopped: boolean;
+    };
+}
+export interface ClickOpts {
+    clamp?: boolean;
+    seed?: number;
+    hoverRangeMs?: [number, number];
+    overshootProbability?: number;
+    overshootPx?: [number, number];
+    pressMedianMs?: number;
+    doubleClick?: boolean;
+    doubleClickProbability?: number;
+    keyboard?: string[];
+    timeoutMs?: number;
+    stop?: {
+        stopped: boolean;
+    };
+}
+export interface WheelOpts {
+    x?: number;
+    y?: number;
+    inertia?: boolean;
+    steps?: number;
+    seed?: number;
+    timeoutMs?: number;
+    stop?: {
+        stopped: boolean;
+    };
+}
+export interface DragOpts {
+    steps?: number;
+    jitter?: number;
+    pressDelayMs?: [number, number];
+    releaseDelayMs?: [number, number];
+    clamp?: boolean;
+    seed?: number;
+    timeoutMs?: number;
+    stop?: {
+        stopped: boolean;
+    };
+}
+export interface InputOpts {
+    wpmRange?: [number, number];
+    errorRate?: number;
+    thinkPauseChance?: number;
+    thinkPauseRangeMs?: [number, number];
+    finalPauseMs?: number;
+    seed?: number;
+    timeoutMs?: number;
+    stop?: {
+        stopped: boolean;
+    };
+}
+/** 拟人操作器：持有 InputSink，行为参数来自 SimProfile（机器差异化） */
+export declare class Human<S extends InputSink> {
+    private readonly sink;
+    private lastPos?;
+    private readonly sim;
+    constructor(sink: S, sim: SimProfile);
+    static withDefaultSim<S extends InputSink>(sink: S): Human<S>;
+    /** 插件 assertPageOk 前置校验（forbidden scheme 检查） */
+    assertPageOk(): Promise<void>;
+    /** 插件 getViewport：Page.getLayoutMetrics.visualViewport，fallback 1440x900 */
+    private getViewport;
+    /** 插件 U：坐标 clamp 到视口（输出四舍五入） */
+    static clampToViewport(p: Point, w: number, h: number): Point;
+    private checkStop;
+    /** mouseMove 核心实现 */
+    private implMove;
+    /** 插件 mouseMove（公共入口：可选超时） */
+    mouseMove(to: Point, opts?: MoveOpts): Promise<Point>;
+    /** mouseClick 核心 */
+    private implClick;
+    /** 插件 mouseClick（公共入口） */
+    mouseClick(at: Point, opts?: ClickOpts): Promise<Point>;
+    /** 插件 mouseWheel：惯性递减或均匀，段间 20~60ms，±1px */
+    mouseWheel(delta: Point, opts?: WheelOpts): Promise<Point>;
+    /** 插件 mx：矩形内按 padding 收缩后随机取点 */
+    static randomPointIn(rect: Rect, padding: [number, number, number, number], rng: Rng): Point;
+    /** 插件 mouseDrag（content_to_bg_mouse_drag，1:1 复刻） */
+    mouseDrag(from: Point, to: Point, opts?: DragOpts): Promise<[Point, Point]>;
+    /**
+     * 插件 randomClickIn：随机选元素在其可见矩形内随机点后 mouseClick，1~2 次。
+     * 需要页面已注入 DOM_SOURCE（window.__rpaDom.getBySels）。
+     */
+    randomClickIn(selector: string, maxClicks?: number, intervalMs?: number): Promise<[number, number]>;
+    /** 插件 typeCharacter */
+    private typeCharacter;
+    /** 插件 typeBackspace */
+    private typeBackspace;
+    /** 按回车（真实 CDP 键盘事件，isTrusted=true） */
+    pressEnter(): Promise<void>;
+    /** 插件 isThinkingTrigger：标点后思考停顿 */
+    static isThinkingTrigger(ch: string): boolean;
+    /** 插件 calculateTypingInterval：相邻字符间隔加权，clamp 30~500ms */
+    calculateTypingInterval(prev: string, next: string, baseMs: number, rng: Rng): number;
+    /** 插件 keyboardInput：WPM 180~280 · 2% 打错重打 · 5% 思考停顿 · 收尾 200ms */
+    keyboardInput(text: string, opts?: InputOpts): Promise<number>;
+}