gz-laya-pilot 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 LayaPilot contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/NOTICE.md

@@ -0,0 +1,11 @@
+# Source and changes
+
+Derived from [anthonyli/laya-pilot](https://github.com/anthonyli/laya-pilot), MIT, copyright 2026 LayaPilot contributors. This is an independent package, not an official upstream release.
+
+The repository already contains the complete adapted source snapshot under `tools/laya-pilot`. Its original archive SHA-256 is `88d4932109b64f40a8c13f82f43cfc6d33e371344f13b688bad4967705f14b30`. An upstream commit was not retained with that snapshot; no commit is claimed here.
+
+Ported `lib/browser-provider.mjs`, the `waitForReady` function in `lib/readiness.mjs`, and decision validation / HTTP protocol from `lib/model.mjs` to strict TypeScript functions. Added schema validation, deterministic recording replay, declarative assertions and semantic target metadata. Removed application routes, demo credentials, workflow classes, implicit logs and unbounded caches from this package. LICENSE retains the upstream notice.
+
+The legacy Excel generator and Python model worker remain in the repository's old tools directory. They are not silently replaced by this package. Recorded JSON cases use Playwright without model inference; `createApiDecision` and `chooseStep` support an explicitly configured Laya-compatible decision endpoint. Local model weights and inference runtime are not distributed.
+
+Playwright and dom-accessibility-api retain their own licenses. No source or dependency claims an npm release of upstream `laya-pilot`.

package/README.md

@@ -0,0 +1,46 @@
+# gz-laya-pilot
+
+Node 22+ / TypeScript functional runtime derived from LayaPilot. ESM with declarations; no framework, business login or persistence built in.
+
+```sh
+npm install gz-laya-pilot
+npx playwright install chromium
+```
+
+```ts
+import { runCase } from 'gz-laya-pilot';
+const result = await runCase(
+  {
+    schema: 'zhidao-recorded-case',
+    version: 1,
+    name: 'Customer search',
+    path: '/customers',
+    steps: [
+      {
+        kind: 'assert',
+        assertion: {
+          name: 'Page ready',
+          source: 'element-state',
+          selector: '[data-testid="search"]',
+          operator: 'visible',
+          timeout: 5000,
+        },
+      },
+    ],
+  },
+  {
+    origin: 'http://127.0.0.1:3000',
+    launch: { headless: true },
+    onProgress: console.log,
+    signal: new AbortController().signal,
+  },
+);
+```
+
+Use `beforeRun(page, context)` for your host's authentication or test setup; use `context.storageState` for an existing test login. Credentials never belong in case JSON. `allowedOrigins` explicitly permits API/asset origins when the test app needs them. By default only the supplied origin is allowed. Abort closes the browser. A run with no assertions reports `completed`, not `passed`.
+
+Browser consumers import `gz-laya-pilot/schema` or `gz-laya-pilot/browser`; neither entry imports Node or Playwright. `locate()` uses unique CSS plus W3C accessible name/role. Version 1 CSS/text targets still work. Automatic retry never substitutes another business control.
+
+`createApiDecision({base, model, key})` returns a Laya-protocol decision function. `chooseStep(instruction, observedCandidates, decide)` selects a structured step or returns null for uncertainty. It does not execute the candidate or invent locators. The host must observe candidates and review the draft; `runCase` evaluates assertions against real DOM, not model opinions. JSON replay does not require Python. The existing Excel / local Python pipeline remains under `tools/laya-pilot` in the source repository.
+
+See NOTICE.md and LICENSE for upstream provenance and the scope of the port.

package/dist/assertions.d.ts

@@ -0,0 +1,3 @@
+import type { Page } from 'playwright';
+import type { Assertion, AssertionResult } from './schema.js';
+export declare function runAssertion(page: Page, assertion: Assertion, step: number, isStopped?: () => boolean): Promise<AssertionResult>;

package/dist/assertions.js

@@ -0,0 +1,111 @@
+// Declarative browser assertions. Native CSS only; imported cases never execute scripts.
+export async function runAssertion(page, assertion, step, isStopped = () => false) {
+    const started = Date.now();
+    let actual = '尚未采样';
+    let passed = false;
+    let stableSince;
+    const names = {
+        contains: '包含',
+        'not-contains': '不包含',
+        equals: '等于',
+        'not-equals': '不等于',
+        visible: '可见',
+        hidden: '不可见或不存在',
+    };
+    while (Date.now() - started < assertion.timeout) {
+        if (isStopped())
+            throw Error('已停止');
+        const sample = await page.evaluate((a) => {
+            const normalize = (text) => String(text ?? '')
+                .replace(/\s+/g, ' ')
+                .trim();
+            const secret = (element) => /password|passwd|token|secret|credential|验证码|密码|密钥|口令/i.test([
+                element.type,
+                element.name,
+                element.id,
+                element.autocomplete,
+                element.getAttribute('aria-label'),
+                element.getAttribute('placeholder'),
+                element.labels?.[0]?.textContent,
+            ].join(' '));
+            let value;
+            if (a.source === 'page-text')
+                value = document.body.innerText;
+            else {
+                let elements;
+                try {
+                    elements = [...document.querySelectorAll(a.selector)].filter((e) => !e.closest('[data-research-assistant],.research-assistant'));
+                }
+                catch {
+                    return { fatal: 'CSS 定位语法无效' };
+                }
+                if (a.source === 'element-count')
+                    value = String(elements.length);
+                else if (!elements.length && a.source === 'element-state' && a.operator === 'hidden')
+                    value = 'hidden';
+                else if (elements.length !== 1)
+                    return { actual: `匹配到 ${elements.length} 个元素，要求唯一元素`, matched: false };
+                else {
+                    const element = elements[0];
+                    if (a.source === 'element-state') {
+                        const rect = element.getBoundingClientRect();
+                        const style = getComputedStyle(element);
+                        value =
+                            rect.width > 0 &&
+                                rect.height > 0 &&
+                                style.visibility !== 'hidden' &&
+                                style.visibility !== 'collapse'
+                                ? 'visible'
+                                : 'hidden';
+                    }
+                    else if (a.source === 'element-value') {
+                        if (secret(element))
+                            return { fatal: '不读取敏感字段的值' };
+                        if (!element.matches('input,textarea,select'))
+                            return { fatal: '输入框值断言只支持 input、textarea、select' };
+                        value = element.value;
+                    }
+                    else
+                        value = element.innerText ?? element.textContent;
+                }
+            }
+            // Text follows rendered whitespace; input values stay exact, including spaces.
+            const expected = a.source === 'element-value' ? (a.expected ?? '') : normalize(a.expected);
+            const current = a.source === 'element-value' ? String(value) : normalize(value);
+            const equal = a.source === 'element-count' ? Number(current) === Number(expected) : current === expected;
+            const matched = a.operator === 'contains'
+                ? current.includes(expected)
+                : a.operator === 'not-contains'
+                    ? !current.includes(expected)
+                    : a.operator === 'equals'
+                        ? equal
+                        : a.operator === 'not-equals'
+                            ? !equal
+                            : current === a.operator;
+            return { actual: current.slice(0, 500), matched };
+        }, assertion);
+        actual = sample.fatal ?? sample.actual ?? '';
+        if (sample.fatal)
+            break;
+        if (sample.matched) {
+            stableSince ??= Date.now();
+            // Avoid accepting a transient match while a post-action view is settling.
+            if (Date.now() - stableSince >= 200) {
+                passed = true;
+                break;
+            }
+        }
+        else
+            stableSince = undefined;
+        await page.waitForTimeout(Math.min(100, Math.max(1, assertion.timeout - (Date.now() - started))));
+    }
+    return {
+        step,
+        name: assertion.name,
+        passed,
+        expected: `${names[assertion.operator]}${assertion.expected === undefined ? '' : ` ${assertion.expected === '' ? '空字符串' : assertion.expected}`}`,
+        actual: actual === 'visible' ? '可见' : actual === 'hidden' ? '不可见或不存在' : actual,
+        duration: Date.now() - started,
+    };
+}
+//# sourceMappingURL=assertions.js.map

package/dist/assertions.js.map

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

package/dist/browser.d.ts

@@ -0,0 +1,9 @@
+import { type LaunchOptions, type BrowserContextOptions } from 'playwright';
+export declare function openBrowser(options?: {
+    launch?: LaunchOptions;
+    context?: BrowserContextOptions;
+}): Promise<{
+    browser: import("playwright").Browser;
+    context: import("playwright").BrowserContext;
+    page: import("playwright").Page;
+}>;

package/dist/browser.js

@@ -0,0 +1,20 @@
+// Adapted from anthonyli/laya-pilot lib/browser-provider.mjs (MIT).
+import { chromium } from 'playwright';
+export async function openBrowser(options = {}) {
+    const browser = await chromium.launch(options.launch);
+    try {
+        const context = await browser.newContext({
+            viewport: { width: 1500, height: 980 },
+            locale: 'zh-CN',
+            ...options.context,
+        });
+        const page = await context.newPage();
+        page.setDefaultTimeout(10000);
+        return { browser, context, page };
+    }
+    catch (error) {
+        await browser.close();
+        throw error;
+    }
+}
+//# sourceMappingURL=browser.js.map

package/dist/browser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser.js","sourceRoot":"","sources":["../src/browser.ts"],"names":[],"mappings":"AAAA,oEAAoE;AACpE,OAAO,EAAE,QAAQ,EAAkD,MAAM,YAAY,CAAC;AACtF,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,UAAuE,EAAE;IAEzE,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IACtD,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,UAAU,CAAC;YACvC,QAAQ,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE;YACtC,MAAM,EAAE,OAAO;YACf,GAAG,OAAO,CAAC,OAAO;SACnB,CAAC,CAAC;QACH,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,OAAO,EAAE,CAAC;QACrC,IAAI,CAAC,iBAAiB,CAAC,KAAK,CAAC,CAAC;QAC9B,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IACpC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,OAAO,CAAC,KAAK,EAAE,CAAC;QACtB,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/decision.d.ts

@@ -0,0 +1,14 @@
+export interface Decision {
+    choice: string;
+    probabilities: Record<string, number>;
+    confidence: number | null;
+}
+export type Decide = (state: string, criteria: Record<string, string>) => Promise<Decision>;
+export declare function decodeDecision(body: unknown, criteria: Record<string, string>): Decision;
+export declare function createApiDecision(options: {
+    base: string;
+    model: string;
+    key: string;
+    timeout?: number;
+    fetchImpl?: typeof fetch;
+}): Decide;

package/dist/decision.js

@@ -0,0 +1,65 @@
+export function decodeDecision(body, criteria) {
+    const envelope = body;
+    let result;
+    try {
+        result = JSON.parse(envelope.choices[0].message.content).result.answers.scenario;
+    }
+    catch {
+        throw Error('模型没有返回有效的 Laya 决策 JSON');
+    }
+    const keys = Object.keys(criteria);
+    if (!result ||
+        !Object.hasOwn(criteria, result.choice) ||
+        !result.probabilities ||
+        Object.keys(result.probabilities).length !== keys.length ||
+        keys.some((key) => !Number.isFinite(result.probabilities[key]) ||
+            result.probabilities[key] < 0 ||
+            result.probabilities[key] > 1))
+        throw Error('模型返回了候选集合之外的选择或无效概率');
+    if (Math.abs(keys.reduce((sum, key) => sum + result.probabilities[key], 0) - 1) > 0.02 ||
+        keys.some((key) => result.probabilities[key] > result.probabilities[result.choice]))
+        throw Error('模型概率与选择不一致');
+    return {
+        choice: result.choice,
+        probabilities: result.probabilities,
+        confidence: Number.isFinite(result.confidence) ? result.confidence : null,
+    };
+}
+export function createApiDecision(options) {
+    const url = new URL(options.base);
+    if (url.protocol !== 'https:' || url.username || url.password || url.search || url.hash)
+        throw Error('API 地址必须是无凭据及查询参数的 HTTPS 地址');
+    if (!options.key.trim())
+        throw Error('缺少模型 API 密钥');
+    return async (state, criteria) => {
+        const response = await (options.fetchImpl ?? fetch)(url.href.replace(/\/$/, '') + '/chat/completions', {
+            method: 'POST',
+            redirect: 'error',
+            signal: AbortSignal.timeout(options.timeout ?? 30000),
+            headers: { Authorization: `Bearer ${options.key}`, 'Content-Type': 'application/json' },
+            body: JSON.stringify({
+                model: options.model,
+                stream: false,
+                messages: [
+                    {
+                        role: 'system',
+                        content: '你是浏览器测试决策器。只返回 JSON：{"result":{"answers":{"scenario":{"choice":"候选原文","probabilities":{"每个候选":0.0},"confidence":0.0}}}}。choice 必须属于 criteria，概率覆盖全部候选且和为1，所选概率最大。证据不足选择停止，不编造确定性。',
+                    },
+                    {
+                        role: 'user',
+                        content: JSON.stringify({
+                            state,
+                            questions: {
+                                scenario: { type: 'choice', instructions: '用户请求对应哪个操作？', criteria },
+                            },
+                        }),
+                    },
+                ],
+            }),
+        });
+        if (!response.ok)
+            throw Error(`模型 API 返回 HTTP ${response.status}`);
+        return decodeDecision(await response.json(), criteria);
+    };
+}
+//# sourceMappingURL=decision.js.map

package/dist/decision.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+export * from './schema.js';
+export { runCase, type ReplayOptions } from './replay.js';
+export { runAssertion } from './assertions.js';
+export { openBrowser } from './browser.js';
+export { waitForReady } from './readiness.js';
+export { createApiDecision, decodeDecision, type Decision, type Decide } from './decision.js';
+export { chooseStep } from './planner.js';

package/dist/index.js

@@ -0,0 +1,8 @@
+export * from './schema.js';
+export { runCase } from './replay.js';
+export { runAssertion } from './assertions.js';
+export { openBrowser } from './browser.js';
+export { waitForReady } from './readiness.js';
+export { createApiDecision, decodeDecision } from './decision.js';
+export { chooseStep } from './planner.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,OAAO,EAAE,OAAO,EAAsB,MAAM,aAAa,CAAC;AAC1D,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,iBAAiB,EAAE,cAAc,EAA8B,MAAM,eAAe,CAAC;AAC9F,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC"}

package/dist/planner.d.ts

@@ -0,0 +1,7 @@
+import type { Decide } from './decision.js';
+import type { Step } from './schema.js';
+/** A model selects from observed, host-provided candidates. It never generates executable code. */
+export declare function chooseStep(instruction: string, candidates: {
+    description: string;
+    step: Step;
+}[], decide: Decide): Promise<Step | null>;

package/dist/planner.js

@@ -0,0 +1,19 @@
+/** A model selects from observed, host-provided candidates. It never generates executable code. */
+export async function chooseStep(instruction, candidates, decide) {
+    if (candidates.length < 1 || candidates.length > 7)
+        throw Error('每次提供 1–7 个可观察的候选操作');
+    const criteria = Object.fromEntries(candidates.map((candidate, index) => [String(index), candidate.description]));
+    criteria.stop = '无法判断，停止并由用户确认';
+    const result = await decide(instruction, criteria);
+    if (result.choice === 'stop')
+        return null;
+    const index = Number(result.choice);
+    if (!Number.isInteger(index) || !Object.hasOwn(criteria, result.choice) || !candidates[index])
+        throw Error('模型选择不属于候选集');
+    const probabilities = Object.values(result.probabilities).sort((a, b) => b - a);
+    if ((result.probabilities[result.choice] ?? 0) < 0.7 ||
+        probabilities[0] - (probabilities[1] ?? 0) < 0.15)
+        return null;
+    return structuredClone(candidates[index].step);
+}
+//# sourceMappingURL=planner.js.map

package/dist/planner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"planner.js","sourceRoot":"","sources":["../src/planner.ts"],"names":[],"mappings":"AAGA,mGAAmG;AACnG,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,WAAmB,EACnB,UAAiD,EACjD,MAAc;IAEd,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC;QAChD,MAAM,KAAK,CAAC,oBAAoB,CAAC,CAAC;IACpC,MAAM,QAAQ,GAAG,MAAM,CAAC,WAAW,CACjC,UAAU,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,SAAS,CAAC,WAAW,CAAC,CAAC,CAC7E,CAAC;IACF,QAAQ,CAAC,IAAI,GAAG,eAAe,CAAC;IAChC,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;IACnD,IAAI,MAAM,CAAC,MAAM,KAAK,MAAM;QAAE,OAAO,IAAI,CAAC;IAC1C,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IACpC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC;QAC3F,MAAM,KAAK,CAAC,YAAY,CAAC,CAAC;IAC5B,MAAM,aAAa,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IAChF,IACE,CAAC,MAAM,CAAC,aAAa,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,GAAG,GAAG;QAChD,aAAa,CAAC,CAAC,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,IAAI;QAEjD,OAAO,IAAI,CAAC;IACd,OAAO,eAAe,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC;AACjD,CAAC"}

package/dist/readiness.d.ts

@@ -0,0 +1,16 @@
+import type { Page } from 'playwright';
+type Failure = {
+    status: number;
+    path: string;
+    resourceType: string;
+};
+type ReadyOptions = {
+    timeout?: number;
+    minimum?: number;
+    failures?: () => Failure[];
+};
+export declare function waitForReady(page: Page, { timeout, minimum, failures }?: ReadyOptions): Promise<{
+    duration_ms: number;
+    controls: number;
+}>;
+export {};

package/dist/readiness.js

@@ -0,0 +1,65 @@
+// Wait for the application, not merely the outer document's DOMContentLoaded.
+export async function waitForReady(page, { timeout = 18000, minimum = 600, failures = () => [] } = {}) {
+    const start = Date.now();
+    let stableSince = Date.now(), previous = '', last;
+    while (Date.now() - start < timeout) {
+        const errors = failures().filter((x) => x.status >= 500 && (/\.html?$|\.js$|\.css$/i.test(x.path) || x.resourceType === 'document'));
+        const states = [];
+        for (const frame of page.frames())
+            try {
+                states.push(await frame.evaluate(() => {
+                    const visible = (e) => {
+                        const r = e.getBoundingClientRect(), s = getComputedStyle(e);
+                        return (r.width > 0 &&
+                            r.height > 0 &&
+                            s.display !== 'none' &&
+                            s.visibility !== 'hidden' &&
+                            !e.closest('[aria-hidden="true"],[inert]'));
+                    };
+                    const body = document.body;
+                    if (!body)
+                        return { controls: 0, busy: true, text: '' };
+                    const text = body.innerText.trim(), controls = [
+                        ...document.querySelectorAll('button,input:not([type=hidden]),select,textarea,a[href],[role=tab],[role=combobox],[role=menuitem]'),
+                    ].filter(visible);
+                    const loading = [
+                        ...document.querySelectorAll('[aria-busy=true],.ant-spin-spinning,.el-loading-mask,[role=progressbar]'),
+                    ].some(visible) ||
+                        text
+                            .split('\n')
+                            .some((x) => /^(?:loading\.{0,3}|加载中[.。…]*|正在加载[.。…]*)$/i.test(x.trim()));
+                    return {
+                        controls: controls.length,
+                        busy: loading,
+                        text: text.slice(0, 240),
+                        signature: controls
+                            .slice(0, 60)
+                            .map((x) => [
+                            x.getAttribute('role'),
+                            x.tagName,
+                            x.getAttribute('placeholder'),
+                            x.getAttribute('aria-label'),
+                            x.textContent?.trim().slice(0, 25),
+                        ].join(':'))
+                            .join('|'),
+                    };
+                }));
+            }
+            catch { /* A frame can detach while the page is settling. */ }
+        const count = states.reduce((n, s) => n + s.controls, 0), busy = states.some((s) => s.busy), fingerprint = states.map((s) => s.signature || '').join('|');
+        last = { count, busy };
+        // A shell may preload unrelated microfrontends. Their errors must not block
+        // an already usable page; only correlate critical errors with an unready UI.
+        if (errors.length && (busy || count === 0))
+            throw new Error(errors.map((x) => x.path + ' HTTP ' + x.status).join('；'));
+        if (fingerprint !== previous || busy || count === 0) {
+            previous = fingerprint;
+            stableSince = Date.now();
+        }
+        if (count > 0 && !busy && Date.now() - stableSince >= minimum)
+            return { duration_ms: Date.now() - start, controls: count };
+        await page.waitForTimeout(150);
+    }
+    throw new Error(`等待${timeout}ms后页面仍为空白或加载中（控件${last?.count || 0}，loading=${last?.busy}），停止本次会话，不继续刷新后续用例`);
+}
+//# sourceMappingURL=readiness.js.map

package/dist/readiness.js.map

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

package/dist/replay.d.ts

@@ -0,0 +1,15 @@
+import type { Page, BrowserContext, LaunchOptions, BrowserContextOptions } from 'playwright';
+import { type RunStatus } from './schema.js';
+export interface ReplayOptions {
+    origin: string;
+    allowedOrigins?: string[];
+    launch?: LaunchOptions;
+    context?: BrowserContextOptions;
+    delay?: number;
+    signal?: AbortSignal;
+    /** Host-owned login/setup, never serialized into a case or exposed to the browser. */
+    beforeRun?: (page: Page, context: BrowserContext) => Promise<void>;
+    onProgress?: (status: RunStatus) => void;
+}
+/** Functions compose the execution path. No business route, login or data fixture is built in. */
+export declare function runCase(value: unknown, options: ReplayOptions): Promise<RunStatus>;