version: "1.0.1" name: reward-zone description: Send and receive recognition awards on Red Hat Reward Zone. Uses pure HTTP SAML. Use when user says "send reward", "give recognition", "check reward zone points", or "view received awards".

Reward Zone

Interact with rewardzone.redhat.com: send awards, view received/sent, check points. Pure HTTP, no browser.

Inputs

Prerequisites

• Redhatter service on localhost:8009
• Red Hat SSO (Kerberos ID + PIN/token)

Workflow

1. Validate Inputs

• action in ["send", "view_received", "check_points", "view_sent"]
• For send: recipient and message required; points positive int

2. Create HTTP Session

• http_session_create(name="reward_zone", base_url="https://rewardzone.redhat.com")

3. Authenticate

• http_saml_auth(session="reward_zone") — pure HTTP SAML
• If not successful → return auth troubleshooting (redhatter, VPN, credentials)

4. Dispatch by Action

check_points:

• http_request(session="reward_zone", method="GET", path="/api/v1/NominationPoints/getNominationPoints")
• Parse and return available points

view_received:

• http_request(session="reward_zone", method="GET", path="/api/v1/Awards/getReceivedAwards")
• Parse and return awards table (Date, From, Award, Points, Message)

view_sent:

• http_request(session="reward_zone", method="GET", path="/api/v1/Awards/getSentAwards")
• Parse and return awards table

send:

• http_request(session="reward_zone", method="GET", path="/api/v1/Members/advancedMemberSearch", params='{"searchText": "recipient"}')
• Parse for pin, name; if not found → return "Recipient not found"
• If dry_run → return preview and exit
• http_request(session="reward_zone", method="POST", path="/api/v1/Awards/submitNomination", json_body='{"nomineePin": "pin", "awardName": "award", "points": N, "description": "msg", "message": "msg"}')

5. Post-Action

• memory_session_log("Reward Zone {action}", ...)

Key Details

• No browser: Pure HTTP SAML flow
• Auth: redhatter → systemctl --user start redhatter
• Categories: RH Multiplier, Team Advocate, Customer Focus