Upload 10 files

README.md

@@ -1,14 +1,19 @@
 ---
 title: KhidmatAI
-emoji: 😻
-colorFrom: yellow
-colorTo: blue
+emoji: 🔧
+colorFrom: blue
+colorTo: green
 sdk: streamlit
-sdk_version: 1.57.0
-python_version: '3.13'
+sdk_version: 1.35.0
 app_file: app.py
 pinned: false
 license: mit
+short_description: AI Service Orchestrator for Pakistan's Informal Economy
 ---
 
-Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
+# 🔧 KhidmatAI — AI Service Orchestrator
+
+AI-powered service booking for Pakistan's informal economy.
+Type your request in **Urdu · Roman Urdu · English**.
+
+Built with **Google Antigravity · Gemini API · Streamlit**.

agents/__init__.py

@@ -0,0 +1 @@
+# agents package

agents/booking.py

@@ -0,0 +1,57 @@
+"""Agent 4 — Booking Agent (writes to data/bookings.json)"""
+import json, uuid, os
+from datetime import datetime, timedelta
+from pathlib import Path
+
+BOOKINGS_FILE = Path(__file__).parent.parent / "data" / "bookings.json"
+
+TIME_SLOT_MAP = {
+    "morning": ["09:00", "10:00", "11:00"],
+    "afternoon": ["13:00", "14:00", "15:00"],
+    "evening": ["17:00", "18:00", "19:00"],
+    "asap": ["09:00", "10:00", "11:00", "13:00", "14:00"],
+}
+
+def pick_slot(provider: dict, requested_time: str) -> str:
+    available = provider.get("available_slots", [])
+    rt = (requested_time or "").lower()
+    for key, slots in TIME_SLOT_MAP.items():
+        if key in rt:
+            for s in slots:
+                if s in available:
+                    return s
+    return available[0] if available else "10:00"
+
+def run(recommendation: dict, intent: dict) -> dict:
+    provider = recommendation.get("best_provider")
+    if not provider:
+        return {"error": "No provider available to book."}
+
+    slot        = pick_slot(provider, intent.get("time", "morning"))
+    booking_id  = f"BK-{datetime.now().strftime('%Y%m%d')}-{str(uuid.uuid4())[:5].upper()}"
+    remind_time = f"{int(slot.split(':')[0]) - 1:02d}:{slot.split(':')[1]}"
+    booked_date = (datetime.now() + timedelta(days=1)).strftime("%A, %d %b %Y")
+
+    record = {
+        "booking_id":     booking_id,
+        "provider_id":    provider["provider_id"],
+        "provider_name":  provider["name"],
+        "service":        intent.get("service_type"),
+        "location":       intent.get("location"),
+        "confirmed_slot": slot,
+        "booked_date":    booked_date,
+        "provider_phone": provider.get("phone"),
+        "reminder_time":  remind_time,
+        "created_at":     datetime.now().isoformat(),
+        "status":         "confirmed",
+    }
+
+    # Write to bookings.json
+    try:
+        existing = json.loads(BOOKINGS_FILE.read_text()) if BOOKINGS_FILE.exists() else []
+        existing.append(record)
+        BOOKINGS_FILE.write_text(json.dumps(existing, indent=2))
+    except Exception:
+        pass   # HF free tier ephemeral filesystem — non-fatal
+
+    return record

agents/discovery.py

@@ -0,0 +1,40 @@
+"""Agent 2 — Discovery Agent (haversine distance, no Maps API needed on free tier)"""
+import json, math, os
+from pathlib import Path
+
+PROVIDERS_FILE = Path(__file__).parent.parent / "data" / "providers.json"
+
+AREA_COORDS = {
+    "G-13": (33.6844, 73.0479), "G-11": (33.6938, 73.0551),
+    "G-10": (33.7020, 73.0397), "G-9":  (33.6995, 73.0440),
+    "G-6":  (33.7290, 73.0935), "F-10": (33.7077, 73.0354),
+    "F-7":  (33.7192, 73.0587), "E-11": (33.7215, 73.0194),
+    "I-8":  (33.6741, 73.0632), "I-10": (33.6800, 73.0530),
+    "DEFAULT": (33.6844, 73.0479),
+}
+
+def haversine(lat1, lon1, lat2, lon2) -> float:
+    R = 6371
+    dlat = math.radians(lat2 - lat1)
+    dlon = math.radians(lon2 - lon1)
+    a = math.sin(dlat/2)**2 + math.cos(math.radians(lat1)) * math.cos(math.radians(lat2)) * math.sin(dlon/2)**2
+    return round(R * 2 * math.asin(math.sqrt(a)), 2)
+
+def run(intent: dict) -> dict:
+    service_type = intent.get("service_type") or ""
+    location     = (intent.get("location") or "DEFAULT").upper().strip()
+
+    with open(PROVIDERS_FILE) as f:
+        all_providers = json.load(f)
+
+    user_lat, user_lng = AREA_COORDS.get(location, AREA_COORDS["DEFAULT"])
+
+    matched = []
+    for p in all_providers:
+        cats = [c.lower() for c in p.get("service_categories", [])]
+        if service_type.lower() in cats:
+            dist = haversine(user_lat, user_lng, p["location"]["lat"], p["location"]["lng"])
+            matched.append({**p, "distance_km": dist})
+
+    matched.sort(key=lambda x: x["distance_km"])
+    return {"providers": matched, "user_location": location, "total_found": len(matched)}

agents/intent.py

@@ -0,0 +1,32 @@
+"""Agent 1 — Intent Agent (Gemini API, no paid Maps needed)"""
+import os, json, re
+import google.generativeai as genai
+
+def run(message: str) -> dict:
+    api_key = os.environ.get("GEMINI_API_KEY", "")
+    if not api_key:
+        raise ValueError("GEMINI_API_KEY secret not set in HuggingFace Space settings.")
+
+    genai.configure(api_key=api_key)
+    model = genai.GenerativeModel("gemini-1.5-flash")   # free-tier model
+
+    prompt = f"""You are a service request parser for Pakistan's informal economy.
+Extract structured info from the user message. Respond ONLY with valid JSON, no markdown.
+
+User message: "{message}"
+
+Return exactly this JSON structure:
+{{
+  "service_type": "<one of: AC Technician, Plumber, Electrician, Tutor, Beautician, Carpenter, Painter, Driver, Maid, Delivery Worker>",
+  "location": "<area name, e.g. G-13>",
+  "time": "<e.g. tomorrow morning, today evening, asap>",
+  "language": "<urdu | roman_urdu | english | mixed>",
+  "confidence": <0.0 to 1.0>
+}}
+
+If a field cannot be determined, use null."""
+
+    response = model.generate_content(prompt)
+    raw = response.text.strip()
+    raw = re.sub(r"```json|```", "", raw).strip()
+    return json.loads(raw)

agents/recommendation.py

@@ -0,0 +1,26 @@
+"""Agent 3 — Recommendation Agent"""
+
+def compute_score(p: dict, max_dist: float) -> float:
+    proximity    = 1 - (p["distance_km"] / max_dist) if max_dist > 0 else 1.0
+    rating       = (p.get("rating", 3) - 1) / 4
+    availability = 1.0 if p.get("available") else 0.0
+    return round(0.40 * proximity + 0.40 * rating + 0.20 * availability, 4)
+
+def run(discovery: dict) -> dict:
+    providers = discovery.get("providers", [])
+    if not providers:
+        return {"best_provider": None, "all_ranked": [], "reasoning": "No providers found."}
+
+    max_dist = max(p["distance_km"] for p in providers) or 1
+    scored = [{**p, "score": compute_score(p, max_dist)} for p in providers]
+    scored.sort(key=lambda x: x["score"], reverse=True)
+    best = scored[0]
+
+    reasoning = (
+        f"**{best['name']}** selected — "
+        f"{best['distance_km']} km away, "
+        f"⭐ {best['rating']} rating, "
+        f"{'available' if best['available'] else 'unavailable'}. "
+        f"Composite score: **{best['score']}**"
+    )
+    return {"best_provider": best, "all_ranked": scored, "reasoning": reasoning}

app.py

@@ -0,0 +1,454 @@
+"""
+KhidmatAI — AI Service Orchestrator for Informal Economy
+Streamlit interface for HuggingFace Spaces (free tier)
+"""
+
+import streamlit as st
+import json, time, os, sys
+from datetime import datetime
+from pathlib import Path
+
+# ── path so agents/ is importable ───────────────────────────────────
+sys.path.insert(0, str(Path(__file__).parent))
+from agents import intent as intent_agent
+from agents import discovery as discovery_agent
+from agents import recommendation as recommendation_agent
+from agents import booking as booking_agent
+
+# ════════════════════════════════════════════════════════════════════
+# PAGE CONFIG
+# ════════════════════════════════════════════════════════════════════
+st.set_page_config(
+    page_title="KhidmatAI",
+    page_icon="🔧",
+    layout="centered",
+)
+
+# ════════════════════════════════════════════════════════════════════
+# CUSTOM CSS
+# ════════════════════════════════════════════════════════════════════
+st.markdown("""
+<style>
+/* ── Global ─────────────────────────────────────────────── */
+@import url('https://fonts.googleapis.com/css2?family=Inter:wght@400;500;600;700&display=swap');
+html, body, [class*="css"] { font-family: 'Inter', sans-serif; }
+
+/* ── Hero banner ────────────────────────────────────────── */
+.hero {
+    background: linear-gradient(135deg, #1a1a2e 0%, #16213e 50%, #0f3460 100%);
+    border-radius: 16px;
+    padding: 32px 28px 24px;
+    text-align: center;
+    margin-bottom: 24px;
+    border: 1px solid rgba(255,255,255,0.08);
+}
+.hero h1 { color: #ffffff; font-size: 2rem; font-weight: 700; margin: 0; letter-spacing: -0.5px; }
+.hero p  { color: rgba(255,255,255,0.65); font-size: 0.95rem; margin: 8px 0 0; }
+.hero-badge {
+    display: inline-block;
+    background: rgba(99,179,237,0.15);
+    border: 1px solid rgba(99,179,237,0.3);
+    color: #90cdf4;
+    font-size: 0.75rem;
+    padding: 3px 10px;
+    border-radius: 20px;
+    margin-bottom: 12px;
+    font-weight: 500;
+}
+
+/* ── Agent step card ────────────────────────────────────── */
+.agent-card {
+    background: #f8fafc;
+    border: 1px solid #e2e8f0;
+    border-left: 4px solid #4299e1;
+    border-radius: 10px;
+    padding: 14px 16px;
+    margin-bottom: 10px;
+}
+.agent-card.done { border-left-color: #48bb78; background: #f0fff4; }
+.agent-card.error { border-left-color: #fc8181; background: #fff5f5; }
+.agent-title { font-weight: 600; font-size: 0.9rem; color: #2d3748; margin-bottom: 4px; }
+.agent-body  { font-size: 0.82rem; color: #4a5568; line-height: 1.5; }
+
+/* ── Provider card ──────────────────────────────────────── */
+.provider-card {
+    background: #ffffff;
+    border: 1.5px solid #e2e8f0;
+    border-radius: 12px;
+    padding: 16px 18px;
+    margin-bottom: 10px;
+    transition: border-color 0.2s;
+}
+.provider-card.best { border-color: #48bb78; background: #f0fff4; }
+.provider-name  { font-size: 1rem; font-weight: 600; color: #1a202c; }
+.provider-meta  { font-size: 0.8rem; color: #718096; margin-top: 4px; }
+.badge-best { background: #c6f6d5; color: #276749; font-size: 0.72rem;
+              padding: 2px 8px; border-radius: 8px; font-weight: 600; margin-left: 8px; }
+.score-bar { height: 5px; background: #e2e8f0; border-radius: 3px; margin-top: 8px; }
+.score-fill { height: 5px; background: #48bb78; border-radius: 3px; }
+
+/* ── Booking receipt ────────────────────────────────────── */
+.receipt {
+    background: linear-gradient(135deg, #f0fff4, #e6fffa);
+    border: 2px solid #9ae6b4;
+    border-radius: 16px;
+    padding: 24px;
+    text-align: center;
+}
+.receipt-id   { font-size: 0.78rem; color: #68d391; letter-spacing: 2px; font-weight: 600; }
+.receipt-name { font-size: 1.4rem; font-weight: 700; color: #1a202c; margin: 8px 0 4px; }
+.receipt-row  { display: flex; justify-content: space-between; padding: 8px 0;
+                border-bottom: 1px solid rgba(0,0,0,0.06); font-size: 0.88rem; }
+.receipt-row:last-child { border-bottom: none; }
+.receipt-label { color: #718096; }
+.receipt-value { color: #1a202c; font-weight: 500; }
+.reminder-box {
+    background: #ebf8ff; border: 1px solid #90cdf4;
+    border-radius: 10px; padding: 12px 16px; margin-top: 14px;
+    font-size: 0.85rem; color: #2b6cb0;
+}
+
+/* ── Trace log ──────────────────────────────────────────── */
+.trace-header { font-size: 0.75rem; font-weight: 600; color: #a0aec0;
+                text-transform: uppercase; letter-spacing: 1px; margin-bottom: 6px; }
+
+/* ── Input box ──────────────────────────────────────────── */
+.stTextArea textarea {
+    font-size: 1rem !important;
+    border-radius: 10px !important;
+    border: 1.5px solid #cbd5e0 !important;
+}
+
+/* ── Example chips ──────────────────────────────────────── */
+.chip {
+    display: inline-block;
+    background: #edf2f7;
+    border: 1px solid #e2e8f0;
+    border-radius: 20px;
+    padding: 4px 12px;
+    font-size: 0.78rem;
+    color: #4a5568;
+    margin: 3px;
+    cursor: pointer;
+}
+</style>
+""", unsafe_allow_html=True)
+
+# ════════════════════════════════════════════════════════════════════
+# SESSION STATE
+# ════════════════════════════════════════════════════════════════════
+for key in ["result", "trace_log", "running"]:
+    if key not in st.session_state:
+        st.session_state[key] = None if key != "running" else False
+
+# ════════════════════════════════════════════════════════════════════
+# HERO
+# ════════════════════════════════════════════════════════════════════
+st.markdown("""
+<div class="hero">
+    <div class="hero-badge">🤖 Powered by Google Antigravity + Gemini API</div>
+    <h1>🔧 KhidmatAI</h1>
+    <p>AI Service Orchestrator for Pakistan's Informal Economy<br>
+    Type your request in <strong>Urdu · Roman Urdu · English</strong></p>
+</div>
+""", unsafe_allow_html=True)
+
+# ════════════════════════════════════════════════════════════════════
+# CHECK API KEY
+# ════════════════════════════════════════════════════════════════════
+api_key = os.environ.get("GEMINI_API_KEY", "")
+if not api_key:
+    st.error(
+        "⚠️ **GEMINI_API_KEY not set.**\n\n"
+        "Go to your HuggingFace Space → **Settings → Variables and Secrets** → "
+        "add a secret named `GEMINI_API_KEY` with your Gemini API key.\n\n"
+        "Get a free key at: https://aistudio.google.com/apikey"
+    )
+    st.stop()
+
+# ════════════════════════════════════════════════════════════════════
+# EXAMPLE INPUTS
+# ════════════════════════════════════════════════════════════════════
+st.markdown("**Try an example:**")
+examples = [
+    "Mujhe kal subah G-13 mein AC technician chahiye",
+    "I need a plumber in F-10 today",
+    "G-9 mein electrician chahiye aaj evening",
+    "Maths tutor chahiye G-11 mein kal",
+    "Home maid service chahiye F-7 mein",
+]
+cols = st.columns(3)
+selected_example = None
+for i, ex in enumerate(examples):
+    if cols[i % 3].button(f"💬 {ex[:30]}…", key=f"ex_{i}", use_container_width=True):
+        selected_example = ex
+
+# ════════════════════════════════════════════════════════════════════
+# INPUT
+# ════════════════════════════════════════════════════════════════════
+default_text = selected_example or ""
+user_input = st.text_area(
+    "Your service request:",
+    value=default_text,
+    height=90,
+    placeholder="e.g. Mujhe kal subah G-13 mein AC technician chahiye",
+    label_visibility="collapsed",
+)
+
+col1, col2 = st.columns([3, 1])
+with col1:
+    run_btn = st.button("🚀 Find & Book Service", type="primary", use_container_width=True)
+with col2:
+    clear_btn = st.button("🔄 Clear", use_container_width=True)
+
+if clear_btn:
+    st.session_state.result = None
+    st.session_state.trace_log = None
+    st.rerun()
+
+# ════════════════════════════════════════════════════════════════════
+# AGENT PIPELINE
+# ════════════════════════════════════════════════════════════════════
+def run_pipeline(message: str):
+    trace = []
+    st.markdown("---")
+    st.markdown("### 🤖 Agent Pipeline Running...")
+
+    # ── Agent 1: Intent ───────────────────────────────────────────
+    with st.container():
+        st.markdown("""<div class="agent-card">
+            <div class="agent-title">🧠 Agent 1 — Intent Agent</div>
+            <div class="agent-body">Parsing your request with Gemini API...</div>
+        </div>""", unsafe_allow_html=True)
+        t0 = time.time()
+        try:
+            intent = intent_agent.run(message)
+            ms = int((time.time() - t0) * 1000)
+            trace.append({
+                "agent": "IntentAgent", "step": 1,
+                "input": {"message": message},
+                "output": intent, "duration_ms": ms,
+                "reasoning": f"Detected language: {intent.get('language')}. "
+                             f"Extracted service={intent.get('service_type')}, "
+                             f"location={intent.get('location')}, time={intent.get('time')}."
+            })
+            st.markdown(f"""<div class="agent-card done">
+                <div class="agent-title">✅ Agent 1 — Intent Agent <small style="color:#718096">({ms}ms)</small></div>
+                <div class="agent-body">
+                    🏷️ <b>Service:</b> {intent.get('service_type') or '?'} &nbsp;|&nbsp;
+                    📍 <b>Location:</b> {intent.get('location') or '?'} &nbsp;|&nbsp;
+                    🕐 <b>Time:</b> {intent.get('time') or '?'} &nbsp;|&nbsp;
+                    🌐 <b>Language:</b> {intent.get('language') or '?'}
+                </div>
+            </div>""", unsafe_allow_html=True)
+        except Exception as e:
+            st.markdown(f"""<div class="agent-card error">
+                <div class="agent-title">❌ Agent 1 Failed</div>
+                <div class="agent-body">{e}</div>
+            </div>""", unsafe_allow_html=True)
+            return None, trace
+
+    # ── Agent 2: Discovery ────────────────────────────────────────
+    with st.container():
+        t0 = time.time()
+        try:
+            disc = discovery_agent.run(intent)
+            ms = int((time.time() - t0) * 1000)
+            trace.append({
+                "agent": "DiscoveryAgent", "step": 2,
+                "input": intent, "output": {"total_found": disc["total_found"]},
+                "duration_ms": ms,
+                "reasoning": f"Searched providers.json for '{intent.get('service_type')}' near {disc['user_location']}. "
+                             f"Found {disc['total_found']} provider(s). Distances computed via haversine formula."
+            })
+            st.markdown(f"""<div class="agent-card done">
+                <div class="agent-title">✅ Agent 2 — Discovery Agent <small style="color:#718096">({ms}ms)</small></div>
+                <div class="agent-body">
+                    Found <b>{disc['total_found']}</b> provider(s) for <b>{intent.get('service_type')}</b>
+                    near <b>{disc['user_location']}</b>.
+                </div>
+            </div>""", unsafe_allow_html=True)
+        except Exception as e:
+            st.markdown(f"""<div class="agent-card error">
+                <div class="agent-title">❌ Agent 2 Failed</div>
+                <div class="agent-body">{e}</div>
+            </div>""", unsafe_allow_html=True)
+            return None, trace
+
+    if disc["total_found"] == 0:
+        st.warning("😕 No providers found for this service in your area. Try a different location or service.")
+        return None, trace
+
+    # ── Agent 3: Recommendation ───────────────────────────────────
+    with st.container():
+        t0 = time.time()
+        try:
+            rec = recommendation_agent.run(disc)
+            ms = int((time.time() - t0) * 1000)
+            trace.append({
+                "agent": "RecommendationAgent", "step": 3,
+                "input": {"providers_found": disc["total_found"]},
+                "output": {
+                    "selected": rec["best_provider"]["name"],
+                    "score": rec["best_provider"]["score"]
+                },
+                "duration_ms": ms,
+                "reasoning": rec["reasoning"]
+            })
+            st.markdown(f"""<div class="agent-card done">
+                <div class="agent-title">✅ Agent 3 — Recommendation Agent <small style="color:#718096">({ms}ms)</small></div>
+                <div class="agent-body">
+                    {rec['reasoning']}
+                </div>
+            </div>""", unsafe_allow_html=True)
+        except Exception as e:
+            st.markdown(f"""<div class="agent-card error">
+                <div class="agent-title">❌ Agent 3 Failed</div>
+                <div class="agent-body">{e}</div>
+            </div>""", unsafe_allow_html=True)
+            return None, trace
+
+    # ── Agent 4: Booking ──────────────────────────────────────────
+    with st.container():
+        t0 = time.time()
+        try:
+            bk = booking_agent.run(rec, intent)
+            ms = int((time.time() - t0) * 1000)
+            trace.append({
+                "agent": "BookingAgent", "step": 4,
+                "input": {"provider": rec["best_provider"]["name"]},
+                "output": {"booking_id": bk["booking_id"], "slot": bk["confirmed_slot"]},
+                "duration_ms": ms,
+                "reasoning": f"Picked slot {bk['confirmed_slot']} from available morning slots. "
+                             f"Wrote to bookings.json. Booking ID: {bk['booking_id']}."
+            })
+            st.markdown(f"""<div class="agent-card done">
+                <div class="agent-title">✅ Agent 4 — Booking Agent <small style="color:#718096">({ms}ms)</small></div>
+                <div class="agent-body">
+                    Booking <b>{bk['booking_id']}</b> confirmed for <b>{bk['confirmed_slot']}</b>.
+                    Reminder set for <b>{bk['reminder_time']}</b>.
+                </div>
+            </div>""", unsafe_allow_html=True)
+        except Exception as e:
+            st.markdown(f"""<div class="agent-card error">
+                <div class="agent-title">❌ Agent 4 Failed</div>
+                <div class="agent-body">{e}</div>
+            </div>""", unsafe_allow_html=True)
+            return None, trace
+
+    return {"intent": intent, "discovery": disc, "recommendation": rec, "booking": bk}, trace
+
+
+# ════════════════════════════════════════════════════════════════════
+# RUN
+# ════════════════════════════════════════════════════════════════════
+if run_btn and user_input.strip():
+    st.session_state.result = None
+    st.session_state.trace_log = None
+    result, trace = run_pipeline(user_input.strip())
+    st.session_state.result = result
+    st.session_state.trace_log = trace
+
+elif run_btn and not user_input.strip():
+    st.warning("Please type a service request first.")
+
+# ════════════════════════════════════════════════════════════════════
+# RESULTS
+# ════════════════════════════════════════════════════════════════════
+if st.session_state.result:
+    result = st.session_state.result
+    rec = result["recommendation"]
+    bk  = result["booking"]
+    disc = result["discovery"]
+
+    st.markdown("---")
+
+    # ── Tabs ────────────────────────────────────────────────────
+    tab1, tab2, tab3 = st.tabs(["📋 Providers Found", "✅ Booking Receipt", "🔍 Agent Trace"])
+
+    # ── Tab 1: Providers ─────────────────────────────────────────
+    with tab1:
+        st.markdown(f"**{disc['total_found']} provider(s) found** — ranked by distance · rating · availability")
+        for i, p in enumerate(rec["all_ranked"]):
+            is_best = i == 0
+            badge   = '<span class="badge-best">⭐ TOP PICK</span>' if is_best else ""
+            avail   = "🟢 Available" if p.get("available") else "🔴 Unavailable"
+            score_w = int(p["score"] * 100)
+            st.markdown(f"""
+            <div class="provider-card {'best' if is_best else ''}">
+                <div class="provider-name">#{i+1} {p['name']}{badge}</div>
+                <div class="provider-meta">
+                    📍 {p['location']['area']} · 
+                    📏 {p['distance_km']} km · 
+                    ⭐ {p['rating']} ({p['total_reviews']} reviews) · 
+                    {avail} · 
+                    💰 {p.get('price_range', 'N/A')}
+                </div>
+                <div class="score-bar"><div class="score-fill" style="width:{score_w}%"></div></div>
+                <div style="font-size:0.75rem;color:#a0aec0;margin-top:3px;">Score: {p['score']}</div>
+            </div>""", unsafe_allow_html=True)
+
+    # ── Tab 2: Receipt ────────────────────────────────────────────
+    with tab2:
+        st.markdown(f"""
+        <div class="receipt">
+            <div class="receipt-id">BOOKING ID: {bk['booking_id']}</div>
+            <div class="receipt-name">🎉 {bk['provider_name']}</div>
+            <div style="color:#48bb78;font-size:0.85rem;margin-bottom:16px;">Booking Confirmed</div>
+            <div class="receipt-row">
+                <span class="receipt-label">🔧 Service</span>
+                <span class="receipt-value">{bk['service']}</span>
+            </div>
+            <div class="receipt-row">
+                <span class="receipt-label">📍 Location</span>
+                <span class="receipt-value">{bk['location']}</span>
+            </div>
+            <div class="receipt-row">
+                <span class="receipt-label">📅 Date</span>
+                <span class="receipt-value">{bk['booked_date']}</span>
+            </div>
+            <div class="receipt-row">
+                <span class="receipt-label">⏰ Slot</span>
+                <span class="receipt-value">{bk['confirmed_slot']}</span>
+            </div>
+            <div class="receipt-row">
+                <span class="receipt-label">📞 Contact</span>
+                <span class="receipt-value">{bk['provider_phone']}</span>
+            </div>
+            <div class="reminder-box">
+                🔔 <b>Reminder</b> set for <b>{bk['reminder_time']}</b> — 1 hour before your appointment.
+            </div>
+        </div>
+        """, unsafe_allow_html=True)
+
+    # ── Tab 3: Agent Trace ────────────────────────────────────────
+    with tab3:
+        st.markdown('<div class="trace-header">Full Agent Decision Log</div>', unsafe_allow_html=True)
+        for step in st.session_state.trace_log:
+            with st.expander(
+                f"Step {step['step']} — {step['agent']} ({step['duration_ms']}ms)",
+                expanded=False
+            ):
+                st.markdown(f"**Reasoning:** {step['reasoning']}")
+                col_a, col_b = st.columns(2)
+                with col_a:
+                    st.markdown("**Input**")
+                    st.json(step["input"])
+                with col_b:
+                    st.markdown("**Output**")
+                    st.json(step["output"])
+
+        st.markdown("**Full trace JSON:**")
+        st.json(st.session_state.trace_log)
+
+# ════════════════════════════════════════════════════════════════════
+# FOOTER
+# ════════════════════════════════════════════════════════════════════
+st.markdown("---")
+st.markdown(
+    "<div style='text-align:center;color:#a0aec0;font-size:0.78rem'>"
+    "KhidmatAI · Built with Google Antigravity · Gemini API · Streamlit · "
+    "Hackathon Project 2025"
+    "</div>",
+    unsafe_allow_html=True
+)

data/bookings.json

@@ -0,0 +1 @@
+[]

data/providers.json

@@ -0,0 +1,132 @@
+[
+  {
+    "provider_id": "PRV-001",
+    "name": "Ali AC Services",
+    "service_categories": ["AC Technician", "HVAC", "Refrigerator Repair"],
+    "location": { "area": "G-13", "city": "Islamabad", "lat": 33.6844, "lng": 73.0479 },
+    "rating": 4.8,
+    "total_reviews": 127,
+    "available": true,
+    "available_slots": ["09:00", "10:00", "14:00", "16:00"],
+    "price_range": "PKR 500-1500",
+    "phone": "+92-300-0000001",
+    "languages": ["Urdu", "English"]
+  },
+  {
+    "provider_id": "PRV-002",
+    "name": "Hassan Plumbing Works",
+    "service_categories": ["Plumber"],
+    "location": { "area": "G-11", "city": "Islamabad", "lat": 33.6938, "lng": 73.0551 },
+    "rating": 4.5,
+    "total_reviews": 89,
+    "available": true,
+    "available_slots": ["08:00", "11:00", "15:00"],
+    "price_range": "PKR 400-1200",
+    "phone": "+92-300-0000002",
+    "languages": ["Urdu"]
+  },
+  {
+    "provider_id": "PRV-003",
+    "name": "Bright Electricals",
+    "service_categories": ["Electrician"],
+    "location": { "area": "F-10", "city": "Islamabad", "lat": 33.7077, "lng": 73.0354 },
+    "rating": 4.7,
+    "total_reviews": 203,
+    "available": true,
+    "available_slots": ["09:00", "13:00", "17:00"],
+    "price_range": "PKR 600-2000",
+    "phone": "+92-300-0000003",
+    "languages": ["Urdu", "English"]
+  },
+  {
+    "provider_id": "PRV-004",
+    "name": "Sir Kamran Academy",
+    "service_categories": ["Tutor"],
+    "location": { "area": "G-9", "city": "Islamabad", "lat": 33.6995, "lng": 73.0440 },
+    "rating": 4.9,
+    "total_reviews": 312,
+    "available": true,
+    "available_slots": ["16:00", "17:00", "18:00", "19:00"],
+    "price_range": "PKR 800-2500 per session",
+    "phone": "+92-300-0000004",
+    "languages": ["Urdu", "English"]
+  },
+  {
+    "provider_id": "PRV-005",
+    "name": "Nadia Beauty Home Service",
+    "service_categories": ["Beautician"],
+    "location": { "area": "G-13", "city": "Islamabad", "lat": 33.6821, "lng": 73.0511 },
+    "rating": 4.6,
+    "total_reviews": 78,
+    "available": true,
+    "available_slots": ["10:00", "12:00", "14:00", "16:00"],
+    "price_range": "PKR 1000-5000",
+    "phone": "+92-300-0000005",
+    "languages": ["Urdu"]
+  },
+  {
+    "provider_id": "PRV-006",
+    "name": "Master Woodcraft",
+    "service_categories": ["Carpenter"],
+    "location": { "area": "I-8", "city": "Islamabad", "lat": 33.6741, "lng": 73.0632 },
+    "rating": 4.4,
+    "total_reviews": 55,
+    "available": true,
+    "available_slots": ["08:00", "10:00", "14:00"],
+    "price_range": "PKR 700-3000",
+    "phone": "+92-300-0000006",
+    "languages": ["Urdu"]
+  },
+  {
+    "provider_id": "PRV-007",
+    "name": "ColorPro Painters",
+    "service_categories": ["Painter"],
+    "location": { "area": "E-11", "city": "Islamabad", "lat": 33.7215, "lng": 73.0194 },
+    "rating": 4.3,
+    "total_reviews": 42,
+    "available": false,
+    "available_slots": [],
+    "price_range": "PKR 2000-8000 per room",
+    "phone": "+92-300-0000007",
+    "languages": ["Urdu", "Punjabi"]
+  },
+  {
+    "provider_id": "PRV-008",
+    "name": "Speedy Drivers Islamabad",
+    "service_categories": ["Driver"],
+    "location": { "area": "G-10", "city": "Islamabad", "lat": 33.7020, "lng": 73.0397 },
+    "rating": 4.7,
+    "total_reviews": 189,
+    "available": true,
+    "available_slots": ["06:00", "08:00", "10:00", "14:00", "18:00", "20:00"],
+    "price_range": "PKR 300-1500 per trip",
+    "phone": "+92-300-0000008",
+    "languages": ["Urdu", "English"]
+  },
+  {
+    "provider_id": "PRV-009",
+    "name": "CleanHome Maids",
+    "service_categories": ["Maid"],
+    "location": { "area": "F-7", "city": "Islamabad", "lat": 33.7192, "lng": 73.0587 },
+    "rating": 4.5,
+    "total_reviews": 134,
+    "available": true,
+    "available_slots": ["08:00", "09:00", "10:00"],
+    "price_range": "PKR 1200-3500 per visit",
+    "phone": "+92-300-0000009",
+    "languages": ["Urdu"]
+  },
+  {
+    "provider_id": "PRV-010",
+    "name": "FastDeliver Islamabad",
+    "service_categories": ["Delivery Worker"],
+    "location": { "area": "G-6", "city": "Islamabad", "lat": 33.7290, "lng": 73.0935 },
+    "rating": 4.2,
+    "total_reviews": 267,
+    "available": true,
+    "available_slots": ["09:00", "11:00", "13:00", "15:00", "17:00"],
+    "price_range": "PKR 150-500 per delivery",
+    "phone": "+92-300-0000010",
+    "languages": ["Urdu", "English"]
+  }
+]

requirements.txt

@@ -0,0 +1,3 @@
+streamlit==1.35.0
+google-generativeai==0.7.2
+python-dotenv==1.0.1