ai-browser 0.2.0 → 0.2.2

package/dist/task/tool-actions.d.ts

@@ -0,0 +1,114 @@
+import type { ToolContext } from './tool-context.js';
+export interface NavigateResult {
+    success: boolean;
+    partial: boolean;
+    statusCode?: number;
+    page: {
+        url: string;
+        title: string;
+    };
+    dialog?: any;
+}
+export interface StabilityResult {
+    stable: boolean;
+    domStable: boolean;
+    networkPending: number;
+    loadState: string;
+}
+export interface PageInfoResult {
+    page: {
+        url: string;
+        title: string;
+        type: string;
+        summary: string;
+    };
+    elements: any[];
+    totalElements: number;
+    truncated: boolean;
+    regions: any[];
+    intents: any[];
+    stability?: any;
+    pendingDialog?: any;
+}
+export interface PageContentResult {
+    sections: any[];
+    [key: string]: any;
+}
+export interface CreateTabResult {
+    tabId: string;
+    url: string;
+    partial: boolean;
+}
+export interface FindElementResult {
+    query: string;
+    candidates: Array<{
+        id: string;
+        label: string;
+        type: string;
+        score: number;
+        matchReason: string;
+    }>;
+}
+export interface ClickResult {
+    success: boolean;
+    page: {
+        url: string;
+        title: string;
+    };
+    newTabCreated?: string;
+    dialog?: any;
+}
+export interface TypeTextResult {
+    success: boolean;
+    page: {
+        url: string;
+        title: string;
+    };
+}
+export interface PressKeyResult {
+    success: boolean;
+    page: {
+        url: string;
+        title: string;
+    };
+}
+export interface WaitResult {
+    success: boolean;
+}
+/** 导航到指定 URL（操作 active tab） */
+export declare function navigate(ctx: ToolContext, sessionId: string, url: string): Promise<NavigateResult>;
+/** 等待页面 DOM 稳定（支持显式 tabId） */
+export declare function waitForStable(ctx: ToolContext, sessionId: string, tabId: string, opts?: {
+    timeout?: number;
+    quietMs?: number;
+}): Promise<StabilityResult>;
+/** 获取页面语义信息（支持显式 tabId） */
+export declare function getPageInfo(ctx: ToolContext, sessionId: string, tabId: string, opts?: {
+    maxElements?: number;
+    visibleOnly?: boolean;
+}): Promise<PageInfoResult>;
+/** 提取页面文本内容（支持显式 tabId） */
+export declare function getPageContent(ctx: ToolContext, sessionId: string, tabId: string, opts?: {
+    maxLength?: number;
+}): Promise<PageContentResult>;
+/** 创建新标签页（可选导航到 URL） */
+export declare function createTab(ctx: ToolContext, sessionId: string, url?: string): Promise<CreateTabResult>;
+/** 关闭指定标签页 */
+export declare function closeTab(ctx: ToolContext, sessionId: string, tabId: string): Promise<{
+    success: boolean;
+}>;
+/** 模糊搜索页面元素 */
+export declare function findElement(ctx: ToolContext, sessionId: string, tabId: string, query: string, limit?: number): Promise<FindElementResult>;
+/** 点击元素（支持显式 tabId） */
+export declare function click(ctx: ToolContext, sessionId: string, tabId: string, elementId: string): Promise<ClickResult>;
+/** 输入文本（支持显式 tabId） */
+export declare function typeText(ctx: ToolContext, sessionId: string, tabId: string, elementId: string, text: string, submit?: boolean): Promise<TypeTextResult>;
+/** 按下键盘按键（支持显式 tabId + 修饰键组合） */
+export declare function pressKey(ctx: ToolContext, sessionId: string, tabId: string, key: string, modifiers?: string[]): Promise<PressKeyResult>;
+/** 条件等待（支持显式 tabId） */
+export declare function wait(ctx: ToolContext, sessionId: string, tabId: string, opts: {
+    condition?: 'time' | 'selector' | 'networkidle' | 'element_hidden';
+    milliseconds?: number;
+    selector?: string;
+}): Promise<WaitResult>;
+//# sourceMappingURL=tool-actions.d.ts.map

package/dist/task/tool-actions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-actions.d.ts","sourceRoot":"","sources":["../../src/task/tool-actions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAsBrD,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IACrC,MAAM,CAAC,EAAE,GAAG,CAAC;CACd;AAED,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,OAAO,CAAC;IAChB,SAAS,EAAE,OAAO,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IACpE,QAAQ,EAAE,GAAG,EAAE,CAAC;IAChB,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,OAAO,CAAC;IACnB,OAAO,EAAE,GAAG,EAAE,CAAC;IACf,OAAO,EAAE,GAAG,EAAE,CAAC;IACf,SAAS,CAAC,EAAE,GAAG,CAAC;IAChB,aAAa,CAAC,EAAE,GAAG,CAAC;CACrB;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,GAAG,EAAE,CAAC;IAChB,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,KAAK,CAAC;QAChB,EAAE,EAAE,MAAM,CAAC;QACX,KAAK,EAAE,MAAM,CAAC;QACd,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,EAAE,MAAM,CAAC;QACd,WAAW,EAAE,MAAM,CAAC;KACrB,CAAC,CAAC;CACJ;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IACrC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,MAAM,CAAC,EAAE,GAAG,CAAC;CACd;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;CACtC;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;CACtC;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,OAAO,CAAC;CAClB;AAYD,+BAA+B;AAC/B,wBAAsB,QAAQ,CAC5B,GAAG,EAAE,WAAW,EAChB,SAAS,EAAE,MAAM,EACjB,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,cAAc,CAAC,CAuCzB;AAED,8BAA8B;AAC9B,wBAAsB,aAAa,CACjC,GAAG,EAAE,WAAW,EAChB,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,EACb,IAAI,CAAC,EAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,GAC5C,OAAO,CAAC,eAAe,CAAC,CAa1B;AAED,2BAA2B;AAC3B,wBAAsB,WAAW,CAC/B,GAAG,EAAE,WAAW,EAChB,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,EACb,IAAI,CAAC,EAAE;IAAE,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,OAAO,CAAA;CAAE,GACrD,OAAO,CAAC,cAAc,CAAC,CAsEzB;AAED,2BAA2B;AAC3B,wBAAsB,cAAc,CAClC,GAAG,EAAE,WAAW,EAChB,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,EACb,IAAI,CAAC,EAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,GAC5B,OAAO,CAAC,iBAAiB,CAAC,CA0B5B;AAED,wBAAwB;AACxB,wBAAsB,SAAS,CAC7B,GAAG,EAAE,WAAW,EAChB,SAAS,EAAE,MAAM,EACjB,GAAG,CAAC,EAAE,MAAM,GACX,OAAO,CAAC,eAAe,CAAC,CA6B1B;AAED,cAAc;AACd,wBAAsB,QAAQ,CAC5B,GAAG,EAAE,WAAW,EAChB,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAA;CAAE,CAAC,CAK/B;AAED,eAAe;AACf,wBAAsB,WAAW,CAC/B,GAAG,EAAE,WAAW,EAChB,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,EACb,KAAK,CAAC,EAAE,MAAM,GACb,OAAO,CAAC,iBAAiB,CAAC,CAkB5B;AAED,uBAAuB;AACvB,wBAAsB,KAAK,CACzB,GAAG,EAAE,WAAW,EAChB,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,WAAW,CAAC,CAgCtB;AAED,uBAAuB;AACvB,wBAAsB,QAAQ,CAC5B,GAAG,EAAE,WAAW,EAChB,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,MAAM,EACZ,MAAM,CAAC,EAAE,OAAO,GACf,OAAO,CAAC,cAAc,CAAC,CAiBzB;AAyCD,iCAAiC;AACjC,wBAAsB,QAAQ,CAC5B,GAAG,EAAE,WAAW,EAChB,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,EACb,GAAG,EAAE,MAAM,EACX,SAAS,CAAC,EAAE,MAAM,EAAE,GACnB,OAAO,CAAC,cAAc,CAAC,CA+BzB;AAED,uBAAuB;AACvB,wBAAsB,IAAI,CACxB,GAAG,EAAE,WAAW,EAChB,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,EACb,IAAI,EAAE;IACJ,SAAS,CAAC,EAAE,MAAM,GAAG,UAAU,GAAG,aAAa,GAAG,gBAAgB,CAAC;IACnE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,GACA,OAAO,CAAC,UAAU,CAAC,CAoBrB"}

package/dist/task/tool-actions.js

@@ -0,0 +1,371 @@
+import { validateUrlAsync } from '../utils/url-validator.js';
+import { ElementCollector, ElementMatcher, PageAnalyzer, RegionDetector, ContentExtractor, } from '../semantic/index.js';
+import { executeAction } from '../browser/actions.js';
+import { ErrorCode } from './error-codes.js';
+// Shared semantic module instances
+const elementCollector = new ElementCollector();
+const elementMatcher = new ElementMatcher();
+const pageAnalyzer = new PageAnalyzer();
+const regionDetector = new RegionDetector();
+const contentExtractor = new ContentExtractor();
+// ===== Helper =====
+function makeError(message, code) {
+    const err = new Error(message);
+    err.errorCode = code;
+    return err;
+}
+// ===== Tool Actions =====
+/** 导航到指定 URL（操作 active tab） */
+export async function navigate(ctx, sessionId, url) {
+    const check = await validateUrlAsync(url, ctx.urlOpts);
+    if (!check.valid) {
+        throw makeError(check.reason, ErrorCode.INVALID_PARAMETER);
+    }
+    const tab = ctx.getActiveTab(sessionId);
+    await ctx.sessionManager.syncHeadfulCookies();
+    await ctx.injectCookies(tab.page);
+    let partial = false;
+    let statusCode;
+    try {
+        const response = await tab.page.goto(url, { waitUntil: 'domcontentloaded', timeout: 30000 });
+        statusCode = response?.status();
+    }
+    catch (err) {
+        if (err.name === 'TimeoutError' || err.message?.includes('timeout')) {
+            partial = true;
+        }
+        else {
+            throw new Error(err.message || 'Navigation failed');
+        }
+    }
+    // SPA 额外渲染时间
+    try {
+        await tab.page.waitForNetworkIdle({ timeout: 3000 });
+    }
+    catch { }
+    tab.url = tab.page.url();
+    await ctx.saveCookies(tab.page);
+    ctx.sessionManager.updateActivity(sessionId);
+    let title = '';
+    try {
+        title = await tab.page.title();
+    }
+    catch {
+        title = '(无法获取标题)';
+    }
+    const result = { success: true, partial, statusCode, page: { url: tab.page.url(), title } };
+    if (tab.events) {
+        const pending = tab.events.getPendingDialog();
+        if (pending)
+            result.dialog = pending;
+    }
+    return result;
+}
+/** 等待页面 DOM 稳定（支持显式 tabId） */
+export async function waitForStable(ctx, sessionId, tabId, opts) {
+    const tab = ctx.getTab(sessionId, tabId);
+    if (!tab)
+        throw makeError(`Tab not found: ${tabId}`, ErrorCode.SESSION_NOT_FOUND);
+    if (!tab.events) {
+        return { stable: true, domStable: true, networkPending: 0, loadState: 'loaded' };
+    }
+    const maxWait = Math.min(opts?.timeout ?? 5000, 30000);
+    const stable = await tab.events.waitForStable(maxWait, opts?.quietMs);
+    ctx.sessionManager.updateActivity(sessionId);
+    const state = tab.events.getStabilityState();
+    return { ...state, stable };
+}
+/** 获取页面语义信息（支持显式 tabId） */
+export async function getPageInfo(ctx, sessionId, tabId, opts) {
+    const tab = ctx.getTab(sessionId, tabId);
+    if (!tab)
+        throw makeError(`Tab not found: ${tabId}`, ErrorCode.SESSION_NOT_FOUND);
+    const limit = opts?.maxElements ?? 50;
+    const filterVisible = opts?.visibleOnly ?? true;
+    const [elements, analysis, regions] = await Promise.all([
+        elementCollector.collect(tab.page),
+        pageAnalyzer.analyze(tab.page),
+        regionDetector.detect(tab.page),
+    ]);
+    let filtered = elements;
+    // Filter to viewport-visible elements
+    if (filterVisible) {
+        const viewport = tab.page.viewport();
+        if (viewport) {
+            filtered = filtered.filter((el) => {
+                const b = el.bounds;
+                if (!b || (b.width === 0 && b.height === 0))
+                    return true;
+                return b.y + b.height > 0 && b.y < viewport.height
+                    && b.x + b.width > 0 && b.x < viewport.width;
+            });
+        }
+    }
+    // Sort by y position and truncate
+    const totalElements = filtered.length;
+    filtered.sort((a, b) => (a.bounds?.y ?? 0) - (b.bounds?.y ?? 0));
+    const truncated = filtered.length > limit;
+    if (truncated)
+        filtered = filtered.slice(0, limit);
+    // Mask sensitive field values
+    for (const el of filtered) {
+        if (el.type === 'textbox' || el.type === 'input') {
+            const idLower = (el.id || '').toLowerCase();
+            const labelLower = (el.label || '').toLowerCase();
+            const isSensitive = idLower.includes('password') || idLower.includes('secret') || idLower.includes('token')
+                || labelLower.includes('password') || labelLower.includes('secret') || labelLower.includes('token');
+            if (isSensitive && el.state?.value) {
+                el.state.value = '********';
+            }
+        }
+    }
+    ctx.sessionManager.updateActivity(sessionId);
+    const result = {
+        page: {
+            url: tab.page.url(),
+            title: await tab.page.title(),
+            type: analysis.pageType,
+            summary: analysis.summary,
+        },
+        elements: filtered,
+        totalElements,
+        truncated,
+        regions,
+        intents: analysis.intents,
+    };
+    if (tab.events) {
+        result.stability = tab.events.getStabilityState();
+        const pending = tab.events.getPendingDialog();
+        if (pending)
+            result.pendingDialog = pending;
+    }
+    return result;
+}
+/** 提取页面文本内容（支持显式 tabId） */
+export async function getPageContent(ctx, sessionId, tabId, opts) {
+    const tab = ctx.getTab(sessionId, tabId);
+    if (!tab)
+        throw makeError(`Tab not found: ${tabId}`, ErrorCode.SESSION_NOT_FOUND);
+    const content = await contentExtractor.extract(tab.page);
+    if (opts?.maxLength && content.sections) {
+        let totalLen = 0;
+        const truncatedSections = [];
+        for (const section of content.sections) {
+            const sectionText = section.text || '';
+            if (totalLen + sectionText.length > opts.maxLength) {
+                const remaining = opts.maxLength - totalLen;
+                if (remaining > 0) {
+                    truncatedSections.push({ ...section, text: sectionText.slice(0, remaining) });
+                }
+                break;
+            }
+            truncatedSections.push(section);
+            totalLen += sectionText.length;
+        }
+        content.sections = truncatedSections;
+    }
+    ctx.sessionManager.updateActivity(sessionId);
+    return content;
+}
+/** 创建新标签页（可选导航到 URL） */
+export async function createTab(ctx, sessionId, url) {
+    const tab = await ctx.sessionManager.createTab(sessionId);
+    if (!tab)
+        throw makeError(`Session not found: ${sessionId}`, ErrorCode.SESSION_NOT_FOUND);
+    // Auto-switch to the new tab
+    ctx.sessionManager.switchTab(sessionId, tab.id);
+    let partial = false;
+    if (url) {
+        const check = await validateUrlAsync(url, ctx.urlOpts);
+        if (!check.valid) {
+            throw makeError(check.reason, ErrorCode.INVALID_PARAMETER);
+        }
+        await ctx.injectCookies(tab.page);
+        try {
+            await tab.page.goto(url, { waitUntil: 'domcontentloaded', timeout: 30000 });
+        }
+        catch (err) {
+            if (err.name === 'TimeoutError' || err.message?.includes('timeout')) {
+                partial = true;
+            }
+            else {
+                throw err;
+            }
+        }
+        tab.url = tab.page.url();
+        await ctx.saveCookies(tab.page);
+    }
+    ctx.sessionManager.updateActivity(sessionId);
+    return { tabId: tab.id, url: tab.page.url(), partial };
+}
+/** 关闭指定标签页 */
+export async function closeTab(ctx, sessionId, tabId) {
+    const closed = await ctx.sessionManager.closeTab(sessionId, tabId);
+    if (!closed)
+        throw makeError(`Tab not found: ${tabId}`, ErrorCode.SESSION_NOT_FOUND);
+    ctx.sessionManager.updateActivity(sessionId);
+    return { success: true };
+}
+/** 模糊搜索页面元素 */
+export async function findElement(ctx, sessionId, tabId, query, limit) {
+    const tab = ctx.getTab(sessionId, tabId);
+    if (!tab)
+        throw makeError(`Tab not found: ${tabId}`, ErrorCode.SESSION_NOT_FOUND);
+    const elements = await elementCollector.collect(tab.page);
+    const candidates = elementMatcher.findByQuery(elements, query, limit ?? 5);
+    ctx.sessionManager.updateActivity(sessionId);
+    return {
+        query,
+        candidates: candidates.map((c) => ({
+            id: c.element.id,
+            label: c.element.label,
+            type: c.element.type,
+            score: c.score,
+            matchReason: c.matchReason,
+        })),
+    };
+}
+/** 点击元素（支持显式 tabId） */
+export async function click(ctx, sessionId, tabId, elementId) {
+    const tab = ctx.getTab(sessionId, tabId);
+    if (!tab)
+        throw makeError(`Tab not found: ${tabId}`, ErrorCode.SESSION_NOT_FOUND);
+    await executeAction(tab.page, 'click', elementId);
+    // Small delay to allow popup/dialog events to fire
+    await new Promise(r => setTimeout(r, 200));
+    tab.url = tab.page.url();
+    await ctx.saveCookies(tab.page);
+    // Check for popup windows captured by PageEventTracker
+    let newTabCreated;
+    if (tab.events) {
+        const popups = tab.events.getPopupPages();
+        for (const popupPage of popups) {
+            const newTab = await ctx.sessionManager.registerPopupAsTab(sessionId, popupPage);
+            if (newTab)
+                newTabCreated = newTab.id;
+        }
+        tab.events.clearPopupPages();
+    }
+    ctx.sessionManager.updateActivity(sessionId);
+    const result = {
+        success: true,
+        page: { url: tab.page.url(), title: await tab.page.title() },
+    };
+    if (newTabCreated)
+        result.newTabCreated = newTabCreated;
+    if (tab.events) {
+        const pending = tab.events.getPendingDialog();
+        if (pending)
+            result.dialog = pending;
+    }
+    return result;
+}
+/** 输入文本（支持显式 tabId） */
+export async function typeText(ctx, sessionId, tabId, elementId, text, submit) {
+    const tab = ctx.getTab(sessionId, tabId);
+    if (!tab)
+        throw makeError(`Tab not found: ${tabId}`, ErrorCode.SESSION_NOT_FOUND);
+    await executeAction(tab.page, 'type', elementId, text);
+    if (submit) {
+        await Promise.all([
+            tab.page.waitForNavigation({ waitUntil: 'domcontentloaded', timeout: 5000 }).catch(() => { }),
+            tab.page.keyboard.press('Enter'),
+        ]);
+    }
+    await ctx.saveCookies(tab.page);
+    ctx.sessionManager.updateActivity(sessionId);
+    return {
+        success: true,
+        page: { url: tab.page.url(), title: await tab.page.title() },
+    };
+}
+// ===== pressKey constants =====
+const ALLOWED_KEYS = new Set([
+    'Enter', 'Escape', 'Tab', 'Backspace', 'Delete', 'Space',
+    'ArrowUp', 'ArrowDown', 'ArrowLeft', 'ArrowRight',
+    'Home', 'End', 'PageUp', 'PageDown',
+]);
+const MODIFIER_COMBO_KEYS = new Set([
+    ...ALLOWED_KEYS,
+    ...'abcdefghijklmnopqrstuvwxyz'.split(''),
+    ...'0123456789'.split(''),
+]);
+const BLOCKED_COMBOS = [
+    { modifiers: ['Control'], key: 'w' },
+    { modifiers: ['Meta'], key: 'w' },
+    { modifiers: ['Control', 'Shift'], key: 'I' },
+    { modifiers: ['Meta', 'Shift'], key: 'I' },
+    { modifiers: ['Control', 'Shift'], key: 'J' },
+    { modifiers: ['Meta', 'Shift'], key: 'J' },
+    { modifiers: ['Control', 'Shift'], key: 'Delete' },
+    { modifiers: ['Control'], key: 'q' },
+    { modifiers: ['Meta'], key: 'q' },
+];
+function isComboAllowed(modifiers, key) {
+    for (const blocked of BLOCKED_COMBOS) {
+        const modSet = new Set(modifiers);
+        const blockedSet = new Set(blocked.modifiers);
+        if (modSet.size === blockedSet.size &&
+            [...blockedSet].every(m => modSet.has(m)) &&
+            key.toLowerCase() === blocked.key.toLowerCase()) {
+            return false;
+        }
+    }
+    return MODIFIER_COMBO_KEYS.has(key);
+}
+/** 按下键盘按键（支持显式 tabId + 修饰键组合） */
+export async function pressKey(ctx, sessionId, tabId, key, modifiers) {
+    const tab = ctx.getTab(sessionId, tabId);
+    if (!tab)
+        throw makeError(`Tab not found: ${tabId}`, ErrorCode.SESSION_NOT_FOUND);
+    if (modifiers && modifiers.length > 0) {
+        if (!isComboAllowed(modifiers, key)) {
+            throw makeError(`不允许的组合键: ${modifiers.join('+')}+${key}`, ErrorCode.INVALID_PARAMETER);
+        }
+        for (const mod of modifiers) {
+            await tab.page.keyboard.down(mod);
+        }
+        await tab.page.keyboard.press(key);
+        for (let i = modifiers.length - 1; i >= 0; i--) {
+            await tab.page.keyboard.up(modifiers[i]);
+        }
+    }
+    else {
+        if (!ALLOWED_KEYS.has(key)) {
+            throw makeError(`不允许的按键: ${key}。允许: ${[...ALLOWED_KEYS].join(', ')}`, ErrorCode.INVALID_PARAMETER);
+        }
+        await tab.page.keyboard.press(key);
+    }
+    await new Promise(r => setTimeout(r, 300));
+    ctx.sessionManager.updateActivity(sessionId);
+    return {
+        success: true,
+        page: { url: tab.page.url(), title: await tab.page.title() },
+    };
+}
+/** 条件等待（支持显式 tabId） */
+export async function wait(ctx, sessionId, tabId, opts) {
+    const tab = ctx.getTab(sessionId, tabId);
+    if (!tab)
+        throw makeError(`Tab not found: ${tabId}`, ErrorCode.SESSION_NOT_FOUND);
+    const { condition, milliseconds, selector } = opts;
+    if (condition === 'networkidle') {
+        await tab.page.waitForNetworkIdle({ timeout: milliseconds || 10000 });
+    }
+    else if (condition === 'element_hidden') {
+        if (!selector)
+            throw makeError('selector is required for element_hidden condition', ErrorCode.INVALID_PARAMETER);
+        await tab.page.waitForSelector(selector, { hidden: true, timeout: milliseconds || 10000 });
+    }
+    else if (condition === 'selector' || (!condition && selector)) {
+        if (!selector)
+            throw makeError('selector is required for selector condition', ErrorCode.INVALID_PARAMETER);
+        await tab.page.waitForSelector(selector, { timeout: milliseconds || 10000 });
+    }
+    else {
+        await new Promise(r => setTimeout(r, Math.min(milliseconds || 1000, 30000)));
+    }
+    ctx.sessionManager.updateActivity(sessionId);
+    return { success: true };
+}
+//# sourceMappingURL=tool-actions.js.map

package/dist/task/tool-actions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-actions.js","sourceRoot":"","sources":["../../src/task/tool-actions.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAC7D,OAAO,EACL,gBAAgB,EAChB,cAAc,EACd,YAAY,EACZ,cAAc,EACd,gBAAgB,GACjB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAEtD,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAE7C,mCAAmC;AACnC,MAAM,gBAAgB,GAAG,IAAI,gBAAgB,EAAE,CAAC;AAChD,MAAM,cAAc,GAAG,IAAI,cAAc,EAAE,CAAC;AAC5C,MAAM,YAAY,GAAG,IAAI,YAAY,EAAE,CAAC;AACxC,MAAM,cAAc,GAAG,IAAI,cAAc,EAAE,CAAC;AAC5C,MAAM,gBAAgB,GAAG,IAAI,gBAAgB,EAAE,CAAC;AAyEhD,qBAAqB;AAErB,SAAS,SAAS,CAAC,OAAe,EAAE,IAAe;IACjD,MAAM,GAAG,GAAG,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC;IAC9B,GAAW,CAAC,SAAS,GAAG,IAAI,CAAC;IAC9B,OAAO,GAAG,CAAC;AACb,CAAC;AAED,2BAA2B;AAE3B,+BAA+B;AAC/B,MAAM,CAAC,KAAK,UAAU,QAAQ,CAC5B,GAAgB,EAChB,SAAiB,EACjB,GAAW;IAEX,MAAM,KAAK,GAAG,MAAM,gBAAgB,CAAC,GAAG,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC;IACvD,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;QACjB,MAAM,SAAS,CAAC,KAAK,CAAC,MAAO,EAAE,SAAS,CAAC,iBAAiB,CAAC,CAAC;IAC9D,CAAC;IAED,MAAM,GAAG,GAAG,GAAG,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC;IACxC,MAAM,GAAG,CAAC,cAAc,CAAC,kBAAkB,EAAE,CAAC;IAC9C,MAAM,GAAG,CAAC,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAElC,IAAI,OAAO,GAAG,KAAK,CAAC;IACpB,IAAI,UAA8B,CAAC;IACnC,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,kBAAkB,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC;QAC7F,UAAU,GAAG,QAAQ,EAAE,MAAM,EAAE,CAAC;IAClC,CAAC;IAAC,OAAO,GAAQ,EAAE,CAAC;QAClB,IAAI,GAAG,CAAC,IAAI,KAAK,cAAc,IAAI,GAAG,CAAC,OAAO,EAAE,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;YACpE,OAAO,GAAG,IAAI,CAAC;QACjB,CAAC;aAAM,CAAC;YACN,MAAM,IAAI,KAAK,CAAC,GAAG,CAAC,OAAO,IAAI,mBAAmB,CAAC,CAAC;QACtD,CAAC;IACH,CAAC;IAED,aAAa;IACb,IAAI,CAAC;QAAC,MAAM,GAAG,CAAC,IAAI,CAAC,kBAAkB,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;IAAC,CAAC;IAAC,MAAM,CAAC,CAAA,CAAC;IAEtE,GAAG,CAAC,GAAG,GAAG,GAAG,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC;IACzB,MAAM,GAAG,CAAC,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAChC,GAAG,CAAC,cAAc,CAAC,cAAc,CAAC,SAAS,CAAC,CAAC;IAE7C,IAAI,KAAK,GAAG,EAAE,CAAC;IACf,IAAI,CAAC;QAAC,KAAK,GAAG,MAAM,GAAG,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;IAAC,CAAC;IAAC,MAAM,CAAC;QAAC,KAAK,GAAG,UAAU,CAAC;IAAC,CAAC;IAErE,MAAM,MAAM,GAAmB,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,EAAE,GAAG,EAAE,GAAG,CAAC,IAAI,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,EAAE,CAAC;IAC5G,IAAI,GAAG,CAAC,MAAM,EAAE,CAAC;QACf,MAAM,OAAO,GAAG,GAAG,CAAC,MAAM,CAAC,gBAAgB,EAAE,CAAC;QAC9C,IAAI,OAAO;YAAG,MAAc,CAAC,MAAM,GAAG,OAAO,CAAC;IAChD,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,8BAA8B;AAC9B,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,GAAgB,EAChB,SAAiB,EACjB,KAAa,EACb,IAA6C;IAE7C,MAAM,GAAG,GAAG,GAAG,CAAC,MAAM,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;IACzC,IAAI,CAAC,GAAG;QAAE,MAAM,SAAS,CAAC,kBAAkB,KAAK,EAAE,EAAE,SAAS,CAAC,iBAAiB,CAAC,CAAC;IAElF,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC;QAChB,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,cAAc,EAAE,CAAC,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC;IACnF,CAAC;IAED,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,OAAO,IAAI,IAAI,EAAE,KAAK,CAAC,CAAC;IACvD,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,MAAM,CAAC,aAAa,CAAC,OAAO,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;IACtE,GAAG,CAAC,cAAc,CAAC,cAAc,CAAC,SAAS,CAAC,CAAC;IAC7C,MAAM,KAAK,GAAG,GAAG,CAAC,MAAM,CAAC,iBAAiB,EAAE,CAAC;IAC7C,OAAO,EAAE,GAAG,KAAK,EAAE,MAAM,EAAE,CAAC;AAC9B,CAAC;AAED,2BAA2B;AAC3B,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,GAAgB,EAChB,SAAiB,EACjB,KAAa,EACb,IAAsD;IAEtD,MAAM,GAAG,GAAG,GAAG,CAAC,MAAM,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;IACzC,IAAI,CAAC,GAAG;QAAE,MAAM,SAAS,CAAC,kBAAkB,KAAK,EAAE,EAAE,SAAS,CAAC,iBAAiB,CAAC,CAAC;IAElF,MAAM,KAAK,GAAG,IAAI,EAAE,WAAW,IAAI,EAAE,CAAC;IACtC,MAAM,aAAa,GAAG,IAAI,EAAE,WAAW,IAAI,IAAI,CAAC;IAEhD,MAAM,CAAC,QAAQ,EAAE,QAAQ,EAAE,OAAO,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;QACtD,gBAAgB,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC;QAClC,YAAY,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC;QAC9B,cAAc,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC;KAChC,CAAC,CAAC;IAEH,IAAI,QAAQ,GAAG,QAAQ,CAAC;IAExB,sCAAsC;IACtC,IAAI,aAAa,EAAE,CAAC;QAClB,MAAM,QAAQ,GAAG,GAAG,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC;QACrC,IAAI,QAAQ,EAAE,CAAC;YACb,QAAQ,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,EAAO,EAAE,EAAE;gBACrC,MAAM,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC;gBACpB,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC;oBAAE,OAAO,IAAI,CAAC;gBACzD,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,MAAM;uBAC7C,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC;YACjD,CAAC,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,kCAAkC;IAClC,MAAM,aAAa,GAAG,QAAQ,CAAC,MAAM,CAAC;IACtC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAM,EAAE,CAAM,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAC3E,MAAM,SAAS,GAAG,QAAQ,CAAC,MAAM,GAAG,KAAK,CAAC;IAC1C,IAAI,SAAS;QAAE,QAAQ,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;IAEnD,8BAA8B;IAC9B,KAAK,MAAM,EAAE,IAAI,QAAiB,EAAE,CAAC;QACnC,IAAI,EAAE,CAAC,IAAI,KAAK,SAAS,IAAI,EAAE,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;YACjD,MAAM,OAAO,GAAG,CAAC,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;YAC5C,MAAM,UAAU,GAAG,CAAC,EAAE,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;YAClD,MAAM,WAAW,GAAG,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC;mBACtG,UAAU,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,UAAU,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,UAAU,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;YACtG,IAAI,WAAW,IAAI,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,CAAC;gBACnC,EAAE,CAAC,KAAK,CAAC,KAAK,GAAG,UAAU,CAAC;YAC9B,CAAC;QACH,CAAC;IACH,CAAC;IAED,GAAG,CAAC,cAAc,CAAC,cAAc,CAAC,SAAS,CAAC,CAAC;IAE7C,MAAM,MAAM,GAAmB;QAC7B,IAAI,EAAE;YACJ,GAAG,EAAE,GAAG,CAAC,IAAI,CAAC,GAAG,EAAE;YACnB,KAAK,EAAE,MAAM,GAAG,CAAC,IAAI,CAAC,KAAK,EAAE;YAC7B,IAAI,EAAE,QAAQ,CAAC,QAAQ;YACvB,OAAO,EAAE,QAAQ,CAAC,OAAO;SAC1B;QACD,QAAQ,EAAE,QAAQ;QAClB,aAAa;QACb,SAAS;QACT,OAAO;QACP,OAAO,EAAE,QAAQ,CAAC,OAAO;KAC1B,CAAC;IAEF,IAAI,GAAG,CAAC,MAAM,EAAE,CAAC;QACf,MAAM,CAAC,SAAS,GAAG,GAAG,CAAC,MAAM,CAAC,iBAAiB,EAAE,CAAC;QAClD,MAAM,OAAO,GAAG,GAAG,CAAC,MAAM,CAAC,gBAAgB,EAAE,CAAC;QAC9C,IAAI,OAAO;YAAE,MAAM,CAAC,aAAa,GAAG,OAAO,CAAC;IAC9C,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,2BAA2B;AAC3B,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,GAAgB,EAChB,SAAiB,EACjB,KAAa,EACb,IAA6B;IAE7B,MAAM,GAAG,GAAG,GAAG,CAAC,MAAM,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;IACzC,IAAI,CAAC,GAAG;QAAE,MAAM,SAAS,CAAC,kBAAkB,KAAK,EAAE,EAAE,SAAS,CAAC,iBAAiB,CAAC,CAAC;IAElF,MAAM,OAAO,GAAG,MAAM,gBAAgB,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAEzD,IAAI,IAAI,EAAE,SAAS,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;QACxC,IAAI,QAAQ,GAAG,CAAC,CAAC;QACjB,MAAM,iBAAiB,GAA4B,EAAE,CAAC;QACtD,KAAK,MAAM,OAAO,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;YACvC,MAAM,WAAW,GAAG,OAAO,CAAC,IAAI,IAAI,EAAE,CAAC;YACvC,IAAI,QAAQ,GAAG,WAAW,CAAC,MAAM,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC;gBACnD,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,GAAG,QAAQ,CAAC;gBAC5C,IAAI,SAAS,GAAG,CAAC,EAAE,CAAC;oBAClB,iBAAiB,CAAC,IAAI,CAAC,EAAE,GAAG,OAAO,EAAE,IAAI,EAAE,WAAW,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC,EAAE,CAAC,CAAC;gBAChF,CAAC;gBACD,MAAM;YACR,CAAC;YACD,iBAAiB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YAChC,QAAQ,IAAI,WAAW,CAAC,MAAM,CAAC;QACjC,CAAC;QACD,OAAO,CAAC,QAAQ,GAAG,iBAAiB,CAAC;IACvC,CAAC;IAED,GAAG,CAAC,cAAc,CAAC,cAAc,CAAC,SAAS,CAAC,CAAC;IAC7C,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,wBAAwB;AACxB,MAAM,CAAC,KAAK,UAAU,SAAS,CAC7B,GAAgB,EAChB,SAAiB,EACjB,GAAY;IAEZ,MAAM,GAAG,GAAG,MAAM,GAAG,CAAC,cAAc,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;IAC1D,IAAI,CAAC,GAAG;QAAE,MAAM,SAAS,CAAC,sBAAsB,SAAS,EAAE,EAAE,SAAS,CAAC,iBAAiB,CAAC,CAAC;IAE1F,6BAA6B;IAC7B,GAAG,CAAC,cAAc,CAAC,SAAS,CAAC,SAAS,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC;IAEhD,IAAI,OAAO,GAAG,KAAK,CAAC;IACpB,IAAI,GAAG,EAAE,CAAC;QACR,MAAM,KAAK,GAAG,MAAM,gBAAgB,CAAC,GAAG,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC;QACvD,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;YACjB,MAAM,SAAS,CAAC,KAAK,CAAC,MAAO,EAAE,SAAS,CAAC,iBAAiB,CAAC,CAAC;QAC9D,CAAC;QACD,MAAM,GAAG,CAAC,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAClC,IAAI,CAAC;YACH,MAAM,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,kBAAkB,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC;QAC9E,CAAC;QAAC,OAAO,GAAQ,EAAE,CAAC;YAClB,IAAI,GAAG,CAAC,IAAI,KAAK,cAAc,IAAI,GAAG,CAAC,OAAO,EAAE,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;gBACpE,OAAO,GAAG,IAAI,CAAC;YACjB,CAAC;iBAAM,CAAC;gBACN,MAAM,GAAG,CAAC;YACZ,CAAC;QACH,CAAC;QACD,GAAG,CAAC,GAAG,GAAG,GAAG,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC;QACzB,MAAM,GAAG,CAAC,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAClC,CAAC;IAED,GAAG,CAAC,cAAc,CAAC,cAAc,CAAC,SAAS,CAAC,CAAC;IAC7C,OAAO,EAAE,KAAK,EAAE,GAAG,CAAC,EAAE,EAAE,GAAG,EAAE,GAAG,CAAC,IAAI,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,CAAC;AACzD,CAAC;AAED,cAAc;AACd,MAAM,CAAC,KAAK,UAAU,QAAQ,CAC5B,GAAgB,EAChB,SAAiB,EACjB,KAAa;IAEb,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,cAAc,CAAC,QAAQ,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;IACnE,IAAI,CAAC,MAAM;QAAE,MAAM,SAAS,CAAC,kBAAkB,KAAK,EAAE,EAAE,SAAS,CAAC,iBAAiB,CAAC,CAAC;IACrF,GAAG,CAAC,cAAc,CAAC,cAAc,CAAC,SAAS,CAAC,CAAC;IAC7C,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;AAC3B,CAAC;AAED,eAAe;AACf,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,GAAgB,EAChB,SAAiB,EACjB,KAAa,EACb,KAAa,EACb,KAAc;IAEd,MAAM,GAAG,GAAG,GAAG,CAAC,MAAM,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;IACzC,IAAI,CAAC,GAAG;QAAE,MAAM,SAAS,CAAC,kBAAkB,KAAK,EAAE,EAAE,SAAS,CAAC,iBAAiB,CAAC,CAAC;IAElF,MAAM,QAAQ,GAAG,MAAM,gBAAgB,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC1D,MAAM,UAAU,GAAG,cAAc,CAAC,WAAW,CAAC,QAAQ,EAAE,KAAK,EAAE,KAAK,IAAI,CAAC,CAAC,CAAC;IAC3E,GAAG,CAAC,cAAc,CAAC,cAAc,CAAC,SAAS,CAAC,CAAC;IAE7C,OAAO;QACL,KAAK;QACL,UAAU,EAAE,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YACjC,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE;YAChB,KAAK,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK;YACtB,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,IAAI;YACpB,KAAK,EAAE,CAAC,CAAC,KAAK;YACd,WAAW,EAAE,CAAC,CAAC,WAAW;SAC3B,CAAC,CAAC;KACJ,CAAC;AACJ,CAAC;AAED,uBAAuB;AACvB,MAAM,CAAC,KAAK,UAAU,KAAK,CACzB,GAAgB,EAChB,SAAiB,EACjB,KAAa,EACb,SAAiB;IAEjB,MAAM,GAAG,GAAG,GAAG,CAAC,MAAM,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;IACzC,IAAI,CAAC,GAAG;QAAE,MAAM,SAAS,CAAC,kBAAkB,KAAK,EAAE,EAAE,SAAS,CAAC,iBAAiB,CAAC,CAAC;IAElF,MAAM,aAAa,CAAC,GAAG,CAAC,IAAI,EAAE,OAAO,EAAE,SAAS,CAAC,CAAC;IAClD,mDAAmD;IACnD,MAAM,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC;IAC3C,GAAG,CAAC,GAAG,GAAG,GAAG,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC;IACzB,MAAM,GAAG,CAAC,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAEhC,uDAAuD;IACvD,IAAI,aAAiC,CAAC;IACtC,IAAI,GAAG,CAAC,MAAM,EAAE,CAAC;QACf,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,aAAa,EAAE,CAAC;QAC1C,KAAK,MAAM,SAAS,IAAI,MAAM,EAAE,CAAC;YAC/B,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,cAAc,CAAC,kBAAkB,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;YACjF,IAAI,MAAM;gBAAE,aAAa,GAAG,MAAM,CAAC,EAAE,CAAC;QACxC,CAAC;QACD,GAAG,CAAC,MAAM,CAAC,eAAe,EAAE,CAAC;IAC/B,CAAC;IAED,GAAG,CAAC,cAAc,CAAC,cAAc,CAAC,SAAS,CAAC,CAAC;IAC7C,MAAM,MAAM,GAAgB;QAC1B,OAAO,EAAE,IAAI;QACb,IAAI,EAAE,EAAE,GAAG,EAAE,GAAG,CAAC,IAAI,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,MAAM,GAAG,CAAC,IAAI,CAAC,KAAK,EAAE,EAAE;KAC7D,CAAC;IACF,IAAI,aAAa;QAAE,MAAM,CAAC,aAAa,GAAG,aAAa,CAAC;IACxD,IAAI,GAAG,CAAC,MAAM,EAAE,CAAC;QACf,MAAM,OAAO,GAAG,GAAG,CAAC,MAAM,CAAC,gBAAgB,EAAE,CAAC;QAC9C,IAAI,OAAO;YAAE,MAAM,CAAC,MAAM,GAAG,OAAO,CAAC;IACvC,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,uBAAuB;AACvB,MAAM,CAAC,KAAK,UAAU,QAAQ,CAC5B,GAAgB,EAChB,SAAiB,EACjB,KAAa,EACb,SAAiB,EACjB,IAAY,EACZ,MAAgB;IAEhB,MAAM,GAAG,GAAG,GAAG,CAAC,MAAM,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;IACzC,IAAI,CAAC,GAAG;QAAE,MAAM,SAAS,CAAC,kBAAkB,KAAK,EAAE,EAAE,SAAS,CAAC,iBAAiB,CAAC,CAAC;IAElF,MAAM,aAAa,CAAC,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,CAAC,CAAC;IACvD,IAAI,MAAM,EAAE,CAAC;QACX,MAAM,OAAO,CAAC,GAAG,CAAC;YAChB,GAAG,CAAC,IAAI,CAAC,iBAAiB,CAAC,EAAE,SAAS,EAAE,kBAAkB,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC;YAC5F,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,OAAO,CAAC;SACjC,CAAC,CAAC;IACL,CAAC;IACD,MAAM,GAAG,CAAC,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAChC,GAAG,CAAC,cAAc,CAAC,cAAc,CAAC,SAAS,CAAC,CAAC;IAC7C,OAAO;QACL,OAAO,EAAE,IAAI;QACb,IAAI,EAAE,EAAE,GAAG,EAAE,GAAG,CAAC,IAAI,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,MAAM,GAAG,CAAC,IAAI,CAAC,KAAK,EAAE,EAAE;KAC7D,CAAC;AACJ,CAAC;AAED,iCAAiC;AAEjC,MAAM,YAAY,GAAG,IAAI,GAAG,CAAC;IAC3B,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,OAAO;IACxD,SAAS,EAAE,WAAW,EAAE,WAAW,EAAE,YAAY;IACjD,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,UAAU;CACpC,CAAC,CAAC;AAEH,MAAM,mBAAmB,GAAG,IAAI,GAAG,CAAC;IAClC,GAAG,YAAY;IACf,GAAG,4BAA4B,CAAC,KAAK,CAAC,EAAE,CAAC;IACzC,GAAG,YAAY,CAAC,KAAK,CAAC,EAAE,CAAC;CAC1B,CAAC,CAAC;AAEH,MAAM,cAAc,GAAgD;IAClE,EAAE,SAAS,EAAE,CAAC,SAAS,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE;IACpC,EAAE,SAAS,EAAE,CAAC,MAAM,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE;IACjC,EAAE,SAAS,EAAE,CAAC,SAAS,EAAE,OAAO,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE;IAC7C,EAAE,SAAS,EAAE,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE;IAC1C,EAAE,SAAS,EAAE,CAAC,SAAS,EAAE,OAAO,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE;IAC7C,EAAE,SAAS,EAAE,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE;IAC1C,EAAE,SAAS,EAAE,CAAC,SAAS,EAAE,OAAO,CAAC,EAAE,GAAG,EAAE,QAAQ,EAAE;IAClD,EAAE,SAAS,EAAE,CAAC,SAAS,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE;IACpC,EAAE,SAAS,EAAE,CAAC,MAAM,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE;CAClC,CAAC;AAEF,SAAS,cAAc,CAAC,SAAmB,EAAE,GAAW;IACtD,KAAK,MAAM,OAAO,IAAI,cAAc,EAAE,CAAC;QACrC,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,SAAS,CAAC,CAAC;QAClC,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QAC9C,IAAI,MAAM,CAAC,IAAI,KAAK,UAAU,CAAC,IAAI;YAC/B,CAAC,GAAG,UAAU,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;YACzC,GAAG,CAAC,WAAW,EAAE,KAAK,OAAO,CAAC,GAAG,CAAC,WAAW,EAAE,EAAE,CAAC;YACpD,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IACD,OAAO,mBAAmB,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;AACtC,CAAC;AAED,iCAAiC;AACjC,MAAM,CAAC,KAAK,UAAU,QAAQ,CAC5B,GAAgB,EAChB,SAAiB,EACjB,KAAa,EACb,GAAW,EACX,SAAoB;IAEpB,MAAM,GAAG,GAAG,GAAG,CAAC,MAAM,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;IACzC,IAAI,CAAC,GAAG;QAAE,MAAM,SAAS,CAAC,kBAAkB,KAAK,EAAE,EAAE,SAAS,CAAC,iBAAiB,CAAC,CAAC;IAElF,IAAI,SAAS,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACtC,IAAI,CAAC,cAAc,CAAC,SAAS,EAAE,GAAG,CAAC,EAAE,CAAC;YACpC,MAAM,SAAS,CAAC,YAAY,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,GAAG,EAAE,EAAE,SAAS,CAAC,iBAAiB,CAAC,CAAC;QACzF,CAAC;QACD,KAAK,MAAM,GAAG,IAAI,SAAS,EAAE,CAAC;YAC5B,MAAM,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAe,CAAC,CAAC;QAChD,CAAC;QACD,MAAM,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAe,CAAC,CAAC;QAC/C,KAAK,IAAI,CAAC,GAAG,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;YAC/C,MAAM,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,SAAS,CAAC,CAAC,CAAa,CAAC,CAAC;QACvD,CAAC;IACH,CAAC;SAAM,CAAC;QACN,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YAC3B,MAAM,SAAS,CACb,WAAW,GAAG,QAAQ,CAAC,GAAG,YAAY,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EACpD,SAAS,CAAC,iBAAiB,CAC5B,CAAC;QACJ,CAAC;QACD,MAAM,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAe,CAAC,CAAC;IACjD,CAAC;IAED,MAAM,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC;IAC3C,GAAG,CAAC,cAAc,CAAC,cAAc,CAAC,SAAS,CAAC,CAAC;IAC7C,OAAO;QACL,OAAO,EAAE,IAAI;QACb,IAAI,EAAE,EAAE,GAAG,EAAE,GAAG,CAAC,IAAI,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,MAAM,GAAG,CAAC,IAAI,CAAC,KAAK,EAAE,EAAE;KAC7D,CAAC;AACJ,CAAC;AAED,uBAAuB;AACvB,MAAM,CAAC,KAAK,UAAU,IAAI,CACxB,GAAgB,EAChB,SAAiB,EACjB,KAAa,EACb,IAIC;IAED,MAAM,GAAG,GAAG,GAAG,CAAC,MAAM,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;IACzC,IAAI,CAAC,GAAG;QAAE,MAAM,SAAS,CAAC,kBAAkB,KAAK,EAAE,EAAE,SAAS,CAAC,iBAAiB,CAAC,CAAC;IAElF,MAAM,EAAE,SAAS,EAAE,YAAY,EAAE,QAAQ,EAAE,GAAG,IAAI,CAAC;IAEnD,IAAI,SAAS,KAAK,aAAa,EAAE,CAAC;QAChC,MAAM,GAAG,CAAC,IAAI,CAAC,kBAAkB,CAAC,EAAE,OAAO,EAAE,YAAY,IAAI,KAAK,EAAE,CAAC,CAAC;IACxE,CAAC;SAAM,IAAI,SAAS,KAAK,gBAAgB,EAAE,CAAC;QAC1C,IAAI,CAAC,QAAQ;YAAE,MAAM,SAAS,CAAC,mDAAmD,EAAE,SAAS,CAAC,iBAAiB,CAAC,CAAC;QACjH,MAAM,GAAG,CAAC,IAAI,CAAC,eAAe,CAAC,QAAQ,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,YAAY,IAAI,KAAK,EAAE,CAAC,CAAC;IAC7F,CAAC;SAAM,IAAI,SAAS,KAAK,UAAU,IAAI,CAAC,CAAC,SAAS,IAAI,QAAQ,CAAC,EAAE,CAAC;QAChE,IAAI,CAAC,QAAQ;YAAE,MAAM,SAAS,CAAC,6CAA6C,EAAE,SAAS,CAAC,iBAAiB,CAAC,CAAC;QAC3G,MAAM,GAAG,CAAC,IAAI,CAAC,eAAe,CAAC,QAAQ,EAAE,EAAE,OAAO,EAAE,YAAY,IAAI,KAAK,EAAE,CAAC,CAAC;IAC/E,CAAC;SAAM,CAAC;QACN,MAAM,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,YAAY,IAAI,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC;IAC/E,CAAC;IAED,GAAG,CAAC,cAAc,CAAC,cAAc,CAAC,SAAS,CAAC,CAAC;IAC7C,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;AAC3B,CAAC"}

package/dist/task/tool-context.d.ts

@@ -0,0 +1,26 @@
+import type { Page } from 'puppeteer-core';
+import type { SessionManager, Tab } from '../browser/index.js';
+import type { CookieStore } from '../browser/CookieStore.js';
+import type { ValidateUrlOptions } from '../utils/url-validator.js';
+export type TrustLevel = 'local' | 'remote';
+/**
+ * 工具执行上下文 — 由 MCP handler 或模板执行器构造。
+ * 所有 toolAction 函数通过此接口获取依赖，不直接引用全局状态。
+ */
+export interface ToolContext {
+    sessionManager: SessionManager;
+    cookieStore?: CookieStore;
+    urlOpts: ValidateUrlOptions;
+    trustLevel: TrustLevel;
+    /** 解析 sessionId（MCP: defaultSession 逻辑；模板: 直接返回绑定 sessionId） */
+    resolveSession(sessionId?: string): Promise<string>;
+    /** 获取指定 session 的活跃 tab */
+    getActiveTab(sessionId: string): Tab;
+    /** 获取指定 session 的指定 tab（并发 tab 场景） */
+    getTab(sessionId: string, tabId: string): Tab | undefined;
+    /** 注入 cookie 到页面（CDP） */
+    injectCookies(page: Page): Promise<void>;
+    /** 从页面保存 cookie（CDP） */
+    saveCookies(page: Page): Promise<void>;
+}
+//# sourceMappingURL=tool-context.d.ts.map

package/dist/task/tool-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-context.d.ts","sourceRoot":"","sources":["../../src/task/tool-context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,KAAK,EAAE,cAAc,EAAE,GAAG,EAAE,MAAM,qBAAqB,CAAC;AAC/D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAC7D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAEpE,MAAM,MAAM,UAAU,GAAG,OAAO,GAAG,QAAQ,CAAC;AAE5C;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B,cAAc,EAAE,cAAc,CAAC;IAC/B,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,OAAO,EAAE,kBAAkB,CAAC;IAC5B,UAAU,EAAE,UAAU,CAAC;IAEvB,gEAAgE;IAChE,cAAc,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAEpD,2BAA2B;IAC3B,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,GAAG,CAAC;IAErC,sCAAsC;IACtC,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,GAAG,GAAG,SAAS,CAAC;IAE1D,yBAAyB;IACzB,aAAa,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEzC,wBAAwB;IACxB,WAAW,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACxC"}

package/dist/task/tool-context.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=tool-context.js.map

package/dist/task/tool-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-context.js","sourceRoot":"","sources":["../../src/task/tool-context.ts"],"names":[],"mappings":""}

package/dist/utils/url-validator.d.ts

@@ -14,4 +14,17 @@ export declare function validateUrl(url: string, options?: ValidateUrlOptions):
     valid: false;
     reason: string;
 };
+/**
+ * Async URL validation with DNS resolution check.
+ * When blockPrivate=true and hostname is not an IP literal,
+ * resolves DNS and checks if the resolved IP is private (anti-DNS-rebinding).
+ * DNS failure → allow original URL (fail-open, avoids false negatives in restricted DNS envs).
+ */
+export declare function validateUrlAsync(url: string, options?: ValidateUrlOptions): Promise<{
+    valid: true;
+    parsed: URL;
+} | {
+    valid: false;
+    reason: string;
+}>;
 //# sourceMappingURL=url-validator.d.ts.map

package/dist/utils/url-validator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"url-validator.d.ts","sourceRoot":"","sources":["../../src/utils/url-validator.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,kBAAkB;IACjC,qFAAqF;IACrF,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,kGAAkG;IAClG,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAsBD,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,GAAE,kBAAuB,GAAG;IAAE,KAAK,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,GAAG,CAAA;CAAE,GAAG;IAAE,KAAK,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAiE1I"}
+{"version":3,"file":"url-validator.d.ts","sourceRoot":"","sources":["../../src/utils/url-validator.ts"],"names":[],"mappings":"AAAA;;GAEG;AAOH,MAAM,WAAW,kBAAkB;IACjC,qFAAqF;IACrF,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,kGAAkG;IAClG,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAsBD,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,GAAE,kBAAuB,GAAG;IAAE,KAAK,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,GAAG,CAAA;CAAE,GAAG;IAAE,KAAK,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAiE1I;AAeD;;;;;GAKG;AACH,wBAAsB,gBAAgB,CACpC,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,kBAAuB,GAC/B,OAAO,CAAC;IAAE,KAAK,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,GAAG,CAAA;CAAE,GAAG;IAAE,KAAK,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CAuC1E"}

package/dist/utils/url-validator.js

@@ -1,6 +1,9 @@
 /**
  * URL validation utility — blocks dangerous protocols and private/loopback addresses.
  */
+import dns from 'node:dns';
+import { promisify } from 'node:util';
+const dnsLookup = promisify(dns.lookup);
 // RFC 1918 + loopback + link-local ranges
 const PRIVATE_IP_PATTERNS = [
     /^127\./, // 127.0.0.0/8
@@ -77,4 +80,65 @@ export function validateUrl(url, options = {}) {
     }
     return { valid: true, parsed };
 }
+/** Check if hostname is an IP literal (v4 or v6 bracket notation) */
+function isIpLiteral(hostname) {
+    if (hostname.startsWith('['))
+        return true; // IPv6
+    return /^\d{1,3}(\.\d{1,3}){3}$/.test(hostname);
+}
+function isPrivateIp(ip) {
+    for (const pattern of PRIVATE_IP_PATTERNS) {
+        if (pattern.test(ip))
+            return true;
+    }
+    return false;
+}
+/**
+ * Async URL validation with DNS resolution check.
+ * When blockPrivate=true and hostname is not an IP literal,
+ * resolves DNS and checks if the resolved IP is private (anti-DNS-rebinding).
+ * DNS failure → allow original URL (fail-open, avoids false negatives in restricted DNS envs).
+ */
+export async function validateUrlAsync(url, options = {}) {
+    // Run synchronous checks first
+    const syncResult = validateUrl(url, options);
+    if (!syncResult.valid)
+        return syncResult;
+    // DNS check only needed when blockPrivate is enabled and hostname is not an IP literal
+    if (!options.blockPrivate)
+        return syncResult;
+    const { parsed } = syncResult;
+    if (parsed.protocol === 'file:')
+        return syncResult;
+    const hostname = parsed.hostname;
+    if (isIpLiteral(hostname))
+        return syncResult; // already checked by sync validator
+    // Resolve DNS and check resolved IP
+    try {
+        const { address } = await dnsLookup(hostname);
+        if (isPrivateIp(address)) {
+            return { valid: false, reason: `DNS resolved to private address: ${hostname} → ${address}` };
+        }
+        if (PRIVATE_HOSTNAMES.has(address)) {
+            return { valid: false, reason: `DNS resolved to private address: ${hostname} → ${address}` };
+        }
+    }
+    catch {
+        // Retry once before giving up — handles transient DNS failures.
+        try {
+            const { address } = await dnsLookup(hostname);
+            if (isPrivateIp(address)) {
+                return { valid: false, reason: `DNS resolved to private address: ${hostname} → ${address}` };
+            }
+            if (PRIVATE_HOSTNAMES.has(address)) {
+                return { valid: false, reason: `DNS resolved to private address: ${hostname} → ${address}` };
+            }
+        }
+        catch {
+            // Fail-open when DNS is unavailable so public URLs are not blocked by local resolver issues.
+            return syncResult;
+        }
+    }
+    return syncResult;
+}
 //# sourceMappingURL=url-validator.js.map