devharness 0.8.0

package/build/tools/dashboard-tools.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Dashboard Tools
+ * MCP tools for managing the cdp-tools dashboard
+ */
+import { z } from 'zod';
+import type { DuplicateSessionInfo } from '../tool-response.js';
+import type { DashboardInstance } from '../dashboard/index.js';
+import type { SessionInfo } from '../session-detector.js';
+export declare function setDashboardInstance(instance: DashboardInstance | null): void;
+export declare function getDashboardInstance(): DashboardInstance | null;
+export declare function setSessionInfo(info: SessionInfo | null): void;
+export declare function getSessionInfo(): SessionInfo | null;
+/**
+ * Get duplicate session info for blocking check
+ */
+export declare function getDuplicateSessionInfo(): DuplicateSessionInfo | null;
+export declare function createDashboardTools(): {
+    dashboard: {
+        description: string;
+        zodSchema: z.ZodObject<{
+            action: z.ZodEnum<["open", "status", "stop"]>;
+        }, "strict", z.ZodTypeAny, {
+            action: "status" | "stop" | "open";
+        }, {
+            action: "status" | "stop" | "open";
+        }>;
+        inputSchema: import("zod-to-json-schema").JsonSchema7Type & {
+            $schema?: string | undefined;
+            definitions?: {
+                [key: string]: import("zod-to-json-schema").JsonSchema7Type;
+            } | undefined;
+        };
+        handler: (args: {
+            action: "status" | "stop" | "open";
+        }, abortSignal?: AbortSignal) => Promise<any>;
+    };
+};
+//# sourceMappingURL=dashboard-tools.d.ts.map

package/build/tools/dashboard-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dashboard-tools.d.ts","sourceRoot":"","sources":["../../src/tools/dashboard-tools.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAChE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC/D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAa1D,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,iBAAiB,GAAG,IAAI,GAAG,IAAI,CAE7E;AAED,wBAAgB,oBAAoB,IAAI,iBAAiB,GAAG,IAAI,CAE/D;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,WAAW,GAAG,IAAI,GAAG,IAAI,CAE7D;AAED,wBAAgB,cAAc,IAAI,WAAW,GAAG,IAAI,CAEnD;AAED;;GAEG;AACH,wBAAgB,uBAAuB,IAAI,oBAAoB,GAAG,IAAI,CA8BrE;AAED,wBAAgB,oBAAoB;;;;;;;;;;;;;;;;;;;;EA4EnC"}

package/build/tools/dashboard-tools.js

@@ -0,0 +1,123 @@
+/**
+ * Dashboard Tools
+ * MCP tools for managing the cdp-tools dashboard
+ */
+import { z } from 'zod';
+import { livePids } from '../helpers/process-liveness.js';
+import { createTool } from '../validation-helpers.js';
+import { createSuccessResponse, createErrorResponse } from '../messages.js';
+const dashboardSchema = z.object({
+    action: z.enum(['open', 'status', 'stop'])
+        .describe('Dashboard action: open (get URL to open dashboard), status (show hub status), stop (stop the hub if this session is the hub)'),
+}).strict();
+// Lazy-bound dashboard instance (set after async initialization in main())
+let dashboardInstanceRef = null;
+let sessionInfoRef = null;
+export function setDashboardInstance(instance) {
+    dashboardInstanceRef = instance;
+}
+export function getDashboardInstance() {
+    return dashboardInstanceRef;
+}
+export function setSessionInfo(info) {
+    sessionInfoRef = info;
+}
+export function getSessionInfo() {
+    return sessionInfoRef;
+}
+/**
+ * Get duplicate session info for blocking check
+ */
+export function getDuplicateSessionInfo() {
+    const instance = dashboardInstanceRef;
+    const session = sessionInfoRef;
+    if (!session?.sessionId) {
+        return null;
+    }
+    let allPids = [process.pid];
+    let allPpids = [process.ppid];
+    if (instance?.client) {
+        allPids = instance.client.getAllPids();
+        allPpids = instance.client.getAllPpids();
+    }
+    else if (instance?.hub) {
+        allPids = instance.hub.getAllPids();
+        allPpids = instance.hub.getAllPpids();
+    }
+    // The hub prunes a pid only on a clean websocket close, so a killed MCP stays
+    // registered and every later session reads it as a duplicate. Drop the dead
+    // ones before deciding: a stale pid should be reaped, not reported.
+    return {
+        sessionId: session.sessionId,
+        shortId: session.shortId,
+        allPids: livePids(allPids, process.pid),
+        allPpids: livePids(allPpids, process.ppid),
+        currentPid: process.pid,
+        currentPpid: process.ppid,
+    };
+}
+export function createDashboardTools() {
+    return {
+        dashboard: createTool('Manage the cdp-tools web dashboard. Actions: open (get URL to open in browser), status (show whether this session is hub or client), stop (stop the hub server if this session is the hub)', dashboardSchema, async (args) => {
+            // Use lazy-bound instance
+            const instance = dashboardInstanceRef;
+            switch (args.action) {
+                case 'open': {
+                    if (!instance) {
+                        return createErrorResponse('DASHBOARD_NOT_AVAILABLE', {
+                            reason: 'Dashboard is disabled or failed to initialize',
+                        });
+                    }
+                    const url = `http://localhost:${instance.port}`;
+                    return createSuccessResponse('DASHBOARD_OPEN', {
+                        url,
+                        type: instance.type,
+                        message: `Dashboard available at ${url}`,
+                    });
+                }
+                case 'status': {
+                    const session = sessionInfoRef;
+                    if (!instance) {
+                        return createSuccessResponse('DASHBOARD_INITIALIZING', {
+                            pid: process.pid,
+                            shortId: session?.shortId ?? '...',
+                        });
+                    }
+                    const isHub = instance.type === 'hub';
+                    return createSuccessResponse('DASHBOARD_STATUS', {
+                        enabled: true,
+                        type: instance.type,
+                        port: instance.port,
+                        isHub,
+                        sessionCount: isHub ? instance.hub?.getSessionCount() : 'N/A',
+                        url: `http://localhost:${instance.port}`,
+                        sessionId: session?.sessionId ?? 'Detecting...',
+                        shortId: session?.shortId ?? '...',
+                        pid: process.pid,
+                    });
+                }
+                case 'stop': {
+                    if (!instance) {
+                        return createErrorResponse('DASHBOARD_NOT_AVAILABLE', {
+                            reason: 'Dashboard is disabled or failed to initialize',
+                        });
+                    }
+                    if (instance.type !== 'hub') {
+                        return createErrorResponse('DASHBOARD_NOT_HUB', {
+                            reason: 'This session is a client, not the hub. Only the hub can be stopped.',
+                        });
+                    }
+                    await instance.hub?.stop();
+                    return createSuccessResponse('DASHBOARD_STOPPED', {
+                        message: 'Dashboard hub has been stopped',
+                    });
+                }
+                default:
+                    return createErrorResponse('DASHBOARD_UNKNOWN_ACTION', {
+                        action: args.action,
+                    });
+            }
+        }),
+    };
+}
+//# sourceMappingURL=dashboard-tools.js.map

package/build/tools/dashboard-tools.js.map

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

package/build/tools/dom-tools.d.ts

@@ -0,0 +1,41 @@
+/**
+ * DOM Inspection Tools
+ */
+import { z } from 'zod';
+import type { CDPManager } from '../cdp-manager.js';
+import { PuppeteerManager } from '../puppeteer-manager.js';
+import type { ConnectionManager } from '../connection-manager.js';
+export declare function createDOMTools(puppeteerManager: PuppeteerManager, cdpManager: CDPManager, connectionManager: ConnectionManager, resolveConnectionFromReason: (connectionReason: string) => Promise<any>): {
+    dom: {
+        description: string;
+        zodSchema: z.ZodObject<{
+            action: z.ZodEnum<["querySelector", "getProperties", "snapshot", "hitTest"]>;
+            connectionReason: z.ZodString;
+            selector: z.ZodOptional<z.ZodString>;
+            maxDepth: z.ZodOptional<z.ZodNumber>;
+        }, "strict", z.ZodTypeAny, {
+            action: "querySelector" | "getProperties" | "snapshot" | "hitTest";
+            connectionReason: string;
+            selector?: string | undefined;
+            maxDepth?: number | undefined;
+        }, {
+            action: "querySelector" | "getProperties" | "snapshot" | "hitTest";
+            connectionReason: string;
+            selector?: string | undefined;
+            maxDepth?: number | undefined;
+        }>;
+        inputSchema: import("zod-to-json-schema").JsonSchema7Type & {
+            $schema?: string | undefined;
+            definitions?: {
+                [key: string]: import("zod-to-json-schema").JsonSchema7Type;
+            } | undefined;
+        };
+        handler: (args: {
+            action: "querySelector" | "getProperties" | "snapshot" | "hitTest";
+            connectionReason: string;
+            selector?: string | undefined;
+            maxDepth?: number | undefined;
+        }, abortSignal?: AbortSignal) => Promise<any>;
+    };
+};
+//# sourceMappingURL=dom-tools.d.ts.map

package/build/tools/dom-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dom-tools.d.ts","sourceRoot":"","sources":["../../src/tools/dom-tools.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAiBlE,wBAAgB,cAAc,CAC5B,gBAAgB,EAAE,gBAAgB,EAClC,UAAU,EAAE,UAAU,EACtB,iBAAiB,EAAE,iBAAiB,EACpC,2BAA2B,EAAE,CAAC,gBAAgB,EAAE,MAAM,KAAK,OAAO,CAAC,GAAG,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA4TxE"}

package/build/tools/dom-tools.js

@@ -0,0 +1,277 @@
+/**
+ * DOM Inspection Tools
+ */
+import { z } from 'zod';
+import { executeWithPauseDetection } from '../debugger-aware-wrapper.js';
+import { checkBrowserAutomation } from '../error-helpers.js';
+import { createTool } from '../validation-helpers.js';
+import { createSuccessResponse, createErrorResponse, formatCodeBlock } from '../messages.js';
+import { resolveSelector, isExtendedSelector, cleanupResolvedSelector } from '../utils/selector-resolver.js';
+// Consolidated schema for DOM tools
+const domSchema = z.object({
+    action: z.enum(['querySelector', 'getProperties', 'snapshot', 'hitTest']).describe('DOM action: querySelector (find element by selector), getProperties (get detailed element properties), snapshot (get full DOM snapshot), hitTest (for every match: is it the topmost element at its own centre, and if not what covers it)'),
+    connectionReason: z.string().describe('Connection reference (use the reference from launchChrome output, e.g., "unnamed-connection-default" or your renamed tab)'),
+    // Parameters for querySelector and getProperties actions
+    selector: z.string().optional().describe('CSS selector (required for querySelector and getProperties actions). Supports extended selectors: :has-text("text") for partial match, :text("text") for exact match. Example: button:has-text("Submit")'),
+    // Parameters for snapshot action
+    maxDepth: z.number().optional().describe('Maximum depth for DOM snapshot (default: 5, for snapshot action)'),
+}).strict();
+export function createDOMTools(puppeteerManager, cdpManager, connectionManager, resolveConnectionFromReason) {
+    return {
+        dom: createTool('Inspect and query the DOM. Actions: querySelector (find element by CSS selector and get basic info), getProperties (get detailed properties of an element), snapshot (get full DOM structure snapshot)', domSchema, async (args) => {
+            const { action, connectionReason } = args;
+            // Validate required parameters for each action
+            if ((action === 'querySelector' || action === 'getProperties') && !args.selector) {
+                return createErrorResponse('MISSING_PARAMETER', {
+                    action,
+                    missing: 'selector',
+                    message: `The "${action}" action requires a "selector" parameter`
+                });
+            }
+            // Resolve connection from reason
+            const resolved = await resolveConnectionFromReason(connectionReason);
+            if (!resolved) {
+                return createErrorResponse('CONNECTION_NOT_FOUND', {
+                    message: 'No Chrome browser available. Use `launchChrome` first to start a browser.'
+                });
+            }
+            const targetPuppeteerManager = resolved.puppeteerManager || puppeteerManager;
+            const targetCdpManager = resolved.cdpManager;
+            const error = checkBrowserAutomation(targetCdpManager, targetPuppeteerManager, `dom.${action}`, resolved.connection.port);
+            if (error) {
+                return error;
+            }
+            const page = targetPuppeteerManager.getPage();
+            // Handle each action
+            switch (action) {
+                case 'querySelector': {
+                    const rawSelector = args.selector;
+                    // Resolve extended selectors (like :has-text())
+                    let selector = rawSelector;
+                    let selectorWarning;
+                    if (isExtendedSelector(selector)) {
+                        const resolved = await resolveSelector(page, selector);
+                        if ('error' in resolved) {
+                            return createErrorResponse('ELEMENT_NOT_FOUND', {
+                                selector: rawSelector,
+                                suggestion: resolved.suggestion,
+                            });
+                        }
+                        selector = resolved.selector;
+                        selectorWarning = resolved.warning;
+                    }
+                    const result = await executeWithPauseDetection(targetCdpManager, async () => {
+                        const element = await page.$(selector);
+                        if (!element) {
+                            return { found: false, selector };
+                        }
+                        // Get element properties
+                        const properties = await element.evaluate((el) => ({
+                            tagName: el.tagName.toLowerCase(),
+                            id: el.id,
+                            className: el.className,
+                            textContent: el.textContent?.substring(0, 200),
+                            visible: !!(el.offsetWidth || el.offsetHeight || el.getClientRects().length),
+                        }));
+                        return { found: true, selector, properties };
+                    }, 'querySelector');
+                    // Clean up temporary selector attribute
+                    await cleanupResolvedSelector(page, selector);
+                    // Check if element was not found
+                    if (!result.result || !result.result.found) {
+                        return createErrorResponse('ELEMENT_NOT_FOUND', { selector: rawSelector });
+                    }
+                    // Return element properties as code block
+                    let markdown = `Element found: \`${rawSelector}\`\n\n${formatCodeBlock(result.result.properties)}`;
+                    if (selectorWarning) {
+                        markdown += `\n\n**Warning:** ${selectorWarning}`;
+                    }
+                    return {
+                        content: [
+                            {
+                                type: 'text',
+                                text: markdown,
+                            },
+                        ],
+                    };
+                }
+                case 'hitTest': {
+                    const rawSelector = args.selector;
+                    let selector = rawSelector;
+                    let selectorWarning;
+                    if (isExtendedSelector(selector)) {
+                        const resolved = await resolveSelector(page, selector);
+                        if ('error' in resolved) {
+                            return createErrorResponse('ELEMENT_NOT_FOUND', {
+                                selector: rawSelector,
+                                suggestion: resolved.suggestion,
+                            });
+                        }
+                        selector = resolved.selector;
+                        selectorWarning = resolved.warning;
+                    }
+                    const result = await executeWithPauseDetection(targetCdpManager, async () => page.evaluate((sel) => {
+                        const doc = globalThis.document;
+                        const describe = (el) => {
+                            if (!el)
+                                return 'nothing';
+                            const id = el.id ? `#${el.id}` : '';
+                            const cls = typeof el.className === 'string' && el.className.trim()
+                                ? '.' + el.className.trim().split(/\s+/).slice(0, 2).join('.')
+                                : '';
+                            const label = el.getAttribute?.('aria-label');
+                            return `${el.tagName.toLowerCase()}${id}${cls}${label ? `[aria-label="${label}"]` : ''}`;
+                        };
+                        return Array.from(doc.querySelectorAll(sel)).map((el, index) => {
+                            const r = el.getBoundingClientRect();
+                            const rect = { x: Math.round(r.x), y: Math.round(r.y), width: Math.round(r.width), height: Math.round(r.height) };
+                            if (!r.width || !r.height) {
+                                return { index, rect, rendered: false, hittable: false, reason: 'zero size', self: describe(el) };
+                            }
+                            const cx = r.x + r.width / 2;
+                            const cy = r.y + r.height / 2;
+                            const inViewport = cx >= 0 && cy >= 0 && cx <= doc.documentElement.clientWidth && cy <= doc.documentElement.clientHeight;
+                            if (!inViewport) {
+                                return { index, rect, rendered: true, hittable: false, reason: 'centre is outside the viewport', self: describe(el) };
+                            }
+                            const top = doc.elementFromPoint(cx, cy);
+                            const hittable = !!top && (top === el || el.contains(top) || top.contains(el));
+                            return {
+                                index,
+                                rect,
+                                rendered: true,
+                                hittable,
+                                self: describe(el),
+                                ...(hittable ? {} : { occludedBy: describe(top), reason: 'another element is on top at its centre' }),
+                            };
+                        });
+                    }, selector), 'hitTest');
+                    await cleanupResolvedSelector(page, selector);
+                    const matches = result.result || [];
+                    if (matches.length === 0) {
+                        return createErrorResponse('ELEMENT_NOT_FOUND', { selector: rawSelector });
+                    }
+                    const hittable = matches.filter(m => m.hittable);
+                    const lines = matches.map(m => `${m.hittable ? 'HIT ' : 'MISS'} [${m.index}] ${m.self} ${m.rect.width}x${m.rect.height} at (${m.rect.x},${m.rect.y})` +
+                        (m.hittable ? '' : ` - ${m.reason}${m.occludedBy ? `: ${m.occludedBy}` : ''}`));
+                    let markdown = `hitTest \`${rawSelector}\`: ${hittable.length} of ${matches.length} hittable\n\n${lines.join('\n')}`;
+                    if (selectorWarning)
+                        markdown += `\n\n**Warning:** ${selectorWarning}`;
+                    return { content: [{ type: 'text', text: markdown }] };
+                }
+                case 'getProperties': {
+                    const rawSelector = args.selector;
+                    // Resolve extended selectors (like :has-text())
+                    let selector = rawSelector;
+                    let selectorWarning;
+                    if (isExtendedSelector(selector)) {
+                        const resolved = await resolveSelector(page, selector);
+                        if ('error' in resolved) {
+                            return createErrorResponse('ELEMENT_NOT_FOUND', {
+                                selector: rawSelector,
+                                suggestion: resolved.suggestion,
+                            });
+                        }
+                        selector = resolved.selector;
+                        selectorWarning = resolved.warning;
+                    }
+                    const result = await executeWithPauseDetection(targetCdpManager, async () => {
+                        const element = await page.$(selector);
+                        if (!element) {
+                            return { error: `Element not found: ${selector}` };
+                        }
+                        // Get detailed element properties
+                        const details = await element.evaluate((el) => {
+                            const rect = el.getBoundingClientRect();
+                            const win = (typeof globalThis.window !== 'undefined') ? globalThis.window : undefined;
+                            const styles = win?.getComputedStyle(el);
+                            // Get all attributes
+                            const attributes = {};
+                            for (const attr of el.attributes) {
+                                attributes[attr.name] = attr.value;
+                            }
+                            return {
+                                tagName: el.tagName.toLowerCase(),
+                                attributes,
+                                textContent: el.textContent,
+                                innerHTML: el.innerHTML.substring(0, 500),
+                                boundingBox: {
+                                    x: rect.x,
+                                    y: rect.y,
+                                    width: rect.width,
+                                    height: rect.height,
+                                },
+                                computedStyles: {
+                                    display: styles.display,
+                                    visibility: styles.visibility,
+                                    position: styles.position,
+                                    color: styles.color,
+                                    backgroundColor: styles.backgroundColor,
+                                    fontSize: styles.fontSize,
+                                },
+                                visible: !!(el.offsetWidth || el.offsetHeight || el.getClientRects().length),
+                            };
+                        });
+                        return { selector: rawSelector, element: details };
+                    }, 'getElementProperties');
+                    // Clean up temporary selector attribute
+                    await cleanupResolvedSelector(page, selector);
+                    // Check if element was not found
+                    if (!result.result || result.result.error) {
+                        return createErrorResponse('ELEMENT_NOT_FOUND', { selector: rawSelector });
+                    }
+                    // Return element properties as code block
+                    let markdown = `Element properties for \`${rawSelector}\`:\n\n${formatCodeBlock(result.result.element)}`;
+                    if (selectorWarning) {
+                        markdown += `\n\n**Warning:** ${selectorWarning}`;
+                    }
+                    return {
+                        content: [
+                            {
+                                type: 'text',
+                                text: markdown,
+                            },
+                        ],
+                    };
+                }
+                case 'snapshot': {
+                    const maxDepth = args.maxDepth ?? 5;
+                    const result = await executeWithPauseDetection(targetCdpManager, async () => {
+                        // Get DOM snapshot using accessibility tree
+                        const snapshot = await page.accessibility.snapshot();
+                        // Also get basic DOM structure
+                        const domStructure = await page.evaluate((depth) => {
+                            function getNodeInfo(node, currentDepth) {
+                                if (currentDepth > depth)
+                                    return null;
+                                const children = [];
+                                for (const child of node.children) {
+                                    const childInfo = getNodeInfo(child, currentDepth + 1);
+                                    if (childInfo)
+                                        children.push(childInfo);
+                                }
+                                return {
+                                    tag: node.tagName.toLowerCase(),
+                                    id: node.id || undefined,
+                                    class: node.className || undefined,
+                                    children: children.length > 0 ? children : undefined,
+                                };
+                            }
+                            const doc = (typeof globalThis.document !== 'undefined') ? globalThis.document : undefined;
+                            return getNodeInfo(doc?.body, 0);
+                        }, maxDepth);
+                        return {
+                            accessibilityTree: snapshot,
+                            domStructure,
+                        };
+                    }, 'getDOMSnapshot');
+                    // Return DOM snapshot using the message template
+                    return createSuccessResponse('DOM_SNAPSHOT_SUCCESS', { depth: maxDepth }, result.result);
+                }
+                default:
+                    return createErrorResponse('INVALID_ACTION', { action });
+            }
+        }),
+    };
+}
+//# sourceMappingURL=dom-tools.js.map

package/build/tools/dom-tools.js.map

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

package/build/tools/download-tools.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Download Tools
+ * Tools for downloading files from URLs with security and quarantine features
+ */
+import { z } from 'zod';
+interface QuarantineEntry {
+    filename: string;
+    url: string;
+    reason: string;
+    size: number;
+    contentType: string | null;
+    timestamp: string;
+}
+/**
+ * Get quarantine summary for reporting
+ */
+export declare function getQuarantineSummary(): QuarantineEntry[];
+/**
+ * Clear quarantine registry (called after reporting)
+ */
+export declare function clearQuarantineRegistry(): void;
+/**
+ * Download tools for saving files from URLs
+ */
+export declare function createDownloadTools(): {
+    saveToDisk: {
+        description: string;
+        zodSchema: z.ZodObject<{
+            url: z.ZodString;
+            filename: z.ZodString;
+            overwriteIfExists: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+        }, "strict", z.ZodTypeAny, {
+            url: string;
+            filename: string;
+            overwriteIfExists: boolean;
+        }, {
+            url: string;
+            filename: string;
+            overwriteIfExists?: boolean | undefined;
+        }>;
+        inputSchema: import("zod-to-json-schema").JsonSchema7Type & {
+            $schema?: string | undefined;
+            definitions?: {
+                [key: string]: import("zod-to-json-schema").JsonSchema7Type;
+            } | undefined;
+        };
+        handler: (args: {
+            url: string;
+            filename: string;
+            overwriteIfExists: boolean;
+        }, abortSignal?: AbortSignal) => Promise<any>;
+    };
+};
+export {};
+//# sourceMappingURL=download-tools.d.ts.map

package/build/tools/download-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"download-tools.d.ts","sourceRoot":"","sources":["../../src/tools/download-tools.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAqBxB,UAAU,eAAe;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,SAAS,EAAE,MAAM,CAAC;CACnB;AAmGD;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,eAAe,EAAE,CAExD;AAED;;GAEG;AACH,wBAAgB,uBAAuB,IAAI,IAAI,CAE9C;AAED;;GAEG;AACH,wBAAgB,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAuLlC"}