@pyrokine/mcp-chrome 2.1.0 → 2.3.0

package/dist/tools/post-condition.js

@@ -0,0 +1,154 @@
+import { z } from 'zod';
+const POST_CONDITION_DEFAULT_TIMEOUT_MS = 3000;
+const POST_CONDITION_MAX_TIMEOUT_MS = 60_000;
+const POST_CONDITION_DEFAULT_INTERVAL_MS = 100;
+const POST_CONDITION_MIN_INTERVAL_MS = 50;
+const POST_CONDITION_MAX_INTERVAL_MS = 5000;
+export const postConditionSchema = z
+    .object({
+    text: z.string().optional().describe('等待页面文本包含该内容'),
+    selector: z.string().optional().describe('等待 CSS selector 至少匹配一个元素'),
+    urlIncludes: z.string().optional().describe('等待当前 URL 包含该字符串'),
+    script: z.string().optional().describe('等待 JavaScript 表达式或函数返回 truthy'),
+    exact: z.boolean().optional().describe('text 使用精确匹配，默认 false'),
+    timeout: z
+        .number()
+        .int()
+        .positive()
+        .max(POST_CONDITION_MAX_TIMEOUT_MS)
+        .optional()
+        .describe('等待超时毫秒，默认 3000，最大 60000'),
+    interval: z
+        .number()
+        .int()
+        .min(POST_CONDITION_MIN_INTERVAL_MS)
+        .max(POST_CONDITION_MAX_INTERVAL_MS)
+        .optional()
+        .describe('轮询间隔毫秒，默认 100，范围 50-5000'),
+})
+    .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));
+}
+async function checkPostCondition(unifiedSession, condition, remainingTimeout) {
+    const checks = [];
+    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 = (sample, truncated) => ({
+                    actual: truncated ? sample.slice(0, sampleLimit) + '...' : sample,
+                    truncated,
+                })
+                if (!body) {
+                    return { matched: false, actual: '', truncated: false }
+                }
+                if (exact) {
+                    const text = body.textContent || ''
+                    const sample = text.slice(0, sampleLimit)
+                    return { matched: text === expected, ...formatSample(sample, text.length > sampleLimit) }
+                }
+
+                const walker = document.createTreeWalker(body, NodeFilter.SHOW_TEXT)
+                let node = walker.nextNode()
+                let carry = ''
+                let sample = ''
+                let total = 0
+                const carryLength = Math.max(0, expected.length - 1)
+                while (node) {
+                    const value = node.nodeValue || ''
+                    sample = appendSample(sample, value)
+                    total += value.length
+                    const searchable = carry + value
+                    if (searchable.includes(expected)) {
+                        return { matched: true, ...formatSample(sample, total > sampleLimit) }
+                    }
+                    carry = carryLength > 0 ? searchable.slice(-carryLength) : ''
+                    node = walker.nextNode()
+                }
+                return { matched: false, ...formatSample(sample, total > sampleLimit) }
+            }`, undefined, Math.max(1, remainingTimeout), [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, Math.max(1, remainingTimeout), [condition.selector]);
+        checks.push({ name: 'selector', matched: count > 0, actual: { count } });
+    }
+    if (condition.urlIncludes !== undefined) {
+        const url = await unifiedSession.evaluate('location.href', undefined, Math.max(1, remainingTimeout));
+        checks.push({ name: 'urlIncludes', matched: url.includes(condition.urlIncludes), actual: url });
+    }
+    if (condition.script !== undefined) {
+        const value = await unifiedSession.evaluate(condition.script, undefined, Math.max(1, remainingTimeout));
+        checks.push({ name: 'script', matched: Boolean(value), actual: value });
+    }
+    return checks;
+}
+export async function waitForPostCondition(unifiedSession, condition, operation) {
+    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;
+    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)) {
+                return {
+                    matched: true,
+                    operation,
+                    elapsedMs: Date.now() - startedAt,
+                    checks: lastChecks,
+                };
+            }
+        }
+        catch (error) {
+            lastError = error instanceof Error ? error.message : String(error);
+        }
+        const waitMs = Math.min(interval, remainingMs(timeout, startedAt));
+        if (waitMs <= 0) {
+            break;
+        }
+        await sleep(waitMs);
+    }
+    throw new PostConditionError({
+        operation,
+        timeout,
+        checks: lastChecks,
+        lastError,
+    });
+}
+//# sourceMappingURL=post-condition.js.map

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

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

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@pyrokine/mcp-chrome",
-    "version": "2.1.0",
+    "version": "2.3.0",
     "description": "Chrome browser automation MCP Server using Chrome DevTools Protocol",
     "main": "dist/index.js",
     "type": "module",
@@ -31,12 +31,12 @@
     },
     "devDependencies": {
         "@eslint/js": "^10.0.1",
-        "@types/node": "^25.9.1",
+        "@types/node": "^25.9.3",
         "@types/ws": "^8.18.1",
-        "eslint": "^10.4.0",
-        "prettier": "^3.8.3",
+        "eslint": "^10.5.0",
+        "prettier": "^3.8.4",
         "typescript": "^6.0.3",
-        "typescript-eslint": "^8.60.0"
+        "typescript-eslint": "^8.61.0"
     },
     "engines": {
         "node": ">=18"
@@ -45,6 +45,9 @@
         "mcp-chrome": "dist/index.js"
     },
     "files": [
-        "dist"
+        "dist",
+        "README.md",
+        "README_zh.md",
+        "LICENSE"
     ]
 }