@qing3a/flow-rpa-engine 0.1.0

package/dist/simprofile.js

@@ -0,0 +1,247 @@
+import { createHash } from 'node:crypto';
+import { mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { dirname } from 'node:path';
+/**
+ * 模拟参数差异化层（sim profile）—— 从 hr-rpa-mcp `src/core/simprofile.mjs`
+ * 完整移植（Rust `simprofile.rs` 已 1:1 复刻原版，TS 直接按 Rust 语义翻译，三者一致）。
+ *
+ * 目的：让每台机器/每个实例的拟人行为参数「基准」互不相同。首次运行时用机器指纹
+ * 生成稳定的 ±15% 乘性扰动，缓存到本地 sim-profile.json，之后每次运行读同一份缓存。
+ *
+ * 原则：
+ * - BASE_SIM 的值 = human.mjs 原硬编码值（勿改，作基准）
+ * - 只扰动「行为风格」参数；不扰动「结构边界」
+ * - 纯本地，无服务器依赖
+ */
+/** 扰动幅度（±百分比） */
+export const PERTURB_PCT = 0.15;
+/** 缓存格式版本：BASE_SIM 结构变化时 bump，旧缓存失效重新生成 */
+const PROFILE_VERSION = 1;
+/**
+ * 确定性 PRNG：xorshift32（对应 hr-rpa-mcp `createRng`）。
+ * `t ^= t<<13; t ^= t>>>17; t ^= t<<5; t>>>0; return (t%1e6)/1e6`
+ */
+export class XorShift32 {
+    s;
+    constructor(seed) {
+        // JS createRng: `t = seed >>> 0 || 1`（seed 0 → 1）
+        this.s = seed > 0 ? seed >>> 0 : 1;
+    }
+    /** 无种子默认随机（等价 Rust `XorShift32::time_seeded`）：取高精度时钟低 32 位作种子 */
+    static timeSeeded() {
+        const t = Number(process.hrtime.bigint() & 0xffffffffn);
+        return new XorShift32((t ^ 0x5bd1e995) >>> 0);
+    }
+    next() {
+        let t = this.s;
+        t ^= t << 13;
+        t ^= t >>> 17;
+        t ^= t << 5;
+        t >>>= 0;
+        this.s = t;
+        return (t % 1_000_000) / 1_000_000;
+    }
+}
+/**
+ * mulberry32：确定性 PRNG（hr-rpa-mcp simprofile 的机器指纹扰动用）。
+ * 全部为 32 位有符号整数运算（|0 / Math.imul / >>> 0），TS 用 >>>0 保证无符号。
+ */
+export function mulberry32(a) {
+    let state = a >>> 0;
+    return function next() {
+        state = (state + 0x6d2b79f5) >>> 0;
+        let t = Math.imul(state ^ (state >>> 15), 1 | state);
+        t = (t + Math.imul(t ^ (t >>> 7), 61 | t)) ^ t;
+        return ((t ^ (t >>> 14)) >>> 0) / 4294967296;
+    };
+}
+export const BASE_SIM = {
+    // mouseMove
+    jitter: 2.5,
+    moveMedianMs: 16,
+    moveSigma: 0.35,
+    startOffsetRange: [100, 200],
+    // mouseClick
+    clickJitter: 1.8,
+    hoverRangeMs: [150, 400],
+    overshootProbability: 0.3,
+    overshootPx: [2, 6],
+    overshootMedianMs: 18,
+    overshootSigma: 0.3,
+    pressMedianMs: 120,
+    pressSigma: 0.45,
+    doubleClickRangeMs: [90, 180],
+    // mouseWheel
+    wheelRatioRange: [0.7, 0.85],
+    wheelInertiaStepsRange: [6, 12],
+    wheelUniformStepsRange: [3, 6],
+    wheelIntervalMs: [20, 60],
+    // mouseDrag
+    dragJitter: 2.5,
+    pressDelayMs: [100, 300],
+    releaseDelayMs: [50, 150],
+    dragPreMedianMs: 30,
+    dragPreSigma: 0.3,
+    dragMoveMedianMs: 40,
+    dragMoveSigma: 0.4,
+    // keyboardInput
+    wpmRange: [180, 280],
+    errorRate: 0.02,
+    thinkPauseChance: 0.05,
+    thinkPauseRangeMs: [500, 1500],
+    finalPauseMs: 200,
+    typeSigma: 0.35,
+    typeErrSigma: 0.4,
+    typeBackspaceSigma: 0.3,
+    // randomClickIn
+    randomClickMaxClicks: 2,
+    randomClickIntervalMs: 1000,
+};
+/* ---------------- 机器指纹 + 扰动 ---------------- */
+/** 机器指纹 → 稳定 seed：用户名/主机名/域/工作目录（不含绝对时间，同机稳定） */
+export function machineSeed() {
+    const s = [
+        process.env.USERNAME || process.env.USER || 'u',
+        process.env.COMPUTERNAME || process.env.HOSTNAME || 'h',
+        process.env.USERDOMAIN || '',
+        process.cwd(),
+    ].join('|');
+    return createHash('sha256').update(s).digest().readUInt32LE(0);
+}
+const r3 = (v) => Math.round(v * 1000) / 1000;
+/** 单点数值：乘性 ±15% */
+function pertNum(v, rng) {
+    return r3(v * (1 + (rng() * 2 - 1) * PERTURB_PCT));
+}
+/** 区间：两端各自乘性 ±15%，保留 3 位小数 */
+function pertRange([a, b], rng) {
+    const fa = 1 + (rng() * 2 - 1) * PERTURB_PCT;
+    const fb = 1 + (rng() * 2 - 1) * PERTURB_PCT;
+    const na = r3(a * fa);
+    const nb = r3(b * fb);
+    return [Math.min(na, nb), Math.max(na, nb)];
+}
+/** 概率：乘性 ±15%，clamp 到 [0,1] */
+function pertProb(v, rng) {
+    const x = v * (1 + (rng() * 2 - 1) * PERTURB_PCT);
+    return r3(Math.max(0, Math.min(1, x)));
+}
+/** 由 BASE_SIM 生成一份扰动后的 profile（对应 JS `perturbBase`） */
+export function perturbBase(rng) {
+    const b = BASE_SIM;
+    const p = {
+        jitter: pertNum(b.jitter, rng),
+        moveMedianMs: pertNum(b.moveMedianMs, rng),
+        moveSigma: pertNum(b.moveSigma, rng),
+        startOffsetRange: pertRange(b.startOffsetRange, rng),
+        clickJitter: pertNum(b.clickJitter, rng),
+        hoverRangeMs: pertRange(b.hoverRangeMs, rng),
+        overshootProbability: pertProb(b.overshootProbability, rng),
+        overshootPx: pertRange(b.overshootPx, rng),
+        overshootMedianMs: pertNum(b.overshootMedianMs, rng),
+        overshootSigma: pertNum(b.overshootSigma, rng),
+        pressMedianMs: pertNum(b.pressMedianMs, rng),
+        pressSigma: pertNum(b.pressSigma, rng),
+        doubleClickRangeMs: pertRange(b.doubleClickRangeMs, rng),
+        wheelRatioRange: pertRange(b.wheelRatioRange, rng),
+        wheelInertiaStepsRange: pertRange(b.wheelInertiaStepsRange, rng),
+        wheelUniformStepsRange: pertRange(b.wheelUniformStepsRange, rng),
+        wheelIntervalMs: pertRange(b.wheelIntervalMs, rng),
+        dragJitter: pertNum(b.dragJitter, rng),
+        pressDelayMs: pertRange(b.pressDelayMs, rng),
+        releaseDelayMs: pertRange(b.releaseDelayMs, rng),
+        dragPreMedianMs: pertNum(b.dragPreMedianMs, rng),
+        dragPreSigma: pertNum(b.dragPreSigma, rng),
+        dragMoveMedianMs: pertNum(b.dragMoveMedianMs, rng),
+        dragMoveSigma: pertNum(b.dragMoveSigma, rng),
+        wpmRange: pertRange(b.wpmRange, rng),
+        errorRate: pertProb(b.errorRate, rng),
+        thinkPauseChance: pertProb(b.thinkPauseChance, rng),
+        thinkPauseRangeMs: pertRange(b.thinkPauseRangeMs, rng),
+        finalPauseMs: pertNum(b.finalPauseMs, rng),
+        typeSigma: pertNum(b.typeSigma, rng),
+        typeErrSigma: pertNum(b.typeErrSigma, rng),
+        typeBackspaceSigma: pertNum(b.typeBackspaceSigma, rng),
+        randomClickMaxClicks: pertNum(b.randomClickMaxClicks, rng),
+        randomClickIntervalMs: pertNum(b.randomClickIntervalMs, rng),
+    };
+    return p;
+}
+/**
+ * 加载本机模拟参数：首次生成扰动并缓存，之后读缓存（同机稳定）。
+ * 任何异常都回退到 BASE_SIM（未扰动基准），绝不阻断主流程。
+ * 等价 Rust `load_sim_profile(profile_file)`。
+ */
+export function loadSimProfile(profileFile) {
+    // 1. 命中缓存直接返回（__v 校验）
+    try {
+        const raw = readFileSync(profileFile, 'utf8');
+        const v = JSON.parse(raw);
+        if (v && typeof v === 'object' && v.__v === PROFILE_VERSION) {
+            const profile = parseProfile(v);
+            if (profile)
+                return { __v: PROFILE_VERSION, profile };
+        }
+    }
+    catch {
+        // 缓存损坏 → 走重建分支
+    }
+    // 2. 首次生成 + 写缓存
+    try {
+        const profile = perturbBase(mulberry32(machineSeed()));
+        const withV = { __v: PROFILE_VERSION, ...profile };
+        mkdirSync(dirname(profileFile), { recursive: true });
+        writeFileSync(profileFile, JSON.stringify(withV, null, 2), 'utf8');
+        return { __v: PROFILE_VERSION, profile };
+    }
+    catch {
+        return { __v: PROFILE_VERSION, profile: { ...BASE_SIM } };
+    }
+}
+/** 从任意对象解析 SimProfile（字段缺失/类型不符 → null，等价 Rust from_value 的 ok()） */
+export function parseProfile(v) {
+    if (!v || typeof v !== 'object')
+        return null;
+    const o = v;
+    // 区间字段（值为两元素数组）列表：单点 number 循环跳过，由下方统一校验
+    const rangeKeys = [
+        'startOffsetRange',
+        'hoverRangeMs',
+        'overshootPx',
+        'doubleClickRangeMs',
+        'wheelRatioRange',
+        'wheelInertiaStepsRange',
+        'wheelUniformStepsRange',
+        'wheelIntervalMs',
+        'pressDelayMs',
+        'releaseDelayMs',
+        'thinkPauseRangeMs',
+        'wpmRange',
+    ];
+    const need = Object.keys(BASE_SIM);
+    const out = {};
+    const rangeKeySet = new Set(rangeKeys);
+    for (const k of need) {
+        if (rangeKeySet.has(k))
+            continue;
+        const val = o[k];
+        if (typeof val !== 'number')
+            return null;
+        // out[k] 的目标类型对区间字段是 [number, number]；单点字段是 number。
+        // 运行时这里只写 number 值（区间字段稍后整体覆写），断言交给区间循环。
+        out[k] = val;
+    }
+    for (const k of rangeKeys) {
+        const val = o[k];
+        if (!Array.isArray(val) || val.length !== 2 || typeof val[0] !== 'number' || typeof val[1] !== 'number') {
+            return null;
+        }
+        out[k] = [val[0], val[1]];
+    }
+    return out;
+}
+/** 默认缓存路径：由 app 层注入数据目录（测试传临时文件，隔离真实拟人参数） */
+export function defaultProfileFile(dataDir) {
+    return `${dataDir.replace(/[\\/]+$/, '')}/sim-profile.json`;
+}
+//# sourceMappingURL=simprofile.js.map

package/dist/simprofile.js.map

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

package/dist/storage.d.ts

@@ -0,0 +1,63 @@
+import type { ExtractSink } from './executor.js';
+import type { RunRecord } from './record.js';
+import type { DomSnapshot } from './export.js';
+/**
+ * 执行记录存储 —— run.json 落盘 + 上传台账（移植自 Rust `storage.rs` + A5 原子写 + D-E2 落盘）。
+ *
+ * 本地存储目录：
+ *   runs/<run_id>.json                    # 执行记录（run.json）
+ *   snapshots/<run_id>.json               # DOM 快照（D-S2：单独文件，不进 run.json——记录结构契约冻结）
+ *   upload-ledger.json                    # 上传台账
+ *   extracted/<run_id>/<step_id>.json     # extract save:true 明细（D-E2，原始数据留在本地）
+ *
+ * 上传台账语义：去重（已传 run 不重传）、断网重试（未传状态可重试）、
+ * 同流程同版本增量。本模块只负责台账的持久化状态管理。
+ * 所有 JSON 落盘统一走 A5 原子写（writeJsonAtomic）。
+ */
+export type LedgerState = 'pending' | 'uploaded' | 'failed';
+export interface LedgerEntry {
+    runId: string;
+    flowId: string;
+    flowVersion: number;
+    state: LedgerState;
+    error?: string;
+    createdAt: string;
+    uploadedAt?: string;
+}
+export interface UploadLedger {
+    entries: LedgerEntry[];
+}
+/** 存储目录句柄 */
+export declare class RunStore {
+    readonly root: string;
+    private readonly ledgerPath;
+    constructor(root: string);
+    runsDir(): string;
+    /** extract save:true 明细目录（D-E2） */
+    extractedDir(): string;
+    /** DOM 快照目录（D-S2：snapshots/<run_id>.json，不进 run.json） */
+    snapshotsDir(): string;
+    ledgerPathOf(): string;
+    /** 保存执行记录为 runs/<run_id>.json（已存在则覆盖，同 run 幂等）；同步入台账 Pending */
+    saveRun(rec: RunRecord): string;
+    /** 读取执行记录 */
+    loadRun(runId: string): RunRecord | undefined;
+    /** 列出已落盘的 run_id（按文件名） */
+    listRunIds(): string[];
+    /** 保存 DOM 快照（覆盖同 run 旧快照，幂等） */
+    saveSnapshot(runId: string, snapshot: DomSnapshot): void;
+    /** 读取 DOM 快照；无快照或损坏 → undefined（快照失败不阻断 run 落盘） */
+    loadSnapshot(runId: string): DomSnapshot | undefined;
+    loadLedger(): UploadLedger;
+    saveLedger(ledger: UploadLedger): void;
+    /** 待上传（Pending/Failed）的 run_id 列表 —— 断网重试的入口 */
+    pendingUploads(): string[];
+    /** 标记上传结果（去重：同 run_id 更新状态） */
+    markUploaded(runId: string, ok: boolean, error?: string): void;
+    /** 保存 extract 明细到 extracted/<run_id>/<step_id>.json（原文，永不进 run.json） */
+    saveExtracted(runId: string, stepId: string, field: string | undefined, content: string): void;
+}
+/** ExtractSink 的真实落盘实现（M4 接口的 M5 落地） */
+export declare function extractSink(store: RunStore): ExtractSink;
+/** 当前时间（ISO 8601 UTC，秒级） */
+export declare function nowIso(): string;

package/dist/storage.js

@@ -0,0 +1,138 @@
+import { mkdirSync, readdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { writeFileAtomic, writeJsonAtomic } from './atomic.js';
+/** 存储目录句柄 */
+export class RunStore {
+    root;
+    ledgerPath;
+    constructor(root) {
+        this.root = root;
+        this.ledgerPath = join(root, 'upload-ledger.json');
+        mkdirSync(this.runsDir(), { recursive: true });
+        mkdirSync(this.extractedDir(), { recursive: true });
+        mkdirSync(this.snapshotsDir(), { recursive: true });
+    }
+    runsDir() {
+        return join(this.root, 'runs');
+    }
+    /** extract save:true 明细目录（D-E2） */
+    extractedDir() {
+        return join(this.root, 'extracted');
+    }
+    /** DOM 快照目录（D-S2：snapshots/<run_id>.json，不进 run.json） */
+    snapshotsDir() {
+        return join(this.root, 'snapshots');
+    }
+    ledgerPathOf() {
+        return this.ledgerPath;
+    }
+    /** 保存执行记录为 runs/<run_id>.json（已存在则覆盖，同 run 幂等）；同步入台账 Pending */
+    saveRun(rec) {
+        const path = join(this.runsDir(), `${rec.runId}.json`);
+        writeJsonAtomic(path, rec);
+        const ledger = this.loadLedger();
+        if (!ledger.entries.some((e) => e.runId === rec.runId)) {
+            ledger.entries.push({
+                runId: rec.runId,
+                flowId: rec.flowId,
+                flowVersion: rec.flowVersion,
+                state: 'pending',
+                error: undefined,
+                createdAt: rec.startedAt,
+                uploadedAt: undefined,
+            });
+            this.saveLedger(ledger);
+        }
+        return path;
+    }
+    /** 读取执行记录 */
+    loadRun(runId) {
+        const path = join(this.runsDir(), `${runId}.json`);
+        try {
+            return JSON.parse(readFileSync(path, 'utf8'));
+        }
+        catch {
+            return undefined;
+        }
+    }
+    /** 列出已落盘的 run_id（按文件名） */
+    listRunIds() {
+        try {
+            const ids = readdirSync(this.runsDir())
+                .filter((n) => n.endsWith('.json'))
+                .map((n) => n.slice(0, -'.json'.length));
+            ids.sort();
+            return ids;
+        }
+        catch {
+            return [];
+        }
+    }
+    /* ---- DOM 快照（D-S2：snapshots/<run_id>.json，不进 run.json） ---- */
+    /** 保存 DOM 快照（覆盖同 run 旧快照，幂等） */
+    saveSnapshot(runId, snapshot) {
+        writeJsonAtomic(join(this.snapshotsDir(), `${runId}.json`), snapshot);
+    }
+    /** 读取 DOM 快照；无快照或损坏 → undefined（快照失败不阻断 run 落盘） */
+    loadSnapshot(runId) {
+        try {
+            return JSON.parse(readFileSync(join(this.snapshotsDir(), `${runId}.json`), 'utf8'));
+        }
+        catch {
+            return undefined;
+        }
+    }
+    /* ---- 上传台账 ---- */
+    loadLedger() {
+        try {
+            const raw = readFileSync(this.ledgerPath, 'utf8');
+            const v = JSON.parse(raw);
+            if (Array.isArray(v.entries))
+                return v;
+            return { entries: [] };
+        }
+        catch {
+            return { entries: [] };
+        }
+    }
+    saveLedger(ledger) {
+        writeJsonAtomic(this.ledgerPath, ledger);
+    }
+    /** 待上传（Pending/Failed）的 run_id 列表 —— 断网重试的入口 */
+    pendingUploads() {
+        return this.loadLedger()
+            .entries.filter((e) => e.state !== 'uploaded')
+            .map((e) => e.runId);
+    }
+    /** 标记上传结果（去重：同 run_id 更新状态） */
+    markUploaded(runId, ok, error) {
+        const ledger = this.loadLedger();
+        const e = ledger.entries.find((x) => x.runId === runId);
+        if (e) {
+            e.state = ok ? 'uploaded' : 'failed';
+            e.error = ok ? undefined : error;
+            e.uploadedAt = ok ? nowIso() : undefined;
+            this.saveLedger(ledger);
+        }
+    }
+    /* ---- extract save:true 明细落盘（D-E2） ---- */
+    /** 保存 extract 明细到 extracted/<run_id>/<step_id>.json（原文，永不进 run.json） */
+    saveExtracted(runId, stepId, field, content) {
+        const dir = join(this.extractedDir(), runId);
+        mkdirSync(dir, { recursive: true });
+        writeJsonAtomic(join(dir, `${stepId}.json`), { runId, stepId, field, savedAt: nowIso(), content });
+    }
+}
+/** ExtractSink 的真实落盘实现（M4 接口的 M5 落地） */
+export function extractSink(store) {
+    return {
+        saveExtracted(runId, stepId, field, content) {
+            store.saveExtracted(runId, stepId, field, content);
+        },
+    };
+}
+/** 当前时间（ISO 8601 UTC，秒级） */
+export function nowIso() {
+    return new Date().toISOString();
+}
+//# sourceMappingURL=storage.js.map

package/dist/storage.js.map

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

package/dist/validate.d.ts

@@ -0,0 +1,37 @@
+import type { Flow } from './schema.js';
+export type { Flow } from './schema.js';
+/**
+ * 解析与语义校验（移植自 Rust `engine/src/lib.rs` 的 `parse_flow` / `validate`）。
+ *
+ * 语义校验项（与 Rust 版逐条对应，错误文案一字不差）：
+ * - flow.id 非空 → `flow.id 不能为空`
+ * - 步骤 id 非空 → `flow {id} 存在空步骤 id`
+ * - 步骤 id 唯一 → `flow {id} 步骤 id 重复: {sid}`
+ * - loop 步骤必须含 params.steps → `loop 步骤 {sid} 缺少子步骤 (params.steps)`
+ *
+ * D-R6 扩展（2026-08-25 定案，Rust 版无此字段）：inputs 参数声明校验
+ * - 参数名非空 → `inputs 参数名为空`
+ * - 参数名流程内唯一 → `inputs 参数名重复: {name}`
+ *
+ * 错误文案是执行记录 / 观察包与测试断言的对外契约，不得漂移。
+ */
+/** 引擎流程定义错误（对齐 Rust `FlowError` 的两档文案前缀） */
+export declare class FlowError extends Error {
+    readonly kind: 'parse' | 'invalid';
+    readonly name: string;
+    constructor(kind: 'parse' | 'invalid', message: string);
+}
+/** 解析失败：`流程定义解析失败: {detail}` */
+export declare function flowParseError(detail: string): FlowError;
+/** 语义校验失败：`流程定义不合法: {detail}` */
+export declare function flowInvalidError(detail: string): FlowError;
+/**
+ * 语义校验（等价 Rust `validate`）。返回错误对象，合法返回 null。
+ * 错误文案与 Rust 版逐字一致（测试断言依赖原文案）。
+ */
+export declare function validate(flow: Flow): FlowError | null;
+/**
+ * 完整入口：反序列化 + 语义校验（等价 Rust `parse_flow`）。
+ * 解析失败（JSON 语法 / 结构不符）抛 FlowError（kind=parse）；校验失败抛 FlowError（kind=invalid）。
+ */
+export declare function parseFlow(json: string): Flow;

package/dist/validate.js

@@ -0,0 +1,108 @@
+import { parseFlowJson } from './schema.js';
+/**
+ * 解析与语义校验（移植自 Rust `engine/src/lib.rs` 的 `parse_flow` / `validate`）。
+ *
+ * 语义校验项（与 Rust 版逐条对应，错误文案一字不差）：
+ * - flow.id 非空 → `flow.id 不能为空`
+ * - 步骤 id 非空 → `flow {id} 存在空步骤 id`
+ * - 步骤 id 唯一 → `flow {id} 步骤 id 重复: {sid}`
+ * - loop 步骤必须含 params.steps → `loop 步骤 {sid} 缺少子步骤 (params.steps)`
+ *
+ * D-R6 扩展（2026-08-25 定案，Rust 版无此字段）：inputs 参数声明校验
+ * - 参数名非空 → `inputs 参数名为空`
+ * - 参数名流程内唯一 → `inputs 参数名重复: {name}`
+ *
+ * 错误文案是执行记录 / 观察包与测试断言的对外契约，不得漂移。
+ */
+/** 引擎流程定义错误（对齐 Rust `FlowError` 的两档文案前缀） */
+export class FlowError extends Error {
+    kind;
+    name;
+    constructor(kind, message) {
+        super(message);
+        this.kind = kind;
+        this.name = kind === 'parse' ? 'FlowParseError' : 'FlowInvalidError';
+    }
+}
+/** 解析失败：`流程定义解析失败: {detail}` */
+export function flowParseError(detail) {
+    return new FlowError('parse', `流程定义解析失败: ${detail}`);
+}
+/** 语义校验失败：`流程定义不合法: {detail}` */
+export function flowInvalidError(detail) {
+    return new FlowError('invalid', `流程定义不合法: ${detail}`);
+}
+/**
+ * 语义校验（等价 Rust `validate`）。返回错误对象，合法返回 null。
+ * 错误文案与 Rust 版逐字一致（测试断言依赖原文案）。
+ */
+export function validate(flow) {
+    if (flow.id.length === 0) {
+        return flowInvalidError('flow.id 不能为空');
+    }
+    // D-R6：inputs 参数声明校验（name 非空、流程内唯一）
+    const seenInputs = new Set();
+    for (const input of flow.inputs ?? []) {
+        if (input.name.length === 0) {
+            return flowInvalidError('inputs 参数名为空');
+        }
+        if (seenInputs.has(input.name)) {
+            return flowInvalidError(`inputs 参数名重复: ${input.name}`);
+        }
+        seenInputs.add(input.name);
+    }
+    const seen = new Set();
+    for (const s of flow.steps) {
+        if (s.id.length === 0) {
+            return flowInvalidError(`flow ${flow.id} 存在空步骤 id`);
+        }
+        if (seen.has(s.id)) {
+            return flowInvalidError(`flow ${flow.id} 步骤 id 重复: ${s.id}`);
+        }
+        seen.add(s.id);
+        if (s.type === 'loop') {
+            if (!('steps' in (s.params ?? {}))) {
+                return flowInvalidError(`loop 步骤 ${s.id} 缺少子步骤 (params.steps)`);
+            }
+            // 嵌套 loop 拒绝（EXECUTION-SPEC D-L5：v1 仅支持一层 loop）
+            const subs = s.params.steps;
+            if (Array.isArray(subs) && subs.some((sub) => isStepOfType(sub, 'loop'))) {
+                return flowInvalidError('嵌套 loop 暂不支持');
+            }
+        }
+    }
+    return null;
+}
+/** 判断未知值是否为指定类型的步骤（validate 层轻量检查，不做完整结构解析） */
+function isStepOfType(v, type) {
+    return !!v && typeof v === 'object' && v.type === type;
+}
+/**
+ * 完整入口：反序列化 + 语义校验（等价 Rust `parse_flow`）。
+ * 解析失败（JSON 语法 / 结构不符）抛 FlowError（kind=parse）；校验失败抛 FlowError（kind=invalid）。
+ */
+export function parseFlow(json) {
+    let raw;
+    try {
+        raw = JSON.parse(json);
+    }
+    catch (e) {
+        const msg = e instanceof Error ? e.message : String(e);
+        throw flowParseError(msg);
+    }
+    let flow;
+    try {
+        flow = parseFlowJson(raw);
+    }
+    catch (e) {
+        // 结构不符（如 {"id":123}、steps 非数组）→ zod 抛 ZodError；
+        // 对齐 Rust serde 反序列化失败统一为 FlowError::Parse 的语义
+        const msg = e instanceof Error ? e.message : String(e);
+        throw flowParseError(msg);
+    }
+    const err = validate(flow);
+    if (err)
+        throw err;
+    return flow;
+}
+//# sourceMappingURL=validate.js.map

package/dist/validate.js.map

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

package/package.json

@@ -0,0 +1,32 @@
+{
+  "name": "@qing3a/flow-rpa-engine",
+  "version": "0.1.0",
+  "type": "module",
+  "description": "flow-rpa 执行引擎（原 engine crate）：解释执行流程定义（schema 驱动），拟人化操作浏览器",
+  "publishConfig": {
+    "access": "public"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./src/*.js": {
+      "types": "./dist/*.d.ts",
+      "default": "./dist/*.js"
+    },
+    "./test/*.js": "./test/*.js",
+    "./package.json": "./package.json"
+  },
+  "files": ["dist"],
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "test": "vitest run --root ../.. --project engine",
+    "typecheck": "tsc --noEmit"
+  },
+  "dependencies": {
+    "zod": "^4.4.3"
+  }
+}