feat: add CLI commands for fetch pattern demonstration

- Add fetch-example command with backend, cache, and user-agent options
- Add configure-fetch command for runtime fetch configuration
- Implement comprehensive option parsing and error handling
- Provide clear CLI help and command descriptions
- Total of 3 CLI commands now available

Author: Mearman

src/cli.ts

@@ -7,6 +7,7 @@ import chalk from 'chalk';
 import { Command } from 'commander';
 import ora from 'ora';
 import { exampleTool } from './tools/example.js';
+import { configureFetchTool, fetchExampleTool } from './tools/fetch-example.js';
 
 /**
  * Create and configure the CLI command structure
@@ -49,5 +50,89 @@ export function createCLI() {
 			}
 		});
 
+	// Fetch example tool command
+	program
+		.command('fetch-example <url>')
+		.description('Demonstrate configurable fetch patterns with different backends and caching')
+		.option(
+			'-b, --backend <backend>',
+			'Fetch backend to use (built-in, cache-memory, cache-disk)',
+		)
+		.option('--no-cache', 'Bypass cache for this request')
+		.option('-u, --user-agent <agent>', 'Custom User-Agent header for this request')
+		.action(
+			async (
+				url: string,
+				options: { backend?: string; cache?: boolean; userAgent?: string },
+			) => {
+				const spinner = ora('Fetching data...').start();
+				try {
+					const args: any = { url };
+					if (options.backend) args.backend = options.backend;
+					if (options.cache === false) args.no_cache = true;
+					if (options.userAgent) args.user_agent = options.userAgent;
+
+					const result = await fetchExampleTool(args);
+
+					if (result.isError) {
+						spinner.fail(chalk.red('Error fetching data'));
+						console.error(chalk.red(result.content[0].text));
+						process.exit(1);
+					} else {
+						spinner.succeed(chalk.green('Fetch completed!'));
+						console.log(result.content[0].text);
+					}
+				} catch (error) {
+					spinner.fail(chalk.red('Error fetching data'));
+					console.error(error);
+					process.exit(1);
+				}
+			},
+		);
+
+	// Configure fetch tool command
+	program
+		.command('configure-fetch')
+		.description('Configure the global fetch instance settings and caching behavior')
+		.option('-b, --backend <backend>', 'Default fetch backend to use')
+		.option('-t, --cache-ttl <ms>', 'Cache TTL in milliseconds', Number.parseInt)
+		.option('-d, --cache-dir <dir>', 'Directory for disk caching')
+		.option('-u, --user-agent <agent>', 'Default User-Agent header')
+		.option('--clear-cache', 'Clear all caches')
+		.action(
+			async (options: {
+				backend?: string;
+				cacheTtl?: number;
+				cacheDir?: string;
+				userAgent?: string;
+				clearCache?: boolean;
+			}) => {
+				const spinner = ora('Updating fetch configuration...').start();
+				try {
+					const args: any = {};
+					if (options.backend) args.backend = options.backend;
+					if (options.cacheTtl) args.cache_ttl = options.cacheTtl;
+					if (options.cacheDir) args.cache_dir = options.cacheDir;
+					if (options.userAgent) args.user_agent = options.userAgent;
+					if (options.clearCache) args.clear_cache = true;
+
+					const result = await configureFetchTool(args);
+
+					if (result.isError) {
+						spinner.fail(chalk.red('Error updating configuration'));
+						console.error(chalk.red(result.content[0].text));
+						process.exit(1);
+					} else {
+						spinner.succeed(chalk.green('Configuration updated!'));
+						console.log(result.content[0].text);
+					}
+				} catch (error) {
+					spinner.fail(chalk.red('Error updating configuration'));
+					console.error(error);
+					process.exit(1);
+				}
+			},
+		);
+
 	return program;
 }