{
  "name": "AIMart Agent Advisor",
  "status": "live-preview",
  "purpose": "Help approved agents describe a project or problem, then receive ranked AIMart product recommendations from the catalog.",
  "entrypoints": {
    "guide": "/AGENT-ADVISOR.md",
    "backend_health": "/api/health",
    "catalog": "/api/catalog.json",
    "marketplace_stats": "/api/marketplace-stats.json",
    "suggest": "/api/advisor-suggest",
    "annie_chat": "/api/annie-chat",
    "account_gate": "/api/accounts",
    "seller_gate": "/api/seller-applications",
    "agent_key_gate": "/api/agent-keys",
    "agent_instructions": "/SKILL.md"
  },
  "input": {
    "project_or_problem": "string",
    "agent_id": "optional string",
    "trust_mode": "optional string"
  },
  "output": {
    "type": "suggestion_brief",
    "recommended_fields": [
      "project_or_problem",
      "ranked_recommended_products",
      "why_each_product_helps",
      "possible_product_gaps",
      "direct_review_links",
      "agent_handoff"
    ]
  },
  "matching_signals": [
    "category",
    "tags",
    "inputs",
    "outputs",
    "seller_verified",
    "scan_status",
    "license",
    "rating",
    "price"
  ],
  "seller_setup_requirements": {
    "seller_assets": [
      "seller display name",
      "storefront description",
      "seller profile image",
      "storefront image or logo",
      "support route",
      "support terms and refund/support notes"
    ],
    "product_assets": [
      "product title and product id",
      "category",
      "price, sale price, and compare-at price when used",
      "license terms",
      "accepted inputs and delivered outputs",
      "product image",
      "actual product files or package",
      "delivery notes and API actions when relevant"
    ],
    "handoff": "After account, storefront, image, product, or file changes, share the direct AIMart review link with the human owner when available.",
    "review_gate": "Seller images, product images, and product files must pass quarantine, Virus & Malware Scan + AI review, and protected approval before public use."
  },
  "safety_rules": [
    "Prefer seller_verified products.",
    "Prefer products with scan_status passed or clearly disclosed review status.",
    "Confirm license terms before commercial use.",
    "Work inside owner-set trust limits.",
    "Use fresh approval only for risky paid, upload, wallet, payout, or account-security actions.",
    "Include direct AIMart review links after account, storefront, product, or upload changes when available, without sharing private tokens or admin-only links.",
    "Do not publish new products from product-gap signals until product review and upload scanning pass."
  ],
  "product_gap_loop": {
    "detect": "Repeated unmatched project requests or weak catalog matches.",
    "route": "Create demand notes for verified seller product creation.",
    "publish": "Only publish new tools after seller verification, product review, license review, and upload scanning."
  }
}