[
  {
    "name": "resolve_msisdn_and_classify",
    "description": "Resolve MSISDN, verify identity confidence, and classify caller type.",
    "parameters": {
      "type": "object",
      "properties": {
        "raw_identifier": {"type": "string", "description": "User-provided number or context MSISDN"},
        "channel": {"type": "string", "enum": ["ivr","chat","whatsapp","web"], "description":"Entry channel"}
      },
      "required": ["raw_identifier","channel"]
    }
  },
  {
    "name": "get_balance",
    "description": "Fetch consumer airtime/data/SMS balances from BSS.",
    "parameters": {
      "type":"object",
      "properties":{
        "msisdn":{"type":"string"},
        "detail_level":{"type":"string","enum":["summary","detailed"],"default":"summary"}
      },
      "required":["msisdn"]
    }
  },
  {
    "name": "recommend_bundles",
    "description": "Recommend top bundles for consumer based on usage/profile.",
    "parameters": {
      "type":"object",
      "properties":{
        "msisdn":{"type":"string"},
        "purpose":{"type":"string","enum":["data","voice","combo"],"description":"Optional user preference"}
      },
      "required":["msisdn"]
    }
  },
  {
    "name": "purchase_bundle",
    "description": "Purchase a specific bundle.",
    "parameters": {
      "type":"object",
      "properties":{
        "msisdn":{"type":"string"},
        "bundle_id":{"type":"string"},
        "payment_method":{"type":"string","enum":["airtime","wallet","card"]},
        "confirm":{"type":"boolean","description":"Must be true before purchase"}
      },
      "required":["msisdn","bundle_id","payment_method","confirm"]
    }
  },
  {
    "name": "retailer_scope_info",
    "description": "Return retailer scope info and optional wallet/balance.",
    "parameters": {
      "type":"object",
      "properties":{
        "retailer_id":{"type":"string"},
        "include_balance":{"type":"boolean","default":true}
      },
      "required":["retailer_id"]
    }
  },
  {
    "name": "enterprise_scope_info",
    "description": "Return enterprise scope info and optional account metadata.",
    "parameters": {
      "type":"object",
      "properties":{
        "enterprise_id":{"type":"string"},
        "include_info":{"type":"boolean","default":true}
      },
      "required":["enterprise_id"]
    }
  },
  {
    "name": "trigger_csat",
    "description": "Send CSAT survey via available channel.",
    "parameters": {
      "type":"object",
      "properties":{
        "msisdn":{"type":"string"},
        "channel":{"type":"string","enum":["ivr","sms","whatsapp","web"]},
        "context":{"type":"string","description":"Short label of resolved intent(s)"}
      },
      "required":["channel"]
    }
  }
]
``