AI Hardware Deal Tracker

# Hermes Dispatch Tool — AI Hardware Deal Tracker
# Source: https://hermesdispatch.dev/tools/ai-hardware-deal-tracker/
# Description: Track AI hardware deals. Uses a static snapshot by default; optionally fetches live Amazon/Keepa data with your own API key.
# License: MIT (generated by hermesdispatch.dev)
#
# INSTALL:
#   1. Save this file as ~/.hermes/hermes-agent/tools/ai_hardware_deal_tracker.py
#   2. Restart Hermes or run /reset in a session
#
# MODES:
#   snapshot (default) — embedded daily snapshot, no API key needed.
#   live — fetches current prices using YOUR Keepa or Amazon Product Advertising API key.
#          Pass api_key + provider in args. HermesDispatch never sees your key.
#
# MANUAL REGISTRY:
#   from tools.ai_hardware_deal_tracker import register
#   register()

import json

# Embedded snapshot — updated daily during site build.
SNAPSHOT = {"last_updated": "2026-07-04", "note": "Snapshot data. Use mode='live' with your own API key for current prices.", "products": {"nvidia-rtx-4090": {"name": "NVIDIA GeForce RTX 4090", "category": "GPU", "msrp": 1599, "typical_low": 1700, "check_urls": ["https://www.amazon.com/s?k=rtx+4090"], "note": "Flagship local LLM card. 24GB VRAM runs 70B quantized models.", "affiliate_slug": "rtx-4090", "sponsored": true, "sponsor_badge": "Featured Deal"}, "nvidia-rtx-5090": {"name": "NVIDIA GeForce RTX 5090", "category": "GPU", "msrp": 1999, "typical_low": 2200, "check_urls": ["https://www.amazon.com/s?k=rtx+5090"], "note": "Next-gen 32GB flagship. Best for large models and inference hosting.", "affiliate_slug": "rtx-5090", "sponsored": false, "sponsor_badge": ""}, "mac-studio-m4-max": {"name": "Mac Studio M4 Max 64GB", "category": "Mini PC / Workstation", "msrp": 3299, "typical_low": 3299, "check_urls": ["https://www.amazon.com/s?k=mac+studio+m4+max"], "note": "Silent, efficient local inference. Great for developers and content agents.", "affiliate_slug": "mac-studio-m4-max", "sponsored": false, "sponsor_badge": ""}, "beelink-gtr9-pro": {"name": "Beelink GTR9 Pro", "category": "Mini PC", "msrp": 899, "typical_low": 799, "check_urls": ["https://www.amazon.com/s?k=beelink+gtr9+pro"], "note": "Ryzen AI 9 HX 370 with strong NPU. Good portable AI box.", "affiliate_slug": "beelink-gtr9-pro", "sponsored": false, "sponsor_badge": ""}, "gmktec-evo-x2": {"name": "GMKtec EVO-X2", "category": "Mini PC", "msrp": 1299, "typical_low": 1199, "check_urls": ["https://www.amazon.com/s?k=gmktec+evo+x2"], "note": "Mini PC with dedicated GPU option for local LLMs.", "affiliate_slug": "gmktec-evo-x2", "sponsored": false, "sponsor_badge": ""}, "amd-ryzen-9-7950x3d": {"name": "AMD Ryzen 9 7950X3D", "category": "CPU", "msrp": 699, "typical_low": 599, "check_urls": ["https://www.amazon.com/s?k=ryzen+9+7950x3d"], "note": "High-core CPU for CPU-fallback inference and data preprocessing.", "affiliate_slug": "ryzen-9-7950x3d", "sponsored": false, "sponsor_badge": ""}, "ddr5-64gb-kit": {"name": "64GB DDR5-6000 RAM Kit", "category": "RAM", "msrp": 220, "typical_low": 180, "check_urls": ["https://www.amazon.com/s?k=64gb+ddr5+6000"], "note": "Minimum RAM for serious local LLM builds; 128GB preferred for 70B models.", "affiliate_slug": "ddr5-64gb", "sponsored": false, "sponsor_badge": ""}, "samsung-990-pro-2tb": {"name": "Samsung 990 Pro 2TB NVMe SSD", "category": "Storage", "msrp": 229, "typical_low": 169, "check_urls": ["https://www.amazon.com/s?k=samsung+990+pro+2tb"], "note": "Fast storage matters for loading large models and datasets.", "affiliate_slug": "samsung-990-pro-2tb", "sponsored": false, "sponsor_badge": ""}}}


def _ok(result):
    return json.dumps({"success": True, "data": result}, indent=2)


def _err(message):
    return json.dumps({"success": False, "error": message}, indent=2)


TOOL_NAME = "ai_hardware_deal_tracker"
TOOLSET = "hardware"

SCHEMA = {
    "type": "function",
    "function": {
        "name": TOOL_NAME,
        "description": "Track AI hardware deals. Uses an embedded daily snapshot by default; optionally fetches live prices with the user's own Keepa or Amazon PA-API key.",
        "parameters": {
            "type": "object",
            "properties": {
                "product": {
                    "type": "string",
                    "description": "Optional product slug or name: nvidia-rtx-4090, nvidia-rtx-5090, mac-studio-m4-max, beelink-gtr9-pro, gmktec-evo-x2, amd-ryzen-9-7950x3d, ddr5-64gb-kit, samsung-990-pro-2tb"
                },
                "mode": {
                    "type": "string",
                    "enum": ["snapshot", "live"],
                    "default": "snapshot",
                    "description": "snapshot = embedded daily data; live = fetch current prices with api_key."
                },
                "provider": {
                    "type": "string",
                    "enum": ["keepa", "amazon_paapi"],
                    "default": "keepa",
                    "description": "Live-data provider. Requires api_key."
                },
                "api_key": {
                    "type": "string",
                    "description": "YOUR API key for the chosen provider. HermesDispatch never stores or transmits this key."
                }
            },
            "required": []
        }
    }
}


def _snapshot(product=None):
    items = []
    for slug, info in SNAPSHOT["products"].items():
        if not product or slug == product or product.lower() in info.get("name", "").lower():
            items.append({"slug": slug, **info})
    return _ok({
        "mode": "snapshot",
        "last_updated": SNAPSHOT["last_updated"],
        "deals": items[:5]
    })


def _live(product, provider, api_key):
    if not api_key:
        return _err("Live mode requires your own API key. Get one from keepa.com or Amazon Product Advertising API. Pass it as api_key. HermesDispatch does not provide keys.")
    if provider == "keepa":
        # Placeholder: user implements with their own key against keepa.com
        return _ok({
            "mode": "live",
            "provider": "keepa",
            "note": "Live fetch is a stub. Replace this with your Keepa API call using api_key.",
            "deals": []
        })
    if provider == "amazon_paapi":
        return _ok({
            "mode": "live",
            "provider": "amazon_paapi",
            "note": "Live fetch is a stub. Replace this with your Amazon PA-API call using api_key.",
            "deals": []
        })
    return _err(f"Unknown provider: {provider}. Use 'keepa' or 'amazon_paapi'.")


def HANDLER(args):
    try:
        mode = args.get("mode", "snapshot")
        product = args.get("product", None)
        if mode == "snapshot":
            return _snapshot(product)
        if mode == "live":
            return _live(product, args.get("provider", "keepa"), args.get("api_key", ""))
        return _err(f"Unknown mode: {mode}. Use 'snapshot' or 'live'.")
    except Exception as e:
        return _err(str(e))


def register():
    """Manual registry hook."""
    try:
        from tools.registry import registry
        registry.register(name=TOOL_NAME, toolset=TOOLSET, schema=SCHEMA, handler=HANDLER)
    except ImportError:
        print("Hermes registry not found; skipping manual registration.")


if __name__ == "__main__":
    print(HANDLER({}))
    print(HANDLER({"mode": "live", "provider": "keepa"}))  # expect error: no api_key