@pyrokine/mcp-chrome 2.3.2 → 2.4.1

package/dist/tools/post-condition.js

@@ -1,4 +1,5 @@
 import { z } from 'zod';
+import { sanitizeErrorMessage } from '../core/error-sanitizer.js';
 const POST_CONDITION_DEFAULT_TIMEOUT_MS = 3000;
 const POST_CONDITION_MAX_TIMEOUT_MS = 60_000;
 const POST_CONDITION_DEFAULT_INTERVAL_MS = 100;
@@ -29,138 +30,95 @@ export const postConditionSchema = z
     .refine((value) => value.text || value.selector || value.urlIncludes || value.script, {
     message: 'postCondition 至少需要 text、selector、urlIncludes、script 之一',
 });
-class PostConditionError extends Error {
-    context;
-    code = 'POST_CONDITION_FAILED';
-    suggestion = '工具动作已执行，但 postCondition 未满足。请检查页面状态、异步业务流程或放宽 postCondition 条件';
-    constructor(context) {
-        super('postCondition 未满足，工具动作不能证明业务目标已经达成');
-        this.context = context;
-        this.name = 'PostConditionError';
-    }
-    toJSON() {
-        return {
-            error: {
-                code: this.code,
-                message: this.message,
-                suggestion: this.suggestion,
-                context: this.context,
-            },
-        };
-    }
-}
 function sleep(ms) {
     return new Promise((resolve) => setTimeout(resolve, ms));
 }
 function remainingMs(timeout, startedAt) {
     return Math.max(0, timeout - (Date.now() - startedAt));
 }
-function nextCheckTimeout(timeout, startedAt) {
-    const remaining = remainingMs(timeout, startedAt);
-    if (remaining <= 0) {
-        throw new Error('postCondition 检查超时');
-    }
-    return Math.max(1, remaining);
+function isUnavailableError(message) {
+    return /frame|execution context|debugger|extension.*(?:disconnect|未连接)|not connected|cannot resolve cdp|failed to attach|restricted|cannot access/i.test(message);
 }
-async function checkPostCondition(unifiedSession, condition, remainingTimeout) {
+function boundedError(error) {
+    return sanitizeErrorMessage(error instanceof Error ? error.message : String(error)).slice(0, 500);
+}
+async function checkPostCondition(unifiedSession, condition, timeout, mode) {
     const checks = [];
-    const checkStartedAt = Date.now();
+    const startedAt = Date.now();
+    const nextTimeout = () => Math.max(1, remainingMs(timeout, startedAt));
     if (condition.text !== undefined) {
         const result = await unifiedSession.evaluate(`(expected, exact) => {
                 const body = document.body
-                const sampleLimit = 500
-                const appendSample = (sample, value) =>
-                    sample.length >= sampleLimit ? sample : sample + value.slice(0, sampleLimit - sample.length)
-                const formatSample = (text) => ({
-                    actual: text.length > sampleLimit ? text.slice(0, sampleLimit) + '...' : text,
-                    truncated: text.length > sampleLimit,
-                })
-                if (!body) {
-                    return { matched: false, actual: '', truncated: false }
-                }
-
-                const values = Array.from(body.querySelectorAll('input, textarea, select')).map((element) => {
-                    if (element instanceof HTMLSelectElement) {
-                        return Array.from(element.selectedOptions)
-                            .map((option) => option.value || option.textContent || '')
-                            .join(' ')
-                    }
-                    if (element instanceof HTMLInputElement || element instanceof HTMLTextAreaElement) {
-                        return element.value || ''
-                    }
-                    return ''
-                })
-                const bodyText = body.textContent || ''
-                if (exact) {
-                    const matched = bodyText === expected || values.some((value) => value === expected)
-                    return { matched, ...formatSample([bodyText, ...values].join('\\n')) }
-                }
-
-                const walker = document.createTreeWalker(body, NodeFilter.SHOW_TEXT)
-                const segments = []
-                let node = walker.nextNode()
-                while (node) {
-                    segments.push(node.nodeValue || '')
-                    node = walker.nextNode()
-                }
-                segments.push(...values)
-                const text = segments.join('\\n')
-                return { matched: text.includes(expected), ...formatSample(text) }
-            }`, undefined, nextCheckTimeout(remainingTimeout, checkStartedAt), [condition.text, condition.exact === true]);
-        checks.push({
-            name: 'text',
-            matched: result.matched,
-            actual: result.actual,
-        });
+                if (!body) return { matched: false, actual: '' }
+                const values = Array.from(body.querySelectorAll('input, textarea, select')).map((element) =>
+                    element instanceof HTMLSelectElement
+                        ? Array.from(element.selectedOptions).map((option) => option.value || option.textContent || '').join(' ')
+                        : element instanceof HTMLInputElement && element.type === 'password'
+                          ? ''
+                          : element instanceof HTMLInputElement || element instanceof HTMLTextAreaElement
+                            ? element.value || ''
+                            : '')
+                const text = [body.textContent || '', ...values].join('\\n')
+                return { matched: exact ? [body.textContent || '', ...values].some((value) => value === expected) : text.includes(expected), actual: text.slice(0, 500) }
+            }`, mode, nextTimeout(), [condition.text, condition.exact === true]);
+        checks.push({ name: 'text', matched: result.matched, actual: result.actual });
     }
     if (condition.selector !== undefined) {
-        const count = await unifiedSession.evaluate('(selector) => document.querySelectorAll(selector).length', undefined, nextCheckTimeout(remainingTimeout, checkStartedAt), [condition.selector]);
+        const count = await unifiedSession.evaluate('(selector) => document.querySelectorAll(selector).length', mode, nextTimeout(), [condition.selector]);
         checks.push({ name: 'selector', matched: count > 0, actual: { count } });
     }
     if (condition.urlIncludes !== undefined) {
-        const url = await unifiedSession.evaluate('location.href', undefined, nextCheckTimeout(remainingTimeout, checkStartedAt));
-        checks.push({ name: 'urlIncludes', matched: url.includes(condition.urlIncludes), actual: url });
+        const url = await unifiedSession.evaluate('location.href', mode, nextTimeout());
+        checks.push({ name: 'urlIncludes', matched: url.includes(condition.urlIncludes), actual: url.slice(0, 500) });
     }
     if (condition.script !== undefined) {
-        const value = await unifiedSession.evaluate(condition.script, undefined, nextCheckTimeout(remainingTimeout, checkStartedAt));
+        const value = await unifiedSession.evaluate(condition.script, mode, nextTimeout());
         checks.push({ name: 'script', matched: Boolean(value), actual: value });
     }
     return checks;
 }
-export async function waitForPostCondition(unifiedSession, condition, operation) {
+export async function waitForPostCondition(unifiedSession, condition, operation, mode) {
     const timeout = condition.timeout ?? POST_CONDITION_DEFAULT_TIMEOUT_MS;
     const interval = condition.interval ?? POST_CONDITION_DEFAULT_INTERVAL_MS;
     const startedAt = Date.now();
-    let lastChecks = [];
-    let lastError;
+    let checks = [];
     while (remainingMs(timeout, startedAt) > 0) {
         try {
-            const checkTimeout = Math.max(1, Math.min(interval, remainingMs(timeout, startedAt)));
-            lastChecks = await checkPostCondition(unifiedSession, condition, checkTimeout);
-            lastError = undefined;
-            if (lastChecks.every((check) => check.matched)) {
+            checks = await checkPostCondition(unifiedSession, condition, Math.max(1, remainingMs(timeout, startedAt)), mode);
+            if (checks.every((check) => check.matched)) {
                 return {
                     matched: true,
+                    verificationStatus: 'matched',
                     operation,
                     elapsedMs: Date.now() - startedAt,
-                    checks: lastChecks,
+                    checks,
+                    retryable: false,
                 };
             }
         }
         catch (error) {
-            lastError = error instanceof Error ? error.message : String(error);
+            const message = boundedError(error);
+            return {
+                matched: false,
+                verificationStatus: isUnavailableError(message) ? 'unavailable' : 'error',
+                operation,
+                elapsedMs: Date.now() - startedAt,
+                checks,
+                retryable: isUnavailableError(message),
+                error: message,
+            };
         }
         const waitMs = Math.min(interval, remainingMs(timeout, startedAt));
-        if (waitMs <= 0) {
-            break;
-        }
-        await sleep(waitMs);
+        if (waitMs > 0)
+            await sleep(waitMs);
     }
-    throw new PostConditionError({
+    return {
+        matched: false,
+        verificationStatus: 'not_matched',
         operation,
-        timeout,
-        checks: lastChecks,
-        lastError,
-    });
+        elapsedMs: Date.now() - startedAt,
+        checks,
+        retryable: true,
+    };
 }
 //# sourceMappingURL=post-condition.js.map

package/dist/tools/post-condition.js.map

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

package/dist/tools/target-diagnostics.d.ts

@@ -0,0 +1,31 @@
+import { getUnifiedSession } from '../core/index.js';
+import type { Target } from '../core/types.js';
+export interface TargetCandidate {
+    tag?: string;
+    text?: string;
+    rect?: {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    };
+    [key: string]: unknown;
+}
+export declare class TargetTimeoutError extends Error {
+    readonly context: Record<string, unknown>;
+    readonly code = "TARGET_TIMEOUT";
+    readonly suggestion = "\u8BF7\u68C0\u67E5 locator\u3001frame \u548C nth\uFF0C\u6216\u6839\u636E\u5019\u9009\u6458\u8981\u8C03\u6574\u76EE\u6807\uFF1B\u8FDE\u63A5\u4E0D\u53EF\u7528\u65F6\u5148\u6062\u590D Extension";
+    constructor(context: Record<string, unknown>);
+    toJSON(): object;
+}
+export declare function summarizeTargetCandidates(candidates: TargetCandidate[]): Array<Record<string, unknown>>;
+export declare function buildTargetDiagnostics(unifiedSession: ReturnType<typeof getUnifiedSession>, target: Target, options: {
+    nth: number;
+    timeout?: number;
+    frame?: string | number;
+    matchCount: number;
+    lastState: string;
+    lastError?: unknown;
+    candidates?: TargetCandidate[];
+}): Promise<Record<string, unknown>>;
+//# sourceMappingURL=target-diagnostics.d.ts.map

package/dist/tools/target-diagnostics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"target-diagnostics.d.ts","sourceRoot":"","sources":["../../src/tools/target-diagnostics.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAA;AACpD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAA;AAO9C,MAAM,WAAW,eAAe;IAC5B,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,IAAI,CAAC,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAA;IAC9D,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CACzB;AAED,qBAAa,kBAAmB,SAAQ,KAAK;IAI7B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAHrD,QAAQ,CAAC,IAAI,oBAAmB;IAChC,QAAQ,CAAC,UAAU,oMAA4D;IAE/E,YAAqB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAGpD;IAED,MAAM,IAAI,MAAM,CAEf;CACJ;AAeD,wBAAgB,yBAAyB,CAAC,UAAU,EAAE,eAAe,EAAE,GAAG,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAMvG;AAmCD,wBAAsB,sBAAsB,CACxC,cAAc,EAAE,UAAU,CAAC,OAAO,iBAAiB,CAAC,EACpD,MAAM,EAAE,MAAM,EACd,OAAO,EAAE;IACL,GAAG,EAAE,MAAM,CAAA;IACX,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;IACvB,UAAU,EAAE,MAAM,CAAA;IAClB,SAAS,EAAE,MAAM,CAAA;IACjB,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,UAAU,CAAC,EAAE,eAAe,EAAE,CAAA;CACjC,GACF,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CA8BlC"}

package/dist/tools/target-diagnostics.js

@@ -0,0 +1,91 @@
+import { sanitizeErrorMessage } from '../core/error-sanitizer.js';
+const MAX_CANDIDATES = 10;
+const MAX_LOCATOR_TEXT = 500;
+const MAX_CANDIDATE_TEXT = 160;
+const MAX_DIAGNOSTIC_TIMEOUT_MS = 1000;
+export class TargetTimeoutError extends Error {
+    context;
+    code = 'TARGET_TIMEOUT';
+    suggestion = '请检查 locator、frame 和 nth，或根据候选摘要调整目标；连接不可用时先恢复 Extension';
+    constructor(context) {
+        super(`等待目标元素超时 (${context.timeout}ms)`);
+        this.context = context;
+        this.name = 'TargetTimeoutError';
+    }
+    toJSON() {
+        return { error: { code: this.code, message: this.message, suggestion: this.suggestion, context: this.context } };
+    }
+}
+function targetType(target) {
+    return Object.keys(target).find((key) => key !== 'nth') ?? 'unknown';
+}
+function boundedTarget(target) {
+    return Object.fromEntries(Object.entries(target).map(([key, value]) => [
+        key,
+        typeof value === 'string' ? value.slice(0, MAX_LOCATOR_TEXT) : value,
+    ]));
+}
+export function summarizeTargetCandidates(candidates) {
+    return candidates.slice(0, MAX_CANDIDATES).map((candidate) => ({
+        ...(typeof candidate.tag === 'string' ? { tag: candidate.tag.slice(0, 40) } : {}),
+        ...(typeof candidate.text === 'string' ? { text: candidate.text.slice(0, MAX_CANDIDATE_TEXT) } : {}),
+        ...(candidate.rect ? { rect: candidate.rect } : {}),
+    }));
+}
+async function collectPageCandidates(unifiedSession, timeout) {
+    try {
+        const candidates = await unifiedSession.evaluate(`(() => Array.from(document.querySelectorAll('input, textarea, select, button, a, [role], [contenteditable="true"]'))
+                .slice(0, ${MAX_CANDIDATES})
+                .map((el) => {
+                    const rect = el.getBoundingClientRect();
+                    return {
+                        tag: el.tagName.toLowerCase(),
+                        id: el.id || undefined,
+                        role: el.getAttribute('role') || undefined,
+                        label: (el.getAttribute('aria-label') || el.getAttribute('placeholder') || '').slice(0, 80),
+                        text: (el.textContent || '').replace(/\\s+/g, ' ').trim().slice(0, ${MAX_CANDIDATE_TEXT}),
+                        visible: rect.width > 0 && rect.height > 0,
+                        disabled: Boolean(el.disabled) || el.getAttribute('aria-disabled') === 'true',
+                        bounds: {x: rect.x, y: rect.y, width: rect.width, height: rect.height}
+                    };
+                }))()`, undefined, Math.min(Math.max(timeout ?? MAX_DIAGNOSTIC_TIMEOUT_MS, 1), MAX_DIAGNOSTIC_TIMEOUT_MS));
+        return { candidates };
+    }
+    catch (error) {
+        return {
+            candidates: [],
+            diagnosticError: sanitizeErrorMessage(error).slice(0, 500),
+        };
+    }
+}
+export async function buildTargetDiagnostics(unifiedSession, target, options) {
+    let state;
+    try {
+        state = await unifiedSession.getLiveState();
+    }
+    catch {
+        state = null;
+    }
+    const knownCandidates = options.candidates ? summarizeTargetCandidates(options.candidates) : [];
+    const pageCandidates = knownCandidates.length > 0
+        ? { candidates: knownCandidates }
+        : await collectPageCandidates(unifiedSession, options.timeout);
+    return {
+        locator: boundedTarget(target),
+        targetType: targetType(target),
+        nth: options.nth,
+        currentUrl: state?.url?.slice(0, 500),
+        tabId: unifiedSession.getCurrentTargetId(),
+        managed: state?.managed ?? false,
+        frame: options.frame,
+        matchCount: options.matchCount,
+        candidates: pageCandidates.candidates,
+        lastLocatorState: options.lastState,
+        timeout: options.timeout,
+        mode: unifiedSession.getMode(),
+        connection: unifiedSession.isExtensionConnected() ? 'connected' : 'unavailable',
+        ...(options.lastError ? { lastError: sanitizeErrorMessage(options.lastError).slice(0, 500) } : {}),
+        ...(pageCandidates.diagnosticError ? { diagnosticError: pageCandidates.diagnosticError } : {}),
+    };
+}
+//# sourceMappingURL=target-diagnostics.js.map

package/dist/tools/target-diagnostics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"target-diagnostics.js","sourceRoot":"","sources":["../../src/tools/target-diagnostics.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAA;AAIjE,MAAM,cAAc,GAAG,EAAE,CAAA;AACzB,MAAM,gBAAgB,GAAG,GAAG,CAAA;AAC5B,MAAM,kBAAkB,GAAG,GAAG,CAAA;AAC9B,MAAM,yBAAyB,GAAG,IAAI,CAAA;AAStC,MAAM,OAAO,kBAAmB,SAAQ,KAAK;IAIpB,OAAO;IAHnB,IAAI,GAAG,gBAAgB,CAAA;IACvB,UAAU,GAAG,yDAAyD,CAAA;IAE/E,YAAqB,OAAgC;QACjD,KAAK,CAAC,aAAa,OAAO,CAAC,OAAO,KAAK,CAAC,CAAA;uBADvB,OAAO;QAExB,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAA;IACpC,CAAC;IAED,MAAM;QACF,OAAO,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,UAAU,EAAE,IAAI,CAAC,UAAU,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,EAAE,CAAA;IACpH,CAAC;CACJ;AAED,SAAS,UAAU,CAAC,MAAc;IAC9B,OAAO,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,KAAK,KAAK,CAAC,IAAI,SAAS,CAAA;AACxE,CAAC;AAED,SAAS,aAAa,CAAC,MAAc;IACjC,OAAO,MAAM,CAAC,WAAW,CACrB,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC;QACzC,GAAG;QACH,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,gBAAgB,CAAC,CAAC,CAAC,CAAC,KAAK;KACvE,CAAC,CACL,CAAA;AACL,CAAC;AAED,MAAM,UAAU,yBAAyB,CAAC,UAA6B;IACnE,OAAO,UAAU,CAAC,KAAK,CAAC,CAAC,EAAE,cAAc,CAAC,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;QAC3D,GAAG,CAAC,OAAO,SAAS,CAAC,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACjF,GAAG,CAAC,OAAO,SAAS,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,kBAAkB,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACpG,GAAG,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,SAAS,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACtD,CAAC,CAAC,CAAA;AACP,CAAC;AAED,KAAK,UAAU,qBAAqB,CAChC,cAAoD,EACpD,OAA2B;IAE3B,IAAI,CAAC;QACD,MAAM,UAAU,GAAG,MAAM,cAAc,CAAC,QAAQ,CAC5C;4BACgB,cAAc;;;;;;;;6FAQmD,kBAAkB;;;;;sBAKzF,EACV,SAAS,EACT,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,IAAI,yBAAyB,EAAE,CAAC,CAAC,EAAE,yBAAyB,CAAC,CACzF,CAAA;QACD,OAAO,EAAE,UAAU,EAAE,CAAA;IACzB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACb,OAAO;YACH,UAAU,EAAE,EAAE;YACd,eAAe,EAAE,oBAAoB,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC;SAC7D,CAAA;IACL,CAAC;AACL,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,sBAAsB,CACxC,cAAoD,EACpD,MAAc,EACd,OAQC;IAED,IAAI,KAA8D,CAAA;IAClE,IAAI,CAAC;QACD,KAAK,GAAG,MAAM,cAAc,CAAC,YAAY,EAAE,CAAA;IAC/C,CAAC;IAAC,MAAM,CAAC;QACL,KAAK,GAAG,IAAI,CAAA;IAChB,CAAC;IACD,MAAM,eAAe,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,yBAAyB,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,EAAE,CAAA;IAC/F,MAAM,cAAc,GAChB,eAAe,CAAC,MAAM,GAAG,CAAC;QACtB,CAAC,CAAC,EAAE,UAAU,EAAE,eAAe,EAAE;QACjC,CAAC,CAAC,MAAM,qBAAqB,CAAC,cAAc,EAAE,OAAO,CAAC,OAAO,CAAC,CAAA;IAEtE,OAAO;QACH,OAAO,EAAE,aAAa,CAAC,MAAM,CAAC;QAC9B,UAAU,EAAE,UAAU,CAAC,MAAM,CAAC;QAC9B,GAAG,EAAE,OAAO,CAAC,GAAG;QAChB,UAAU,EAAE,KAAK,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC;QACrC,KAAK,EAAE,cAAc,CAAC,kBAAkB,EAAE;QAC1C,OAAO,EAAE,KAAK,EAAE,OAAO,IAAI,KAAK;QAChC,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,UAAU,EAAE,OAAO,CAAC,UAAU;QAC9B,UAAU,EAAE,cAAc,CAAC,UAAU;QACrC,gBAAgB,EAAE,OAAO,CAAC,SAAS;QACnC,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,IAAI,EAAE,cAAc,CAAC,OAAO,EAAE;QAC9B,UAAU,EAAE,cAAc,CAAC,oBAAoB,EAAE,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,aAAa;QAC/E,GAAG,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,oBAAoB,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAClG,GAAG,CAAC,cAAc,CAAC,eAAe,CAAC,CAAC,CAAC,EAAE,eAAe,EAAE,cAAc,CAAC,eAAe,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACjG,CAAA;AACL,CAAC"}

package/dist/tools/wait.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"wait.d.ts","sourceRoot":"","sources":["../../src/tools/wait.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AAwoBxE;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CASxD"}
+{"version":3,"file":"wait.d.ts","sourceRoot":"","sources":["../../src/tools/wait.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AA4lBxE;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CASxD"}