feat: Add suppressWarnings option to reduce context window usage

Adds a new optional 'suppressWarnings' parameter to build and test tools
that filters warning messages from output, helping AI assistants conserve
context window space when warnings are not relevant to the task.

Affected tools:
- build_device, test_device
- build_macos, build_run_macos, test_macos
- build_sim, build_run_sim, test_sim
- clean

Includes unit tests for the warning suppression logic.

Author: codeman9

src/mcp/tools/device/build_device.ts

@@ -25,6 +25,10 @@ const baseSchemaObject = z.object({
   derivedDataPath: z.string().optional().describe('Path to derived data directory'),
   extraArgs: z.array(z.string()).optional().describe('Additional arguments to pass to xcodebuild'),
   preferXcodebuild: z.boolean().optional().describe('Prefer xcodebuild over faster alternatives'),
+  suppressWarnings: z
+    .boolean()
+    .optional()
+    .describe('If true, suppresses warning messages from build output to reduce context usage'),
 });
 
 const baseSchema = z.preprocess(nullifyEmptyStrings, baseSchemaObject);

src/mcp/tools/device/test_device.ts

@@ -47,6 +47,10 @@ const baseSchemaObject = z.object({
     .describe(
       'Environment variables to pass to the test runner (TEST_RUNNER_ prefix added automatically)',
     ),
+  suppressWarnings: z
+    .boolean()
+    .optional()
+    .describe('If true, suppresses warning messages from build output to reduce context usage'),
 });
 
 const baseSchema = z.preprocess(nullifyEmptyStrings, baseSchemaObject);

src/mcp/tools/macos/build_macos.ts

@@ -46,6 +46,10 @@ const baseSchemaObject = z.object({
     .boolean()
     .optional()
     .describe('If true, prefers xcodebuild over the experimental incremental build system'),
+  suppressWarnings: z
+    .boolean()
+    .optional()
+    .describe('If true, suppresses warning messages from build output to reduce context usage'),
 });
 
 const baseSchema = z.preprocess(nullifyEmptyStrings, baseSchemaObject);

src/mcp/tools/macos/build_run_macos.ts

@@ -37,6 +37,10 @@ const baseSchemaObject = z.object({
     .boolean()
     .optional()
     .describe('If true, prefers xcodebuild over the experimental incremental build system'),
+  suppressWarnings: z
+    .boolean()
+    .optional()
+    .describe('If true, suppresses warning messages from build output to reduce context usage'),
 });
 
 const baseSchema = z.preprocess(nullifyEmptyStrings, baseSchemaObject);

src/mcp/tools/macos/test_macos.ts

@@ -48,6 +48,10 @@ const baseSchemaObject = z.object({
     .describe(
       'Environment variables to pass to the test runner (TEST_RUNNER_ prefix added automatically)',
     ),
+  suppressWarnings: z
+    .boolean()
+    .optional()
+    .describe('If true, suppresses warning messages from build output to reduce context usage'),
 });
 
 const baseSchema = z.preprocess(nullifyEmptyStrings, baseSchemaObject);

src/mcp/tools/simulator/build_run_sim.ts

@@ -51,6 +51,10 @@ const baseOptions = {
     .describe(
       'If true, prefers xcodebuild over the experimental incremental build system, useful for when incremental build system fails.',
     ),
+  suppressWarnings: z
+    .boolean()
+    .optional()
+    .describe('If true, suppresses warning messages from build output to reduce context usage'),
 };
 
 const baseSchemaObject = z.object({

src/mcp/tools/simulator/build_sim.ts

@@ -49,6 +49,10 @@ const baseOptions = {
     .describe(
       'If true, prefers xcodebuild over the experimental incremental build system, useful for when incremental build system fails.',
     ),
+  suppressWarnings: z
+    .boolean()
+    .optional()
+    .describe('If true, suppresses warning messages from build output to reduce context usage'),
 };
 
 const baseSchemaObject = z.object({

src/mcp/tools/simulator/test_sim.ts

@@ -64,6 +64,10 @@ const baseSchemaObject = z.object({
     .describe(
       'Environment variables to pass to the test runner (TEST_RUNNER_ prefix added automatically)',
     ),
+  suppressWarnings: z
+    .boolean()
+    .optional()
+    .describe('If true, suppresses warning messages from build output to reduce context usage'),
 });
 
 // Apply preprocessor to handle empty strings
@@ -113,6 +117,7 @@ export async function test_simLogic(
       preferXcodebuild: params.preferXcodebuild ?? false,
       platform: XcodePlatform.iOSSimulator,
       testRunnerEnv: params.testRunnerEnv,
+      suppressWarnings: params.suppressWarnings,
     },
     executor,
   );

src/mcp/tools/utilities/clean.ts

@@ -51,6 +51,10 @@ const baseOptions = {
     .describe(
       'Optional: Platform to clean for (defaults to iOS). Choose from macOS, iOS, iOS Simulator, watchOS, watchOS Simulator, tvOS, tvOS Simulator, visionOS, visionOS Simulator',
     ),
+  suppressWarnings: z
+    .boolean()
+    .optional()
+    .describe('If true, suppresses warning messages from build output to reduce context usage'),
 };
 
 const baseSchemaObject = z.object({

src/types/common.ts

@@ -94,6 +94,7 @@ export interface SharedBuildParams {
   configuration: string;
   derivedDataPath?: string;
   extraArgs?: string[];
+  suppressWarnings?: boolean;
 }
 
 /**