@jshookmcp/jshook 0.1.9 → 0.2.1

package/dist/src/server/domains/browser/handlers/captcha-solver.js

@@ -1,3 +1,4 @@
+import { argString, argNumber, argBool } from '../../../domains/shared/parse-args.js';
 import { logger } from '../../../../utils/logger.js';
 import { CAPTCHA_SOLVER_BASE_URL, CAPTCHA_SUBMIT_TIMEOUT_MS, CAPTCHA_POLL_INTERVAL_MS, CAPTCHA_RESULT_TIMEOUT_MS, CAPTCHA_DEFAULT_TIMEOUT_MS, CAPTCHA_MIN_TIMEOUT_MS, CAPTCHA_MAX_TIMEOUT_MS, CAPTCHA_MAX_RETRIES, CAPTCHA_DEFAULT_RETRIES, } from '../../../../constants.js';
 function sleep(ms) {
@@ -127,14 +128,14 @@ export async function handleCaptchaVisionSolve(args, collector) {
         throw new Error('No active page.');
     const mode = normalizeSolverMode(args.mode ?? args.provider ?? process.env.CAPTCHA_PROVIDER);
     const externalService = resolveExternalServiceName(args);
-    const apiKey = args.apiKey || process.env.CAPTCHA_API_KEY || '';
+    const apiKey = argString(args, 'apiKey', '') || process.env.CAPTCHA_API_KEY || '';
     const challengeTypeHint = normalizeChallengeTypeHint(args.challengeType ?? args.typeHint);
-    const timeoutMs = Math.min(Math.max(args.timeoutMs ?? CAPTCHA_DEFAULT_TIMEOUT_MS, CAPTCHA_MIN_TIMEOUT_MS), CAPTCHA_MAX_TIMEOUT_MS);
-    const maxRetries = Math.min(Math.max(args.maxRetries ?? CAPTCHA_DEFAULT_RETRIES, 0), CAPTCHA_MAX_RETRIES);
+    const timeoutMs = Math.min(Math.max(argNumber(args, 'timeoutMs', CAPTCHA_DEFAULT_TIMEOUT_MS), CAPTCHA_MIN_TIMEOUT_MS), CAPTCHA_MAX_TIMEOUT_MS);
+    const maxRetries = Math.min(Math.max(argNumber(args, 'maxRetries', CAPTCHA_DEFAULT_RETRIES), 0), CAPTCHA_MAX_RETRIES);
     let challengeType = challengeTypeHint;
     let taskKind = challengeTypeHint === 'image' ? 'image' : 'recaptcha_v2';
-    let siteKey = args.siteKey;
-    const pageUrl = args.pageUrl || page.url();
+    let siteKey = argString(args, 'siteKey');
+    const pageUrl = argString(args, 'pageUrl', '') || page.url();
     if (challengeType === 'auto') {
         const detected = await page.evaluate(() => {
             if (document.querySelector('[data-sitekey]')) {
@@ -228,11 +229,11 @@ export async function handleWidgetChallengeSolve(args, collector) {
         throw new Error('No active page.');
     const mode = normalizeSolverMode(args.mode ?? args.provider ?? process.env.CAPTCHA_PROVIDER);
     const externalService = resolveExternalServiceName(args);
-    const apiKey = args.apiKey || process.env.CAPTCHA_API_KEY || '';
-    const timeoutMs = Math.min(Math.max(args.timeoutMs ?? 120_000, 5_000), 600_000);
-    const injectToken = args.injectToken ?? true;
-    let siteKey = args.siteKey;
-    const pageUrl = args.pageUrl || page.url();
+    const apiKey = argString(args, 'apiKey', '') || process.env.CAPTCHA_API_KEY || '';
+    const timeoutMs = Math.min(Math.max(argNumber(args, 'timeoutMs', 120_000), 5_000), 600_000);
+    const injectToken = argBool(args, 'injectToken', true);
+    let siteKey = argString(args, 'siteKey');
+    const pageUrl = argString(args, 'pageUrl', '') || page.url();
     if (!siteKey) {
         siteKey = await page.evaluate(() => {
             const el = document.querySelector('.cf-turnstile[data-sitekey], [data-sitekey]');

package/dist/src/server/domains/browser/handlers/console-handlers.js

@@ -1,3 +1,4 @@
+import { argString, argNumber } from '../../../domains/shared/parse-args.js';
 export class ConsoleHandlers {
     deps;
     constructor(deps) {
@@ -18,9 +19,9 @@ export class ConsoleHandlers {
         };
     }
     async handleConsoleGetLogs(args) {
-        const type = args.type;
-        const limit = args.limit;
-        const since = args.since;
+        const type = argString(args, 'type');
+        const limit = argNumber(args, 'limit');
+        const since = argNumber(args, 'since');
         const logs = this.deps.consoleMonitor.getLogs({ type, limit, since });
         const result = {
             count: logs.length,
@@ -37,7 +38,7 @@ export class ConsoleHandlers {
         };
     }
     async handleConsoleExecute(args) {
-        const expression = args.expression;
+        const expression = argString(args, 'expression', '');
         const result = await this.deps.consoleMonitor.execute(expression);
         return {
             content: [

package/dist/src/server/domains/browser/handlers/detailed-data.js

@@ -1,3 +1,4 @@
+import { argString } from '../../../domains/shared/parse-args.js';
 export class DetailedDataHandlers {
     deps;
     constructor(deps) {
@@ -5,8 +6,8 @@ export class DetailedDataHandlers {
     }
     async handleGetDetailedData(args) {
         try {
-            const detailId = args.detailId;
-            const path = args.path;
+            const detailId = argString(args, 'detailId', '');
+            const path = argString(args, 'path');
             const data = this.deps.detailedDataManager.retrieve(detailId, path);
             return {
                 content: [

package/dist/src/server/domains/browser/handlers/dom-query.js

@@ -1,11 +1,12 @@
+import { argString, argNumber, argBool } from '../../../domains/shared/parse-args.js';
 export class DOMQueryHandlers {
     deps;
     constructor(deps) {
         this.deps = deps;
     }
     async handleDOMQuerySelector(args) {
-        const selector = args.selector;
-        const getAttributes = args.getAttributes ?? true;
+        const selector = argString(args, 'selector', '');
+        const getAttributes = argBool(args, 'getAttributes', true);
         const element = await this.deps.domInspector.querySelector(selector, getAttributes);
         return {
             content: [
@@ -17,8 +18,8 @@ export class DOMQueryHandlers {
         };
     }
     async handleDOMQueryAll(args) {
-        const selector = args.selector;
-        const limit = args.limit ?? 100;
+        const selector = argString(args, 'selector', '');
+        const limit = argNumber(args, 'limit', 100);
         const result = await this.deps.domInspector.querySelectorAll(selector, limit);
         return {
             content: [
@@ -34,8 +35,8 @@ export class DOMQueryHandlers {
         };
     }
     async handleDOMGetStructure(args) {
-        const maxDepth = args.maxDepth ?? 3;
-        const includeText = args.includeText ?? true;
+        const maxDepth = argNumber(args, 'maxDepth', 3);
+        const includeText = argBool(args, 'includeText', true);
         const structure = await this.deps.domInspector.getStructure(maxDepth, includeText);
         return {
             content: [
@@ -47,7 +48,7 @@ export class DOMQueryHandlers {
         };
     }
     async handleDOMFindClickable(args) {
-        const filterText = args.filterText;
+        const filterText = argString(args, 'filterText');
         const result = await this.deps.domInspector.findClickable(filterText);
         return {
             content: [

package/dist/src/server/domains/browser/handlers/dom-search.js

@@ -1,11 +1,12 @@
+import { argString } from '../../../domains/shared/parse-args.js';
 export class DOMSearchHandlers {
     deps;
     constructor(deps) {
         this.deps = deps;
     }
     async handleDOMFindByText(args) {
-        const text = args.text;
-        const tag = args.tag;
+        const text = argString(args, 'text', '');
+        const tag = argString(args, 'tag');
         const elements = await this.deps.domInspector.findByText(text, tag);
         return {
             content: [
@@ -20,7 +21,7 @@ export class DOMSearchHandlers {
         };
     }
     async handleDOMGetXPath(args) {
-        const selector = args.selector;
+        const selector = argString(args, 'selector', '');
         const xpath = await this.deps.domInspector.getXPath(selector);
         return {
             content: [

package/dist/src/server/domains/browser/handlers/dom-style.js

@@ -1,10 +1,11 @@
+import { argString } from '../../../domains/shared/parse-args.js';
 export class DOMStyleHandlers {
     deps;
     constructor(deps) {
         this.deps = deps;
     }
     async handleDOMGetComputedStyle(args) {
-        const selector = args.selector;
+        const selector = argString(args, 'selector', '');
         const styles = await this.deps.domInspector.getComputedStyle(selector);
         return {
             content: [
@@ -19,7 +20,7 @@ export class DOMStyleHandlers {
         };
     }
     async handleDOMIsInViewport(args) {
-        const selector = args.selector;
+        const selector = argString(args, 'selector', '');
         const inViewport = await this.deps.domInspector.isInViewport(selector);
         return {
             content: [

package/dist/src/server/domains/browser/handlers/framework-state.js

@@ -1,12 +1,13 @@
+import { argString, argNumber } from '../../../domains/shared/parse-args.js';
 export class FrameworkStateHandlers {
     deps;
     constructor(deps) {
         this.deps = deps;
     }
     async handleFrameworkStateExtract(args) {
-        const framework = args.framework ?? 'auto';
-        const selector = args.selector ?? '';
-        const maxDepth = args.maxDepth ?? 5;
+        const framework = argString(args, 'framework', 'auto');
+        const selector = argString(args, 'selector', '');
+        const maxDepth = argNumber(args, 'maxDepth', 5);
         try {
             const page = (await this.deps.getActivePage());
             const result = await page.evaluate((opts) => {

package/dist/src/server/domains/browser/handlers/human-behavior.js

@@ -1,3 +1,4 @@
+import { argString, argNumber, argBool } from '../../../domains/shared/parse-args.js';
 function cubicBezier(p0, p1, p2, p3, t) {
     const u = 1 - t;
     const uu = u * u;
@@ -47,31 +48,32 @@ export async function handleHumanMouse(args, collector) {
     const page = await collector.getActivePage();
     if (!page)
         throw new Error('No active page. Use browser_launch or browser_attach first.');
-    let toX = args.toX;
-    let toY = args.toY;
-    if (typeof args.selector === 'string' && args.selector) {
+    let toX = argNumber(args, 'toX');
+    let toY = argNumber(args, 'toY');
+    const selector = argString(args, 'selector');
+    if (selector) {
         const box = await page.evaluate((sel) => {
             const el = document.querySelector(sel);
             if (!el)
                 return null;
             const rect = el.getBoundingClientRect();
             return { x: rect.x + rect.width / 2, y: rect.y + rect.height / 2 };
-        }, args.selector);
+        }, selector);
         if (!box)
-            throw new Error(`Selector not found: ${args.selector}`);
+            throw new Error(`Selector not found: ${selector}`);
         toX = box.x;
         toY = box.y;
     }
     if (toX === undefined || toY === undefined) {
         throw new Error('Either selector or toX/toY coordinates are required');
     }
-    const fromX = args.fromX ?? 0;
-    const fromY = args.fromY ?? 0;
-    const steps = Math.max(1, Math.min(args.steps ?? 24, 500));
-    const durationMs = Math.max(10, Math.min(args.durationMs ?? 600, 30000));
-    const jitterPx = Math.max(0, Math.min(args.jitterPx ?? 1.5, 20));
-    const curve = args.curve ?? 'ease';
-    const shouldClick = args.click ?? false;
+    const fromX = argNumber(args, 'fromX', 0);
+    const fromY = argNumber(args, 'fromY', 0);
+    const steps = Math.max(1, Math.min(argNumber(args, 'steps', 24), 500));
+    const durationMs = Math.max(10, Math.min(argNumber(args, 'durationMs', 600), 30000));
+    const jitterPx = Math.max(0, Math.min(argNumber(args, 'jitterPx', 1.5), 20));
+    const curve = argString(args, 'curve', 'ease');
+    const shouldClick = argBool(args, 'click', false);
     const from = { x: fromX, y: fromY };
     const to = { x: toX, y: toY };
     const [cp1, cp2] = generateControlPoints(from, to);
@@ -105,12 +107,12 @@ export async function handleHumanScroll(args, collector) {
     const page = await collector.getActivePage();
     if (!page)
         throw new Error('No active page.');
-    const distance = Math.max(1, Math.min(args.distance ?? 500, 10000));
-    const direction = args.direction ?? 'down';
-    const segments = Math.max(1, Math.min(args.segments ?? 8, 200));
-    const pauseMs = Math.max(0, Math.min(args.pauseMs ?? 80, 5000));
-    const jitter = Math.max(0, Math.min(args.jitter ?? 0.3, 1));
-    const selector = args.selector;
+    const distance = Math.max(1, Math.min(argNumber(args, 'distance', 500), 10000));
+    const direction = argString(args, 'direction', 'down');
+    const segments = Math.max(1, Math.min(argNumber(args, 'segments', 8), 200));
+    const pauseMs = Math.max(0, Math.min(argNumber(args, 'pauseMs', 80), 5000));
+    const jitter = Math.max(0, Math.min(argNumber(args, 'jitter', 0.3), 1));
+    const selector = argString(args, 'selector');
     const isVertical = direction === 'up' || direction === 'down';
     const sign = (direction === 'down' || direction === 'right') ? 1 : -1;
     let scrolled = 0;
@@ -150,12 +152,12 @@ export async function handleHumanTyping(args, collector) {
     const page = await collector.getActivePage();
     if (!page)
         throw new Error('No active page.');
-    const selector = args.selector;
-    const text = args.text;
-    const wpm = Math.max(10, Math.min(args.wpm ?? 90, 300));
-    const errorRate = Math.max(0, Math.min(args.errorRate ?? 0.02, 0.3));
-    const correctDelayMs = Math.max(50, Math.min(args.correctDelayMs ?? 200, 2000));
-    const clearFirst = args.clearFirst ?? false;
+    const selector = argString(args, 'selector', '');
+    const text = argString(args, 'text', '');
+    const wpm = Math.max(10, Math.min(argNumber(args, 'wpm', 90), 300));
+    const errorRate = Math.max(0, Math.min(argNumber(args, 'errorRate', 0.02), 0.3));
+    const correctDelayMs = Math.max(50, Math.min(argNumber(args, 'correctDelayMs', 200), 2000));
+    const clearFirst = argBool(args, 'clearFirst', false);
     if (!selector || !text) {
         throw new Error('selector and text are required');
     }

package/dist/src/server/domains/browser/handlers/indexeddb-dump.js

@@ -1,12 +1,13 @@
+import { argString, argNumber } from '../../../domains/shared/parse-args.js';
 export class IndexedDBDumpHandlers {
     deps;
     constructor(deps) {
         this.deps = deps;
     }
     async handleIndexedDBDump(args) {
-        const database = args.database ?? '';
-        const store = args.store ?? '';
-        const maxRecords = args.maxRecords ?? 100;
+        const database = argString(args, 'database', '');
+        const store = argString(args, 'store', '');
+        const maxRecords = argNumber(args, 'maxRecords', 100);
         try {
             const page = (await this.deps.getActivePage());
             const result = await page.evaluate(async (opts) => {

package/dist/src/server/domains/browser/handlers/js-heap.js

@@ -1,6 +1,7 @@
 import { DetailedDataManager } from '../../../../utils/DetailedDataManager.js';
 import { cdpLimit } from '../../../../utils/concurrency.js';
 import { logger } from '../../../../utils/logger.js';
+import { argString, argNumber, argBool } from '../../../domains/shared/parse-args.js';
 const NODE_TYPE_NAMES = [
     'hidden',
     'array',
@@ -40,9 +41,9 @@ export class JSHeapSearchHandlers {
         this.detailedDataManager = DetailedDataManager.getInstance();
     }
     async handleJSHeapSearch(args) {
-        const pattern = typeof args.pattern === 'string' ? args.pattern : '';
-        const maxResults = typeof args.maxResults === 'number' ? args.maxResults : 50;
-        const caseSensitive = typeof args.caseSensitive === 'boolean' ? args.caseSensitive : false;
+        const pattern = argString(args, 'pattern', '');
+        const maxResults = argNumber(args, 'maxResults', 50);
+        const caseSensitive = argBool(args, 'caseSensitive', false);
         if (!pattern) {
             return {
                 content: [{

package/dist/src/server/domains/browser/handlers/page-data.js

@@ -1,3 +1,4 @@
+import { argString, argNumber } from '../../../domains/shared/parse-args.js';
 export class PageDataHandlers {
     deps;
     constructor(deps) {
@@ -61,8 +62,8 @@ export class PageDataHandlers {
         };
     }
     async handlePageSetViewport(args) {
-        const width = args.width;
-        const height = args.height;
+        const width = argNumber(args, 'width', 0);
+        const height = argNumber(args, 'height', 0);
         await this.deps.pageController.setViewport(width, height);
         return {
             content: [
@@ -77,7 +78,7 @@ export class PageDataHandlers {
         };
     }
     async handlePageEmulateDevice(args) {
-        const device = args.device;
+        const device = argString(args, 'device', '');
         await this.deps.pageController.emulateDevice(device);
         return {
             content: [
@@ -106,8 +107,8 @@ export class PageDataHandlers {
         };
     }
     async handlePageSetLocalStorage(args) {
-        const key = args.key;
-        const value = args.value;
+        const key = argString(args, 'key', '');
+        const value = argString(args, 'value', '');
         await this.deps.pageController.setLocalStorage(key, value);
         return {
             content: [

package/dist/src/server/domains/browser/handlers/page-evaluation.js

@@ -1,4 +1,5 @@
 import { resolveScreenshotOutputPath } from '../../../../utils/outputPaths.js';
+import { argString, argNumber, argBool, argObject, argStringArray } from '../../../domains/shared/parse-args.js';
 function filterFields(value, fields) {
     if (Array.isArray(value)) {
         return value.map((item) => filterFields(item, fields));
@@ -44,11 +45,11 @@ export class PageEvaluationHandlers {
         this.deps = deps;
     }
     async handlePageEvaluate(args) {
-        const code = (args.script ?? args.code);
-        const autoSummarize = args.autoSummarize ?? true;
-        const maxSize = args.maxSize ?? 51200;
-        const fieldFilterArg = args.fieldFilter;
-        const doStripBase64 = args.stripBase64 ?? false;
+        const code = argString(args, 'script', '') || argString(args, 'code', '');
+        const autoSummarize = argBool(args, 'autoSummarize', true);
+        const maxSize = argNumber(args, 'maxSize', 51200);
+        const fieldFilterArg = argStringArray(args, 'fieldFilter');
+        const doStripBase64 = argBool(args, 'stripBase64', false);
         const applyPostFilters = (raw) => {
             let out = raw;
             if (fieldFilterArg && fieldFilterArg.length > 0) {
@@ -88,11 +89,11 @@ export class PageEvaluationHandlers {
         };
     }
     async handlePageScreenshot(args) {
-        const requestedPath = args.path;
-        const type = (args.type || 'png');
-        const quality = args.quality;
-        const fullPage = args.fullPage;
-        const clipArg = args.clip;
+        const requestedPath = argString(args, 'path');
+        const type = (argString(args, 'type', 'png'));
+        const quality = argNumber(args, 'quality');
+        const fullPage = argBool(args, 'fullPage', false);
+        const clipArg = argObject(args, 'clip');
         const rawSelector = args.selector;
         const selectors = [];
         if (Array.isArray(rawSelector)) {
@@ -249,7 +250,7 @@ export class PageEvaluationHandlers {
         };
     }
     async handlePageInjectScript(args) {
-        const script = args.script;
+        const script = argString(args, 'script', '');
         await this.deps.pageController.injectScript(script);
         return {
             content: [
@@ -264,8 +265,8 @@ export class PageEvaluationHandlers {
         };
     }
     async handlePageWaitForSelector(args) {
-        const selector = args.selector;
-        const timeout = args.timeout;
+        const selector = argString(args, 'selector', '');
+        const timeout = argNumber(args, 'timeout');
         if (this.deps.getActiveDriver() === 'camoufox') {
             const page = (await this.deps.getCamoufoxPage());
             try {

package/dist/src/server/domains/browser/handlers/page-interaction.js

@@ -1,3 +1,4 @@
+import { argString, argNumber, argStringArray } from '../../../domains/shared/parse-args.js';
 export class PageInteractionHandlers {
     deps;
     constructor(deps) {
@@ -50,7 +51,7 @@ export class PageInteractionHandlers {
         return 'left';
     }
     async handlePageClick(args) {
-        const selector = args.selector;
+        const selector = argString(args, 'selector', '');
         const button = this.parseMouseButton(args.button);
         const clickCount = this.parseNumberArg(args.clickCount, {
             defaultValue: 1,
@@ -126,9 +127,9 @@ export class PageInteractionHandlers {
         };
     }
     async handlePageType(args) {
-        const selector = args.selector;
-        const text = args.text;
-        const delay = args.delay;
+        const selector = argString(args, 'selector', '');
+        const text = argString(args, 'text', '');
+        const delay = argNumber(args, 'delay');
         if (this.deps.getActiveDriver() === 'camoufox') {
             const page = (await this.deps.getCamoufoxPage());
             await page.fill(selector, text);
@@ -155,8 +156,8 @@ export class PageInteractionHandlers {
         };
     }
     async handlePageSelect(args) {
-        const selector = args.selector;
-        const values = args.values;
+        const selector = argString(args, 'selector', '');
+        const values = argStringArray(args, 'values');
         if (this.deps.getActiveDriver() === 'camoufox') {
             const page = (await this.deps.getCamoufoxPage());
             await page.selectOption(selector, values);
@@ -187,7 +188,7 @@ export class PageInteractionHandlers {
         };
     }
     async handlePageHover(args) {
-        const selector = args.selector;
+        const selector = argString(args, 'selector', '');
         if (this.deps.getActiveDriver() === 'camoufox') {
             const page = (await this.deps.getCamoufoxPage());
             await page.hover(selector);
@@ -218,8 +219,8 @@ export class PageInteractionHandlers {
         };
     }
     async handlePageScroll(args) {
-        const x = args.x;
-        const y = args.y;
+        const x = argNumber(args, 'x', 0);
+        const y = argNumber(args, 'y', 0);
         if (this.deps.getActiveDriver() === 'camoufox') {
             const page = (await this.deps.getCamoufoxPage());
             await page.evaluate((position) => {
@@ -252,7 +253,7 @@ export class PageInteractionHandlers {
         };
     }
     async handlePagePressKey(args) {
-        const key = args.key;
+        const key = argString(args, 'key', '');
         if (this.deps.getActiveDriver() === 'camoufox') {
             const page = (await this.deps.getCamoufoxPage());
             await page.keyboard.press(key);

package/dist/src/server/domains/browser/handlers/page-navigation.js

@@ -1,13 +1,14 @@
+import { argString, argNumber, argBool } from '../../../domains/shared/parse-args.js';
 export class PageNavigationHandlers {
     deps;
     constructor(deps) {
         this.deps = deps;
     }
     async handlePageNavigate(args) {
-        const url = args.url;
-        const rawWaitUntil = args.waitUntil || 'networkidle';
-        const timeout = args.timeout;
-        const enableNetworkMonitoring = args.enableNetworkMonitoring;
+        const url = argString(args, 'url', '');
+        const rawWaitUntil = argString(args, 'waitUntil', 'networkidle');
+        const timeout = argNumber(args, 'timeout');
+        const enableNetworkMonitoring = argBool(args, 'enableNetworkMonitoring');
         if (this.deps.getActiveDriver() === 'camoufox') {
             const playwrightWaitUntil = rawWaitUntil === 'networkidle2' ? 'networkidle' : rawWaitUntil;
             const page = (await this.deps.getCamoufoxPage());

package/dist/src/server/domains/browser/handlers/script-management.js

@@ -1,12 +1,13 @@
+import { argString, argNumber, argBool } from '../../../domains/shared/parse-args.js';
 export class ScriptManagementHandlers {
     deps;
     constructor(deps) {
         this.deps = deps;
     }
     async handleGetAllScripts(args) {
-        const includeSource = args.includeSource ?? false;
+        const includeSource = argBool(args, 'includeSource', false);
         const MAX_SCRIPTS_CAP = 500;
-        const maxScripts = Math.min(args.maxScripts ?? (includeSource ? 200 : 1000), MAX_SCRIPTS_CAP);
+        const maxScripts = Math.min(argNumber(args, 'maxScripts', includeSource ? 200 : 1000), MAX_SCRIPTS_CAP);
         const scripts = await this.deps.scriptManager.getAllScripts(includeSource, maxScripts);
         const data = { count: scripts.length, scripts };
         const processed = this.deps.detailedDataManager.smartHandle(data);
@@ -20,12 +21,12 @@ export class ScriptManagementHandlers {
         };
     }
     async handleGetScriptSource(args) {
-        const scriptId = args.scriptId;
-        const url = args.url;
-        const preview = args.preview ?? false;
-        const maxLines = args.maxLines ?? 100;
-        const startLine = args.startLine;
-        const endLine = args.endLine;
+        const scriptId = argString(args, 'scriptId');
+        const url = argString(args, 'url');
+        const preview = argBool(args, 'preview', false);
+        const maxLines = argNumber(args, 'maxLines', 100);
+        const startLine = argNumber(args, 'startLine');
+        const endLine = argNumber(args, 'endLine');
         const script = await this.deps.scriptManager.getScriptSource(scriptId, url);
         if (!script) {
             return {

package/dist/src/server/domains/browser/handlers/stealth-injection.js

@@ -1,4 +1,5 @@
 import { StealthScripts } from '../../../domains/shared/modules.js';
+import { argString } from '../../../domains/shared/parse-args.js';
 export class StealthInjectionHandlers {
     deps;
     constructor(deps) {
@@ -34,7 +35,7 @@ export class StealthInjectionHandlers {
         };
     }
     async handleStealthSetUserAgent(args) {
-        const platform = args.platform || 'windows';
+        const platform = argString(args, 'platform', 'windows');
         const page = await this.deps.pageController.getPage();
         await StealthScripts.setRealisticUserAgent(page, platform);
         return {

package/dist/src/server/domains/browser/handlers.impl.js

@@ -1,4 +1,5 @@
 import { AICaptchaDetector } from '../../domains/shared/modules.js';
+import { argString, argNumber, argBool } from '../../domains/shared/parse-args.js';
 import { DetailedDataManager } from '../../../utils/DetailedDataManager.js';
 import { resolveOutputDirectory } from '../../../utils/outputPaths.js';
 import { logger } from '../../../utils/logger.js';
@@ -139,7 +140,7 @@ export class BrowserToolHandlers {
         }
     }
     async handleBrowserLaunch(args) {
-        const driver = args.driver || 'chrome';
+        const driver = argString(args, 'driver', 'chrome');
         if (driver === 'camoufox') {
             return this.handleCamoufoxLaunch(args);
         }
@@ -280,7 +281,7 @@ export class BrowserToolHandlers {
         return this.domQuery.handleDOMQueryAll(args);
     }
     async handleDOMGetStructure(args) {
-        const structure = await this.domInspector.getStructure(args.maxDepth ?? 3, args.includeText ?? true);
+        const structure = await this.domInspector.getStructure(argNumber(args, 'maxDepth', 3), argBool(args, 'includeText', true));
         const processedStructure = this.detailedDataManager.smartHandle(structure, 51200);
         return {
             content: [{