botrun-horse 2.30.0 → 2.34.0

package/botrun-c/dev/mcp-token-calculator/test-all-schemas.ts

@@ -1,314 +0,0 @@
-/**
- * 全面驗證所有 8 個 MCP Tools 的 Schema 正確性
- *
- * 確保優化後的 descriptions 不會影響 Claude 正確調用工具
- */
-
-// ============================================================================
-// Schema 驗證測試
-// ============================================================================
-
-interface TestResult {
-  toolName: string;
-  passed: boolean;
-  errors: string[];
-}
-
-const allTests: TestResult[] = [];
-
-function testSchema(toolName: string, schema: any, requiredFields: string[]): void {
-  const errors: string[] = [];
-
-  // 1. 檢查 inputSchema 必要欄位
-  if (!schema.type || schema.type !== 'object') {
-    errors.push('❌ inputSchema.type must be "object"');
-  }
-
-  if (!schema.properties || typeof schema.properties !== 'object') {
-    errors.push('❌ inputSchema.properties must exist and be an object');
-  }
-
-  if (!Array.isArray(schema.required)) {
-    errors.push('❌ inputSchema.required must be an array');
-  }
-
-  // 2. 驗證 required 欄位是否都在 properties 中定義
-  if (schema.required && schema.properties) {
-    for (const field of schema.required) {
-      if (!schema.properties[field]) {
-        errors.push(`❌ Required field "${field}" not found in properties`);
-      }
-    }
-  }
-
-  // 3. 驗證每個 property 都有 type 和 description
-  if (schema.properties) {
-    for (const [fieldName, fieldDef] of Object.entries(schema.properties)) {
-      const field = fieldDef as any;
-
-      if (!field.type && !field.enum) {
-        errors.push(`❌ Field "${fieldName}" missing type definition`);
-      }
-
-      if (!field.description) {
-        errors.push(`❌ Field "${fieldName}" missing description`);
-      }
-
-      // 如果是 array type，必須有 items
-      if (field.type === 'array' && !field.items) {
-        errors.push(`❌ Field "${fieldName}" is array but missing items definition`);
-      }
-
-      // 如果有 enum，必須是陣列
-      if (field.enum && !Array.isArray(field.enum)) {
-        errors.push(`❌ Field "${fieldName}" enum must be an array`);
-      }
-    }
-  }
-
-  // 4. 驗證 required 欄位列表
-  const expectedRequired = requiredFields.sort().join(',');
-  const actualRequired = (schema.required || []).sort().join(',');
-  if (expectedRequired !== actualRequired) {
-    errors.push(`❌ Required fields mismatch. Expected: [${expectedRequired}], Got: [${actualRequired}]`);
-  }
-
-  allTests.push({
-    toolName,
-    passed: errors.length === 0,
-    errors,
-  });
-}
-
-// ============================================================================
-// 測試所有工具
-// ============================================================================
-
-console.log('='.repeat(80));
-console.log('🧪 全面驗證所有 MCP Tools 的 Schema 正確性');
-console.log('='.repeat(80));
-console.log();
-
-// 1. split_pdf
-testSchema(
-  'split_pdf',
-  {
-    type: 'object',
-    properties: {
-      filePath: {
-        type: 'string',
-        description: 'PDF file path (absolute or relative)',
-      },
-      outputDir: {
-        type: 'string',
-        description: 'Output dir (optional, default: {filename}_pages)',
-      },
-    },
-    required: ['filePath'],
-  },
-  ['filePath']
-);
-
-// 2. pdf_to_text
-testSchema(
-  'pdf_to_text',
-  {
-    type: 'object',
-    properties: {
-      inputDir: {
-        type: 'string',
-        description: 'Input dir path (e.g., split PDF dir)',
-      },
-      outputDir: {
-        type: 'string',
-        description: 'Output dir (optional, default: {inputDir}_text)',
-      },
-    },
-    required: ['inputDir'],
-  },
-  ['inputDir']
-);
-
-// 3. secure_rg_search
-testSchema(
-  'secure_rg_search',
-  {
-    type: 'object',
-    properties: {
-      pattern: {
-        type: 'string',
-        description: 'Regex pattern',
-      },
-      path: {
-        type: 'string',
-        description: 'Search path (relative to working dir, default: .)',
-      },
-      args: {
-        type: 'array',
-        items: { type: 'string' },
-        description: 'Extra rg args. Ex: ["-i", "-C", "3", "--type", "js"]',
-      },
-    },
-    required: ['pattern'],
-  },
-  ['pattern']
-);
-
-// 4. read_files
-testSchema(
-  'read_files',
-  {
-    type: 'object',
-    properties: {
-      patterns: {
-        type: 'array',
-        items: {
-          type: 'string',
-        },
-        description: 'File paths or glob patterns array. Ex: ["file.txt", "*.md", "src/**/*.ts"]',
-      },
-    },
-    required: ['patterns'],
-  },
-  ['patterns']
-);
-
-// 5. list_files
-testSchema(
-  'list_files',
-  {
-    type: 'object',
-    properties: {},
-    required: [],
-  },
-  []
-);
-
-// 6. read_multimodal
-testSchema(
-  'read_multimodal',
-  {
-    type: 'object',
-    properties: {
-      filePaths: {
-        type: ['string', 'array'],
-        description: 'Path(s). String or array. Wildcards OK. Ex: "*.pdf" or ["doc.pdf","video.mp4"]',
-        items: { type: 'string' },
-      },
-      prompt: {
-        type: 'string',
-        description: 'Optional. Question to ask about the content.',
-      },
-    },
-    required: ['filePaths'],
-  },
-  ['filePaths']
-);
-
-// 7. web_search
-testSchema(
-  'web_search',
-  {
-    type: 'object',
-    properties: {
-      queries: {
-        type: ['string', 'array'],
-        description: 'Query string or array. Ex: "台灣新聞" or ["新聞","天氣","股市"]',
-        items: { type: 'string' },
-      },
-      max_uses: {
-        type: 'number',
-        description: 'Limit searches per conversation. Ex: 3',
-      },
-      allowed_domains: {
-        type: 'array',
-        items: { type: 'string' },
-        description: 'Whitelist. Ex: ["gov.tw","edu.tw"] for official sites only',
-      },
-      blocked_domains: {
-        type: 'array',
-        items: { type: 'string' },
-        description: 'Blacklist. Ex: ["spam.com"]',
-      },
-      user_location: {
-        type: 'object',
-        properties: {
-          type: { type: 'string', enum: ['approximate'] },
-          city: { type: 'string' },
-          region: { type: 'string' },
-          country: { type: 'string' },
-          timezone: { type: 'string' },
-        },
-        description: 'Localize. Ex: {type:"approximate",city:"Taipei",country:"TW",timezone:"Asia/Taipei"}',
-      },
-    },
-    required: ['queries'],
-  },
-  ['queries']
-);
-
-// 8. transcribe_audio_file
-testSchema(
-  'transcribe_audio_file',
-  {
-    type: 'object',
-    properties: {
-      filePath: {
-        type: 'string',
-        description: 'Audio file path (relative or absolute)',
-      },
-      model: {
-        type: 'string',
-        description: 'Whisper model (default: whisper-Breeze-ASR-25)',
-        enum: ['whisper-Breeze-ASR-25', 'Whisper-Large-V3'],
-      },
-    },
-    required: ['filePath'],
-  },
-  ['filePath']
-);
-
-// ============================================================================
-// 輸出測試結果
-// ============================================================================
-
-console.log('📋 測試結果：');
-console.log();
-
-let passedCount = 0;
-let failedCount = 0;
-
-allTests.forEach((test, index) => {
-  const status = test.passed ? '✅ PASS' : '❌ FAIL';
-  const icon = test.passed ? '✅' : '❌';
-
-  console.log(`${index + 1}. ${icon} ${test.toolName.padEnd(25, ' ')} ${status}`);
-
-  if (!test.passed) {
-    test.errors.forEach(error => {
-      console.log(`   ${error}`);
-    });
-    failedCount++;
-  } else {
-    passedCount++;
-  }
-});
-
-console.log();
-console.log('='.repeat(80));
-console.log('📊 測試總結：');
-console.log('='.repeat(80));
-console.log(`總計工具數量: ${allTests.length} 個`);
-console.log(`✅ 通過: ${passedCount} 個`);
-console.log(`❌ 失敗: ${failedCount} 個`);
-console.log(`通過率: ${((passedCount / allTests.length) * 100).toFixed(1)}%`);
-console.log();
-
-if (failedCount === 0) {
-  console.log('🎉 所有 Schema 驗證通過！優化成功，保持完整功能！');
-} else {
-  console.log('⚠️  部分 Schema 驗證失敗，請修正後再次測試。');
-  process.exit(1);
-}
-
-console.log('='.repeat(80));

package/botrun-c/dev/mcp-token-calculator/test-schema-correctness.ts

@@ -1,221 +0,0 @@
-/**
- * 測試優化後的 Tool Definitions Schema 正確性
- *
- * 確保：
- * 1. inputSchema 結構完全相同
- * 2. type, properties, required 欄位沒有改變
- * 3. 只有 description 欄位被精簡
- */
-
-// ============================================================================
-// 原始 Schema（從備份提取）
-// ============================================================================
-
-const ORIGINAL_WEB_SEARCH_SCHEMA = {
-  type: 'object',
-  properties: {
-    queries: {
-      type: ['string', 'array'],
-      items: { type: 'string' },
-    },
-    max_uses: {
-      type: 'number',
-    },
-    allowed_domains: {
-      type: 'array',
-      items: { type: 'string' },
-    },
-    blocked_domains: {
-      type: 'array',
-      items: { type: 'string' },
-    },
-    user_location: {
-      type: 'object',
-      properties: {
-        type: { type: 'string', enum: ['approximate'] },
-        city: { type: 'string' },
-        region: { type: 'string' },
-        country: { type: 'string' },
-        timezone: { type: 'string' },
-      },
-    },
-  },
-  required: ['queries'],
-};
-
-const ORIGINAL_READ_MULTIMODAL_SCHEMA = {
-  type: 'object',
-  properties: {
-    filePaths: {
-      type: ['string', 'array'],
-      items: { type: 'string' },
-    },
-    prompt: {
-      type: 'string',
-    },
-  },
-  required: ['filePaths'],
-};
-
-// ============================================================================
-// 優化後 Schema
-// ============================================================================
-
-const OPTIMIZED_WEB_SEARCH_SCHEMA = {
-  type: 'object',
-  properties: {
-    queries: {
-      type: ['string', 'array'],
-      items: { type: 'string' },
-    },
-    max_uses: {
-      type: 'number',
-    },
-    allowed_domains: {
-      type: 'array',
-      items: { type: 'string' },
-    },
-    blocked_domains: {
-      type: 'array',
-      items: { type: 'string' },
-    },
-    user_location: {
-      type: 'object',
-      properties: {
-        type: { type: 'string', enum: ['approximate'] },
-        city: { type: 'string' },
-        region: { type: 'string' },
-        country: { type: 'string' },
-        timezone: { type: 'string' },
-      },
-    },
-  },
-  required: ['queries'],
-};
-
-const OPTIMIZED_READ_MULTIMODAL_SCHEMA = {
-  type: 'object',
-  properties: {
-    filePaths: {
-      type: ['string', 'array'],
-      items: { type: 'string' },
-    },
-    prompt: {
-      type: 'string',
-    },
-  },
-  required: ['filePaths'],
-};
-
-// ============================================================================
-// 測試函數
-// ============================================================================
-
-function deepEqual(obj1: any, obj2: any, path: string = 'root'): { equal: boolean; errors: string[] } {
-  const errors: string[] = [];
-
-  if (obj1 === obj2) {
-    return { equal: true, errors };
-  }
-
-  if (typeof obj1 !== typeof obj2) {
-    errors.push(`${path}: Type mismatch (${typeof obj1} vs ${typeof obj2})`);
-    return { equal: false, errors };
-  }
-
-  if (Array.isArray(obj1) && Array.isArray(obj2)) {
-    if (obj1.length !== obj2.length) {
-      errors.push(`${path}: Array length mismatch (${obj1.length} vs ${obj2.length})`);
-      return { equal: false, errors };
-    }
-
-    for (let i = 0; i < obj1.length; i++) {
-      const result = deepEqual(obj1[i], obj2[i], `${path}[${i}]`);
-      if (!result.equal) {
-        errors.push(...result.errors);
-      }
-    }
-
-    return { equal: errors.length === 0, errors };
-  }
-
-  if (typeof obj1 === 'object' && obj1 !== null && obj2 !== null) {
-    const keys1 = Object.keys(obj1).sort();
-    const keys2 = Object.keys(obj2).sort();
-
-    if (keys1.length !== keys2.length) {
-      errors.push(`${path}: Object keys count mismatch (${keys1.length} vs ${keys2.length})`);
-    }
-
-    const allKeys = new Set([...keys1, ...keys2]);
-
-    for (const key of allKeys) {
-      if (!(key in obj1)) {
-        errors.push(`${path}.${key}: Missing in original`);
-      } else if (!(key in obj2)) {
-        errors.push(`${path}.${key}: Missing in optimized`);
-      } else {
-        const result = deepEqual(obj1[key], obj2[key], `${path}.${key}`);
-        if (!result.equal) {
-          errors.push(...result.errors);
-        }
-      }
-    }
-
-    return { equal: errors.length === 0, errors };
-  }
-
-  if (obj1 !== obj2) {
-    errors.push(`${path}: Value mismatch (${JSON.stringify(obj1)} vs ${JSON.stringify(obj2)})`);
-  }
-
-  return { equal: errors.length === 0, errors };
-}
-
-function testSchema(name: string, original: any, optimized: any): boolean {
-  console.log(`\n${'='.repeat(60)}`);
-  console.log(`Testing: ${name}`);
-  console.log(`${'='.repeat(60)}`);
-
-  const result = deepEqual(original, optimized);
-
-  if (result.equal) {
-    console.log('✅ PASS: Schema structure is identical');
-    return true;
-  } else {
-    console.log('❌ FAIL: Schema structure has changed!');
-    console.log('\nErrors:');
-    result.errors.forEach(error => console.log(`  - ${error}`));
-    return false;
-  }
-}
-
-// ============================================================================
-// 執行測試
-// ============================================================================
-
-console.log('='.repeat(80));
-console.log('🧪 Tool Definitions Schema 正確性測試');
-console.log('='.repeat(80));
-console.log('\n目標：確保優化後的 inputSchema 結構與原始版本完全相同');
-
-const test1 = testSchema('web_search', ORIGINAL_WEB_SEARCH_SCHEMA, OPTIMIZED_WEB_SEARCH_SCHEMA);
-const test2 = testSchema('read_multimodal', ORIGINAL_READ_MULTIMODAL_SCHEMA, OPTIMIZED_READ_MULTIMODAL_SCHEMA);
-
-console.log('\n' + '='.repeat(80));
-console.log('📊 測試結果總結');
-console.log('='.repeat(80));
-
-if (test1 && test2) {
-  console.log('\n✅ 所有測試通過！');
-  console.log('\n✅ Schema 結構完全正確，功能保證不受影響');
-  console.log('✅ 只有 description 欄位被精簡，參數結構沒有改變');
-  console.log('✅ Claude 可以正確理解和調用這些 tools');
-  console.log('\n🎉 優化成功！可以安全部署。');
-} else {
-  console.log('\n❌ 測試失敗！');
-  console.log('⚠️  Schema 結構有變化，可能影響功能正確性');
-  console.log('⚠️  請檢查上述錯誤並修正');
-}
-
-console.log('\n' + '='.repeat(80));

package/botrun-c/dev/mcp-token-calculator/verify-optimization.ts

@@ -1,159 +0,0 @@
-/**
- * 驗證優化後的 MCP Tool Definitions Token 使用量
- */
-
-import { encoding_for_model } from 'tiktoken';
-
-const encoder = encoding_for_model('gpt-4');
-
-function countTokens(text: string): number {
-  const tokens = encoder.encode(text);
-  return tokens.length;
-}
-
-// ============================================================================
-// 優化後的 Tool Definitions（直接從修改後的源碼提取）
-// ============================================================================
-
-const OPTIMIZED_TOOLS = {
-  web_search: {
-    name: 'web_search',
-    description: 'Web search (Brave + Claude Haiku 4.5, Taiwan endpoint). Returns TC summary + citations.',
-    inputSchema: {
-      type: 'object',
-      properties: {
-        queries: {
-          type: ['string', 'array'],
-          description: 'Query string or array. Ex: "台灣新聞" or ["新聞","天氣","股市"]',
-          items: { type: 'string' },
-        },
-        max_uses: {
-          type: 'number',
-          description: 'Limit searches per conversation. Ex: 3',
-        },
-        allowed_domains: {
-          type: 'array',
-          items: { type: 'string' },
-          description: 'Whitelist. Ex: ["gov.tw","edu.tw"] for official sites only',
-        },
-        blocked_domains: {
-          type: 'array',
-          items: { type: 'string' },
-          description: 'Blacklist. Ex: ["spam.com"]',
-        },
-        user_location: {
-          type: 'object',
-          properties: {
-            type: { type: 'string', enum: ['approximate'] },
-            city: { type: 'string' },
-            region: { type: 'string' },
-            country: { type: 'string' },
-            timezone: { type: 'string' },
-          },
-          description: 'Localize. Ex: {type:"approximate",city:"Taipei",country:"TW",timezone:"Asia/Taipei"}',
-        },
-      },
-      required: ['queries'],
-    },
-  },
-
-  read_multimodal: {
-    name: 'read_multimodal',
-    description: 'Multimodal reader (Claude Haiku 4.5, Taiwan). Doc: PDF/TXT. Image: PNG/JPG/WebP. Video: MP4/MOV/WebM. Audio: MP3/WAV/AAC. Max 30 files, glob support.',
-    inputSchema: {
-      type: 'object',
-      properties: {
-        filePaths: {
-          type: ['string', 'array'],
-          description: 'Path(s). String or array. Wildcards OK. Ex: "*.pdf" or ["doc.pdf","video.mp4"]',
-          items: { type: 'string' },
-        },
-        prompt: {
-          type: 'string',
-          description: 'Optional. Question to ask about the content.',
-        },
-      },
-      required: ['filePaths'],
-    },
-  },
-};
-
-// ============================================================================
-// 計算並比較
-// ============================================================================
-
-console.log('='.repeat(80));
-console.log('✅ 優化後的 Token 使用量驗證');
-console.log('='.repeat(80));
-console.log();
-
-const webSearchJson = JSON.stringify(OPTIMIZED_TOOLS.web_search, null, 2);
-const readMultimodalJson = JSON.stringify(OPTIMIZED_TOOLS.read_multimodal, null, 2);
-
-const webSearchTokens = countTokens(webSearchJson);
-const readMultimodalTokens = countTokens(readMultimodalJson);
-const totalTokens = webSearchTokens + readMultimodalTokens;
-
-// 原始數據
-const ORIGINAL_WEB_SEARCH = 1934;
-const ORIGINAL_READ_MULTIMODAL = 647;
-const ORIGINAL_TOTAL = 2581;
-
-console.log('📊 優化結果：');
-console.log();
-console.log('| Tool             | 原始 Tokens | 優化後 Tokens | 減少量 | 減少比例 |');
-console.log('|------------------|------------:|--------------:|-------:|---------:|');
-console.log(`| web_search       |       ${ORIGINAL_WEB_SEARCH} |           ${webSearchTokens.toString().padStart(3)} |  ${(ORIGINAL_WEB_SEARCH - webSearchTokens).toString().padStart(5)} |   ${(((ORIGINAL_WEB_SEARCH - webSearchTokens) / ORIGINAL_WEB_SEARCH) * 100).toFixed(1)}% |`);
-console.log(`| read_multimodal  |        ${ORIGINAL_READ_MULTIMODAL} |           ${readMultimodalTokens.toString().padStart(3)} |    ${(ORIGINAL_READ_MULTIMODAL - readMultimodalTokens).toString().padStart(3)} |   ${(((ORIGINAL_READ_MULTIMODAL - readMultimodalTokens) / ORIGINAL_READ_MULTIMODAL) * 100).toFixed(1)}% |`);
-console.log('|------------------|------------:|--------------:|-------:|---------:|');
-console.log(`| **總計**         |   **${ORIGINAL_TOTAL}** |       **${totalTokens.toString().padStart(3)}** |  **${(ORIGINAL_TOTAL - totalTokens).toString().padStart(5)}** | **${(((ORIGINAL_TOTAL - totalTokens) / ORIGINAL_TOTAL) * 100).toFixed(1)}%** |`);
-
-console.log();
-console.log('='.repeat(80));
-console.log('🎯 優化效果總結');
-console.log('='.repeat(80));
-console.log();
-
-const reductionFactor = ORIGINAL_TOTAL / totalTokens;
-console.log(`✅ 成功減少 ${ORIGINAL_TOTAL - totalTokens} tokens (${(((ORIGINAL_TOTAL - totalTokens) / ORIGINAL_TOTAL) * 100).toFixed(1)}%)`);
-console.log(`✅ 濃縮倍數：${reductionFactor.toFixed(2)}x (原本的 1/${reductionFactor.toFixed(1)})`);
-console.log();
-
-if (reductionFactor >= 4.0) {
-  console.log('🏆 優化成效：優秀！達到 4 倍以上縮減');
-} else if (reductionFactor >= 3.0) {
-  console.log('🎉 優化成效：良好！達到 3 倍以上縮減');
-} else if (reductionFactor >= 2.0) {
-  console.log('👍 優化成效：合格，達到 2 倍以上縮減');
-} else {
-  console.log('⚠️  優化成效：不足，建議進一步精簡');
-}
-
-console.log();
-console.log('='.repeat(80));
-console.log('📈 所有 8 個 MCP Tools 的預估總 Token 負擔');
-console.log('='.repeat(80));
-console.log();
-
-// 其他 6 個 tools 的 token 數（未修改）
-const OTHER_TOOLS_TOKENS = 190 + 194 + 208 + 221 + 262 + 243; // split_pdf + list_files + pdf_to_text + read_files + secure_rg + transcribe_audio
-
-const newTotalAll = totalTokens + OTHER_TOOLS_TOKENS;
-const originalTotalAll = 3899;
-
-console.log(`原始總負擔（8 個 tools）: ${originalTotalAll} tokens`);
-console.log(`優化後總負擔（8 個 tools）: ${newTotalAll} tokens`);
-console.log(`總共減少: ${originalTotalAll - newTotalAll} tokens (${(((originalTotalAll - newTotalAll) / originalTotalAll) * 100).toFixed(1)}%)`);
-console.log();
-
-console.log('💡 實際應用場景：');
-console.log(`  - 初始載入 (ListTools): ${newTotalAll} tokens`);
-console.log(`  - 100 次對話 (如果每次都傳): ${(newTotalAll * 100).toLocaleString()} tokens`);
-console.log(`  - 節省成本 (vs 原版): ${((originalTotalAll - newTotalAll) * 100).toLocaleString()} tokens`);
-
-console.log();
-console.log('='.repeat(80));
-console.log('✅ 驗證完成！');
-console.log('='.repeat(80));
-
-encoder.free();