fix: Use z.coerce to correctly manage booleans with OpenCode and Codex

Author: Winify

src/tools/click.tool.ts

@@ -3,6 +3,7 @@ import { z } from 'zod';
 import type { ToolCallback } from '@modelcontextprotocol/sdk/server/mcp';
 import type { CallToolResult } from '@modelcontextprotocol/sdk/types';
 import type { ToolDefinition } from '../types/tool';
+import { coerceBoolean } from '../utils/zod-helpers';
 
 const defaultTimeout: number = 3000;
 
@@ -11,7 +12,7 @@ export const clickToolDefinition: ToolDefinition = {
   description: 'clicks an element',
   inputSchema: {
     selector: z.string().describe('Value for the selector, in the form of css selector or xpath ("button.my-class" or "//button[@class=\'my-class\']" or "button=Exact text with spaces" or "a*=Link containing text")'),
-    scrollToView: z.boolean().optional().describe('Whether to scroll the element into view before clicking').default(true),
+    scrollToView: coerceBoolean.optional().describe('Whether to scroll the element into view before clicking').default(true),
     timeout: z.number().optional().describe('Maximum time to wait for element in milliseconds'),
   },
 };

src/tools/cookies.tool.ts

@@ -3,6 +3,7 @@ import type { CallToolResult } from '@modelcontextprotocol/sdk/types';
 import type { ToolDefinition } from '../types/tool';
 import { z } from 'zod';
 import type { Cookie } from '@wdio/protocols';
+import { coerceBoolean } from '../utils/zod-helpers';
 
 export const setCookieToolDefinition: ToolDefinition = {
   name: 'set_cookie',
@@ -13,8 +14,8 @@ export const setCookieToolDefinition: ToolDefinition = {
     domain: z.string().optional().describe('Cookie domain (defaults to current domain)'),
     path: z.string().optional().describe('Cookie path (defaults to "/")'),
     expiry: z.number().optional().describe('Expiry date as Unix timestamp in seconds'),
-    httpOnly: z.boolean().optional().describe('HttpOnly flag'),
-    secure: z.boolean().optional().describe('Secure flag'),
+    httpOnly: coerceBoolean.optional().describe('HttpOnly flag'),
+    secure: coerceBoolean.optional().describe('Secure flag'),
     sameSite: z.enum(['strict', 'lax', 'none']).optional().describe('SameSite attribute'),
   },
 };

src/tools/execute-sequence.tool.ts

@@ -12,20 +12,21 @@ import { appendStep } from '../recording/step-recorder';
 import { waitForStability } from '../utils/stability-detector';
 import { captureStateDelta } from '../utils/state-diff';
 import { getInteractableBrowserElements } from '../scripts/get-interactable-browser-elements';
+import { coerceBoolean } from '../utils/zod-helpers';
 
 // Action schemas
 const clickActionSchema = z.object({
   action: z.literal('click'),
   selector: z.string(),
-  scrollToView: z.boolean().optional(),
+  scrollToView: coerceBoolean.optional(),
   timeout: z.number().optional(),
 });
 
 const setValueActionSchema = z.object({
   action: z.literal('set_value'),
   selector: z.string(),
   value: z.string(),
-  scrollToView: z.boolean().optional(),
+  scrollToView: coerceBoolean.optional(),
   timeout: z.number().optional(),
 });
 
@@ -78,7 +79,7 @@ export const executeSequenceToolDefinition: ToolDefinition = {
   description: 'Execute a sequence of actions atomically. Waits for page stability between actions. Returns a state delta showing what changed.',
   inputSchema: {
     actions: z.array(actionSchema).min(1).describe('Sequence of actions to execute'),
-    waitForStability: z.boolean().optional().default(true).describe('Wait for page stability after each action'),
+    waitForStability: coerceBoolean.optional().default(true).describe('Wait for page stability after each action'),
   },
 };
 

src/tools/launch-chrome.tool.ts

@@ -6,6 +6,7 @@ import type { ToolCallback } from '@modelcontextprotocol/sdk/server/mcp';
 import type { CallToolResult } from '@modelcontextprotocol/sdk/types';
 import type { ToolDefinition } from '../types/tool';
 import { z } from 'zod';
+import { coerceBoolean } from '../utils/zod-helpers';
 
 const USER_DATA_DIR = join(tmpdir(), 'chrome-debug');
 
@@ -29,7 +30,7 @@ After this tool succeeds, call attach_browser() to connect.`,
     mode: z.enum(['newInstance', 'freshSession']).default('newInstance').describe(
       'newInstance: open alongside existing Chrome | freshSession: clean profile'
     ),
-    copyProfileFiles: z.boolean().default(false).describe(
+    copyProfileFiles: coerceBoolean.default(false).describe(
       'Copy your Default Chrome profile (cookies, logins) into the debug session.'
     ),
   },

src/tools/session.tool.ts

@@ -8,6 +8,7 @@ import { registerSession, closeSession } from '../session/lifecycle';
 import { localBrowserProvider } from '../providers/local-browser.provider';
 import { localAppiumProvider } from '../providers/local-appium.provider';
 import type { SessionMetadata } from '../session/state';
+import { coerceBoolean } from '../utils/zod-helpers';
 
 const platformEnum = z.enum(['browser', 'ios', 'android']);
 const browserEnum = z.enum(['chrome', 'firefox', 'edge', 'safari']);
@@ -19,22 +20,22 @@ export const startSessionToolDefinition: ToolDefinition = {
   inputSchema: {
     platform: platformEnum.describe('Session platform type'),
     browser: browserEnum.optional().describe('Browser to launch (required for browser platform)'),
-    headless: z.boolean().optional().default(true).describe('Run browser in headless mode (default: true)'),
+    headless: coerceBoolean.optional().default(true).describe('Run browser in headless mode (default: true)'),
     windowWidth: z.number().min(400).max(3840).optional().default(1920).describe('Browser window width'),
     windowHeight: z.number().min(400).max(2160).optional().default(1080).describe('Browser window height'),
     deviceName: z.string().optional().describe('Mobile device/emulator/simulator name (required for ios/android)'),
     platformVersion: z.string().optional().describe('OS version (e.g., "17.0", "14")'),
     appPath: z.string().optional().describe('Path to app file (.app/.apk/.ipa)'),
     automationName: automationEnum.optional().describe('Automation driver'),
-    autoGrantPermissions: z.boolean().optional().describe('Auto-grant app permissions (default: true)'),
-    autoAcceptAlerts: z.boolean().optional().describe('Auto-accept alerts (default: true)'),
-    autoDismissAlerts: z.boolean().optional().describe('Auto-dismiss alerts (default: false)'),
+    autoGrantPermissions: coerceBoolean.optional().describe('Auto-grant app permissions (default: true)'),
+    autoAcceptAlerts: coerceBoolean.optional().describe('Auto-accept alerts (default: true)'),
+    autoDismissAlerts: coerceBoolean.optional().describe('Auto-dismiss alerts (default: false)'),
     appWaitActivity: z.string().optional().describe('Activity to wait for on Android launch'),
     udid: z.string().optional().describe('Unique Device Identifier for iOS real device'),
-    noReset: z.boolean().optional().describe('Preserve app data between sessions'),
-    fullReset: z.boolean().optional().describe('Uninstall app before/after session'),
+    noReset: coerceBoolean.optional().describe('Preserve app data between sessions'),
+    fullReset: coerceBoolean.optional().describe('Uninstall app before/after session'),
     newCommandTimeout: z.number().min(0).optional().default(300).describe('Appium command timeout in seconds'),
-    attach: z.boolean().optional().default(false).describe('Attach to existing Chrome instead of launching'),
+    attach: coerceBoolean.optional().default(false).describe('Attach to existing Chrome instead of launching'),
     port: z.number().optional().default(9222).describe('Chrome remote debugging port (for attach mode)'),
     host: z.string().optional().default('localhost').describe('Chrome host (for attach mode)'),
     appiumHost: z.string().optional().describe('Appium server hostname'),
@@ -77,7 +78,7 @@ export const closeSessionToolDefinition: ToolDefinition = {
   name: 'close_session',
   description: 'Closes or detaches from the current browser or app session',
   inputSchema: {
-    detach: z.boolean().optional().describe('If true, disconnect without terminating (preserves app state). Default: false'),
+    detach: coerceBoolean.optional().describe('If true, disconnect without terminating (preserves app state). Default: false'),
   },
 };
 

src/tools/set-value.tool.ts

@@ -3,6 +3,7 @@ import { z } from 'zod';
 import type { ToolCallback } from '@modelcontextprotocol/sdk/server/mcp';
 import type { CallToolResult } from '@modelcontextprotocol/sdk/types';
 import type { ToolDefinition } from '../types/tool';
+import { coerceBoolean } from '../utils/zod-helpers';
 
 const defaultTimeout: number = 3000;
 
@@ -12,7 +13,7 @@ export const setValueToolDefinition: ToolDefinition = {
   inputSchema: {
     selector: z.string().describe('Value for the selector, in the form of css selector or xpath ("button.my-class" or "//button[@class=\'my-class\']")'),
     value: z.string().describe('Text to enter into the element'),
-    scrollToView: z.boolean().optional().describe('Whether to scroll the element into view before typing').default(true),
+    scrollToView: coerceBoolean.optional().describe('Whether to scroll the element into view before typing').default(true),
     timeout: z.number().optional().describe('Maximum time to wait for element in milliseconds'),
   },
 };

src/utils/zod-helpers.ts

@@ -0,0 +1,11 @@
+import { z } from 'zod';
+
+export const coerceBoolean = z.preprocess((val) => {
+  if (typeof val === 'boolean') return val;
+  if (typeof val === 'string') {
+    if (val === 'false' || val === '0') return false;
+    if (val === 'true' || val === '1') return true;
+    return Boolean(val);
+  }
+  return val;
+}, z.boolean());