kiku-agent 1.3.0 → 1.3.1

package/server/agent/telemetry/techPowerUpClient.js

@@ -0,0 +1,682 @@
+import { promises as fs } from 'node:fs';
+import path from 'node:path';
+import { createHash } from 'node:crypto';
+import { KIKU_DATA_DIR } from '../appPaths.js';
+import { mcpClientManager } from '../mcpClient.js';
+import { fileURLToPath } from 'node:url';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+const TECHPOWERUP_MCP_CONFIG_PATH = path.join(__dirname, 'techpowerup-mcp.json');
+
+let techPowerUpMcpConfigCache = null;
+
+export async function loadTechPowerUpMcpConfig() {
+  if (techPowerUpMcpConfigCache) return techPowerUpMcpConfigCache;
+  try {
+    const content = await fs.readFile(TECHPOWERUP_MCP_CONFIG_PATH, 'utf8');
+    const parsed = JSON.parse(content);
+    if (parsed && typeof parsed === 'object') techPowerUpMcpConfigCache = parsed;
+    return parsed;
+  } catch {
+    return { mcpServers: {} };
+  }
+}
+
+export const TECHPOWERUP_MCP_CONFIG = Object.freeze({
+  'techpowerup-gpu': {
+    type: 'http',
+    url: 'https://www.techpowerup.com/gpu-specs/api/mcp',
+    toolName: 'search_gpu_cards',
+    queryArg: 'query'
+  },
+  'techpowerup-cpu': {
+    type: 'http',
+    url: 'https://www.techpowerup.com/cpu-specs/api/mcp',
+    toolName: 'search_cpus',
+    queryArg: 'query'
+  },
+  'techpowerup-ssd': {
+    type: 'http',
+    url: 'https://www.techpowerup.com/ssd-specs/api/mcp',
+    toolName: 'search_ssds',
+    queryArg: 'query'
+  }
+});
+
+export const HARDWARE_RESOLUTION_SOURCE = Object.freeze({
+  MCP_TECHPOWERUP_GPU: 'mcp:techpowerup-gpu',
+  MCP_TECHPOWERUP_CPU: 'mcp:techpowerup-cpu',
+  MCP_TECHPOWERUP_SSD: 'mcp:techpowerup-ssd',
+  KNOWN_DATABASE: 'known_database',
+  HEURISTIC_FALLBACK: 'heuristic_fallback'
+});
+
+const MCP_RESOLUTION_ORDER = [
+  'techpowerup-gpu',
+  'techpowerup-cpu',
+  'techpowerup-ssd'
+];
+
+
+export const KNOWN_GPU_SPECS = [
+ 
+  { match: /rtx 5090\b/i, name: 'GeForce RTX 5090 32GB', vramGb: 32, busBits: 512, bandwidthGbs: 1792.0, arch: 'Blackwell GB202', pcie: 'PCIe 5.0 x16', memoryType: 'GDDR7' },
+  { match: /rtx 5080\b/i, name: 'GeForce RTX 5080 16GB', vramGb: 16, busBits: 256, bandwidthGbs: 1024.0, arch: 'Blackwell GB203', pcie: 'PCIe 5.0 x16', memoryType: 'GDDR7' },
+  { match: /rtx 5070 ti\b/i, name: 'GeForce RTX 5070 Ti 16GB', vramGb: 16, busBits: 256, bandwidthGbs: 896.0, arch: 'Blackwell GB203', pcie: 'PCIe 5.0 x16', memoryType: 'GDDR7' },
+  { match: /rtx 5070\b/i, name: 'GeForce RTX 5070 12GB', vramGb: 12, busBits: 192, bandwidthGbs: 672.0, arch: 'Blackwell GB205', pcie: 'PCIe 5.0 x16', memoryType: 'GDDR7' },
+
+ 
+  { match: /rtx 4090\b/i, name: 'GeForce RTX 4090 24GB', vramGb: 24, busBits: 384, bandwidthGbs: 1008.0, arch: 'Ada AD102', pcie: 'PCIe 4.0 x16', memoryType: 'GDDR6X' },
+  { match: /rtx 4090\s*d\b/i, name: 'GeForce RTX 4090 D 24GB', vramGb: 24, busBits: 384, bandwidthGbs: 1008.0, arch: 'Ada AD102', pcie: 'PCIe 4.0 x16', memoryType: 'GDDR6X' },
+  { match: /rtx 4080 super\b/i, name: 'GeForce RTX 4080 SUPER 16GB', vramGb: 16, busBits: 256, bandwidthGbs: 736.0, arch: 'Ada AD103', pcie: 'PCIe 4.0 x16', memoryType: 'GDDR6X' },
+  { match: /rtx 4080\b/i, name: 'GeForce RTX 4080 16GB', vramGb: 16, busBits: 256, bandwidthGbs: 716.8, arch: 'Ada AD103', pcie: 'PCIe 4.0 x16', memoryType: 'GDDR6X' },
+  { match: /rtx 4070 ti super\b/i, name: 'GeForce RTX 4070 Ti SUPER 16GB', vramGb: 16, busBits: 256, bandwidthGbs: 672.3, arch: 'Ada AD103', pcie: 'PCIe 4.0 x16', memoryType: 'GDDR6X' },
+  { match: /rtx 4070 ti\b/i, name: 'GeForce RTX 4070 Ti 12GB', vramGb: 12, busBits: 192, bandwidthGbs: 504.2, arch: 'Ada AD104', pcie: 'PCIe 4.0 x16', memoryType: 'GDDR6X' },
+  { match: /rtx 4070 super\b/i, name: 'GeForce RTX 4070 SUPER 12GB', vramGb: 12, busBits: 192, bandwidthGbs: 504.2, arch: 'Ada AD104', pcie: 'PCIe 4.0 x16', memoryType: 'GDDR6X' },
+  { match: /rtx 4070\b/i, name: 'GeForce RTX 4070 12GB', vramGb: 12, busBits: 192, bandwidthGbs: 504.2, arch: 'Ada AD104', pcie: 'PCIe 4.0 x16', memoryType: 'GDDR6X' },
+  { match: /rtx 4060 ti\b/i, name: 'GeForce RTX 4060 Ti 16GB', vramGb: 16, busBits: 128, bandwidthGbs: 288.0, arch: 'Ada AD106', pcie: 'PCIe 4.0 x8', memoryType: 'GDDR6' },
+  { match: /rtx 4060 ti\b/i, name: 'GeForce RTX 4060 Ti 8GB', vramGb: 8, busBits: 128, bandwidthGbs: 288.0, arch: 'Ada AD106', pcie: 'PCIe 4.0 x8', memoryType: 'GDDR6' },
+  { match: /rtx 4060\b/i, name: 'GeForce RTX 4060 8GB', vramGb: 8, busBits: 128, bandwidthGbs: 272.0, arch: 'Ada AD107', pcie: 'PCIe 4.0 x8', memoryType: 'GDDR6' },
+  { match: /rtx 4050\b/i, name: 'GeForce RTX 4050 Laptop 6GB', vramGb: 6, busBits: 96, bandwidthGbs: 192.0, arch: 'Ada AD107', pcie: 'PCIe 4.0 x8', memoryType: 'GDDR6' },
+
+ 
+  { match: /rtx 3090 ti\b/i, name: 'GeForce RTX 3090 Ti 24GB', vramGb: 24, busBits: 384, bandwidthGbs: 1008.0, arch: 'Ampere GA102', pcie: 'PCIe 4.0 x16', memoryType: 'GDDR6X' },
+  { match: /rtx 3090\b/i, name: 'GeForce RTX 3090 24GB', vramGb: 24, busBits: 384, bandwidthGbs: 936.2, arch: 'Ampere GA102', pcie: 'PCIe 4.0 x16', memoryType: 'GDDR6X' },
+  { match: /rtx 3080 ti\b/i, name: 'GeForce RTX 3080 Ti 12GB', vramGb: 12, busBits: 384, bandwidthGbs: 912.4, arch: 'Ampere GA102', pcie: 'PCIe 4.0 x16', memoryType: 'GDDR6X' },
+  { match: /rtx 3080\b/i, name: 'GeForce RTX 3080 12GB', vramGb: 12, busBits: 384, bandwidthGbs: 912.0, arch: 'Ampere GA102', pcie: 'PCIe 4.0 x16', memoryType: 'GDDR6X' },
+  { match: /rtx 3080\b/i, name: 'GeForce RTX 3080 10GB', vramGb: 10, busBits: 320, bandwidthGbs: 760.3, arch: 'Ampere GA102', pcie: 'PCIe 4.0 x16', memoryType: 'GDDR6X' },
+  { match: /rtx 3070 ti\b/i, name: 'GeForce RTX 3070 Ti 8GB', vramGb: 8, busBits: 256, bandwidthGbs: 608.3, arch: 'Ampere GA104', pcie: 'PCIe 4.0 x16', memoryType: 'GDDR6X' },
+  { match: /rtx 3070\b/i, name: 'GeForce RTX 3070 8GB', vramGb: 8, busBits: 256, bandwidthGbs: 448.0, arch: 'Ampere GA104', pcie: 'PCIe 4.0 x16', memoryType: 'GDDR6' },
+  { match: /rtx 3060 ti\b/i, name: 'GeForce RTX 3060 Ti 8GB', vramGb: 8, busBits: 256, bandwidthGbs: 448.0, arch: 'Ampere GA104', pcie: 'PCIe 4.0 x16', memoryType: 'GDDR6' },
+  { match: /rtx 3060.*(laptop|mobile)/i, name: 'GeForce RTX 3060 Laptop 6GB', vramGb: 6, busBits: 192, bandwidthGbs: 336.0, arch: 'Ampere GA106', pcie: 'PCIe 4.0 x16', memoryType: 'GDDR6' },
+  { match: /rtx 3060\b/i, name: 'GeForce RTX 3060 12GB', vramGb: 12, busBits: 192, bandwidthGbs: 360.0, arch: 'Ampere GA106', pcie: 'PCIe 4.0 x16', memoryType: 'GDDR6' },
+  { match: /rtx 3060\b/i, name: 'GeForce RTX 3060 8GB', vramGb: 8, busBits: 128, bandwidthGbs: 240.0, arch: 'Ampere GA106', pcie: 'PCIe 4.0 x16', memoryType: 'GDDR6' },
+  { match: /rtx 3050\b/i, name: 'GeForce RTX 3050 8GB', vramGb: 8, busBits: 128, bandwidthGbs: 224.0, arch: 'Ampere GA106', pcie: 'PCIe 4.0 x8', memoryType: 'GDDR6' },
+  { match: /rtx 3050\b/i, name: 'GeForce RTX 3050 6GB', vramGb: 6, busBits: 96, bandwidthGbs: 168.0, arch: 'Ampere GA107', pcie: 'PCIe 4.0 x8', memoryType: 'GDDR6' },
+
+  
+  { match: /titan rtx\b/i, name: 'NVIDIA TITAN RTX 24GB', vramGb: 24, busBits: 384, bandwidthGbs: 672.0, arch: 'Turing TU102', pcie: 'PCIe 3.0 x16', memoryType: 'GDDR6' },
+  { match: /rtx 2080 ti.*(22|mod)/i, name: 'GeForce RTX 2080 Ti 22GB (AI Mod)', vramGb: 22, busBits: 352, bandwidthGbs: 616.0, arch: 'Turing TU102', pcie: 'PCIe 3.0 x16', memoryType: 'GDDR6' },
+  { match: /rtx 2080 ti\b/i, name: 'GeForce RTX 2080 Ti 22GB (AI Mod)', vramGb: 22, busBits: 352, bandwidthGbs: 616.0, arch: 'Turing TU102', pcie: 'PCIe 3.0 x16', memoryType: 'GDDR6' },
+  { match: /rtx 2080 ti\b/i, name: 'GeForce RTX 2080 Ti 11GB', vramGb: 11, busBits: 352, bandwidthGbs: 616.0, arch: 'Turing TU102', pcie: 'PCIe 3.0 x16', memoryType: 'GDDR6' },
+  { match: /rtx 2080 super\b/i, name: 'GeForce RTX 2080 SUPER 8GB', vramGb: 8, busBits: 256, bandwidthGbs: 496.0, arch: 'Turing TU104', pcie: 'PCIe 3.0 x16', memoryType: 'GDDR6' },
+  { match: /rtx 2080\b/i, name: 'GeForce RTX 2080 8GB', vramGb: 8, busBits: 256, bandwidthGbs: 448.0, arch: 'Turing TU104', pcie: 'PCIe 3.0 x16', memoryType: 'GDDR6' },
+  { match: /rtx 2070 super\b/i, name: 'GeForce RTX 2070 SUPER 8GB', vramGb: 8, busBits: 256, bandwidthGbs: 448.0, arch: 'Turing TU104', pcie: 'PCIe 3.0 x16', memoryType: 'GDDR6' },
+  { match: /rtx 2070\b/i, name: 'GeForce RTX 2070 8GB', vramGb: 8, busBits: 256, bandwidthGbs: 448.0, arch: 'Turing TU106', pcie: 'PCIe 3.0 x16', memoryType: 'GDDR6' },
+  { match: /rtx 2060 super\b/i, name: 'GeForce RTX 2060 SUPER 8GB', vramGb: 8, busBits: 256, bandwidthGbs: 448.0, arch: 'Turing TU106', pcie: 'PCIe 3.0 x16', memoryType: 'GDDR6' },
+  { match: /rtx 2060\b/i, name: 'GeForce RTX 2060 12GB', vramGb: 12, busBits: 192, bandwidthGbs: 336.0, arch: 'Turing TU106', pcie: 'PCIe 3.0 x16', memoryType: 'GDDR6' },
+  { match: /rtx 2060\b/i, name: 'GeForce RTX 2060 6GB', vramGb: 6, busBits: 192, bandwidthGbs: 336.0, arch: 'Turing TU106', pcie: 'PCIe 3.0 x16', memoryType: 'GDDR6' },
+  { match: /gtx 1660 ti\b/i, name: 'GeForce GTX 1660 Ti 6GB', vramGb: 6, busBits: 192, bandwidthGbs: 288.0, arch: 'Turing TU116', pcie: 'PCIe 3.0 x16', memoryType: 'GDDR6' },
+  { match: /gtx 1660 super\b/i, name: 'GeForce GTX 1660 SUPER 6GB', vramGb: 6, busBits: 192, bandwidthGbs: 336.0, arch: 'Turing TU116', pcie: 'PCIe 3.0 x16', memoryType: 'GDDR6' },
+  { match: /gtx 1660\b/i, name: 'GeForce GTX 1660 6GB', vramGb: 6, busBits: 192, bandwidthGbs: 192.0, arch: 'Turing TU116', pcie: 'PCIe 3.0 x16', memoryType: 'GDDR5' },
+  { match: /gtx 1650 super\b/i, name: 'GeForce GTX 1650 SUPER 4GB', vramGb: 4, busBits: 128, bandwidthGbs: 192.0, arch: 'Turing TU116', pcie: 'PCIe 3.0 x16', memoryType: 'GDDR6' },
+  { match: /gtx 1650\b/i, name: 'GeForce GTX 1650 4GB', vramGb: 4, busBits: 128, bandwidthGbs: 128.0, arch: 'Turing TU117', pcie: 'PCIe 3.0 x16', memoryType: 'GDDR5' },
+
+ 
+  { match: /titan x(p|\s*pascal)?\b/i, name: 'NVIDIA TITAN Xp 12GB', vramGb: 12, busBits: 384, bandwidthGbs: 547.7, arch: 'Pascal GP102', pcie: 'PCIe 3.0 x16', memoryType: 'GDDR5X' },
+  { match: /gtx 1080 ti\b/i, name: 'GeForce GTX 1080 Ti 11GB', vramGb: 11, busBits: 352, bandwidthGbs: 484.4, arch: 'Pascal GP102', pcie: 'PCIe 3.0 x16', memoryType: 'GDDR5X' },
+  { match: /gtx 1080\b/i, name: 'GeForce GTX 1080 8GB', vramGb: 8, busBits: 256, bandwidthGbs: 320.3, arch: 'Pascal GP104', pcie: 'PCIe 3.0 x16', memoryType: 'GDDR5X' },
+  { match: /gtx 1070 ti\b/i, name: 'GeForce GTX 1070 Ti 8GB', vramGb: 8, busBits: 256, bandwidthGbs: 256.3, arch: 'Pascal GP104', pcie: 'PCIe 3.0 x16', memoryType: 'GDDR5' },
+  { match: /gtx 1070\b/i, name: 'GeForce GTX 1070 8GB', vramGb: 8, busBits: 256, bandwidthGbs: 256.3, arch: 'Pascal GP104', pcie: 'PCIe 3.0 x16', memoryType: 'GDDR5' },
+  { match: /gtx 1060\b/i, name: 'GeForce GTX 1060 6GB', vramGb: 6, busBits: 192, bandwidthGbs: 192.2, arch: 'Pascal GP106', pcie: 'PCIe 3.0 x16', memoryType: 'GDDR5' },
+  { match: /gtx 1060\b/i, name: 'GeForce GTX 1060 3GB', vramGb: 3, busBits: 192, bandwidthGbs: 192.2, arch: 'Pascal GP106', pcie: 'PCIe 3.0 x16', memoryType: 'GDDR5' },
+
+
+
+  { match: /b200\b/i, name: 'NVIDIA B200 SXM 192GB HBM3e', vramGb: 192, busBits: 8192, bandwidthGbs: 8000.0, arch: 'Blackwell GB100', pcie: 'SXM6', memoryType: 'HBM3e' },
+  { match: /h200\b/i, name: 'NVIDIA H200 141GB HBM3e', vramGb: 141, busBits: 6144, bandwidthGbs: 4800.0, arch: 'Hopper GH100', pcie: 'SXM5', memoryType: 'HBM3e' },
+  { match: /h100.*sxm/i, name: 'NVIDIA H100 SXM5 80GB HBM3', vramGb: 80, busBits: 5120, bandwidthGbs: 3350.0, arch: 'Hopper GH100', pcie: 'SXM5', memoryType: 'HBM3' },
+  { match: /h100.*nvl/i, name: 'NVIDIA H100 NVL 94GB HBM3', vramGb: 94, busBits: 5120, bandwidthGbs: 3900.0, arch: 'Hopper GH100', pcie: 'PCIe 5.0 x16', memoryType: 'HBM3' },
+  { match: /h100\b/i, name: 'NVIDIA H100 PCIe 80GB HBM2e', vramGb: 80, busBits: 5120, bandwidthGbs: 2039.0, arch: 'Hopper GH100', pcie: 'PCIe 5.0 x16', memoryType: 'HBM2e' },
+  { match: /a100\b/i, name: 'NVIDIA A100 80GB HBM2e', vramGb: 80, busBits: 5120, bandwidthGbs: 2039.0, arch: 'Ampere GA100', pcie: 'PCIe 4.0 x16 / SXM4', memoryType: 'HBM2e' },
+  { match: /a100\b/i, name: 'NVIDIA A100 40GB HBM2', vramGb: 40, busBits: 5120, bandwidthGbs: 1555.0, arch: 'Ampere GA100', pcie: 'PCIe 4.0 x16 / SXM4', memoryType: 'HBM2' },
+  { match: /a800\b/i, name: 'NVIDIA A800 80GB HBM2e', vramGb: 80, busBits: 5120, bandwidthGbs: 2039.0, arch: 'Ampere GA100', pcie: 'PCIe 4.0 x16', memoryType: 'HBM2e' },
+  { match: /l40s\b/i, name: 'NVIDIA L40S 48GB', vramGb: 48, busBits: 384, bandwidthGbs: 864.0, arch: 'Ada AD102', pcie: 'PCIe 4.0 x16', memoryType: 'GDDR6' },
+  { match: /l40\b/i, name: 'NVIDIA L40 48GB', vramGb: 48, busBits: 384, bandwidthGbs: 864.0, arch: 'Ada AD102', pcie: 'PCIe 4.0 x16', memoryType: 'GDDR6' },
+  { match: /l4\b/i, name: 'NVIDIA L4 24GB', vramGb: 24, busBits: 192, bandwidthGbs: 300.0, arch: 'Ada AD104', pcie: 'PCIe 4.0 x16', memoryType: 'GDDR6' },
+  { match: /rtx 6000 ada\b/i, name: 'NVIDIA RTX 6000 Ada Generation 48GB', vramGb: 48, busBits: 384, bandwidthGbs: 960.0, arch: 'Ada AD102', pcie: 'PCIe 4.0 x16', memoryType: 'GDDR6' },
+  { match: /rtx 5000 ada\b/i, name: 'NVIDIA RTX 5000 Ada Generation 32GB', vramGb: 32, busBits: 256, bandwidthGbs: 576.0, arch: 'Ada AD102', pcie: 'PCIe 4.0 x16', memoryType: 'GDDR6' },
+  { match: /rtx 4500 ada\b/i, name: 'NVIDIA RTX 4500 Ada Generation 24GB', vramGb: 24, busBits: 192, bandwidthGbs: 432.0, arch: 'Ada AD104', pcie: 'PCIe 4.0 x16', memoryType: 'GDDR6' },
+  { match: /rtx 4000.*sff ada\b/i, name: 'NVIDIA RTX 4000 SFF Ada Generation 20GB', vramGb: 20, busBits: 160, bandwidthGbs: 280.0, arch: 'Ada AD104', pcie: 'PCIe 4.0 x16', memoryType: 'GDDR6' },
+  { match: /rtx 4000 ada\b/i, name: 'NVIDIA RTX 4000 Ada Generation 20GB', vramGb: 20, busBits: 160, bandwidthGbs: 360.0, arch: 'Ada AD104', pcie: 'PCIe 4.0 x16', memoryType: 'GDDR6' },
+  { match: /rtx 2000 ada\b/i, name: 'NVIDIA RTX 2000 Ada Generation 16GB', vramGb: 16, busBits: 128, bandwidthGbs: 224.0, arch: 'Ada AD107', pcie: 'PCIe 4.0 x8', memoryType: 'GDDR6' },
+  { match: /rtx a6000\b/i, name: 'NVIDIA RTX A6000 48GB', vramGb: 48, busBits: 384, bandwidthGbs: 768.0, arch: 'Ampere GA102', pcie: 'PCIe 4.0 x16', memoryType: 'GDDR6' },
+  { match: /rtx a5500\b/i, name: 'NVIDIA RTX A5500 24GB', vramGb: 24, busBits: 384, bandwidthGbs: 768.0, arch: 'Ampere GA102', pcie: 'PCIe 4.0 x16', memoryType: 'GDDR6' },
+  { match: /rtx a5000\b/i, name: 'NVIDIA RTX A5000 24GB', vramGb: 24, busBits: 384, bandwidthGbs: 768.0, arch: 'Ampere GA102', pcie: 'PCIe 4.0 x16', memoryType: 'GDDR6' },
+  { match: /rtx a4500\b/i, name: 'NVIDIA RTX A4500 20GB', vramGb: 20, busBits: 320, bandwidthGbs: 640.0, arch: 'Ampere GA102', pcie: 'PCIe 4.0 x16', memoryType: 'GDDR6' },
+  { match: /rtx a4000\b/i, name: 'NVIDIA RTX A4000 16GB', vramGb: 16, busBits: 256, bandwidthGbs: 448.0, arch: 'Ampere GA104', pcie: 'PCIe 4.0 x16', memoryType: 'GDDR6' },
+  { match: /rtx a2000\b/i, name: 'NVIDIA RTX A2000 12GB', vramGb: 12, busBits: 192, bandwidthGbs: 288.0, arch: 'Ampere GA106', pcie: 'PCIe 4.0 x16', memoryType: 'GDDR6' },
+  { match: /rtx a2000\b/i, name: 'NVIDIA RTX A2000 6GB', vramGb: 6, busBits: 192, bandwidthGbs: 288.0, arch: 'Ampere GA106', pcie: 'PCIe 4.0 x16', memoryType: 'GDDR6' },
+  { match: /a40\b/i, name: 'NVIDIA A40 48GB', vramGb: 48, busBits: 384, bandwidthGbs: 696.0, arch: 'Ampere GA102', pcie: 'PCIe 4.0 x16', memoryType: 'GDDR6' },
+  { match: /a30\b/i, name: 'NVIDIA A30 24GB HBM2', vramGb: 24, busBits: 3072, bandwidthGbs: 933.0, arch: 'Ampere GA100', pcie: 'PCIe 4.0 x16', memoryType: 'HBM2' },
+  { match: /a16\b/i, name: 'NVIDIA A16 64GB (4x16GB)', vramGb: 64, busBits: 512, bandwidthGbs: 800.0, arch: 'Ampere GA107', pcie: 'PCIe 4.0 x16', memoryType: 'GDDR6' },
+  { match: /a10g\b/i, name: 'NVIDIA A10G 24GB', vramGb: 24, busBits: 384, bandwidthGbs: 600.0, arch: 'Ampere GA102', pcie: 'PCIe 4.0 x16', memoryType: 'GDDR6' },
+  { match: /a10\b/i, name: 'NVIDIA A10 24GB', vramGb: 24, busBits: 384, bandwidthGbs: 600.0, arch: 'Ampere GA102', pcie: 'PCIe 4.0 x16', memoryType: 'GDDR6' },
+  { match: /a2\b/i, name: 'NVIDIA A2 16GB', vramGb: 16, busBits: 128, bandwidthGbs: 200.0, arch: 'Ampere GA107', pcie: 'PCIe 4.0 x8', memoryType: 'GDDR6' },
+  { match: /quadro rtx 8000\b/i, name: 'Quadro RTX 8000 48GB', vramGb: 48, busBits: 384, bandwidthGbs: 672.0, arch: 'Turing TU102', pcie: 'PCIe 3.0 x16', memoryType: 'GDDR6' },
+  { match: /quadro rtx 6000\b/i, name: 'Quadro RTX 6000 24GB', vramGb: 24, busBits: 384, bandwidthGbs: 672.0, arch: 'Turing TU102', pcie: 'PCIe 3.0 x16', memoryType: 'GDDR6' },
+  { match: /quadro rtx 5000\b/i, name: 'Quadro RTX 5000 16GB', vramGb: 16, busBits: 256, bandwidthGbs: 448.0, arch: 'Turing TU104', pcie: 'PCIe 3.0 x16', memoryType: 'GDDR6' },
+  { match: /quadro rtx 4000\b/i, name: 'Quadro RTX 4000 8GB', vramGb: 8, busBits: 256, bandwidthGbs: 416.0, arch: 'Turing TU106', pcie: 'PCIe 3.0 x16', memoryType: 'GDDR6' },
+  { match: /quadro p6000\b/i, name: 'Quadro P6000 24GB', vramGb: 24, busBits: 384, bandwidthGbs: 432.0, arch: 'Pascal GP102', pcie: 'PCIe 3.0 x16', memoryType: 'GDDR5X' },
+  { match: /quadro p5000\b/i, name: 'Quadro P5000 16GB', vramGb: 16, busBits: 256, bandwidthGbs: 288.0, arch: 'Pascal GP104', pcie: 'PCIe 3.0 x16', memoryType: 'GDDR5X' },
+  { match: /quadro p4000\b/i, name: 'Quadro P4000 8GB', vramGb: 8, busBits: 256, bandwidthGbs: 243.0, arch: 'Pascal GP104', pcie: 'PCIe 3.0 x16', memoryType: 'GDDR5' },
+  { match: /quadro m6000\b/i, name: 'Quadro M6000 24GB', vramGb: 24, busBits: 384, bandwidthGbs: 317.0, arch: 'Maxwell GM200', pcie: 'PCIe 3.0 x16', memoryType: 'GDDR5' },
+  { match: /tesla v100\b/i, name: 'NVIDIA Tesla V100 32GB HBM2', vramGb: 32, busBits: 4096, bandwidthGbs: 900.0, arch: 'Volta GV100', pcie: 'PCIe 3.0 x16 / SXM2', memoryType: 'HBM2' },
+  { match: /tesla v100\b/i, name: 'NVIDIA Tesla V100 16GB HBM2', vramGb: 16, busBits: 4096, bandwidthGbs: 900.0, arch: 'Volta GV100', pcie: 'PCIe 3.0 x16 / SXM2', memoryType: 'HBM2' },
+  { match: /tesla t4\b/i, name: 'NVIDIA Tesla T4 16GB', vramGb: 16, busBits: 128, bandwidthGbs: 320.0, arch: 'Turing TU104', pcie: 'PCIe 3.0 x16', memoryType: 'GDDR6' },
+  { match: /tesla p40\b/i, name: 'NVIDIA Tesla P40 24GB', vramGb: 24, busBits: 384, bandwidthGbs: 345.6, arch: 'Pascal GP102', pcie: 'PCIe 3.0 x16', memoryType: 'GDDR5' },
+  { match: /tesla p100\b/i, name: 'NVIDIA Tesla P100 16GB HBM2', vramGb: 16, busBits: 4096, bandwidthGbs: 732.0, arch: 'Pascal GP100', pcie: 'PCIe 3.0 x16', memoryType: 'HBM2' },
+  { match: /tesla p4\b/i, name: 'NVIDIA Tesla P4 8GB', vramGb: 8, busBits: 128, bandwidthGbs: 192.0, arch: 'Pascal GP104', pcie: 'PCIe 3.0 x16', memoryType: 'GDDR5' },
+  { match: /tesla m40\b/i, name: 'NVIDIA Tesla M40 24GB', vramGb: 24, busBits: 384, bandwidthGbs: 288.0, arch: 'Maxwell GM200', pcie: 'PCIe 3.0 x16', memoryType: 'GDDR5' },
+  { match: /cmp 170hx\b/i, name: 'NVIDIA CMP 170HX 8GB HBM2e', vramGb: 8, busBits: 4096, bandwidthGbs: 1493.0, arch: 'Ampere GA100', pcie: 'PCIe 4.0 x4', memoryType: 'HBM2e' },
+  { match: /cmp 90hx\b/i, name: 'NVIDIA CMP 90HX 10GB', vramGb: 10, busBits: 320, bandwidthGbs: 760.0, arch: 'Ampere GA102', pcie: 'PCIe 4.0 x16', memoryType: 'GDDR6X' },
+
+ 
+  { match: /mi300x\b/i, name: 'AMD Instinct MI300X 192GB HBM3', vramGb: 192, busBits: 8192, bandwidthGbs: 5300.0, arch: 'CDNA 3', pcie: 'OAM', memoryType: 'HBM3' },
+  { match: /mi300a\b/i, name: 'AMD Instinct MI300A 128GB HBM3', vramGb: 128, busBits: 8192, bandwidthGbs: 5300.0, arch: 'CDNA 3', pcie: 'APU', memoryType: 'HBM3' },
+  { match: /mi250x\b/i, name: 'AMD Instinct MI250X 128GB HBM2e', vramGb: 128, busBits: 8192, bandwidthGbs: 3200.0, arch: 'CDNA 2', pcie: 'OAM', memoryType: 'HBM2e' },
+  { match: /mi210\b/i, name: 'AMD Instinct MI210 64GB HBM2e', vramGb: 64, busBits: 4096, bandwidthGbs: 1600.0, arch: 'CDNA 2', pcie: 'PCIe 4.0 x16', memoryType: 'HBM2e' },
+  { match: /mi100\b/i, name: 'AMD Instinct MI100 32GB HBM2', vramGb: 32, busBits: 4096, bandwidthGbs: 1228.8, arch: 'CDNA 1', pcie: 'PCIe 4.0 x16', memoryType: 'HBM2' },
+  { match: /mi60\b/i, name: 'AMD Instinct MI60 32GB HBM2', vramGb: 32, busBits: 4096, bandwidthGbs: 1024.0, arch: 'Vega 20', pcie: 'PCIe 4.0 x16', memoryType: 'HBM2' },
+  { match: /mi50\b/i, name: 'AMD Instinct MI50 16GB HBM2', vramGb: 16, busBits: 4096, bandwidthGbs: 1024.0, arch: 'Vega 20', pcie: 'PCIe 4.0 x16', memoryType: 'HBM2' },
+
+  
+  { match: /pro w7900\b/i, name: 'Radeon PRO W7900 48GB', vramGb: 48, busBits: 384, bandwidthGbs: 864.0, arch: 'RDNA 3 Navi 31', pcie: 'PCIe 4.0 x16', memoryType: 'GDDR6' },
+  { match: /pro w7800\b/i, name: 'Radeon PRO W7800 32GB', vramGb: 32, busBits: 256, bandwidthGbs: 576.0, arch: 'RDNA 3 Navi 31', pcie: 'PCIe 4.0 x16', memoryType: 'GDDR6' },
+  { match: /pro w7700\b/i, name: 'Radeon PRO W7700 16GB', vramGb: 16, busBits: 128, bandwidthGbs: 288.0, arch: 'RDNA 3 Navi 32', pcie: 'PCIe 4.0 x16', memoryType: 'GDDR6' },
+  { match: /pro w6800\b/i, name: 'Radeon PRO W6800 32GB', vramGb: 32, busBits: 256, bandwidthGbs: 512.0, arch: 'RDNA 2 Navi 21', pcie: 'PCIe 4.0 x16', memoryType: 'GDDR6' },
+  { match: /radeon pro vii\b/i, name: 'Radeon PRO VII 16GB HBM2', vramGb: 16, busBits: 4096, bandwidthGbs: 1024.0, arch: 'Vega 20', pcie: 'PCIe 4.0 x16', memoryType: 'HBM2' },
+  { match: /radeon vii\b/i, name: 'Radeon VII 16GB HBM2', vramGb: 16, busBits: 4096, bandwidthGbs: 1024.0, arch: 'Vega 20', pcie: 'PCIe 3.0 x16', memoryType: 'HBM2' },
+
+
+
+  { match: /rx 7900 xtx\b/i, name: 'Radeon RX 7900 XTX 24GB', vramGb: 24, busBits: 384, bandwidthGbs: 960.0, arch: 'RDNA 3 Navi 31', pcie: 'PCIe 4.0 x16', memoryType: 'GDDR6' },
+  { match: /rx 7900 xt\b/i, name: 'Radeon RX 7900 XT 20GB', vramGb: 20, busBits: 320, bandwidthGbs: 800.0, arch: 'RDNA 3 Navi 31', pcie: 'PCIe 4.0 x16', memoryType: 'GDDR6' },
+  { match: /rx 7900 gre\b/i, name: 'Radeon RX 7900 GRE 16GB', vramGb: 16, busBits: 256, bandwidthGbs: 576.0, arch: 'RDNA 3 Navi 31', pcie: 'PCIe 4.0 x16', memoryType: 'GDDR6' },
+  { match: /rx 7800 xt\b/i, name: 'Radeon RX 7800 XT 16GB', vramGb: 16, busBits: 256, bandwidthGbs: 624.1, arch: 'RDNA 3 Navi 32', pcie: 'PCIe 4.0 x16', memoryType: 'GDDR6' },
+  { match: /rx 7700 xt\b/i, name: 'Radeon RX 7700 XT 12GB', vramGb: 12, busBits: 192, bandwidthGbs: 432.0, arch: 'RDNA 3 Navi 32', pcie: 'PCIe 4.0 x16', memoryType: 'GDDR6' },
+  { match: /rx 7600 xt\b/i, name: 'Radeon RX 7600 XT 16GB', vramGb: 16, busBits: 128, bandwidthGbs: 288.0, arch: 'RDNA 3 Navi 33', pcie: 'PCIe 4.0 x8', memoryType: 'GDDR6' },
+  { match: /rx 7600\b/i, name: 'Radeon RX 7600 8GB', vramGb: 8, busBits: 128, bandwidthGbs: 288.0, arch: 'RDNA 3 Navi 33', pcie: 'PCIe 4.0 x8', memoryType: 'GDDR6' },
+
+ 
+  { match: /rx 6950 xt\b/i, name: 'Radeon RX 6950 XT 16GB', vramGb: 16, busBits: 256, bandwidthGbs: 576.0, arch: 'RDNA 2 Navi 21', pcie: 'PCIe 4.0 x16', memoryType: 'GDDR6' },
+  { match: /rx 6900 xt\b/i, name: 'Radeon RX 6900 XT 16GB', vramGb: 16, busBits: 256, bandwidthGbs: 512.0, arch: 'RDNA 2 Navi 21', pcie: 'PCIe 4.0 x16', memoryType: 'GDDR6' },
+  { match: /rx 6800 xt\b/i, name: 'Radeon RX 6800 XT 16GB', vramGb: 16, busBits: 256, bandwidthGbs: 512.0, arch: 'RDNA 2 Navi 21', pcie: 'PCIe 4.0 x16', memoryType: 'GDDR6' },
+  { match: /rx 6800\b/i, name: 'Radeon RX 6800 16GB', vramGb: 16, busBits: 256, bandwidthGbs: 512.0, arch: 'RDNA 2 Navi 21', pcie: 'PCIe 4.0 x16', memoryType: 'GDDR6' },
+  { match: /rx 6750 xt\b/i, name: 'Radeon RX 6750 XT 12GB', vramGb: 12, busBits: 192, bandwidthGbs: 432.0, arch: 'RDNA 2 Navi 22', pcie: 'PCIe 4.0 x16', memoryType: 'GDDR6' },
+  { match: /rx 6700 xt\b/i, name: 'Radeon RX 6700 XT 12GB', vramGb: 12, busBits: 192, bandwidthGbs: 384.0, arch: 'RDNA 2 Navi 22', pcie: 'PCIe 4.0 x16', memoryType: 'GDDR6' },
+  { match: /rx 6650 xt\b/i, name: 'Radeon RX 6650 XT 8GB', vramGb: 8, busBits: 128, bandwidthGbs: 280.0, arch: 'RDNA 2 Navi 23', pcie: 'PCIe 4.0 x8', memoryType: 'GDDR6' },
+  { match: /rx 6600 xt\b/i, name: 'Radeon RX 6600 XT 8GB', vramGb: 8, busBits: 128, bandwidthGbs: 256.0, arch: 'RDNA 2 Navi 23', pcie: 'PCIe 4.0 x8', memoryType: 'GDDR6' },
+  { match: /rx 6600\b/i, name: 'Radeon RX 6600 8GB', vramGb: 8, busBits: 128, bandwidthGbs: 224.0, arch: 'RDNA 2 Navi 23', pcie: 'PCIe 4.0 x8', memoryType: 'GDDR6' },
+  { match: /rx 5700 xt\b/i, name: 'Radeon RX 5700 XT 8GB', vramGb: 8, busBits: 256, bandwidthGbs: 448.0, arch: 'RDNA 1 Navi 10', pcie: 'PCIe 4.0 x16', memoryType: 'GDDR6' },
+  { match: /rx 580\b/i, name: 'Radeon RX 580 8GB', vramGb: 8, busBits: 256, bandwidthGbs: 256.0, arch: 'Polaris 20', pcie: 'PCIe 3.0 x16', memoryType: 'GDDR5' },
+
+ 
+  { match: /ryzen ai max\+? 395|strix halo/i, name: 'AMD Ryzen AI Max+ 395 (Strix Halo) Unified Memory', vramGb: 128, busBits: 256, bandwidthGbs: 256.0, arch: 'RDNA 3.5', pcie: 'Unified APU', memoryType: 'LPDDR5X', isUnifiedMemory: true },
+  { match: /ryzen ai 9 hx 370|strix point/i, name: 'AMD Ryzen AI 9 HX 370 (Strix Point) Unified Memory', vramGb: 32, busBits: 128, bandwidthGbs: 120.0, arch: 'RDNA 3.5', pcie: 'Unified APU', memoryType: 'LPDDR5X', isUnifiedMemory: true },
+  { match: /radeon 780m/i, name: 'AMD Radeon 780M Unified Memory', vramGb: 16, busBits: 128, bandwidthGbs: 120.0, arch: 'RDNA 3', pcie: 'Unified APU', memoryType: 'LPDDR5X', isUnifiedMemory: true },
+
+  
+  { match: /apple m.*ultra\b/i, name: 'Apple M Ultra Unified Memory', vramGb: 128, busBits: 1024, bandwidthGbs: 800.0, arch: 'Apple Silicon Ultra', pcie: 'Unified SoC', memoryType: 'LPDDR5', isUnifiedMemory: true },
+  { match: /apple m4 max\b/i, name: 'Apple M4 Max Unified Memory (16-Core)', vramGb: 128, busBits: 512, bandwidthGbs: 546.0, arch: 'Apple Silicon Max', pcie: 'Unified SoC', memoryType: 'LPDDR5X', isUnifiedMemory: true },
+  { match: /apple m4 max\b/i, name: 'Apple M4 Max Unified Memory (14-Core)', vramGb: 36, busBits: 384, bandwidthGbs: 410.0, arch: 'Apple Silicon Max', pcie: 'Unified SoC', memoryType: 'LPDDR5X', isUnifiedMemory: true },
+  { match: /apple m4 pro\b/i, name: 'Apple M4 Pro Unified Memory', vramGb: 48, busBits: 256, bandwidthGbs: 273.0, arch: 'Apple Silicon Pro', pcie: 'Unified SoC', memoryType: 'LPDDR5X', isUnifiedMemory: true },
+  { match: /apple m4\b/i, name: 'Apple M4 Unified Memory', vramGb: 24, busBits: 128, bandwidthGbs: 120.0, arch: 'Apple Silicon', pcie: 'Unified SoC', memoryType: 'LPDDR5X', isUnifiedMemory: true },
+  { match: /apple m3 max\b/i, name: 'Apple M3 Max Unified Memory (16-Core)', vramGb: 128, busBits: 512, bandwidthGbs: 400.0, arch: 'Apple Silicon Max', pcie: 'Unified SoC', memoryType: 'LPDDR5', isUnifiedMemory: true },
+  { match: /apple m3 max\b/i, name: 'Apple M3 Max Unified Memory (14-Core)', vramGb: 36, busBits: 384, bandwidthGbs: 300.0, arch: 'Apple Silicon Max', pcie: 'Unified SoC', memoryType: 'LPDDR5', isUnifiedMemory: true },
+  { match: /apple m3 pro\b/i, name: 'Apple M3 Pro Unified Memory', vramGb: 36, busBits: 192, bandwidthGbs: 150.0, arch: 'Apple Silicon Pro', pcie: 'Unified SoC', memoryType: 'LPDDR5', isUnifiedMemory: true },
+  { match: /apple m3\b/i, name: 'Apple M3 Unified Memory', vramGb: 24, busBits: 128, bandwidthGbs: 100.0, arch: 'Apple Silicon', pcie: 'Unified SoC', memoryType: 'LPDDR5', isUnifiedMemory: true },
+  { match: /apple m2 max\b/i, name: 'Apple M2 Max Unified Memory', vramGb: 96, busBits: 512, bandwidthGbs: 400.0, arch: 'Apple Silicon Max', pcie: 'Unified SoC', memoryType: 'LPDDR5', isUnifiedMemory: true },
+  { match: /apple m2 pro\b/i, name: 'Apple M2 Pro Unified Memory', vramGb: 32, busBits: 256, bandwidthGbs: 200.0, arch: 'Apple Silicon Pro', pcie: 'Unified SoC', memoryType: 'LPDDR5', isUnifiedMemory: true },
+  { match: /apple m2\b/i, name: 'Apple M2 Unified Memory', vramGb: 24, busBits: 128, bandwidthGbs: 100.0, arch: 'Apple Silicon', pcie: 'Unified SoC', memoryType: 'LPDDR5', isUnifiedMemory: true },
+  { match: /apple m1 max\b/i, name: 'Apple M1 Max Unified Memory', vramGb: 64, busBits: 512, bandwidthGbs: 400.0, arch: 'Apple Silicon Max', pcie: 'Unified SoC', memoryType: 'LPDDR5', isUnifiedMemory: true },
+  { match: /apple m1 pro\b/i, name: 'Apple M1 Pro Unified Memory', vramGb: 32, busBits: 256, bandwidthGbs: 200.0, arch: 'Apple Silicon Pro', pcie: 'Unified SoC', memoryType: 'LPDDR5', isUnifiedMemory: true },
+  { match: /apple m1\b/i, name: 'Apple M1 Unified Memory', vramGb: 16, busBits: 128, bandwidthGbs: 68.3, arch: 'Apple Silicon', pcie: 'Unified SoC', memoryType: 'LPDDR4X', isUnifiedMemory: true },
+  { match: /apple/i, name: 'Apple Silicon Unified Memory', vramGb: 16, busBits: 128, bandwidthGbs: 100.0, arch: 'Apple Silicon', pcie: 'Unified SoC', memoryType: 'LPDDR5', isUnifiedMemory: true },
+
+ 
+  { match: /gaudi 3\b/i, name: 'Intel Gaudi 3 AI Accelerator 128GB HBM2e', vramGb: 128, busBits: 8192, bandwidthGbs: 3700.0, arch: 'Gaudi 3', pcie: 'OAM', memoryType: 'HBM2e' },
+  { match: /gaudi 2\b/i, name: 'Intel Gaudi 2 AI Accelerator 96GB HBM2e', vramGb: 96, busBits: 6144, bandwidthGbs: 2450.0, arch: 'Gaudi 2', pcie: 'OAM', memoryType: 'HBM2e' },
+  { match: /gpu max 1550|ponte vecchio\b/i, name: 'Intel Data Center GPU Max 1550 128GB HBM2e', vramGb: 128, busBits: 4096, bandwidthGbs: 3276.8, arch: 'Xe-HPC', pcie: 'OAM', memoryType: 'HBM2e' },
+  { match: /gpu max 1100\b/i, name: 'Intel Data Center GPU Max 1100 48GB HBM2e', vramGb: 48, busBits: 4096, bandwidthGbs: 1228.8, arch: 'Xe-HPC', pcie: 'PCIe 5.0 x16', memoryType: 'HBM2e' },
+  { match: /arc b580\b/i, name: 'Intel Arc B580 12GB', vramGb: 12, busBits: 192, bandwidthGbs: 456.0, arch: 'Battlemage BMG-G21', pcie: 'PCIe 4.0 x8', memoryType: 'GDDR6' },
+  { match: /arc b570\b/i, name: 'Intel Arc B570 10GB', vramGb: 10, busBits: 160, bandwidthGbs: 380.0, arch: 'Battlemage BMG-G21', pcie: 'PCIe 4.0 x8', memoryType: 'GDDR6' },
+  { match: /arc a770\b/i, name: 'Intel Arc A770 16GB', vramGb: 16, busBits: 256, bandwidthGbs: 560.0, arch: 'Alchemist ACM-G10', pcie: 'PCIe 4.0 x16', memoryType: 'GDDR6' },
+  { match: /arc a770\b/i, name: 'Intel Arc A770 8GB', vramGb: 8, busBits: 256, bandwidthGbs: 512.0, arch: 'Alchemist ACM-G10', pcie: 'PCIe 4.0 x16', memoryType: 'GDDR6' },
+  { match: /arc a750\b/i, name: 'Intel Arc A750 8GB', vramGb: 8, busBits: 256, bandwidthGbs: 512.0, arch: 'Alchemist ACM-G10', pcie: 'PCIe 4.0 x16', memoryType: 'GDDR6' },
+  { match: /arc a580\b/i, name: 'Intel Arc A580 8GB', vramGb: 8, busBits: 256, bandwidthGbs: 512.0, arch: 'Alchemist ACM-G10', pcie: 'PCIe 4.0 x16', memoryType: 'GDDR6' },
+  { match: /arc a380\b/i, name: 'Intel Arc A380 6GB', vramGb: 6, busBits: 96, bandwidthGbs: 186.0, arch: 'Alchemist ACM-G11', pcie: 'PCIe 4.0 x8', memoryType: 'GDDR6' },
+  { match: /arc 140v|lunar lake/i, name: 'Intel Core Ultra Arc 140V Unified Memory', vramGb: 32, busBits: 128, bandwidthGbs: 136.5, arch: 'Xe2-LPG', pcie: 'Unified SoC', memoryType: 'LPDDR5X', isUnifiedMemory: true }
+];
+
+const DISAMBIGUATED_GPU_MEMO_LIMIT = 200;
+const disambiguateGpuMemo = new Map();
+
+function memoizeDisambiguatedGpu(raw, spec) {
+  if (disambiguateGpuMemo.size >= DISAMBIGUATED_GPU_MEMO_LIMIT) {
+    disambiguateGpuMemo.delete(disambiguateGpuMemo.keys().next().value);
+  }
+  disambiguateGpuMemo.set(raw, spec);
+  return { ...spec };
+}
+
+function _computeHardwareFingerprint(detectedName, detectedVramGb, detectedVendor) {
+  const raw = [
+    String(detectedName || '').trim().toLowerCase(),
+    Number(detectedVramGb) || 0,
+    String(detectedVendor || '').trim().toLowerCase()
+  ].join('|');
+  return createHash('sha256').update(raw, 'utf8').digest('hex').slice(0, 16);
+}
+
+function _normalizeMcpPayload(payload, detectedVramGb) {
+  if (!payload || typeof payload !== 'object') return null;
+  
+ 
+  if (payload.results && Array.isArray(payload.results) && payload.results.length > 0) {
+    const data = payload.results[0];
+    if (data && typeof data === 'object' && data._type !== 'withheld') {
+      const name = String(data.name || data.productName || data.model || data.card_name || '').trim();
+      const vramMb = data.vramMb ? data.vramMb / 1024 : 0;
+      const memSizeGb = data.memSize ? data.memSize / 1024 : 0;
+      const vram = Number(data.vramGb ?? data.memoryGb ?? data.totalVramGb ?? vramMb ?? memSizeGb ?? data.memory_size_gb ?? 0) || 0;
+      const busBits = Number(data.busBits ?? data.memoryBusWidth ?? data.busWidth ?? data.memory_bus_width ?? data.memBusWidth ?? 0) || 0;
+      const bandwidth = Number(data.bandwidthGbs ?? data.memoryBandwidth ?? data.bandwidth ?? data.memory_bandwidth_gb_s ?? data.memBandwidth ?? 0) || 0;
+      const chipName = data.chip && data.chip.name ? data.chip.name : data.chip;
+      const arch = String(data.arch ?? data.architecture ?? data.gpuArchitecture ?? chipName ?? 'Generic').trim();
+      const pcie = String(data.pcie ?? data.pciInterface ?? data.busInterface ?? data.interface ?? 'PCIe x16').trim();
+      const memoryType = String(data.memoryType ?? data.ramType ?? data.memType ?? data.memory_type ?? 'GDDR6').trim();
+      
+      if (!name || (!vram && !busBits && !bandwidth)) return null;
+      const out = {
+        name,
+        vramGb: vram > 0 ? vram : (Number(detectedVramGb) || 0),
+        busBits: busBits > 0 ? busBits : 0,
+        bandwidthGbs: bandwidth > 0 ? bandwidth : 0,
+        arch: arch || 'Generic Discrete GPU',
+        pcie: pcie || 'PCIe x16',
+        memoryType: memoryType || 'GDDR6'
+      };
+      if (data.isUnifiedMemory || data.unifiedMemory) out.isUnifiedMemory = true;
+      return out;
+    }
+  }
+
+  const candidates = [payload.data, payload.result, payload.content, payload];
+  for (const c of candidates) {
+    if (!c || typeof c !== 'object') continue;
+    const data = Array.isArray(c) ? c[0] : c;
+    if (!data || typeof data !== 'object') continue;
+    
+    const name = String(data.name || data.productName || data.model || data.card_name || '').trim();
+    const vramMb = data.vramMb ? data.vramMb / 1024 : 0;
+    const memSizeGb = data.memSize ? data.memSize / 1024 : 0;
+    const vram = Number(data.vramGb ?? data.memoryGb ?? data.totalVramGb ?? vramMb ?? memSizeGb ?? data.memory_size_gb ?? 0) || 0;
+    const busBits = Number(data.busBits ?? data.memoryBusWidth ?? data.busWidth ?? data.memory_bus_width ?? data.memBusWidth ?? 0) || 0;
+    const bandwidth = Number(data.bandwidthGbs ?? data.memoryBandwidth ?? data.bandwidth ?? data.memory_bandwidth_gb_s ?? data.memBandwidth ?? 0) || 0;
+    const chipName = data.chip && data.chip.name ? data.chip.name : data.chip;
+    const arch = String(data.arch ?? data.architecture ?? data.gpuArchitecture ?? chipName ?? 'Generic').trim();
+    const pcie = String(data.pcie ?? data.pciInterface ?? data.busInterface ?? data.interface ?? 'PCIe x16').trim();
+    const memoryType = String(data.memoryType ?? data.ramType ?? data.memType ?? data.memory_type ?? 'GDDR6').trim();
+    
+    if (!name || (!vram && !busBits && !bandwidth)) continue;
+    const out = {
+      name,
+      vramGb: vram > 0 ? vram : (Number(detectedVramGb) || 0),
+      busBits: busBits > 0 ? busBits : 0,
+      bandwidthGbs: bandwidth > 0 ? bandwidth : 0,
+      arch: arch || 'Generic Discrete GPU',
+      pcie: pcie || 'PCIe x16',
+      memoryType: memoryType || 'GDDR6'
+    };
+    if (data.isUnifiedMemory || data.unifiedMemory) out.isUnifiedMemory = true;
+    return out;
+  }
+  return null;
+}
+
+export class HardwareFingerprintCache {
+  constructor(options = {}) {
+    this.cacheFile = options.cacheFile || path.join(KIKU_DATA_DIR, 'hardware_fingerprint_cache.json');
+    this.maxAgeMs = options.maxAgeMs ?? 30 * 86400 * 1000;
+    this._loaded = null;
+    this._flushTimer = null;
+    this._flushChain = null;
+  }
+
+  async _load() {
+    if (this._loaded) return this._loaded;
+    try {
+      const raw = await fs.readFile(this.cacheFile, 'utf8');
+      const parsed = JSON.parse(raw);
+      this._loaded = {
+        schemaVersion: 1,
+        generatedAt: Date.now(),
+        profiles: parsed && typeof parsed.profiles === 'object' ? parsed.profiles : {}
+      };
+    } catch {
+      this._loaded = { schemaVersion: 1, generatedAt: Date.now(), profiles: {} };
+    }
+    return this._loaded;
+  }
+
+  async _flush() {
+    if (!this._loaded) return;
+    try {
+      await fs.mkdir(path.dirname(this.cacheFile), { recursive: true });
+      await fs.writeFile(this.cacheFile, JSON.stringify(this._loaded, null, 2), 'utf8');
+    } catch {}
+  }
+
+  async get(fingerprint) {
+    const store = await this._load();
+    const entry = store.profiles[fingerprint];
+    if (!entry) return null;
+    if (Date.now() - (entry.resolvedAt || 0) > this.maxAgeMs) return null;
+    return entry.profile || null;
+  }
+
+  async put(fingerprint, profile) {
+    const store = await this._load();
+    store.profiles[fingerprint] = {
+      resolvedAt: Date.now(),
+      profile
+    };
+    await this._flush();
+  }
+
+  async touch(fingerprint) {
+    const store = await this._load();
+    const entry = store.profiles[fingerprint];
+    if (entry) {
+      entry.lastHitAt = Date.now();
+      this._scheduleFlush();
+    }
+  }
+
+  _scheduleFlush() {
+    if (this._flushTimer) clearTimeout(this._flushTimer);
+    this._flushTimer = setTimeout(() => {
+      this._flushTimer = null;
+      this._flushChain = (this._flushChain || Promise.resolve())
+        .then(() => this._flush())
+        .catch(() => {});
+    }, 500);
+  }
+}
+
+export class TechPowerUpClient {
+  constructor(options = {}) {
+    this.legacyCacheFile = options.cacheFile || path.join(KIKU_DATA_DIR, 'hardware_profile.json');
+    this.cacheFile = options.cacheFile || path.join(KIKU_DATA_DIR, 'hardware_profile.json');
+    this.timeoutMs = options.timeoutMs || 2500;
+    this.mcpTimeoutMs = options.mcpTimeoutMs || 1500;
+    this.mcpEnabled = options.mcpEnabled ?? true;
+    this.fingerprintCache = new HardwareFingerprintCache({
+      cacheFile: path.join(path.dirname(this.cacheFile), 'hardware_fingerprint_cache.json'),
+      maxAgeMs: options.fingerprintCacheMaxAgeMs ?? 30 * 86400 * 1000
+    });
+  }
+
+
+  async _querySingleMcpServer(mcpId, config, queryName, queryVramGb) {
+    if (!this.mcpEnabled) return null;
+    const url = config.url && !config.url.endsWith('/') ? config.url + '/' : (config.url || '');
+    const endpoint = url + 'tools/call';
+    const args = {};
+    args[config.queryArg || 'query'] = queryName;
+    if (queryVramGb > 0) args.vramGb = queryVramGb;
+    const body = {
+      jsonrpc: '2.0',
+      id: Date.now().toString(36) + Math.random().toString(36).slice(2, 8),
+      method: 'tools/call',
+      params: { name: config.toolName || 'gpu_lookup', arguments: args }
+    };
+    let res;
+    try {
+      res = await fetch(endpoint, {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify(body),
+        signal: AbortSignal.timeout(this.mcpTimeoutMs)
+      });
+    } catch {
+      return null;
+    }
+    if (!res.ok) return null;
+    let payload;
+    try {
+      payload = await res.json();
+    } catch {
+      return null;
+    }
+    const normalized = _normalizeMcpPayload(payload, queryVramGb);
+    if (!normalized) return null;
+    return { source: `mcp:${mcpId}`, spec: normalized };
+  }
+
+  async _queryHardwareMcp(detectedName = '', detectedVramGb = 0) {
+    if (!this.mcpEnabled) return null;
+    const queryName = String(detectedName || '').trim();
+    if (!queryName) return null;
+    
+ 
+    const mcpConfig = await loadTechPowerUpMcpConfig();
+    const servers = mcpConfig.mcpServers || {};
+    
+    try {
+      await mcpClientManager.loadPersistedServers();
+      
+   
+      for (const [name, config] of Object.entries(servers)) {
+        try {
+          await mcpClientManager.connect(name, config, { persist: false, fetchMetadata: true });
+        } catch {}
+      }
+      
+      for (const mcpId of MCP_RESOLUTION_ORDER) {
+        const config = servers[mcpId] || TECHPOWERUP_MCP_CONFIG[mcpId];
+        if (!config) continue;
+        
+        const toolName = config.toolName || 'search_gpu_cards';
+        const args = {};
+        args[config.queryArg || 'query'] = queryName;
+        if (detectedVramGb > 0) args.vramGb = detectedVramGb;
+        
+        try {
+          const result = await mcpClientManager.callTool(toolName, args);
+          if (result && result.status === 'success') {
+            const normalized = _normalizeMcpPayload(result, detectedVramGb);
+            if (normalized) {
+              return { source: `mcp:${mcpId}`, spec: normalized };
+            }
+          }
+        } catch {}
+      }
+    } catch {}
+    
+ 
+    for (const mcpId of MCP_RESOLUTION_ORDER) {
+      const config = servers[mcpId] || TECHPOWERUP_MCP_CONFIG[mcpId];
+      if (!config) continue;
+   
+      const updatedConfig = { ...config, toolName: config.toolName || 'search_gpu_cards' };
+      try {
+        const result = await this._querySingleMcpServer(mcpId, updatedConfig, queryName, detectedVramGb);
+        if (result && result.spec) return result;
+      } catch {}
+    }
+    return null;
+  }
+
+  
+  disambiguateGpu(detectedName = '', detectedVramGb = 0) {
+    const raw = String(detectedName || '').trim();
+    if (disambiguateGpuMemo.has(raw)) {
+      return { ...disambiguateGpuMemo.get(raw) };
+    }
+    const vram = Number(detectedVramGb) || 0;
+
+  
+    const explicitMatch = raw.match(/\b(\d{1,3})\s*(?:gb|g)\b/i);
+    const explicitVram = explicitMatch ? parseFloat(explicitMatch[1]) : 0;
+    const targetVram = vram > 0 ? vram : explicitVram;
+
+ 
+    const matchedSpecs = [];
+    for (const spec of KNOWN_GPU_SPECS) {
+      const match = raw.match(spec.match);
+      if (match) {
+        matchedSpecs.push({
+          spec,
+          matchLength: match[0].length
+        });
+      }
+    }
+
+    if (matchedSpecs.length > 0) {
+      const maxLength = Math.max(...matchedSpecs.map(m => m.matchLength));
+      const topCandidates = matchedSpecs
+        .filter(m => m.matchLength === maxLength)
+        .map(m => {
+          const { match: _ignored, ...rest } = m.spec;
+          return { ...rest, source: HARDWARE_RESOLUTION_SOURCE.KNOWN_DATABASE };
+        });
+
+      if (topCandidates.length === 1) {
+        return topCandidates[0];
+      }
+
+      if (targetVram > 0) {
+        topCandidates.sort((a, b) => Math.abs(a.vramGb - targetVram) - Math.abs(b.vramGb - targetVram));
+        return topCandidates[0];
+      }
+
+      return topCandidates[0];
+    }
+
+   
+    let busBits = 192;
+    let bandwidthGbs = 250;
+    let memoryType = 'GDDR6';
+
+    if (vram <= 4) { busBits = 128; bandwidthGbs = 128; memoryType = 'GDDR6'; }
+    else if (vram <= 6) { busBits = 192; bandwidthGbs = 288; memoryType = 'GDDR6'; }
+    else if (vram <= 8) { busBits = 256; bandwidthGbs = 448; memoryType = 'GDDR6'; }
+    else if (vram <= 12) { busBits = 192; bandwidthGbs = 504; memoryType = 'GDDR6X'; }
+    else if (vram <= 16) { busBits = 256; bandwidthGbs = 672; memoryType = 'GDDR6X'; }
+    else if (vram <= 24) { busBits = 384; bandwidthGbs = 936; memoryType = 'GDDR6X'; }
+    else if (vram <= 48) { busBits = 384; bandwidthGbs = 768; memoryType = 'GDDR6'; }
+    else if (vram <= 96) { busBits = 5120; bandwidthGbs = 2039; memoryType = 'HBM2e'; }
+    else { busBits = 6144; bandwidthGbs = 3200; memoryType = 'HBM3'; }
+
+    return {
+      name: raw || 'Generic Acceleration Device',
+      vramGb: vram || 6,
+      busBits,
+      bandwidthGbs,
+      arch: 'Generic Discrete GPU',
+      pcie: 'PCIe x16',
+      memoryType,
+      approximate: true,
+      source: HARDWARE_RESOLUTION_SOURCE.HEURISTIC_FALLBACK
+    };
+  }
+
+ 
+  calculateTheoreticalTps(bandwidthGbs, modelSizeGb = 4.0) {
+    const bw = Number(bandwidthGbs) || 0;
+    const size = Number(modelSizeGb) || 4.0;
+    if (bw <= 0 || size <= 0) return 0;
+    return Number((bw / size).toFixed(1));
+  }
+
+
+  estimateColdStartTimeSec(modelSizeGb = 4.0, storageSeqReadGbs = 3.5) {
+    const size = Number(modelSizeGb) || 4.0;
+    const speed = Math.max(0.2, Number(storageSeqReadGbs) || 3.5); 
+    return Number((size / speed).toFixed(2));
+  }
+
+
+  async resolveHardwareProfile(gpuInfo = {}, options = {}) {
+    const name = gpuInfo.name || 'GeForce RTX 2060';
+    const vramGb = gpuInfo.totalMb ? (gpuInfo.totalMb / 1024) : 6.0;
+    const vendor = gpuInfo.vendor || '';
+    const fingerprint = _computeHardwareFingerprint(name, vramGb, vendor);
+
+    if (!options.forceRefresh) {
+      const cached = await this.fingerprintCache.get(fingerprint);
+      if (cached) {
+        await this.fingerprintCache.touch(fingerprint).catch(() => {});
+        return cached;
+      }
+      const legacy = await this._loadLegacyCachedProfile(name);
+      if (legacy && legacy.spec) return legacy;
+    }
+
+    let source = HARDWARE_RESOLUTION_SOURCE.MCP_TECHPOWERUP_GPU;
+    let spec = null;
+
+    const mcpResult = await this._queryHardwareMcp(name, vramGb);
+    if (mcpResult && mcpResult.spec) {
+      source = mcpResult.source;
+      spec = mcpResult.spec;
+    } else {
+      const dbSpec = this.disambiguateGpu(name, vramGb);
+      spec = dbSpec;
+      source = dbSpec.source || HARDWARE_RESOLUTION_SOURCE.KNOWN_DATABASE;
+    }
+
+    if (!spec.source) spec.source = source;
+
+    const profile = {
+      fingerprint,
+      spec,
+      resolution: {
+        source,
+        resolvedAt: new Date().toISOString(),
+        requestedName: name,
+        requestedVramGb: Number(vramGb.toFixed(2))
+      },
+      theoreticalMaxTps4Gb: this.calculateTheoreticalTps(spec.bandwidthGbs, 4.0),
+      theoreticalMaxTps7Gb: this.calculateTheoreticalTps(spec.bandwidthGbs, 7.0),
+      nvmeColdStartSec4Gb: this.estimateColdStartTimeSec(4.0, 3.5),
+      timestamp: Date.now()
+    };
+
+    await this.fingerprintCache.put(fingerprint, profile).catch(() => {});
+    await this._saveLegacyCachedProfile(profile).catch(() => {});
+    return profile;
+  }
+
+  async _loadLegacyCachedProfile(detectedName) {
+    try {
+      const content = await fs.readFile(this.legacyCacheFile, 'utf8');
+      const data = JSON.parse(content);
+      const fresh = Date.now() - (data.timestamp || 0) < 7 * 86400 * 1000;
+      if (!fresh) return null;
+      if (detectedName && data.spec && !String(data.spec.name || '').includes(detectedName.split(' ')[0] || '')) return null;
+      return data;
+    } catch {
+      return null;
+    }
+  }
+
+  async _saveLegacyCachedProfile(profile) {
+    try {
+      await fs.mkdir(path.dirname(this.legacyCacheFile), { recursive: true });
+      const legacy = {
+        spec: profile.spec,
+        theoreticalMaxTps4Gb: profile.theoreticalMaxTps4Gb,
+        theoreticalMaxTps7Gb: profile.theoreticalMaxTps7Gb,
+        nvmeColdStartSec4Gb: profile.nvmeColdStartSec4Gb,
+        timestamp: profile.timestamp
+      };
+      await fs.writeFile(this.legacyCacheFile, JSON.stringify(legacy, null, 2), 'utf8');
+    } catch {}
+  }
+}
+
+export const techPowerUpClient = new TechPowerUpClient();