Upload folder using huggingface_hub

.gitattributes

@@ -33,3 +33,25 @@ saved_model/**/* filter=lfs diff=lfs merge=lfs -text
 *.zip filter=lfs diff=lfs merge=lfs -text
 *.zst filter=lfs diff=lfs merge=lfs -text
 *tfevents* filter=lfs diff=lfs merge=lfs -text
+src/finadvisor/3030_Module04_Demonstration01_v1.0.pdf filter=lfs diff=lfs merge=lfs -text
+src/image-generator/src/image-generator/generated_images/06767ab4-8205-478b-9387-fd94f3929969.png filter=lfs diff=lfs merge=lfs -text
+src/image-generator/src/image-generator/generated_images/1214aea0-d1d9-4125-b619-2cb81fa54d7e.png filter=lfs diff=lfs merge=lfs -text
+src/image-generator/src/image-generator/generated_images/1629816f-fbfd-4e2d-ac0c-18b39172832c.png filter=lfs diff=lfs merge=lfs -text
+src/image-generator/src/image-generator/generated_images/26c96916-52a4-44c8-8f5f-437bba078205.png filter=lfs diff=lfs merge=lfs -text
+src/image-generator/src/image-generator/generated_images/272868d3-16fc-474b-9398-c8bc6dffcc21.png filter=lfs diff=lfs merge=lfs -text
+src/image-generator/src/image-generator/generated_images/3f645a42-5fd2-4c79-bd4a-62710d905fbb.png filter=lfs diff=lfs merge=lfs -text
+src/image-generator/src/image-generator/generated_images/52665623-7fa0-426b-91ca-21f418471674.png filter=lfs diff=lfs merge=lfs -text
+src/image-generator/src/image-generator/generated_images/6490bab7-6c83-4f6c-b138-cc962a806817.png filter=lfs diff=lfs merge=lfs -text
+src/image-generator/src/image-generator/generated_images/6869b3cb-e2fa-4224-9b2f-3229a84e49a9.png filter=lfs diff=lfs merge=lfs -text
+src/image-generator/src/image-generator/generated_images/6cb30ef4-6089-4899-a6d2-43217a762069.png filter=lfs diff=lfs merge=lfs -text
+src/image-generator/src/image-generator/generated_images/6f8885b5-f4b6-4286-96a5-c27e57cf84e1.png filter=lfs diff=lfs merge=lfs -text
+src/image-generator/src/image-generator/generated_images/a38ab0db-de95-4d0b-9b9a-6bb97a73e364.png filter=lfs diff=lfs merge=lfs -text
+src/image-generator/src/image-generator/generated_images/a5c56b0d-235e-469c-953f-3a18a988e99f.png filter=lfs diff=lfs merge=lfs -text
+src/image-generator/src/image-generator/generated_images/ab435c70-86b5-4262-9e73-2170f5de5dd1.png filter=lfs diff=lfs merge=lfs -text
+src/image-generator/src/image-generator/generated_images/b0dff864-d52b-43a5-8cca-217c967b9faa.png filter=lfs diff=lfs merge=lfs -text
+src/image-generator/src/image-generator/generated_images/d0466afb-74e1-4d9c-9894-a2adbbe847c3.png filter=lfs diff=lfs merge=lfs -text
+src/image-generator/src/image-generator/generated_images/d4d748a3-0a48-4e3e-a9d9-b05ad7ae9c2f.png filter=lfs diff=lfs merge=lfs -text
+src/image-generator/src/image-generator/generated_images/e92b2025-8bd4-49a5-9ea0-f3ae9d545947.png filter=lfs diff=lfs merge=lfs -text
+src/image-generator/src/image-generator/generated_images/efa13dc8-abde-4985-a0d9-92122b1a9136.png filter=lfs diff=lfs merge=lfs -text
+src/image-generator/src/image-generator/generated_images/f54ad375-d70e-49ef-94b5-7d3320037da8.png filter=lfs diff=lfs merge=lfs -text
+src/interview-assistant/data/interview_rag_db/chroma.sqlite3 filter=lfs diff=lfs merge=lfs -text

Dockerfile

@@ -0,0 +1,22 @@
+
+FROM python:3.12-slim
+
+WORKDIR /app
+
+RUN apt-get update && apt-get install -y --no-install-recommends \
+    git \
+    && rm -rf /var/lib/apt/lists/*
+
+COPY pyproject.toml .
+RUN pip install --no-cache-dir .
+
+COPY src/mcp-rag-secure ./src/mcp-rag-secure
+
+ENV PYTHONPATH=/app/src
+
+# Create directory for ChromaDB
+RUN mkdir -p src/mcp-rag-secure/chroma_db && chmod 777 src/mcp-rag-secure/chroma_db
+
+EXPOSE 7860
+
+CMD ["python", "src/mcp-rag-secure/server.py", "--transport", "sse", "--port", "7860", "--host", "0.0.0.0"]

README.md

@@ -1,10 +1,27 @@
----
-title: Mcp Rag Secure
-emoji: 🐢
-colorFrom: purple
-colorTo: red
-sdk: docker
-pinned: false
----
-
-Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
+
+---
+title: MCP Secure RAG
+emoji: 🔒
+colorFrom: pink
+colorTo: red
+sdk: docker
+pinned: false
+---
+
+# MCP Secure Multi-Tenant RAG Server
+
+This is a Model Context Protocol (MCP) server for secure, tenant-isolated Retrieval-Augmented Generation.
+
+## Tools
+- `ingest_document`: Add documents with strict tenant ID metadata.
+- `query_knowledge_base`: Query documents filtered by tenant ID.
+- `delete_tenant_data`: Wipe data for a specific tenant.
+
+## Security
+- Uses ChromaDB for vector storage.
+- All operations require a `tenant_id` to ensure data isolation.
+
+## Running Locally
+```bash
+python src/mcp-rag-secure/server.py
+```

pyproject.toml

@@ -0,0 +1,201 @@
+[project]
+name = "agenticai"
+version = "0.1.0"
+description = "Agentic AI project"
+readme = "README.md"
+requires-python = "==3.12.*"
+
+dependencies = [
+    # =======================
+    # LLM PROVIDERS / SDKs
+    # =======================
+    "openai>=2.8.1",
+    "openai-agents>=0.5.1",
+    "anthropic>=0.49.0",
+    "langchain-openai>=1.0.3",
+    "langchain-anthropic>=1.1.0",
+    "langchain_huggingface>=1.1.0",
+    "langchain_ollama>=1.0.0",
+    "langchain_google_genai>=3.0.3",
+    "langchain_groq>=1.0.1",
+
+
+    # =======================
+    # LANGCHAIN / LANGGRAPH
+    # =======================
+    "langchain>=1.0.7",
+    "langchain-community>=0.4.1",
+    "langgraph>=1.0.3",
+    "langgraph-checkpoint-sqlite>=3.0.0",
+    "langsmith>=0.4.43",
+    "langchain-text-splitters>=1.0.0",
+    "langchain-chroma>=1.0.0",
+    "html2text>=2025.4.15",
+    "traceloop-sdk>=0.33.0",
+
+    # =======================
+    # MICROSOFT AGENT FRAMEWORK
+    # =======================
+    #"agent-framework==1.0.0b251204",
+    #"agent-framework-azure-ai==1.0.0b251204",
+    #"azure-ai-projects",
+    #"azure-ai-agents",
+    #"azure-ai-agents>=1.2.0b5",
+    #"agent-framework-azure-ai",
+
+    # =======================
+    # VECTOR DB / INDEXING
+    # =======================
+    "faiss-cpu>=1.13.0",
+    "chromadb>=0.4.0",
+    "sentence-transformers>=5.1.2",
+    "pymupdf",
+    "pypdf>=6.3.0",
+    "pypdf2>=3.0.1",
+    "arxiv>=2.3.1",
+    "wikipedia>=1.4.0",
+
+    # =======================
+    # AUTOGEN
+    # =======================
+    "autogen-agentchat==0.4.7",
+    "autogen-ext[grpc,mcp,ollama,openai]==0.4.7",
+    "asyncio",
+    "phidata>=2.0.0",
+
+    # =======================
+    # MCP
+    # =======================
+    "mcp-server-fetch>=2025.1.17",
+    "mcp[cli]>=1.21.2",
+    
+    # =======================
+    # NETWORKING / UTILITIES
+    # =======================
+    "psutil>=7.0.0",
+    "python-dotenv>=1.0.1",
+    "requests>=2.32.3",
+    "aiohttp>=3.8.5",
+    "httpx>=0.28.1",
+    "speedtest-cli>=2.1.3",
+    "logfire",
+    "google-search-results",
+    "smithery>=0.4.4",
+    "sendgrid",
+
+    # =======================
+    # WEB SCRAPING
+    # =======================
+    "playwright>=1.51.0",
+    "beautifulsoup4>=4.12.3",
+    "lxml>=5.3.1",
+
+    # =======================
+    # FINANCE / NLP
+    # =======================
+    "yfinance>=0.2.66",
+    "textblob>=0.17.1",
+    "polygon-api-client>=1.16.3",
+
+    # =======================
+    # VISUAL / UI / PDF
+    # =======================
+    "plotly>=6.5.0",
+    "streamlit>=1.51.0",
+    "reportlab>=4.4.5",
+    "fastapi",
+    "Pillow",
+    "python-docx",
+    "matplotlib",
+    "fpdf",
+    "extra-streamlit-components",
+    "nest_asyncio",
+
+    # =======================
+    # AUDIO / VIDEO
+    # =======================
+    "yt_dlp>=2025.11.12",
+    "openai-whisper==20240930",
+    "numba==0.59.0",
+    "llvmlite==0.42.0",
+
+    # =======================
+    # MACHINE LEARNING
+    # =======================
+    "scikit-learn>=1.7.2",
+    "huggingface_hub<=1.3.2",
+    "datasets>=4.4.1",
+
+    # =======================
+    # IPYNB SUPPORT
+    # =======================
+    "ipykernel>=7.1.0",
+
+    # =======================
+    # TOOLS
+    # =======================
+    "ddgs>=9.9.2",
+    "duckduckgo_search",
+    "azure-identity>=1.25.1",
+    "azure-mgmt-resource>=23.0.1",
+    "azure-mgmt-compute>=30.3.0",
+    "azure-mgmt-monitor>=6.0.2",
+    "azure-monitor-query>=1.2.0",
+    "PyGithub>=2.1.1",
+
+    # =======================
+    # OBSERVABILITY
+    # =======================
+    "openinference-instrumentation-autogen>=0.1.0",
+    "openinference-instrumentation-openai>=0.1.15",
+    "opentelemetry-sdk>=1.20.0",
+    "opentelemetry-exporter-otlp>=1.20.0",
+    "opentelemetry-api>=1.20.0",
+
+    # =======================
+    # Google Authentication
+    # =======================
+    "google-auth>=2.22.0",
+    "google-auth-oauthlib>=0.4.6",
+    "google-auth-httplib2>=0.1.0",
+    "autoflake>=1.5.0",
+
+]
+
+[dependency-groups]
+dev = [
+    "pytest>=8.3.3",
+    "ipykernel>=7.1.0",
+    "pytest-asyncio",
+]
+
+# ============================================================
+# BUILD SYSTEM
+# ============================================================
+# Defines how to build the project.
+# We use setuptools as the build backend, ensuring consistent packaging.
+[build-system]
+requires = ["setuptools>=80.9.0"]
+build-backend = "setuptools.build_meta"
+
+# ============================================================
+# PACKAGING & DISCOVERY
+# ============================================================
+# Tells setuptools where to find the source code.
+# This makes 'common' and 'src' importable when installed (pip install -e .).
+[tool.setuptools.packages.find]
+where = ["."]  # Look in the project root
+include = ["common*", "src*"]  # Treat 'common' and 'src' folders as packages
+
+
+# ============================================================
+# PYTEST SETTINGS
+# ============================================================
+# Configures the test runner to automatically find code.
+[tool.pytest.ini_options]
+# Adds 'src' and 'common' to the python path during tests.
+# This allows tests to import modules (e.g., 'import travel_agent')
+# just like the apps do locally, preventing ModuleNotFoundError.
+pythonpath = ["src", "common"]
+testpaths = ["tests"]  # Only look for tests in the 'tests' directory
+addopts = "-q"  # Run in quiet mode (less verbose output)

src/accessibility_v1/Dockerfile

@@ -0,0 +1,34 @@
+# Dockerfile
+FROM python:3.11-slim
+
+apt-get update
+apt-get install -y \
+    libnss3 \
+    libnspr4 \
+    libasound2 \
+    libatk1.0-0 \
+    libx11-xcb1 \
+    libxcomposite1 \
+    libxdamage1 \
+    libxrandr2 \
+    libgbm1 \
+    libpango-1.0-0 \
+    libcups2 \
+    libxss1 \
+    libxshmfence1
+
+
+WORKDIR /app
+
+COPY requirements.txt /app/
+RUN pip install --no-cache-dir -r requirements.txt
+
+# copy server and axe
+COPY server.py /app/
+COPY axe.min.js /app/
+
+# install playwright browsers
+RUN playwright install --with-deps
+
+EXPOSE 8000
+CMD ["python", "server.py"]

src/accessibility_v1/app.py

@@ -0,0 +1,187 @@
+# app.py
+import os
+import nest_asyncio
+import asyncio
+import json
+from datetime import datetime
+import streamlit as st
+from agents import Agent, Runner, trace, OpenAIChatCompletionsModel
+from agents.mcp import MCPServerStdio
+
+import aiohttp
+from xml.etree import ElementTree as ET
+from openai import AsyncOpenAI
+import urllib.parse
+import ipaddress
+import socket
+
+# Allow nested async in Jupyter/Streamlit
+nest_asyncio.apply()
+nest_asyncio.apply()
+
+TEMPLATE_PATH = os.path.abspath("templates/dashboard_template.html")
+
+
+def is_safe_url(url: str) -> bool:
+    """
+    Basic SSRF protection: allow only http(s) URLs whose resolved IPs are not
+    private, loopback, link-local, or reserved.
+    """
+    try:
+        parsed = urllib.parse.urlparse(url)
+        if parsed.scheme not in ("http", "https"):
+            return False
+        if not parsed.hostname:
+            return False
+        # Resolve hostname to IPs
+        addrinfo_list = socket.getaddrinfo(parsed.hostname, None)
+        for family, _, _, _, sockaddr in addrinfo_list:
+            if family == socket.AF_INET:
+                ip_str = sockaddr[0]
+            elif family == socket.AF_INET6:
+                ip_str = sockaddr[0]
+            else:
+                continue
+            ip_obj = ipaddress.ip_address(ip_str)
+            if (
+                ip_obj.is_private
+                or ip_obj.is_loopback
+                or ip_obj.is_link_local
+                or ip_obj.is_reserved
+                or ip_obj.is_multicast
+            ):
+                return False
+        return True
+    except Exception:
+        # On any error parsing or resolving, consider the URL unsafe
+        return False
+
+
+async def fetch_sitemap_urls(base_url: str):
+    if not is_safe_url(base_url):
+        raise ValueError(f"Unsafe or invalid URL provided: {base_url}")
+    sitemap_url = base_url.rstrip("/") + "/sitemap.xml"
+    urls = []
+    async with aiohttp.ClientSession() as session:
+        try:
+            async with session.get(sitemap_url) as resp:
+                if resp.status != 200:
+                    return [base_url]
+                xml_text = await resp.text()
+                root = ET.fromstring(xml_text)
+                urls = [elem.text for elem in root.findall(".//{*}loc")]
+        except:
+            return [base_url]
+    return urls if urls else [base_url]
+
+
+async def run_accessibility_audit(base_url: str):
+    script_path = os.path.abspath("mcp/server.py")
+    if not os.path.exists(script_path):
+        st.error(f"MCP server not found: {script_path}")
+        return None
+
+    params = {"command": "uv", "args": ["run", script_path]}
+    # model = "gpt-4.1-mini"
+
+    GEMINI_BASE_URL = "https://generativelanguage.googleapis.com/v1beta/openai/"
+    google_api_key = os.getenv('GOOGLE_API_KEY')
+    gemini_client = AsyncOpenAI(base_url=GEMINI_BASE_URL, api_key=google_api_key)
+    model = OpenAIChatCompletionsModel(model="gemini-2.0-flash", openai_client=gemini_client) 
+
+    try:
+        async with MCPServerStdio(params=params, client_session_timeout_seconds=180) as accessibility_server:
+            urls_to_audit = await fetch_sitemap_urls(base_url)
+            audit_results = {}
+            page_summaries = {}
+
+            progress_placeholder = st.empty()  # dynamic progress updates
+
+            audit_instructions = (
+                "You are an AI assistant specialized in ADA/WCAG compliance. "
+                "Audit a webpage and produce a Markdown report including all rules with columns: "
+                "Level, Rule, Pass/Fail, Reason, Recommendation."
+            )
+
+            for idx, url in enumerate(urls_to_audit, start=1):
+                progress_placeholder.info(f"🔹 Auditing page {idx}/{len(urls_to_audit)}: {url}")
+                audit_agent = Agent(
+                    name="accessibility_agent",
+                    instructions=audit_instructions,
+                    model=model,
+                    mcp_servers=[accessibility_server]
+                )
+                with trace(f"audit_{url}"):
+                    result = await Runner.run(audit_agent, f"Audit {url} for ADA/WCAG compliance.")
+                markdown_output = result.final_output if result and result.final_output else ""
+                audit_results[url] = markdown_output
+
+                # Compute per-page summary
+                passed = failed = warning = 0
+                for line in markdown_output.splitlines():
+                    if "|" in line:
+                        parts = [p.strip() for p in line.split("|")]
+                        if len(parts) >= 5:
+                            status = parts[2].lower()
+                            if "pass" in status:
+                                passed += 1
+                            elif "fail" in status:
+                                failed += 1
+                            elif "warn" in status or "warning" in status:
+                                warning += 1
+                page_summaries[url] = {"pass": passed, "fail": failed, "warning": warning}
+
+            # Prepare JSON data for template
+            audit_json = []
+            for page, md in audit_results.items():
+                rows = []
+                for line in md.splitlines():
+                    if "|" in line:
+                        parts = [p.strip() for p in line.split("|")]
+                        if len(parts) >= 5:
+                            rows.append({
+                                "level": parts[0],
+                                "rule": parts[1],
+                                "status": parts[2],
+                                "reason": parts[3],
+                                "recommendation": parts[4],
+                            })
+                audit_json.append({
+                    "page": page,
+                    "rows": rows,
+                    "summary": page_summaries.get(page, {"pass": 0, "fail": 0, "warning": 0})
+                })
+
+            # Load template
+            with open(TEMPLATE_PATH, "r", encoding="utf-8") as f:
+                template_html = f.read()
+
+            html_content = template_html.replace("<!--AUDIT_JSON_PLACEHOLDER-->", json.dumps(audit_json))
+
+            # Save HTML report
+            output_dir = os.path.abspath("output")
+            os.makedirs(output_dir, exist_ok=True)
+            timestamp = datetime.now().strftime("%Y%m%d_%H%M%S")
+            output_file = os.path.join(output_dir, f"accessibility_dashboard_{timestamp}.html")
+            with open(output_file, "w", encoding="utf-8") as f:
+                f.write(html_content)
+
+            progress_placeholder.success(f"✅ Accessibility audit complete! Report saved to `{output_file}`.")
+
+            return html_content
+
+    except Exception as e:
+        st.error(f"Error running audit: {e}")
+        return None
+
+
+# ------------------- Streamlit UI -------------------
+st.set_page_config(page_title="Accessibility Dashboard", layout="wide")
+st.title("🌐 Site Accessibility Audit Dashboard")
+
+site_url = st.text_input("Enter the website URL", "https://oauthapp.azurewebsites.net")
+
+if st.button("Run Audit") and site_url:
+    html_output = asyncio.run(run_accessibility_audit(site_url))
+    if html_output:
+        st.components.v1.html(html_output, height=900, scrolling=True)

src/accessibility_v1/mcp/server.py

@@ -0,0 +1,373 @@
+# mcp/server.py
+import os
+import asyncio
+import json
+from typing import Any, Dict, List, Optional
+from mcp.server.fastmcp import FastMCP
+
+from playwright.async_api import async_playwright, Page
+import textwrap
+import math
+
+
+
+mcp = FastMCP("accessibility_server")
+
+# Path to axe script (must exist next to this file or set AXE_JS_PATH env)
+DEFAULT_AXE_PATH = os.path.join(os.path.dirname(__file__), "axe.min.js")
+AXE_JS_PATH = os.environ.get("AXE_JS_PATH", DEFAULT_AXE_PATH)
+
+# ---------- Helper: start browser, load page ----------
+async def _open_page(url: str, timeout: int = 30000, wait_until: str = "load"):
+    """
+    Launch Playwright chromium, open url, return (playwright, browser, context, page).
+    Caller must close browser and playwright.
+    """
+    playwright = await async_playwright().start()
+    browser = await playwright.chromium.launch(args=["--no-sandbox"], headless=True)
+    context = await browser.new_context()
+    page = await context.new_page()
+    await page.goto(url, timeout=timeout, wait_until=wait_until)
+    # allow some dynamic content to settle
+    await asyncio.sleep(0.5)
+    return playwright, browser, context, page
+
+# ---------- Helper: inject axe and run ----------
+async def _ensure_axe(page: Page):
+    if not os.path.exists(AXE_JS_PATH):
+        raise FileNotFoundError(f"axe.min.js not found at {AXE_JS_PATH}. Download axe-core and place it there.")
+    with open(AXE_JS_PATH, "r", encoding="utf-8") as f:
+        axe_source = f.read()
+    # Add axe to page
+    await page.add_init_script(axe_source)
+    # also evaluate once to be safe
+    await page.evaluate("() => { window.__axe_injected = typeof axe !== 'undefined'; }")
+    ok = await page.evaluate("() => typeof axe !== 'undefined'")
+    if not ok:
+        # attempt to inject directly
+        await page.evaluate(axe_source + "\n() => {}")
+    # final check
+    ok2 = await page.evaluate("() => typeof axe !== 'undefined'")
+    if not ok2:
+        raise RuntimeError("Failed to inject axe into page")
+
+async def _run_axe(page: Page, tags: Optional[List[str]] = None, rules: Optional[Dict[str, Any]] = None):
+    """
+    Run axe.run with wcag2a and wcag2aa tags by default.
+    Returns axe JSON result.
+    """
+    tags = tags or ["wcag2a", "wcag2aa"]
+    config = {"runOnly": {"type": "tag", "values": tags}}
+    if rules:
+        config["rules"] = rules
+    # axe.run returns a Promise; evaluate and return JSON-serializable result
+    result = await page.evaluate(
+        """(conf) => {
+            return axe.run(document, conf);
+        }""",
+        config,
+    )
+    return result
+
+# ---------- Custom JS checks (run inside page) ----------
+HEADINGS_JS = """() => {
+  const headings = Array.from(document.querySelectorAll('h1,h2,h3,h4,h5,h6')).map(h => ({tag:h.tagName.toLowerCase(), text:h.innerText.trim().slice(0,200)}));
+  const hasH1 = headings.some(h=>h.tag==='h1');
+  let last = 0;
+  const orderProblems = [];
+  for (let i=0;i<headings.length;i++){
+    const lvl = parseInt(headings[i].tag.slice(1));
+    if (last !== 0 && (lvl - last) > 1) orderProblems.push({index:i, tag:headings[i].tag, prev:last});
+    last = lvl;
+  }
+  return {headings, hasH1, orderProblems};
+}"""
+
+LANG_JS = """() => {
+  const html = document.documentElement;
+  const lang = html ? html.getAttribute('lang') : null;
+  return {lang, dir: html ? html.getAttribute('dir') : null};
+}"""
+
+IMAGES_JS = """() => {
+  const imgs = Array.from(document.images).map(i => ({src:i.currentSrc||i.src, alt:i.getAttribute('alt'), role:i.getAttribute('role'), ariaHidden:i.getAttribute('aria-hidden')}));
+  const missingAlt = imgs.filter(i => (i.alt === null || i.alt === '') && i.ariaHidden !== 'true');
+  return {count: imgs.length, missingAlt, sample: missingAlt.slice(0,10)};
+}"""
+
+FORMS_JS = """() => {
+  const inputs = Array.from(document.querySelectorAll('input,textarea,select')).map(el=>{
+    const id = el.id;
+    const label = id ? (document.querySelector("label[for='"+id+"']") ? document.querySelector("label[for='"+id+"']").innerText : null) : (el.closest('label') ? el.closest('label').innerText : null);
+    const ariaLabel = el.getAttribute('aria-label');
+    const ariaLabelledBy = el.getAttribute('aria-labelledby');
+    const name = el.getAttribute('name');
+    return {tag:el.tagName.toLowerCase(), type:el.type||null, id, name, label: label ? label.trim().slice(0,200) : null, ariaLabel, ariaLabelledBy};
+  });
+  const missing = inputs.filter(i => !i.label && !i.ariaLabel && !i.ariaLabelledBy);
+  return {inputsCount: inputs.length, missing, sample: missing.slice(0,10)};
+}"""
+
+ARIA_JS = """() => {
+  // detect common ARIA misuse: role mismatch, duplicate ids referenced by aria-labelledby, missing required aria attributes
+  const issues = [];
+  const all = Array.from(document.querySelectorAll('[role], [aria-labelledby], [aria-label], [aria-hidden], [aria-live]'));
+  for (const el of all) {
+    const role = el.getAttribute('role');
+    if (role && role === 'img' && !el.getAttribute('aria-label') && !el.querySelector('img')) {
+      issues.push({type:'role-img-missing-name', outer: el.outerHTML.slice(0,200)});
+    }
+  }
+  // duplicate id references
+  const labels = {};
+  Array.from(document.querySelectorAll('[id]')).forEach(e => { labels[e.id] = (labels[e.id]||0)+1; });
+  Object.keys(labels).filter(k => labels[k]>1).forEach(k => issues.push({type:'duplicate-id', id:k, count:labels[k]}));
+  return {count: all.length, issues: issues.slice(0,50)};
+}"""
+
+KEYBOARD_JS = """() => {
+  // collect focusable elements
+  const focusable = Array.from(document.querySelectorAll('a[href], button, input, textarea, select, [tabindex]'))
+    .filter(el => !el.hasAttribute('disabled') && el.getAttribute('tabindex') !== '-1');
+  // capture natural tab order (by DOM order)
+  const tabOrder = focusable.map(el => ({tag: el.tagName.toLowerCase(), id: el.id||null, class: el.className||null, tabindex: el.getAttribute('tabindex')||null}));
+  // detect tabindex>0 (bad practice)
+  const positiveTabindex = focusable.filter(el => el.hasAttribute('tabindex') && parseInt(el.getAttribute('tabindex')||'0')>0).map(e=>({tag:e.tagName,id:e.id}));
+  return {focusableCount: focusable.length, tabOrder: tabOrder.slice(0,200), positiveTabindex};
+}"""
+
+VIDEO_JS = """() => {
+  const videos = Array.from(document.querySelectorAll('video,audio'));
+  const out = [];
+  for (const v of videos) {
+    const tracks = Array.from(v.querySelectorAll('track')).map(t=>({kind:t.kind, srclang:t.srclang, label:t.label}));
+    // look for external transcript links nearby
+    let transcript = null;
+    const next = v.nextElementSibling;
+    if (next && /transcript|caption|captions/i.test(next.innerText||'')) transcript = next.innerText.trim().slice(0,300);
+    out.push({tag:v.tagName.toLowerCase(), hasTracks: tracks.length>0, tracks, transcript});
+  }
+  return {count: videos.length, videos: out};
+}"""
+
+CONTRAST_JS = """() => {
+  function luminance(r,g,b){
+    const a = [r,g,b].map(v=>{ v=v/255; return v<=0.03928? v/12.92: Math.pow((v+0.055)/1.055,2.4);});
+    return 0.2126*a[0]+0.7152*a[1]+0.0722*a[2];
+  }
+  function parseRGB(colorStr){
+    const m = colorStr.match(/rgba?\\((\\d+),\\s*(\\d+),\\s*(\\d+)/);
+    return m ? [parseInt(m[1]),parseInt(m[2]),parseInt(m[3])] : null;
+  }
+  const candidates = Array.from(document.querySelectorAll('body *')).filter(el => (el.innerText||'').trim().length>0).slice(0,400);
+  const issues = [];
+  for (const el of candidates){
+    const style = window.getComputedStyle(el);
+    const color = parseRGB(style.color);
+    let bg = null;
+    let cur = el;
+    while(cur && cur!==document){
+      const b = window.getComputedStyle(cur).backgroundColor;
+      if (b && b!=='rgba(0, 0, 0, 0)' && b!=='transparent') { bg = parseRGB(b); break; }
+      cur = cur.parentElement;
+    }
+    if (!bg) bg = [255,255,255];
+    if (!color) continue;
+    const L1 = luminance(color[0],color[1],color[2]);
+    const L2 = luminance(bg[0],bg[1],bg[2]);
+    const ratio = (Math.max(L1,L2)+0.05)/(Math.min(L1,L2)+0.05);
+    const fontSize = parseFloat(style.fontSize) || 12;
+    const fontWeight = style.fontWeight;
+    const large = fontSize >= 18 || (fontSize >= 14 && (fontWeight === '700' || parseInt(fontWeight||'0')>=700));
+    const pass = large ? ratio >= 3.0 : ratio >= 4.5;
+    if (!pass) issues.push({text: (el.innerText||'').slice(0,120), ratio: Number(ratio.toFixed(2)), fontSize, large});
+  }
+  return {checked: candidates.length, issues: issues.slice(0,200)};
+}"""
+
+SEMANTICS_JS = """() => {
+  // check for landmark elements and semantic usage
+  const landmarks = {};
+  ['header','main','nav','footer','aside','form'].forEach(k => landmarks[k] = document.querySelectorAll(k).length);
+  // detect skip link
+  const skip = Array.from(document.querySelectorAll('a[href]')).some(a => /skip|skip to content/i.test(a.innerText||''));
+  return {landmarks, hasSkipLink: skip};
+}"""
+
+# ---------- Tool definitions ----------
+@mcp.tool()
+async def run_axe_audit(url: str, timeout: int = 30000):
+    """
+    Run axe-core on the page and return the full axe result (violations, passes, incomplete, etc).
+    This is the primary automated scanner and is required for broad WCAG coverage.
+    """
+    playwright = browser = context = page = None
+    try:
+        playwright, browser, context, page = await _open_page(url, timeout=timeout)
+        await _ensure_axe(page)
+        axe_result = await _run_axe(page, tags=["wcag2a", "wcag2aa"])
+        return {"url": url, "axe": axe_result}
+    except Exception as e:
+        return {"url": url, "error": str(e)}
+    finally:
+        if context:
+            await context.close()
+        if browser:
+            await browser.close()
+        if playwright:
+            await playwright.stop()
+
+# Individual custom checks (wrap the JS above)
+async def _eval_js_on_page(url: str, js: str, timeout: int = 30000):
+    playwright = browser = context = page = None
+    try:
+        playwright, browser, context, page = await _open_page(url, timeout=timeout)
+        res = await page.evaluate(js)
+        return {"url": url, "result": res}
+    except Exception as e:
+        return {"url": url, "error": str(e)}
+    finally:
+        if context:
+            await context.close()
+        if browser:
+            await browser.close()
+        if playwright:
+            await playwright.stop()
+
+@mcp.tool()
+async def check_headings(url: str):
+    return await _eval_js_on_page(url, HEADINGS_JS)
+
+@mcp.tool()
+async def check_language(url: str):
+    return await _eval_js_on_page(url, LANG_JS)
+
+@mcp.tool()
+async def check_images(url: str):
+    return await _eval_js_on_page(url, IMAGES_JS)
+
+@mcp.tool()
+async def check_forms(url: str):
+    return await _eval_js_on_page(url, FORMS_JS)
+
+@mcp.tool()
+async def check_aria(url: str):
+    return await _eval_js_on_page(url, ARIA_JS)
+
+@mcp.tool()
+async def check_keyboard(url: str):
+    return await _eval_js_on_page(url, KEYBOARD_JS)
+
+@mcp.tool()
+async def check_videos(url: str):
+    return await _eval_js_on_page(url, VIDEO_JS)
+
+@mcp.tool()
+async def check_contrast(url: str):
+    return await _eval_js_on_page(url, CONTRAST_JS)
+
+@mcp.tool()
+async def check_semantics(url: str):
+    return await _eval_js_on_page(url, SEMANTICS_JS)
+
+# Aggregator / Full audit
+@mcp.tool()
+async def full_audit(url: str, timeout: int = 60000):
+    """
+    Runs axe + all custom checks and returns a comprehensive report with suggested remediation hints.
+    Optimized to reuse a single browser session.
+    """
+    playwright = browser = context = page = None
+    results: Dict[str, Any] = {}
+    
+    try:
+        # Launch browser once
+        playwright, browser, context, page = await _open_page(url, timeout=timeout)
+        
+        # 1. Run Axe (needs injection)
+        try:
+            await _ensure_axe(page)
+            axe_result = await _run_axe(page, tags=["wcag2a", "wcag2aa"])
+            results["axe"] = {"url": url, "axe": axe_result}
+        except Exception as e:
+            results["axe"] = {"error": str(e)}
+
+        # 2. Run all custom JS checks sequentially on the SAME page
+        # This avoids spawning 10+ browser instances
+        check_definitions = {
+            "headings": HEADINGS_JS,
+            "language": LANG_JS,
+            "images": IMAGES_JS,
+            "forms": FORMS_JS,
+            "aria": ARIA_JS,
+            "keyboard": KEYBOARD_JS,
+            "videos": VIDEO_JS,
+            "contrast": CONTRAST_JS,
+            "semantics": SEMANTICS_JS
+        }
+
+        for key, js_code in check_definitions.items():
+            try:
+                res = await page.evaluate(js_code)
+                results[key] = {"url": url, "result": res}
+            except Exception as e:
+                results[key] = {"error": str(e)}
+
+    except Exception as e:
+        return {"url": url, "error": f"Fatal browser error: {str(e)}"}
+    finally:
+        if context:
+            await context.close()
+        if browser:
+            await browser.close()
+        if playwright:
+            await playwright.stop()
+
+    # Build summary: count axe violations of level 'serious' or 'critical' (if present), map to quick remediation hints
+    summary = {"url": url, "total_axe_violations": 0, "by_impact": {}, "quick_fixes": []}
+    try:
+        axe_out = results.get("axe", {}).get("axe") or results.get("axe", {}).get("result")
+        if axe_out and isinstance(axe_out, dict):
+            violations = axe_out.get("violations", [])
+            summary["total_axe_violations"] = len(violations)
+            by_impact = {}
+            for v in violations:
+                impact = v.get("impact", "unknown")
+                by_impact[impact] = by_impact.get(impact, 0) + 1
+                # add concise remediation hint
+                summary["quick_fixes"].append({
+                    "id": v.get("id"),
+                    "impact": impact,
+                    "help": v.get("help"),
+                    "nodes_sample": [n.get("html")[:200] for n in v.get("nodes", [])[:3]],
+                    "why": v.get("description")
+                })
+            summary["by_impact"] = by_impact
+    except Exception:
+        pass
+
+    # augment summary with simple counts from custom checks
+    try:
+        summary["missing_alt_count"] = len(results.get("images", {}).get("result", {}).get("missingAlt", [])) if results.get("images", {}).get("result") else None
+    except Exception:
+        summary["missing_alt_count"] = None
+    try:
+        summary["forms_missing_labels"] = len(results.get("forms", {}).get("result", {}).get("missing", [])) if results.get("forms", {}).get("result") else None
+    except Exception:
+        summary["forms_missing_labels"] = None
+    try:
+        summary["contrast_issues"] = len(results.get("contrast", {}).get("result", {}).get("issues", [])) if results.get("contrast", {}).get("result") else None
+    except Exception:
+        summary["contrast_issues"] = None
+
+    # Return combined report
+    return {"url": url, "summary": summary, "results": results}
+
+import sys
+
+# Run MCP server via stdio transport
+if __name__ == "__main__":
+    print("Starting Accessibility MCP server (stdio transport).", file=sys.stderr)
+    if not os.path.exists(AXE_JS_PATH):
+        print(f"WARNING: axe.min.js not found at {AXE_JS_PATH}. Download axe-core (axe.min.js) and place it beside this file or set AXE_JS_PATH.", file=sys.stderr)
+    mcp.run(transport="stdio")

src/accessibility_v1/notebook/accessibility.ipynb

@@ -0,0 +1,768 @@
+{
+ "cells": [
+  {
+   "cell_type": "code",
+   "execution_count": 2,
+   "id": "2dd4443a",
+   "metadata": {},
+   "outputs": [
+    {
+     "data": {
+      "text/plain": [
+       "True"
+      ]
+     },
+     "execution_count": 2,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
+   "source": [
+    "from dotenv import load_dotenv\n",
+    "from agents import Agent, Runner, trace\n",
+    "from agents.mcp import MCPServerStdio\n",
+    "import os\n",
+    "from IPython.display import display, Markdown\n",
+    "\n",
+    "load_dotenv(override=True)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 11,
+   "id": "76b37f4a",
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "\n",
+      "✅ Available MCP Tools:\n",
+      "- run_axe_audit: \n",
+      "    Run axe-core on the page and return the full axe result (violations, passes, incomplete, etc).\n",
+      "    This is the primary automated scanner and is required for broad WCAG coverage.\n",
+      "    \n",
+      "- check_headings: \n",
+      "- check_language: \n",
+      "- check_images: \n",
+      "- check_forms: \n",
+      "- check_aria: \n",
+      "- check_keyboard: \n",
+      "- check_videos: \n",
+      "- check_contrast: \n",
+      "- check_semantics: \n",
+      "- full_audit: \n",
+      "    Runs axe + all custom checks and returns a comprehensive report with suggested remediation hints.\n",
+      "    \n"
+     ]
+    },
+    {
+     "data": {
+      "text/plain": [
+       "[Tool(name='run_axe_audit', description='\\n    Run axe-core on the page and return the full axe result (violations, passes, incomplete, etc).\\n    This is the primary automated scanner and is required for broad WCAG coverage.\\n    ', inputSchema={'properties': {'url': {'title': 'Url', 'type': 'string'}, 'timeout': {'default': 30000, 'title': 'Timeout', 'type': 'integer'}}, 'required': ['url'], 'title': 'run_axe_auditArguments', 'type': 'object'}, annotations=None),\n",
+       " Tool(name='check_headings', description='', inputSchema={'properties': {'url': {'title': 'Url', 'type': 'string'}}, 'required': ['url'], 'title': 'check_headingsArguments', 'type': 'object'}, annotations=None),\n",
+       " Tool(name='check_language', description='', inputSchema={'properties': {'url': {'title': 'Url', 'type': 'string'}}, 'required': ['url'], 'title': 'check_languageArguments', 'type': 'object'}, annotations=None),\n",
+       " Tool(name='check_images', description='', inputSchema={'properties': {'url': {'title': 'Url', 'type': 'string'}}, 'required': ['url'], 'title': 'check_imagesArguments', 'type': 'object'}, annotations=None),\n",
+       " Tool(name='check_forms', description='', inputSchema={'properties': {'url': {'title': 'Url', 'type': 'string'}}, 'required': ['url'], 'title': 'check_formsArguments', 'type': 'object'}, annotations=None),\n",
+       " Tool(name='check_aria', description='', inputSchema={'properties': {'url': {'title': 'Url', 'type': 'string'}}, 'required': ['url'], 'title': 'check_ariaArguments', 'type': 'object'}, annotations=None),\n",
+       " Tool(name='check_keyboard', description='', inputSchema={'properties': {'url': {'title': 'Url', 'type': 'string'}}, 'required': ['url'], 'title': 'check_keyboardArguments', 'type': 'object'}, annotations=None),\n",
+       " Tool(name='check_videos', description='', inputSchema={'properties': {'url': {'title': 'Url', 'type': 'string'}}, 'required': ['url'], 'title': 'check_videosArguments', 'type': 'object'}, annotations=None),\n",
+       " Tool(name='check_contrast', description='', inputSchema={'properties': {'url': {'title': 'Url', 'type': 'string'}}, 'required': ['url'], 'title': 'check_contrastArguments', 'type': 'object'}, annotations=None),\n",
+       " Tool(name='check_semantics', description='', inputSchema={'properties': {'url': {'title': 'Url', 'type': 'string'}}, 'required': ['url'], 'title': 'check_semanticsArguments', 'type': 'object'}, annotations=None),\n",
+       " Tool(name='full_audit', description='\\n    Runs axe + all custom checks and returns a comprehensive report with suggested remediation hints.\\n    ', inputSchema={'properties': {'url': {'title': 'Url', 'type': 'string'}, 'timeout': {'default': 60000, 'title': 'Timeout', 'type': 'integer'}}, 'required': ['url'], 'title': 'full_auditArguments', 'type': 'object'}, annotations=None)]"
+      ]
+     },
+     "execution_count": 11,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
+   "source": [
+    "import os\n",
+    "import nest_asyncio\n",
+    "from agents.mcp import MCPServerStdio\n",
+    "\n",
+    "nest_asyncio.apply()\n",
+    "\n",
+    "async def list_tools():\n",
+    "    script_path = os.path.abspath(\"../mcp/server.py\")\n",
+    "    params = {\"command\": \"uv\", \"args\": [\"run\", script_path]}\n",
+    "\n",
+    "    async with MCPServerStdio(params=params, client_session_timeout_seconds=60) as server:\n",
+    "        tools = await server.list_tools()\n",
+    "\n",
+    "        print(\"\\n✅ Available MCP Tools:\")\n",
+    "        for t in tools:\n",
+    "            # Tool object → use attributes instead of dict access\n",
+    "            print(f\"- {t.name}: {t.description}\")\n",
+    "\n",
+    "        return tools\n",
+    "\n",
+    "await list_tools()\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 14,
+   "id": "0462c3cb",
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "🚀 Launching Accessibility MCP server at: /home/azureuser/ws/agenticai/projects/accessibility/mcp/server.py\n",
+      "✅ Connected to MCP server. Listing available tools...\n",
+      "🔧 11 tools loaded:\n",
+      "   - run_axe_audit: \n",
+      "    Run axe-core on the page and return the full axe result (violations, passes, incomplete, etc).\n",
+      "    This is the primary automated scanner and is required for broad WCAG coverage.\n",
+      "    \n",
+      "   - check_headings: \n",
+      "   - check_language: \n",
+      "   - check_images: \n",
+      "   - check_forms: \n",
+      "   - check_aria: \n",
+      "   - check_keyboard: \n",
+      "   - check_videos: \n",
+      "   - check_contrast: \n",
+      "   - check_semantics: \n",
+      "   - full_audit: \n",
+      "    Runs axe + all custom checks and returns a comprehensive report with suggested remediation hints.\n",
+      "    \n"
+     ]
+    },
+    {
+     "data": {
+      "text/markdown": [
+       "# Accessibility Audit Report for oauthapp.azurewebsites.net\n",
+       "\n",
+       "## Compliance Summary\n",
+       "- **WCAG 2.1 Level A and AA Violations:** 0 detected\n",
+       "- **Color Contrast Issues:** None found (all text passes AA contrast ratio criteria)\n",
+       "- **Missing Alt Attributes on Images:** None\n",
+       "- **Forms Without Labels:** None (no input forms detected)\n",
+       "- **ARIA Issues:** Some role=\"img\" SVG elements missing accessible names, and one duplicate id attribute.\n",
+       "- **Keyboard Accessibility:** No critical issues, 24 focusable elements with a logical tab order.\n",
+       "- **Headings:** Proper use of headings with a single H1 and logically structured H2s.\n",
+       "- **Language:** Valid lang attribute (`en`) specified on the HTML element.\n",
+       "- **Videos:** None present, so no caption requirements.\n",
+       "- **Landmarks:** Site makes use of landmarks: header, main, nav, footer, aside.\n",
+       "\n",
+       "## Detailed Findings\n",
+       "\n",
+       "### Positive Findings\n",
+       "- Document has meaningful and properly structured headings (1 H1, followed by H2s).\n",
+       "- All images have valid alt text, providing alternative descriptions.\n",
+       "- Color contrast ratios meet or exceed WCAG 2.1 AA standards (4.5:1 for normal text, 3:1 for large text).\n",
+       "- The document contains a valid `<title>` element for proper page identification.\n",
+       "- The document's `<html>` element includes a valid `lang=\"en\"` attribute.\n",
+       "- Navigation and structural landmarks (header, nav, main, footer, aside) are present for assistive technology.\n",
+       "- Keyboard focus order is logical and functional.\n",
+       "- No form inputs lacking labels (no input fields found).\n",
+       "- No use of deprecated or disallowed elements like `<blink>` or `<marquee>`.\n",
+       "- No meta-refresh or zoom disabling issues detected.\n",
+       "\n",
+       "### Accessibility Issues\n",
+       "\n",
+       "1. **SVG Elements with `role=\"img\"` Missing Accessible Names:**\n",
+       "   - Multiple Font Awesome SVG icons used as images have the `role=\"img\"` attribute but lack accessible names (`aria-label` or `<title>`).\n",
+       "   - This can be problematic for screen reader users because these images do not have descriptive alternative text.\n",
+       "   - Example elements affected include icons like plus, book, code-branch, key, sign-in-alt, unlock-alt, users, bars, etc.\n",
+       "\n",
+       "2. **Duplicate ID Attribute:**\n",
+       "   - The ID `docIcon` is present on multiple SVG elements, which violates the uniqueness requirement for IDs in HTML.\n",
+       "   - Duplicate IDs can cause issues in assistive technologies and scripting.\n",
+       "\n",
+       "3. **Missing Skip Link:**\n",
+       "   - No \"skip to content\" link was detected. While not required, it is a strong recommended practice to help keyboard and screen reader users bypass repetitive navigation.\n",
+       "\n",
+       "## Recommendations\n",
+       "\n",
+       "### Fix SVG Accessibility\n",
+       "\n",
+       "- Add accessible names to SVG icons with `role=\"img\"`.\n",
+       "- Methods:\n",
+       "  - Add a `<title>` element inside the SVG describing the icon (e.g., `<title>Expand</title>`).\n",
+       "  - Or add `aria-label=\"Description of icon\"` attribute directly on the SVG.\n",
+       "- Ensure that decorative SVGs use `aria-hidden=\"true\"` and no `role=\"img\"`, if they convey no meaningful content.\n",
+       "\n",
+       "### Fix Duplicate IDs\n",
+       "\n",
+       "- Rename one of the duplicated `docIcon` IDs to a unique ID to meet HTML specifications.\n",
+       "- Confirm all IDs on the page are unique.\n",
+       "\n",
+       "### Add a Skip Link\n",
+       "\n",
+       "- Add a visually hidden but keyboard-accessible \"Skip to main content\" link at the top of the page.\n",
+       "- Example:\n",
+       "  ```html\n",
+       "  <a href=\"#main-content\" class=\"skip-link\">Skip to main content</a>\n",
+       "  ```\n",
+       "- Ensure the main content container has an `id=\"main-content\"`.\n",
+       "\n",
+       "---\n",
+       "\n",
+       "## Overall Compliance Rating: **High**\n",
+       "\n",
+       "The page demonstrates strong compliance with WCAG 2.1 Level A and AA criteria. Only minor ARIA and duplicate ID issues were found, which are relatively simple to fix. Addressing these will further improve accessibility and screen reader experience.\n",
+       "\n",
+       "---\n",
+       "\n",
+       "If you want, I can provide sample code snippets or detailed instructions for the fixes."
+      ],
+      "text/plain": [
+       "<IPython.core.display.Markdown object>"
+      ]
+     },
+     "metadata": {},
+     "output_type": "display_data"
+    }
+   ],
+   "source": [
+    "import os\n",
+    "import nest_asyncio\n",
+    "import asyncio\n",
+    "from agents import Agent, Runner, trace\n",
+    "from agents.mcp import MCPServerStdio\n",
+    "from IPython.display import Markdown, display\n",
+    "\n",
+    "# Allow nested async in Jupyter\n",
+    "nest_asyncio.apply()\n",
+    "\n",
+    "async def run_agent():\n",
+    "    # ---------------------------------------------------------------------\n",
+    "    # Setup\n",
+    "    # ---------------------------------------------------------------------\n",
+    "    script_path = os.path.abspath(\"../mcp/server.py\")\n",
+    "    if not os.path.exists(script_path):\n",
+    "        raise FileNotFoundError(f\"MCP server script not found at: {script_path}\")\n",
+    "\n",
+    "    print(f\"🚀 Launching Accessibility MCP server at: {script_path}\")\n",
+    "\n",
+    "    params = {\"command\": \"uv\", \"args\": [\"run\", script_path]}\n",
+    "\n",
+    "    instructions = (\n",
+    "        \"You are an AI assistant specialized in ADA and WCAG 2.2 compliance. \"\n",
+    "        \"Your job is to evaluate webpages using the available MCP tools. \"\n",
+    "        \"Provide a compliance rating, identify accessibility issues, \"\n",
+    "        \"and suggest detailed fixes in Markdown format.\"\n",
+    "    )\n",
+    "\n",
+    "    request = \"Audit oauthapp.azurewebsites.net for ADA and WCAG compliance and summarize findings in Markdown.\"\n",
+    "\n",
+    "    model = \"gpt-4.1-mini\"\n",
+    "\n",
+    "    # ---------------------------------------------------------------------\n",
+    "    # Run the agent with MCP server\n",
+    "    # ---------------------------------------------------------------------\n",
+    "    try:\n",
+    "        async with MCPServerStdio(params=params, client_session_timeout_seconds=90) as accessibility_server:\n",
+    "            print(\"✅ Connected to MCP server. Listing available tools...\")\n",
+    "            tools = await accessibility_server.list_tools()\n",
+    "            print(f\"🔧 {len(tools)} tools loaded:\")\n",
+    "            for tool in tools:\n",
+    "                print(f\"   - {tool.name}: {tool.description}\")\n",
+    "\n",
+    "            agent = Agent(\n",
+    "                name=\"accessibility_agent\",\n",
+    "                instructions=instructions,\n",
+    "                model=model,\n",
+    "                mcp_servers=[accessibility_server],\n",
+    "            )\n",
+    "\n",
+    "            with trace(\"accessibility_agent\"):\n",
+    "                result = await Runner.run(agent, request)\n",
+    "\n",
+    "            # -----------------------------------------------------------------\n",
+    "            # Display or fallback if model output is empty\n",
+    "            # -----------------------------------------------------------------\n",
+    "            if not result or not result.final_output:\n",
+    "                display(Markdown(\"⚠️ **No audit results returned.** Please check the MCP server logs.\"))\n",
+    "            else:\n",
+    "                display(Markdown(result.final_output))\n",
+    "\n",
+    "    except asyncio.TimeoutError:\n",
+    "        print(\"⏱️ MCP server timed out. Try increasing `client_session_timeout_seconds`.\")\n",
+    "    except Exception as e:\n",
+    "        print(f\"❌ Unexpected error: {e}\")\n",
+    "\n",
+    "# Run inside notebook\n",
+    "await run_agent()\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 18,
+   "id": "33a8d58c",
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "🚀 Launching Accessibility MCP server at: /home/azureuser/ws/agenticai/projects/accessibility/mcp/server.py\n",
+      "✅ Connected to MCP server.\n",
+      "🔧 Pages to audit: 5\n",
+      "📄 Auditing: https://oauthapp.azurewebsites.net/\n"
+     ]
+    },
+    {
+     "data": {
+      "text/markdown": [
+       "### Audit for https://oauthapp.azurewebsites.net/"
+      ],
+      "text/plain": [
+       "<IPython.core.display.Markdown object>"
+      ]
+     },
+     "metadata": {},
+     "output_type": "display_data"
+    },
+    {
+     "data": {
+      "text/markdown": [
+       "# Accessibility Audit Report for https://oauthapp.azurewebsites.net/\n",
+       "\n",
+       "| Level | Rule                          | Pass/Fail | Reason                                                                                      | Recommendation                                                                                       |\n",
+       "|-------|-------------------------------|-----------|---------------------------------------------------------------------------------------------|----------------------------------------------------------------------------------------------------|\n",
+       "| A     | html-has-lang                 | Pass      | The `<html>` element has a lang attribute set to \"en\".                                      | No action needed.                                                                                   |\n",
+       "| A     | valid-lang                   | Pass      | The lang attribute has a valid value \"en\".                                                 | No action needed.                                                                                   |\n",
+       "| A     | document-title               | Pass      | The document contains a non-empty `<title>` element.                                       | No action needed.                                                                                   |\n",
+       "| A     | image-alt                    | Pass      | All images have alternate text provided.                                                   | No action needed.                                                                                   |\n",
+       "| A     | label                       | Pass      | No form inputs requiring labels found.                                                     | No action needed.                                                                                   |\n",
+       "| A     | link-name                   | Pass      | All links have discernible text.                                                           | No action needed.                                                                                   |\n",
+       "| A     | button-name                 | Pass      | All buttons have discernible text.                                                         | No action needed.                                                                                   |\n",
+       "| A     | aria-hidden-body            | Pass      | No `aria-hidden=\"true\"` on the `<body>`.                                                   | No action needed.                                                                                   |\n",
+       "| A     | aria-hidden-focus           | Pass      | ARIA hidden elements are not focusable and contain no focusable children.                   | No action needed.                                                                                   |\n",
+       "| AA    | color-contrast              | Pass      | Contrast ratios meet or exceed WCAG 2 AA minimum threshold.                                | No action needed.                                                                                   |\n",
+       "| A     | headings                   | Pass      | The page has a single `<h1>` and properly structured `<h2>` headings, no order problems.    | No action needed.                                                                                   |\n",
+       "| A     | keyboard                   | Pass      | All interactive elements are focusable and tabbable in a logical order.                     | No action needed.                                                                                   |\n",
+       "| A     | list                      | Pass      | Lists are correctly structured with only allowed immediate children.                        | No action needed.                                                                                   |\n",
+       "| A     | listitem                   | Pass      | All `<li>` elements are contained inside `<ul>` or `<ol>`.                                 | No action needed.                                                                                   |\n",
+       "| A     | meta-viewport              | Pass      | Meta viewport tag does not disable zooming/scaling.                                        | No action needed.                                                                                   |\n",
+       "| A     | nested-interactive          | Pass      | There are no nested interactive controls.                                                  | No action needed.                                                                                   |\n",
+       "| A     | scrollable-region-focusable | Pass      | Scrollable regions have keyboard access.                                                   | No action needed.                                                                                   |\n",
+       "| A     | semantics                  | Pass      | Page uses landmarks such as header, main, nav, footer, aside correctly.                     | Consider adding a \"Skip to content\" link for improved navigation by keyboard/screen reader users.   |\n",
+       "\n",
+       "| Level | Rule                          | Pass/Fail | Reason                                                                                      | Recommendation                                                                                       |\n",
+       "|-------|-------------------------------|-----------|---------------------------------------------------------------------------------------------|----------------------------------------------------------------------------------------------------|\n",
+       "| A     | aria-role-img-alt              | Fail      | Multiple `<svg>` elements with role=\"img\" lack accessible names.                           | Provide accessible names using `aria-label` or `aria-labelledby` for all SVG images with `role=\"img\"`.|\n",
+       "\n",
+       "| Level | Rule                          | Pass/Fail | Reason                                                                                      | Recommendation                                                                                       |\n",
+       "|-------|-------------------------------|-----------|---------------------------------------------------------------------------------------------|----------------------------------------------------------------------------------------------------|\n",
+       "| A     | duplicate-id                  | Fail      | The ID \"docIcon\" is used more than once in the DOM.                                        | Ensure all ID attributes are unique in the document to avoid conflicts during navigation and assistive technology usage.|\n",
+       "\n",
+       "| Level | Rule                          | Pass/Fail | Reason                                                                                      | Recommendation                                                                                       |\n",
+       "|-------|-------------------------------|-----------|---------------------------------------------------------------------------------------------|----------------------------------------------------------------------------------------------------|\n",
+       "| A     | has-skip-link                 | Fail      | The page does not contain any mechanism to skip repetitive content (such as a \"Skip to content\" link). | Add a \"Skip to content\" link as an immediate child of the body for keyboard users to bypass navigation.|\n",
+       "\n",
+       "---\n",
+       "\n",
+       "### Summary:\n",
+       "- The site meets many core WCAG 2.1 Level A and AA accessibility requirements including language declaration, image alt text, headings structure, contrast, keyboard accessibility, and ARIA usage in most areas.\n",
+       "- Major issues to address:\n",
+       "  - Provide accessible names for decorative or functional SVG images flagged with role=\"img\".\n",
+       "  - Ensure all ID attributes are unique, fixing duplicate ID \"docIcon\".\n",
+       "  - Add a skip link to improve keyboard navigation for screen reader users.\n",
+       "\n",
+       "Addressing these will improve the site's accessibility and compliance with WCAG 2.1 A and AA standards."
+      ],
+      "text/plain": [
+       "<IPython.core.display.Markdown object>"
+      ]
+     },
+     "metadata": {},
+     "output_type": "display_data"
+    },
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "📄 Auditing: https://oauthapp.azurewebsites.net/code\n"
+     ]
+    },
+    {
+     "data": {
+      "text/markdown": [
+       "### Audit for https://oauthapp.azurewebsites.net/code"
+      ],
+      "text/plain": [
+       "<IPython.core.display.Markdown object>"
+      ]
+     },
+     "metadata": {},
+     "output_type": "display_data"
+    },
+    {
+     "data": {
+      "text/markdown": [
+       "# ADA/WCAG 2.2 Compliance Audit Report for https://oauthapp.azurewebsites.net/code\n",
+       "\n",
+       "| Level | Rule                                      | Pass/Fail | Reason                                                                                                                      | Recommendation                                                                                             |\n",
+       "|-------|-------------------------------------------|-----------|-----------------------------------------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------------------|\n",
+       "| A     | Document has lang attribute                | Pass      | The `<html>` element has a valid `lang=\"en\"` attribute.                                                                      | None                                                                                                      |\n",
+       "| A     | Document has a non-empty title             | Pass      | Document contains a non-empty `<title>` element.                                                                             | None                                                                                                      |\n",
+       "| A     | Proper use of headings hierarchy           | Fail      | No `<h1>` heading present; page starts with `<h2>` and has subsequents `<h3>` headings.                                       | Include one `<h1>` heading for the main page title to improve document structure and navigation.           |\n",
+       "| A     | Images have alternative text                | Pass      | All images have meaningful alt attributes.                                                                                   | None                                                                                                      |\n",
+       "| A     | ARIA role and attributes valid             | Fail      | Multiple `<svg>` elements with role=\"img\" are missing accessible names. Also, there is a duplicate `id=\"docIcon\"`.           | Provide accessible names or aria-labels for decorative SVG elements or mark them as aria-hidden if purely decorative. Ensure all IDs are unique. |\n",
+       "| A     | Lists are structured correctly              | Fail      | The ordered list (`<ol>`) contains direct children that are `<pre>` elements, which is invalid.                              | Replace invalid direct children with `<li>` and wrap any code blocks inside proper `<li>` elements.       |\n",
+       "| AA    | Contrast ratio between text and background | Pass      | All checked elements meet the minimum WCAG 2.1 AA contrast ratio.                                                            | None                                                                                                      |\n",
+       "| AA    | Keyboard focus and tab order                | Pass      | Keyboard focusable elements exist and follow a proper tab order.                                                             | None                                                                                                      |\n",
+       "| AA    | Landmark regions and semantic tags          | Pass      | The page includes landmarks such as `<header>`, `<main>`, `<nav>`, `<footer>`, and `<aside>`.                                  | None                                                                                                      |\n",
+       "| AA    | Mechanism to bypass blocks of content       | Fail      | No skip link or similar method to bypass repeated navigation elements found.                                                  | Add a \"Skip to main content\" link or equivalent to facilitate keyboard and screen reader users.            |\n",
+       "\n",
+       "---\n",
+       "\n",
+       "## Summary and Recommendations\n",
+       "\n",
+       "- The page is mostly compliant with WCAG 2.2 Level A and AA in many areas including language, alternative text for images, color contrast, keyboard accessibility, and semantic landmarks.\n",
+       "- Improvements are needed for proper heading structure by adding a main heading `<h1>`.\n",
+       "- ARIA usage should be reviewed to ensure all elements with roles have accessible names, especially decorative SVG icons, and to fix duplicate IDs.\n",
+       "- List structures should be corrected by ensuring that only `<li>` elements are direct children of `<ul>` or `<ol>`. Any other elements such as `<pre>` should be nested inside `<li>`.\n",
+       "- The site should include a mechanism (e.g., skip navigation link) to allow users to bypass repeated blocks, enhancing keyboard and screen reader navigation.\n",
+       "\n",
+       "Addressing these issues will enhance accessibility and compliance with WCAG 2.2 guidelines."
+      ],
+      "text/plain": [
+       "<IPython.core.display.Markdown object>"
+      ]
+     },
+     "metadata": {},
+     "output_type": "display_data"
+    },
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "📄 Auditing: https://oauthapp.azurewebsites.net/credential\n"
+     ]
+    },
+    {
+     "data": {
+      "text/markdown": [
+       "### Audit for https://oauthapp.azurewebsites.net/credential"
+      ],
+      "text/plain": [
+       "<IPython.core.display.Markdown object>"
+      ]
+     },
+     "metadata": {},
+     "output_type": "display_data"
+    },
+    {
+     "data": {
+      "text/markdown": [
+       "# ADA/WCAG 2.2 Compliance Audit Report for https://oauthapp.azurewebsites.net/credential\n",
+       "\n",
+       "| Level | Rule                                  | Pass/Fail | Reason                                                                                                      | Recommendation                                                                                     |\n",
+       "|-------|--------------------------------------|-----------|-------------------------------------------------------------------------------------------------------------|--------------------------------------------------------------------------------------------------|\n",
+       "| A     | HTML document has a lang attribute   | Pass      | The `<html>` element includes a valid `lang=\"en\"` attribute.                                                | No action needed.                                                                                 |\n",
+       "| A     | Document has a non-empty title       | Pass      | The document contains a non-empty `<title>` element.                                                       | No action needed.                                                                                 |\n",
+       "| A     | Lists are structured correctly       | Fail      | An ordered list (`<ol>`) contains invalid direct children (`<pre>` element) instead of only `<li>` elements.  | Fix lists to contain only permitted elements directly under `<ul>` or `<ol>`, i.e., `<li>`.      |\n",
+       "| A     | All `<img>` elements have alt text   | Pass      | All images have valid non-empty alt attributes.                                                            | No action needed.                                                                                 |\n",
+       "| A     | No form fields missing labels        | Pass      | No input fields in forms or visible labels missing.                                                        | No action needed.                                                                                 |\n",
+       "| A     | ARIA roles and attributes valid      | Fail      | Multiple SVG icons with role=\"img\" are missing accessible names; duplicate ID \"docIcon\" found twice.       | Add accessible names to SVG icons via `aria-label` or `title`, and ensure unique IDs.            |\n",
+       "| A     | Keyboard focus and tab order usable  | Pass      | Keyboard focusable elements exist, and tab order appears logical without positive tabindex issues.          | No action needed.                                                                                 |\n",
+       "| AA    | Color contrast ratio compliance      | Pass      | All text and UI components meet minimum contrast ratios (4.5:1 for normal text).                            | No action needed.                                                                                 |\n",
+       "| AA    | Landmarks and page structure         | Pass      | Page uses multiple landmark elements including header, main, nav, footer, and aside.                        | Add a \"Skip to content\" link for improved accessibility and easier navigation for keyboard users.|\n",
+       "| AAA   | No videos requiring captions         | Pass      | No videos present on the page to analyze captioning.                                                       | No action needed.                                                                                 |\n",
+       "| AA    | Headings hierarchy                   | Pass      | Headings levels are used properly; no H1 but appropriate use of H2 and H3 found.                            | Consider adding an H1 heading for better semantic structure.                                    |\n",
+       "\n",
+       "## Summary:\n",
+       "- The page mostly meets WCAG 2.1 Level A and AA requirements.\n",
+       "- There is one serious violation related to list semantics: an `<ol>` contains a non-permitted direct child (`<pre>` element). This must be corrected.\n",
+       "- ARIA issues include multiple SVG images with role=\"img\" missing accessible names and duplicate ID usage, posing accessibility problems for screen reader users. These should be addressed by adding accessible names and ensuring IDs are unique.\n",
+       "- The page lacks a skip link to allow keyboard users to bypass repetitive navigation.\n",
+       "- No contrast issues were detected.\n",
+       "- Headings structure is fair but lacks an H1.\n",
+       "\n",
+       "---\n",
+       "\n",
+       "### Recommendations Summary:\n",
+       "- Correct list structure by ensuring `<ul>` and `<ol>` contain only `<li>`, `<script>`, or `<template>` as direct children.\n",
+       "- Provide accessible names (via `aria-label` or `<title>`) for all SVG icons that have `role=\"img\"`.\n",
+       "- Remove duplicate element IDs (e.g., \"docIcon\") so all IDs are unique.\n",
+       "- Add a visible \"Skip to content\" link at the top of the page.\n",
+       "- Consider introducing an H1 heading to improve document outline.\n",
+       "\n",
+       "This will improve the page's accessibility for users with disabilities and align it more closely with WCAG 2.2 guidelines."
+      ],
+      "text/plain": [
+       "<IPython.core.display.Markdown object>"
+      ]
+     },
+     "metadata": {},
+     "output_type": "display_data"
+    },
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "📄 Auditing: https://oauthapp.azurewebsites.net/implicit\n"
+     ]
+    },
+    {
+     "data": {
+      "text/markdown": [
+       "### Audit for https://oauthapp.azurewebsites.net/implicit"
+      ],
+      "text/plain": [
+       "<IPython.core.display.Markdown object>"
+      ]
+     },
+     "metadata": {},
+     "output_type": "display_data"
+    },
+    {
+     "data": {
+      "text/markdown": [
+       "# ADA/WCAG 2.2 Compliance Audit Report for https://oauthapp.azurewebsites.net/implicit\n",
+       "\n",
+       "| Level | Rule                                | Pass/Fail | Reason                                                                                      | Recommendation                                                                                           |\n",
+       "|-------|-----------------------------------|-----------|---------------------------------------------------------------------------------------------|--------------------------------------------------------------------------------------------------------|\n",
+       "| A     | HTML lang attribute (WCAG 3.1.1) | Pass      | The `<html>` element has a valid `lang=\"en\"` attribute.                                     | None                                                                                                   |\n",
+       "| A     | Document Title (WCAG 2.4.2)        | Pass      | The document contains a non-empty `<title>` element.                                        | None                                                                                                   |\n",
+       "| A     | Image alternative text (WCAG 1.1.1) | Pass      | All images have appropriate alt attributes.                                                | None                                                                                                   |\n",
+       "| A     | Keyboard navigation (WCAG 2.1.1)  | Pass      | Page elements are keyboard focusable with logical tab order.                               | None                                                                                                   |\n",
+       "| A     | List semantics (WCAG 1.3.1)       | Fail      | A `<ol>` list contains direct children `<pre>` which is invalid (only `<li>`, `<script>`, or `<template>` allowed). | Correct the list structure to ensure only `<li>`, `<script>`, or `<template>` tags are direct children of lists. |\n",
+       "| A     | ARIA role img missing accessible name (WCAG 4.1.2) | Fail      | Multiple `<svg>` elements with role `img` are missing accessible names.                     | Provide accessible names (using `aria-label` or `aria-labelledby`) for all `<svg>` elements with `img` role. |\n",
+       "| AA    | Color contrast (WCAG 1.4.3)       | Pass      | All text and interactive element color contrasts meet minimum 4.5:1 or 3:1 ratio as appropriate. | None                                                                                                   |\n",
+       "| AA    | Semantic landmarks (WCAG 1.3.1)   | Pass      | Page includes landmarks like `header`, `main`, `nav`, `footer`, and `aside`.                | Add a skip link mechanism for bypassing navigation to main content to improve accessibility.           |\n",
+       "| AA    | Headings structure (WCAG 2.4.6)   | Pass      | Headings have good structure; no H1 is present but no order problems detected.               | Consider adding a main `<h1>` heading for page structure clarity.                                      |\n",
+       "\n",
+       "## Summary\n",
+       "- The page mostly complies with core WCAG 2.1 A and AA criteria including language declaration, color contrast, keyboard navigation, and form labeling.\n",
+       "- There is a structural accessibility failure regarding list markup — lists contain disallowed direct children.\n",
+       "- There are multiple SVG graphics missing accessible names which could impact screen reader users.\n",
+       "- No issues found with color contrast or keyboard accessibility.\n",
+       "- Semantic landmarks are present but page lacks a skip link so users must tab through navigation repeatedly.\n",
+       "\n",
+       "## Recommendations\n",
+       "1. Fix list markup so that lists only contain directly `<li>`, `<script>`, or `<template>` elements.\n",
+       "2. Add accessible names to all SVG elements with `role=\"img\"` to ensure screen readers announce meaningful labels.\n",
+       "3. Add a skip navigation link to allow keyboard and screen reader users to bypass repetitive content.\n",
+       "4. Consider adding an `<h1>` for main page title to better support assistive technology users.\n",
+       "\n",
+       "This report is based on automated scanning combined with structural analysis as of system date. Manual testing is recommended for comprehensive compliance assurance."
+      ],
+      "text/plain": [
+       "<IPython.core.display.Markdown object>"
+      ]
+     },
+     "metadata": {},
+     "output_type": "display_data"
+    },
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "📄 Auditing: https://oauthapp.azurewebsites.net/password\n"
+     ]
+    },
+    {
+     "data": {
+      "text/markdown": [
+       "### Audit for https://oauthapp.azurewebsites.net/password"
+      ],
+      "text/plain": [
+       "<IPython.core.display.Markdown object>"
+      ]
+     },
+     "metadata": {},
+     "output_type": "display_data"
+    },
+    {
+     "data": {
+      "text/markdown": [
+       "# ADA/WCAG Compliance Audit Report for https://oauthapp.azurewebsites.net/password\n",
+       "\n",
+       "| Level | Rule                              | Pass/Fail | Reason                                                                                          | Recommendation                                                                                       |\n",
+       "|-------|-----------------------------------|-----------|------------------------------------------------------------------------------------------------|----------------------------------------------------------------------------------------------------|\n",
+       "| A     | list                              | Fail      | An ordered list (<ol>) contains a <pre> element as a direct child, which is not allowed.       | Ensure <ul> and <ol> elements only contain <li>, <script>, or <template> elements as direct children.|\n",
+       "| A     | role-img-alt                     | Fail      | Multiple <svg> icons with role=\"img\" are missing accessible names (alt text equivalent).       | Provide accessible names for all <svg> elements with role=\"img\", e.g., aria-label or <title> element.|\n",
+       "| A     | duplicate-id                    | Fail      | Duplicate ID \"docIcon\" found on multiple elements.                                            | Ensure all id attributes are unique on the page.                                                  |\n",
+       "| A     | html-has-lang                  | Pass      | The <html> element has a valid lang attribute set to \"en\".                                    | None needed.                                                                                    |\n",
+       "| A     | image-alt                      | Pass      | All <img> elements have alt attributes with valid values.                                     | None needed.                                                                                    |\n",
+       "| A     | forms-label                   | Pass      | No forms or form fields present that are missing labels.                                      | None needed.                                                                                    |\n",
+       "| A     | button-name                   | Pass      | Buttons have discernible text or accessible names.                                            | None needed.                                                                                    |\n",
+       "| AA    | color-contrast                | Pass      | Text and UI components meet the minimum contrast ratio required by WCAG 2.1 AA.                | None needed.                                                                                    |\n",
+       "| A     | keyboard                      | Pass      | Keyboard navigation works; all interactive elements are focusable in correct order.           | None needed.                                                                                    |\n",
+       "| A     | headings                      | Pass      | Proper heading structure is present with no order problems, but no <h1> found.               | Recommend adding a single <h1> heading for improved semantic structure and accessibility.       |\n",
+       "| A     | semantics-landmarks           | Pass      | Page contains multiple landmark elements like header, main, nav, and footer.                  | Consider adding a \"skip to content\" link to facilitate bypassing repetitive navigation.          |\n",
+       "| AA    | meta-viewport                | Pass      | Meta viewport tag correctly configured without disabling zoom.                                | None needed.                                                                                    |\n",
+       "\n",
+       "## Summary\n",
+       "The page is mostly compliant with fundamental WCAG 2.1 A and AA requirements but has several accessibility issues that must be addressed:\n",
+       "\n",
+       "- The key violation is improper list structure where a <pre> element exists directly inside an <ol>. This breaks semantic list requirement.\n",
+       "- Numerous SVG icons lack accessible names which impacts screen reader users.\n",
+       "- Duplicate IDs on the page violate unique ID constraints, which can cause accessibility and scripting issues.\n",
+       "- The page misses a primary <h1> heading which is recommended for semantic clarity and accessibility.\n",
+       "- Adding a skip link is recommended to allow keyboard users to bypass navigation easily.\n",
+       "\n",
+       "Addressing these issues will enhance accessibility for users relying on assistive technologies and keyboard navigation.\n",
+       "\n",
+       "---\n",
+       "\n",
+       "For detailed guidance, refer to the WCAG 2.2 checklist and [Deque University Axe rules](https://dequeuniversity.com/rules/axe/4.8/)."
+      ],
+      "text/plain": [
+       "<IPython.core.display.Markdown object>"
+      ]
+     },
+     "metadata": {},
+     "output_type": "display_data"
+    },
+    {
+     "name": "stderr",
+     "output_type": "stream",
+     "text": [
+      "Error getting response: Connection error.. (request_id: None)\n"
+     ]
+    },
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "❌ Unexpected error: Connection error.\n"
+     ]
+    }
+   ],
+   "source": [
+    "import os\n",
+    "import nest_asyncio\n",
+    "import asyncio\n",
+    "from datetime import datetime\n",
+    "from agents import Agent, Runner, trace\n",
+    "from agents.mcp import MCPServerStdio\n",
+    "from IPython.display import Markdown, display, HTML\n",
+    "\n",
+    "nest_asyncio.apply()\n",
+    "\n",
+    "async def run_site_accessibility_dashboard(base_url: str):\n",
+    "    # ------------------- Setup MCP Server -------------------\n",
+    "    script_path = os.path.abspath(\"../mcp/server.py\")\n",
+    "    if not os.path.exists(script_path):\n",
+    "        raise FileNotFoundError(f\"MCP server script not found at: {script_path}\")\n",
+    "\n",
+    "    print(f\"🚀 Launching Accessibility MCP server at: {script_path}\")\n",
+    "    params = {\"command\": \"uv\", \"args\": [\"run\", script_path]}\n",
+    "    model = \"gpt-4.1-mini\"\n",
+    "\n",
+    "    try:\n",
+    "        async with MCPServerStdio(params=params, client_session_timeout_seconds=120) as accessibility_server:\n",
+    "            print(\"✅ Connected to MCP server.\")\n",
+    "\n",
+    "            # ------------------- Fetch sitemap -------------------\n",
+    "            import aiohttp\n",
+    "            from xml.etree import ElementTree as ET\n",
+    "            urls_to_audit = [base_url]\n",
+    "            sitemap_url = base_url.rstrip(\"/\") + \"/sitemap.xml\"\n",
+    "            try:\n",
+    "                async with aiohttp.ClientSession() as session:\n",
+    "                    async with session.get(sitemap_url) as resp:\n",
+    "                        if resp.status == 200:\n",
+    "                            xml_text = await resp.text()\n",
+    "                            root = ET.fromstring(xml_text)\n",
+    "                            urls_to_audit = [elem.text for elem in root.findall(\".//{*}loc\")]\n",
+    "            except Exception as e:\n",
+    "                print(f\"⚠️ Sitemap fetch error: {e}\")\n",
+    "            \n",
+    "            print(f\"🔧 Pages to audit: {len(urls_to_audit)}\")\n",
+    "\n",
+    "            # ------------------- Run Accessibility Audit per Page -------------------\n",
+    "            audit_results = {}\n",
+    "            audit_instructions = (\n",
+    "                \"You are an AI assistant specialized in ADA/WCAG 2.2 compliance. \"\n",
+    "                \"Audit a webpage and produce a Markdown report including all rules (Pass/Fail) \"\n",
+    "                \"with columns: Level (A, AA, AAA), Rule, Pass/Fail, Reason, Recommendation.\"\n",
+    "            )\n",
+    "\n",
+    "            for url in urls_to_audit:\n",
+    "                print(f\"📄 Auditing: {url}\")\n",
+    "                audit_agent = Agent(\n",
+    "                    name=\"accessibility_agent\",\n",
+    "                    instructions=audit_instructions,\n",
+    "                    model=model,\n",
+    "                    mcp_servers=[accessibility_server],\n",
+    "                )\n",
+    "                with trace(f\"audit_{url}\"):\n",
+    "                    result = await Runner.run(audit_agent, f\"Audit {url} for ADA/WCAG compliance.\")\n",
+    "                markdown_output = result.final_output if result and result.final_output else f\"⚠️ No results for {url}\"\n",
+    "                audit_results[url] = markdown_output\n",
+    "                display(Markdown(f\"### Audit for {url}\"))\n",
+    "                display(Markdown(markdown_output))\n",
+    "\n",
+    "            # ------------------- HTML Dashboard -------------------\n",
+    "            html_instructions = (\n",
+    "                \"You are an AI assistant that converts multiple Markdown accessibility audit reports \"\n",
+    "                \"into a single responsive HTML dashboard. \"\n",
+    "                \"Requirements: \\n\"\n",
+    "                \"- Hero banner with site name\\n\"\n",
+    "                \"- Filters: All / Passed / Failed / Warnings\\n\"\n",
+    "                \"- Clicking a filter updates the table dynamically\\n\"\n",
+    "                \"- Table columns: Level, Rule, Pass/Fail, Reason, Recommendation\\n\"\n",
+    "                \"- TailwindCSS styling\\n\"\n",
+    "                \"- Include a summary row with total Pass/Fail counts per page\"\n",
+    "            )\n",
+    "\n",
+    "            html_agent = Agent(\n",
+    "                name=\"html_dashboard_agent\",\n",
+    "                instructions=html_instructions,\n",
+    "                model=model\n",
+    "            )\n",
+    "\n",
+    "            html_request = \"Generate a site-wide accessibility dashboard from the following Markdown reports:\\n\\n\"\n",
+    "            for url, md in audit_results.items():\n",
+    "                html_request += f\"Page: {url}\\n{md}\\n\\n\"\n",
+    "\n",
+    "            with trace(\"html_dashboard_agent\"):\n",
+    "                html_result = await Runner.run(html_agent, html_request)\n",
+    "\n",
+    "            html_output = html_result.final_output if html_result and html_result.final_output else \"<p>⚠️ HTML dashboard generation failed.</p>\"\n",
+    "            display(HTML(html_output))\n",
+    "\n",
+    "            # ------------------- Save HTML -------------------\n",
+    "            output_dir = os.path.abspath(\"output\")\n",
+    "            os.makedirs(output_dir, exist_ok=True)\n",
+    "            timestamp = datetime.now().strftime(\"%Y%m%d_%H%M%S\")\n",
+    "            output_file = os.path.join(output_dir, f\"accessibility_dashboard_{timestamp}.html\")\n",
+    "            with open(output_file, \"w\", encoding=\"utf-8\") as f:\n",
+    "                f.write(html_output)\n",
+    "\n",
+    "            print(f\"✅ Site-wide HTML dashboard saved to: {output_file}\")\n",
+    "\n",
+    "    except asyncio.TimeoutError:\n",
+    "        print(\"⏱️ MCP server timed out. Increase `client_session_timeout_seconds` if needed.\")\n",
+    "    except Exception as e:\n",
+    "        print(f\"❌ Unexpected error: {e}\")\n",
+    "\n",
+    "# Run dashboard\n",
+    "await run_site_accessibility_dashboard(\"https://oauthapp.azurewebsites.net\")\n"
+   ]
+  }
+ ],
+ "metadata": {
+  "kernelspec": {
+   "display_name": "agents",
+   "language": "python",
+   "name": "python3"
+  },
+  "language_info": {
+   "codemirror_mode": {
+    "name": "ipython",
+    "version": 3
+   },
+   "file_extension": ".py",
+   "mimetype": "text/x-python",
+   "name": "python",
+   "nbconvert_exporter": "python",
+   "pygments_lexer": "ipython3",
+   "version": "3.12.11"
+  }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 5
+}

src/accessibility_v1/notebook/output/accessibility_audit_20251112_061159.html

@@ -0,0 +1,252 @@
+```html
+<table style="width:100%; border-collapse: collapse; font-family: Arial, sans-serif;">
+  <thead>
+    <tr style="background:#333; color:#fff; text-align:left;">
+      <th style="padding:8px; border: 1px solid #ddd;">Level</th>
+      <th style="padding:8px; border: 1px solid #ddd;">Rule</th>
+      <th style="padding:8px; border: 1px solid #ddd;">Pass/Fail</th>
+    </tr>
+  </thead>
+  <tbody>
+    <!-- Pass rows -->
+    <details style="border:1px solid #ddd; margin-bottom:4px; border-radius:4px;" open>
+      <summary style="padding:8px; cursor:pointer; background:#d4edda; border-radius:4px; font-weight:bold;">
+        <span style="margin-right:16px;">A</span> 
+        <span style="margin-right:16px;">document-title</span> 
+        <span style="color:#155724; font-weight:bold;">Pass</span>
+      </summary>
+      <tr style="display:none;">
+        <td colspan="3" style="padding:8px; border: 1px solid #ddd; background:#f9fff9;">
+          <strong>Reason:</strong> Page contains a non-empty <code>&lt;title&gt;</code> element<br>
+          <strong>Recommendation:</strong> None
+        </td>
+      </tr>
+    </details>
+
+    <details style="border:1px solid #ddd; margin-bottom:4px; border-radius:4px;" open>
+      <summary style="padding:8px; cursor:pointer; background:#d4edda; border-radius:4px; font-weight:bold;">
+        <span style="margin-right:16px;">A</span> 
+        <span style="margin-right:16px;">html-has-lang</span> 
+        <span style="color:#155724; font-weight:bold;">Pass</span>
+      </summary>
+      <tr style="display:none;">
+        <td colspan="3" style="padding:8px; border: 1px solid #ddd; background:#f9fff9;">
+          <strong>Reason:</strong> <code>&lt;html&gt;</code> element has a valid <code>lang</code> attribute with value <code>en</code><br>
+          <strong>Recommendation:</strong> None
+        </td>
+      </tr>
+    </details>
+
+    <details style="border:1px solid #ddd; margin-bottom:4px; border-radius:4px;" open>
+      <summary style="padding:8px; cursor:pointer; background:#d4edda; border-radius:4px; font-weight:bold;">
+        <span style="margin-right:16px;">AA</span> 
+        <span style="margin-right:16px;">color-contrast</span> 
+        <span style="color:#155724; font-weight:bold;">Pass</span>
+      </summary>
+      <tr style="display:none;">
+        <td colspan="3" style="padding:8px; border: 1px solid #ddd; background:#f9fff9;">
+          <strong>Reason:</strong> Text and background colors have sufficient contrast exceeding WCAG 2 AA minimum thresholds<br>
+          <strong>Recommendation:</strong> None
+        </td>
+      </tr>
+    </details>
+
+    <details style="border:1px solid #ddd; margin-bottom:4px; border-radius:4px;" open>
+      <summary style="padding:8px; cursor:pointer; background:#d4edda; border-radius:4px; font-weight:bold;">
+        <span style="margin-right:16px;">A</span> 
+        <span style="margin-right:16px;">image-alt</span> 
+        <span style="color:#155724; font-weight:bold;">Pass</span>
+      </summary>
+      <tr style="display:none;">
+        <td colspan="3" style="padding:8px; border: 1px solid #ddd; background:#f9fff9;">
+          <strong>Reason:</strong> All 6 images have descriptive alternative text<br>
+          <strong>Recommendation:</strong> None
+        </td>
+      </tr>
+    </details>
+
+    <details style="border:1px solid #ddd; margin-bottom:4px; border-radius:4px;" open>
+      <summary style="padding:8px; cursor:pointer; background:#d4edda; border-radius:4px; font-weight:bold;">
+        <span style="margin-right:16px;">A</span> 
+        <span style="margin-right:16px;">headings</span> 
+        <span style="color:#155724; font-weight:bold;">Pass</span>
+      </summary>
+      <tr style="display:none;">
+        <td colspan="3" style="padding:8px; border: 1px solid #ddd; background:#f9fff9;">
+          <strong>Reason:</strong> Page has one <code>&lt;h1&gt;</code> and properly structured <code>&lt;h2&gt;</code> headings with no order issues<br>
+          <strong>Recommendation:</strong> None
+        </td>
+      </tr>
+    </details>
+
+    <details style="border:1px solid #ddd; margin-bottom:4px; border-radius:4px;" open>
+      <summary style="padding:8px; cursor:pointer; background:#d4edda; border-radius:4px; font-weight:bold;">
+        <span style="margin-right:16px;">A</span> 
+        <span style="margin-right:16px;">forms-missing-labels</span> 
+        <span style="color:#155724; font-weight:bold;">Pass</span>
+      </summary>
+      <tr style="display:none;">
+        <td colspan="3" style="padding:8px; border: 1px solid #ddd; background:#f9fff9;">
+          <strong>Reason:</strong> No form inputs were found or missing labels<br>
+          <strong>Recommendation:</strong> None
+        </td>
+      </tr>
+    </details>
+
+    <details style="border:1px solid #ddd; margin-bottom:4px; border-radius:4px;" open>
+      <summary style="padding:8px; cursor:pointer; background:#d4edda; border-radius:4px; font-weight:bold;">
+        <span style="margin-right:16px;">A</span> 
+        <span style="margin-right:16px;">aria-command-name</span> 
+        <span style="color:#155724; font-weight:bold;">Pass</span>
+      </summary>
+      <tr style="display:none;">
+        <td colspan="3" style="padding:8px; border: 1px solid #ddd; background:#f9fff9;">
+          <strong>Reason:</strong> Elements with ARIA commands have accessible names<br>
+          <strong>Recommendation:</strong> None
+        </td>
+      </tr>
+    </details>
+
+    <details style="border:1px solid #ddd; margin-bottom:4px; border-radius:4px;" open>
+      <summary style="padding:8px; cursor:pointer; background:#d4edda; border-radius:4px; font-weight:bold;">
+        <span style="margin-right:16px;">A</span> 
+        <span style="margin-right:16px;">button-name</span> 
+        <span style="color:#155724; font-weight:bold;">Pass</span>
+      </summary>
+      <tr style="display:none;">
+        <td colspan="3" style="padding:8px; border: 1px solid #ddd; background:#f9fff9;">
+          <strong>Reason:</strong> All buttons have discernible text<br>
+          <strong>Recommendation:</strong> None
+        </td>
+      </tr>
+    </details>
+
+    <details style="border:1px solid #ddd; margin-bottom:4px; border-radius:4px;" open>
+      <summary style="padding:8px; cursor:pointer; background:#d4edda; border-radius:4px; font-weight:bold;">
+        <span style="margin-right:16px;">A</span> 
+        <span style="margin-right:16px;">link-name</span> 
+        <span style="color:#155724; font-weight:bold;">Pass</span>
+      </summary>
+      <tr style="display:none;">
+        <td colspan="3" style="padding:8px; border: 1px solid #ddd; background:#f9fff9;">
+          <strong>Reason:</strong> All links have discernible text<br>
+          <strong>Recommendation:</strong> None
+        </td>
+      </tr>
+    </details>
+
+    <details style="border:1px solid #ddd; margin-bottom:4px; border-radius:4px;" open>
+      <summary style="padding:8px; cursor:pointer; background:#d4edda; border-radius:4px; font-weight:bold;">
+        <span style="margin-right:16px;">A</span> 
+        <span style="margin-right:16px;">bypass</span> 
+        <span style="color:#155724; font-weight:bold;">Pass</span>
+      </summary>
+      <tr style="display:none;">
+        <td colspan="3" style="padding:8px; border: 1px solid #ddd; background:#f9fff9;">
+          <strong>Reason:</strong> Page structure facilitates bypassing repeated content (headings and landmark regions present)<br>
+          <strong>Recommendation:</strong> Consider adding an explicit "Skip to main content" link for easier navigation
+        </td>
+      </tr>
+    </details>
+
+    <details style="border:1px solid #ddd; margin-bottom:4px; border-radius:4px;" open>
+      <summary style="padding:8px; cursor:pointer; background:#d4edda; border-radius:4px; font-weight:bold;">
+        <span style="margin-right:16px;">A</span> 
+        <span style="margin-right:16px;">no-autoplay-audio</span> 
+        <span style="color:#155724; font-weight:bold;">Pass</span>
+      </summary>
+      <tr style="display:none;">
+        <td colspan="3" style="padding:8px; border: 1px solid #ddd; background:#f9fff9;">
+          <strong>Reason:</strong> No audio or video content autoplays without control<br>
+          <strong>Recommendation:</strong> None
+        </td>
+      </tr>
+    </details>
+
+    <details style="border:1px solid #ddd; margin-bottom:4px; border-radius:4px;" open>
+      <summary style="padding:8px; cursor:pointer; background:#d4edda; border-radius:4px; font-weight:bold;">
+        <span style="margin-right:16px;">A</span> 
+        <span style="margin-right:16px;">meta-viewport</span> 
+        <span style="color:#155724; font-weight:bold;">Pass</span>
+      </summary>
+      <tr style="display:none;">
+        <td colspan="3" style="padding:8px; border: 1px solid #ddd; background:#f9fff9;">
+          <strong>Reason:</strong> Meta viewport tag does not disable zooming or text scaling<br>
+          <strong>Recommendation:</strong> None
+        </td>
+      </tr>
+    </details>
+
+    <details style="border:1px solid #ddd; margin-bottom:4px; border-radius:4px;" open>
+      <summary style="padding:8px; cursor:pointer; background:#d4edda; border-radius:4px; font-weight:bold;">
+        <span style="margin-right:16px;">AA</span> 
+        <span style="margin-right:16px;">scrollable-region-focusable</span> 
+        <span style="color:#155724; font-weight:bold;">Pass</span>
+      </summary>
+      <tr style="display:none;">
+        <td colspan="3" style="padding:8px; border: 1px solid #ddd; background:#f9fff9;">
+          <strong>Reason:</strong> Scrollable regions are keyboard accessible<br>
+          <strong>Recommendation:</strong> None
+        </td>
+      </tr>
+    </details>
+
+    <details style="border:1px solid #ddd; margin-bottom:4px; border-radius:4px;" open>
+      <summary style="padding:8px; cursor:pointer; background:#d4edda; border-radius:4px; font-weight:bold;">
+        <span style="margin-right:16px;">A</span> 
+        <span style="margin-right:16px;">nested-interactive</span> 
+        <span style="color:#155724; font-weight:bold;">Pass</span>
+      </summary>
+      <tr style="display:none;">
+        <td colspan="3" style="padding:8px; border: 1px solid #ddd; background:#f9fff9;">
+          <strong>Reason:</strong> No nested interactive controls that interfere with screen reader focus<br>
+          <strong>Recommendation:</strong> None
+        </td>
+      </tr>
+    </details>
+
+    <!-- Fail rows -->
+    <details style="border:1px solid #ddd; margin-bottom:4px; border-radius:4px;">
+      <summary style="padding:8px; cursor:pointer; background:#f8d7da; border-radius:4px; font-weight:bold;">
+        <span style="margin-right:16px;">A</span> 
+        <span style="margin-right:16px;">role-img-alt</span> 
+        <span style="color:#721c24; font-weight:bold;">Fail</span>
+      </summary>
+      <tr style="display:none;">
+        <td colspan="3" style="padding:8px; border: 1px solid #ddd; background:#fff5f5;">
+          <strong>Reason:</strong> These SVG icons lack alternative text for screen readers<br>
+          <strong>Recommendation:</strong> Add descriptive <code>aria-label</code> or <code>&lt;title&gt;</code> within SVG for each icon to provide accessible names
+        </td>
+      </tr>
+    </details>
+
+    <details style="border:1px solid #ddd; margin-bottom:4px; border-radius:4px;">
+      <summary style="padding:8px; cursor:pointer; background:#f8d7da; border-radius:4px; font-weight:bold;">
+        <span style="margin-right:16px;">A</span> 
+        <span style="margin-right:16px;">duplicate-id</span> 
+        <span style="color:#721c24; font-weight:bold;">Fail</span>
+      </summary>
+      <tr style="display:none;">
+        <td colspan="3" style="padding:8px; border: 1px solid #ddd; background:#fff5f5;">
+          <strong>Reason:</strong> ID attributes must be unique on the page to avoid reference confusion<br>
+          <strong>Recommendation:</strong> Ensure all ID attributes are unique within the HTML document
+        </td>
+      </tr>
+    </details>
+
+    <details style="border:1px solid #ddd; margin-bottom:4px; border-radius:4px;">
+      <summary style="padding:8px; cursor:pointer; background:#f8d7da; border-radius:4px; font-weight:bold;">
+        <span style="margin-right:16px;">A</span> 
+        <span style="margin-right:16px;">skip-link</span> 
+        <span style="color:#721c24; font-weight:bold;">Fail</span>
+      </summary>
+      <tr style="display:none;">
+        <td colspan="3" style="padding:8px; border: 1px solid #ddd; background:#fff5f5;">
+          <strong>Reason:</strong> Absence of skip links impacts keyboard users and screen reader users' ability to quickly access main content<br>
+          <strong>Recommendation:</strong> Add a visible or programmatically focusable skip link at the top of the page
+        </td>
+      </tr>
+    </details>
+  </tbody>
+</table>
+```

src/accessibility_v1/output/accessibility_dashboard_20251112_065648.html

@@ -0,0 +1,171 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+<meta charset="UTF-8">
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+<title>Accessibility Dashboard</title>
+<script src="https://cdn.tailwindcss.com"></script>
+<style>
+  .pass { color: #16a34a; }   /* green */
+  .fail { color: #dc2626; }   /* red */
+  .warning { color: #f59e0b; } /* amber */
+  .summary-card { cursor: pointer; }
+</style>
+</head>
+<body class="bg-gray-100 font-sans">
+  <header class="bg-blue-600 text-white p-6 shadow-md sticky top-0 z-50">
+    <h1 class="text-3xl font-bold" id="site-name">Site Accessibility Dashboard</h1>
+    <p class="mt-2" id="summary">
+      Summary: All Pages
+      | Passed: <span id="total-pass">0</span>
+      | Failed: <span id="total-fail">0</span>
+      | Warnings: <span id="total-warning">0</span>
+    </p>
+  </header>
+
+  <!-- Page Summary Cards -->
+  <div class="flex flex-wrap gap-4 px-6 mb-4" id="summary-cards"></div>
+
+  <!-- Filters -->
+  <div class="flex space-x-4 mb-4 px-6">
+    <button class="filter-btn px-4 py-2 bg-gray-300 rounded" data-filter="all">All</button>
+    <button class="filter-btn px-4 py-2 bg-green-300 rounded" data-filter="pass">Passed</button>
+    <button class="filter-btn px-4 py-2 bg-red-300 rounded" data-filter="fail">Failed</button>
+    <button class="filter-btn px-4 py-2 bg-yellow-300 rounded" data-filter="warning">Warnings</button>
+  </div>
+
+  <!-- Audit Tables -->
+  <div id="audit-tables" class="px-6 space-y-4"></div>
+
+  <!-- Scroll-to-top button -->
+  <button id="scrollTopBtn" 
+          class="fixed bottom-4 right-4 bg-blue-600 text-white px-4 py-2 rounded shadow-lg hover:bg-blue-700 transition-opacity opacity-75 hover:opacity-100">
+    ↑ Top
+  </button>
+
+<script>
+const tableRows = [];
+const pageTables = {};
+const buttons = document.querySelectorAll(".filter-btn");
+
+// ---------------- Table Row / Per-Page Table ----------------
+function addRow(page, level, rule, status, reason, recommendation) {
+  if(!pageTables[page]) {
+    const container = document.getElementById("audit-tables");
+    const header = document.createElement("div");
+    header.className = "bg-gray-200 px-4 py-2 rounded cursor-pointer shadow";
+    header.innerHTML = `<h2 class="font-bold">${page}</h2>`;
+    const tableDiv = document.createElement("div");
+    tableDiv.className = "overflow-x-auto mt-2 hidden";
+    const table = document.createElement("table");
+    table.className = "min-w-full bg-white shadow rounded";
+    table.innerHTML = `
+      <thead class="bg-gray-100">
+        <tr>
+          <th class="px-4 py-2">Level</th>
+          <th class="px-4 py-2">Rule</th>
+          <th class="px-4 py-2">Pass/Fail</th>
+          <th class="px-4 py-2">Reason</th>
+          <th class="px-4 py-2">Recommendation</th>
+        </tr>
+      </thead>
+      <tbody></tbody>
+    `;
+    tableDiv.appendChild(table);
+    container.appendChild(header);
+    container.appendChild(tableDiv);
+    header.addEventListener("click", () => tableDiv.classList.toggle("hidden"));
+    pageTables[page] = table.querySelector("tbody");
+  }
+
+  const tbody = pageTables[page];
+  const tr = document.createElement("tr");
+  tr.className = "border-b";
+  tr.dataset.status = status.toLowerCase();
+  tr.dataset.page = page;
+  tr.innerHTML = `
+    <td class="px-4 py-2">${level}</td>
+    <td class="px-4 py-2">${rule}</td>
+    <td class="px-4 py-2 ${status.toLowerCase()}">${status}</td>
+    <td class="px-4 py-2">${reason}</td>
+    <td class="px-4 py-2">${recommendation}</td>
+  `;
+  tableRows.push(tr);
+  tbody.appendChild(tr);
+}
+
+// ---------------- Page Summary Cards ----------------
+const pageSummaries = {};
+function addSummaryCard(page, passed, failed, warning) {
+  pageSummaries[page] = {passed, failed, warning};
+  const container = document.getElementById("summary-cards");
+  const total = passed + failed + warning;
+  const passRatio = total>0?passed/total:0;
+  let colorClass="bg-green-400";
+  if(passRatio<0.3) colorClass="bg-red-500";
+  else if(passRatio<0.7) colorClass="bg-yellow-400";
+  const passPercent = total>0?(passed/total*100):0;
+  const failPercent = total>0?(failed/total*100):0;
+  const warnPercent = total>0?(warning/total*100):0;
+
+  const card = document.createElement("div");
+  card.className="summary-card bg-white shadow p-4 rounded w-64 hover:shadow-lg";
+  card.innerHTML=`
+    <div class="flex justify-between items-center mb-2">
+      <h3 class="font-bold text-lg">${page}</h3>
+      <span class="px-2 py-1 text-white rounded ${colorClass}">Pass: ${passPercent.toFixed(0)}%</span>
+    </div>
+    <div class="flex h-3 mb-2 w-full rounded overflow-hidden shadow-inner">
+      <div class="bg-green-500 h-full" style="width:${passPercent}%;"></div>
+      <div class="bg-red-600 h-full" style="width:${failPercent}%;"></div>
+      <div class="bg-yellow-400 h-full" style="width:${warnPercent}%;"></div>
+    </div>
+    <div class="text-sm">
+      <p class="text-green-600">Passed: ${passed}</p>
+      <p class="text-red-600">Failed: ${failed}</p>
+      <p class="text-yellow-500">Warnings: ${warning}</p>
+    </div>
+  `;
+  card.addEventListener("click", ()=>{
+    const row = tableRows.find(r=>r.dataset.page===page);
+    if(row) row.scrollIntoView({behavior:"smooth", block:"start"});
+  });
+  container.appendChild(card);
+}
+
+// ---------------- Filters ----------------
+function updateTable(filter){
+  Object.values(pageTables).forEach(tbody=>{
+    Array.from(tbody.children).forEach(row=>{
+      if(filter==="all"||row.dataset.status===filter) row.style.display="";
+      else row.style.display="none";
+    });
+  });
+}
+buttons.forEach(btn=>{
+  btn.addEventListener("click",()=>updateTable(btn.dataset.filter));
+});
+
+// ---------------- Scroll to Top ----------------
+const scrollBtn=document.getElementById("scrollTopBtn");
+scrollBtn.addEventListener("click",()=>window.scrollTo({top:0,behavior:"smooth"}));
+window.addEventListener("scroll",()=>{scrollBtn.style.display=window.scrollY>200?"block":"none";});
+scrollBtn.style.display="none";
+
+// ---------------- Hero Banner Totals ----------------
+function updateTotals(passed, failed, warning){
+  document.getElementById("total-pass").innerText=passed;
+  document.getElementById("total-fail").innerText=failed;
+  document.getElementById("total-warning").innerText=warning;
+  const total=passed+failed+warning;
+  const ratio=total>0?passed/total:0;
+  const summaryEl=document.getElementById("summary");
+  summaryEl.classList.remove("text-green-500","text-yellow-400","text-red-500");
+  if(ratio<0.3) summaryEl.classList.add("text-red-500");
+  else if(ratio<0.7) summaryEl.classList.add("text-yellow-400");
+  else summaryEl.classList.add("text-green-500");
+}
+</script>
+
+</body>
+</html>

src/accessibility_v1/output/accessibility_dashboard_20251112_070331.html

@@ -0,0 +1,171 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+<meta charset="UTF-8">
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+<title>Accessibility Dashboard</title>
+<script src="https://cdn.tailwindcss.com"></script>
+<style>
+  .pass { color: #16a34a; }   /* green */
+  .fail { color: #dc2626; }   /* red */
+  .warning { color: #f59e0b; } /* amber */
+  .summary-card { cursor: pointer; }
+</style>
+</head>
+<body class="bg-gray-100 font-sans">
+  <header class="bg-blue-600 text-white p-6 shadow-md sticky top-0 z-50">
+    <h1 class="text-3xl font-bold" id="site-name">Site Accessibility Dashboard</h1>
+    <p class="mt-2" id="summary">
+      Summary: All Pages
+      | Passed: <span id="total-pass">0</span>
+      | Failed: <span id="total-fail">0</span>
+      | Warnings: <span id="total-warning">0</span>
+    </p>
+  </header>
+
+  <!-- Page Summary Cards -->
+  <div class="flex flex-wrap gap-4 px-6 mb-4" id="summary-cards"></div>
+
+  <!-- Filters -->
+  <div class="flex space-x-4 mb-4 px-6">
+    <button class="filter-btn px-4 py-2 bg-gray-300 rounded" data-filter="all">All</button>
+    <button class="filter-btn px-4 py-2 bg-green-300 rounded" data-filter="pass">Passed</button>
+    <button class="filter-btn px-4 py-2 bg-red-300 rounded" data-filter="fail">Failed</button>
+    <button class="filter-btn px-4 py-2 bg-yellow-300 rounded" data-filter="warning">Warnings</button>
+  </div>
+
+  <!-- Audit Tables -->
+  <div id="audit-tables" class="px-6 space-y-4"></div>
+
+  <!-- Scroll-to-top button -->
+  <button id="scrollTopBtn" 
+          class="fixed bottom-4 right-4 bg-blue-600 text-white px-4 py-2 rounded shadow-lg hover:bg-blue-700 transition-opacity opacity-75 hover:opacity-100">
+    ↑ Top
+  </button>
+
+<script>
+const tableRows = [];
+const pageTables = {};
+const buttons = document.querySelectorAll(".filter-btn");
+
+// ---------------- Table Row / Per-Page Table ----------------
+function addRow(page, level, rule, status, reason, recommendation) {
+  if(!pageTables[page]) {
+    const container = document.getElementById("audit-tables");
+    const header = document.createElement("div");
+    header.className = "bg-gray-200 px-4 py-2 rounded cursor-pointer shadow";
+    header.innerHTML = `<h2 class="font-bold">${page}</h2>`;
+    const tableDiv = document.createElement("div");
+    tableDiv.className = "overflow-x-auto mt-2 hidden";
+    const table = document.createElement("table");
+    table.className = "min-w-full bg-white shadow rounded";
+    table.innerHTML = `
+      <thead class="bg-gray-100">
+        <tr>
+          <th class="px-4 py-2">Level</th>
+          <th class="px-4 py-2">Rule</th>
+          <th class="px-4 py-2">Pass/Fail</th>
+          <th class="px-4 py-2">Reason</th>
+          <th class="px-4 py-2">Recommendation</th>
+        </tr>
+      </thead>
+      <tbody></tbody>
+    `;
+    tableDiv.appendChild(table);
+    container.appendChild(header);
+    container.appendChild(tableDiv);
+    header.addEventListener("click", () => tableDiv.classList.toggle("hidden"));
+    pageTables[page] = table.querySelector("tbody");
+  }
+
+  const tbody = pageTables[page];
+  const tr = document.createElement("tr");
+  tr.className = "border-b";
+  tr.dataset.status = status.toLowerCase();
+  tr.dataset.page = page;
+  tr.innerHTML = `
+    <td class="px-4 py-2">${level}</td>
+    <td class="px-4 py-2">${rule}</td>
+    <td class="px-4 py-2 ${status.toLowerCase()}">${status}</td>
+    <td class="px-4 py-2">${reason}</td>
+    <td class="px-4 py-2">${recommendation}</td>
+  `;
+  tableRows.push(tr);
+  tbody.appendChild(tr);
+}
+
+// ---------------- Page Summary Cards ----------------
+const pageSummaries = {};
+function addSummaryCard(page, passed, failed, warning) {
+  pageSummaries[page] = {passed, failed, warning};
+  const container = document.getElementById("summary-cards");
+  const total = passed + failed + warning;
+  const passRatio = total>0?passed/total:0;
+  let colorClass="bg-green-400";
+  if(passRatio<0.3) colorClass="bg-red-500";
+  else if(passRatio<0.7) colorClass="bg-yellow-400";
+  const passPercent = total>0?(passed/total*100):0;
+  const failPercent = total>0?(failed/total*100):0;
+  const warnPercent = total>0?(warning/total*100):0;
+
+  const card = document.createElement("div");
+  card.className="summary-card bg-white shadow p-4 rounded w-64 hover:shadow-lg";
+  card.innerHTML=`
+    <div class="flex justify-between items-center mb-2">
+      <h3 class="font-bold text-lg">${page}</h3>
+      <span class="px-2 py-1 text-white rounded ${colorClass}">Pass: ${passPercent.toFixed(0)}%</span>
+    </div>
+    <div class="flex h-3 mb-2 w-full rounded overflow-hidden shadow-inner">
+      <div class="bg-green-500 h-full" style="width:${passPercent}%;"></div>
+      <div class="bg-red-600 h-full" style="width:${failPercent}%;"></div>
+      <div class="bg-yellow-400 h-full" style="width:${warnPercent}%;"></div>
+    </div>
+    <div class="text-sm">
+      <p class="text-green-600">Passed: ${passed}</p>
+      <p class="text-red-600">Failed: ${failed}</p>
+      <p class="text-yellow-500">Warnings: ${warning}</p>
+    </div>
+  `;
+  card.addEventListener("click", ()=>{
+    const row = tableRows.find(r=>r.dataset.page===page);
+    if(row) row.scrollIntoView({behavior:"smooth", block:"start"});
+  });
+  container.appendChild(card);
+}
+
+// ---------------- Filters ----------------
+function updateTable(filter){
+  Object.values(pageTables).forEach(tbody=>{
+    Array.from(tbody.children).forEach(row=>{
+      if(filter==="all"||row.dataset.status===filter) row.style.display="";
+      else row.style.display="none";
+    });
+  });
+}
+buttons.forEach(btn=>{
+  btn.addEventListener("click",()=>updateTable(btn.dataset.filter));
+});
+
+// ---------------- Scroll to Top ----------------
+const scrollBtn=document.getElementById("scrollTopBtn");
+scrollBtn.addEventListener("click",()=>window.scrollTo({top:0,behavior:"smooth"}));
+window.addEventListener("scroll",()=>{scrollBtn.style.display=window.scrollY>200?"block":"none";});
+scrollBtn.style.display="none";
+
+// ---------------- Hero Banner Totals ----------------
+function updateTotals(passed, failed, warning){
+  document.getElementById("total-pass").innerText=passed;
+  document.getElementById("total-fail").innerText=failed;
+  document.getElementById("total-warning").innerText=warning;
+  const total=passed+failed+warning;
+  const ratio=total>0?passed/total:0;
+  const summaryEl=document.getElementById("summary");
+  summaryEl.classList.remove("text-green-500","text-yellow-400","text-red-500");
+  if(ratio<0.3) summaryEl.classList.add("text-red-500");
+  else if(ratio<0.7) summaryEl.classList.add("text-yellow-400");
+  else summaryEl.classList.add("text-green-500");
+}
+</script>
+
+</body>
+</html>

src/accessibility_v1/output/accessibility_dashboard_20251112_070840.html

@@ -0,0 +1,171 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+<meta charset="UTF-8">
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+<title>Accessibility Dashboard</title>
+<script src="https://cdn.tailwindcss.com"></script>
+<style>
+  .pass { color: #16a34a; }   /* green */
+  .fail { color: #dc2626; }   /* red */
+  .warning { color: #f59e0b; } /* amber */
+  .summary-card { cursor: pointer; }
+</style>
+</head>
+<body class="bg-gray-100 font-sans">
+  <header class="bg-blue-600 text-white p-6 shadow-md sticky top-0 z-50">
+    <h1 class="text-3xl font-bold" id="site-name">Site Accessibility Dashboard</h1>
+    <p class="mt-2" id="summary">
+      Summary: All Pages
+      | Passed: <span id="total-pass">0</span>
+      | Failed: <span id="total-fail">0</span>
+      | Warnings: <span id="total-warning">0</span>
+    </p>
+  </header>
+
+  <!-- Page Summary Cards -->
+  <div class="flex flex-wrap gap-4 px-6 mb-4" id="summary-cards"></div>
+
+  <!-- Filters -->
+  <div class="flex space-x-4 mb-4 px-6">
+    <button class="filter-btn px-4 py-2 bg-gray-300 rounded" data-filter="all">All</button>
+    <button class="filter-btn px-4 py-2 bg-green-300 rounded" data-filter="pass">Passed</button>
+    <button class="filter-btn px-4 py-2 bg-red-300 rounded" data-filter="fail">Failed</button>
+    <button class="filter-btn px-4 py-2 bg-yellow-300 rounded" data-filter="warning">Warnings</button>
+  </div>
+
+  <!-- Audit Tables -->
+  <div id="audit-tables" class="px-6 space-y-4"></div>
+
+  <!-- Scroll-to-top button -->
+  <button id="scrollTopBtn" 
+          class="fixed bottom-4 right-4 bg-blue-600 text-white px-4 py-2 rounded shadow-lg hover:bg-blue-700 transition-opacity opacity-75 hover:opacity-100">
+    ↑ Top
+  </button>
+
+<script>
+const tableRows = [];
+const pageTables = {};
+const buttons = document.querySelectorAll(".filter-btn");
+
+// ---------------- Table Row / Per-Page Table ----------------
+function addRow(page, level, rule, status, reason, recommendation) {
+  if(!pageTables[page]) {
+    const container = document.getElementById("audit-tables");
+    const header = document.createElement("div");
+    header.className = "bg-gray-200 px-4 py-2 rounded cursor-pointer shadow";
+    header.innerHTML = `<h2 class="font-bold">${page}</h2>`;
+    const tableDiv = document.createElement("div");
+    tableDiv.className = "overflow-x-auto mt-2 hidden";
+    const table = document.createElement("table");
+    table.className = "min-w-full bg-white shadow rounded";
+    table.innerHTML = `
+      <thead class="bg-gray-100">
+        <tr>
+          <th class="px-4 py-2">Level</th>
+          <th class="px-4 py-2">Rule</th>
+          <th class="px-4 py-2">Pass/Fail</th>
+          <th class="px-4 py-2">Reason</th>
+          <th class="px-4 py-2">Recommendation</th>
+        </tr>
+      </thead>
+      <tbody></tbody>
+    `;
+    tableDiv.appendChild(table);
+    container.appendChild(header);
+    container.appendChild(tableDiv);
+    header.addEventListener("click", () => tableDiv.classList.toggle("hidden"));
+    pageTables[page] = table.querySelector("tbody");
+  }
+
+  const tbody = pageTables[page];
+  const tr = document.createElement("tr");
+  tr.className = "border-b";
+  tr.dataset.status = status.toLowerCase();
+  tr.dataset.page = page;
+  tr.innerHTML = `
+    <td class="px-4 py-2">${level}</td>
+    <td class="px-4 py-2">${rule}</td>
+    <td class="px-4 py-2 ${status.toLowerCase()}">${status}</td>
+    <td class="px-4 py-2">${reason}</td>
+    <td class="px-4 py-2">${recommendation}</td>
+  `;
+  tableRows.push(tr);
+  tbody.appendChild(tr);
+}
+
+// ---------------- Page Summary Cards ----------------
+const pageSummaries = {};
+function addSummaryCard(page, passed, failed, warning) {
+  pageSummaries[page] = {passed, failed, warning};
+  const container = document.getElementById("summary-cards");
+  const total = passed + failed + warning;
+  const passRatio = total>0?passed/total:0;
+  let colorClass="bg-green-400";
+  if(passRatio<0.3) colorClass="bg-red-500";
+  else if(passRatio<0.7) colorClass="bg-yellow-400";
+  const passPercent = total>0?(passed/total*100):0;
+  const failPercent = total>0?(failed/total*100):0;
+  const warnPercent = total>0?(warning/total*100):0;
+
+  const card = document.createElement("div");
+  card.className="summary-card bg-white shadow p-4 rounded w-64 hover:shadow-lg";
+  card.innerHTML=`
+    <div class="flex justify-between items-center mb-2">
+      <h3 class="font-bold text-lg">${page}</h3>
+      <span class="px-2 py-1 text-white rounded ${colorClass}">Pass: ${passPercent.toFixed(0)}%</span>
+    </div>
+    <div class="flex h-3 mb-2 w-full rounded overflow-hidden shadow-inner">
+      <div class="bg-green-500 h-full" style="width:${passPercent}%;"></div>
+      <div class="bg-red-600 h-full" style="width:${failPercent}%;"></div>
+      <div class="bg-yellow-400 h-full" style="width:${warnPercent}%;"></div>
+    </div>
+    <div class="text-sm">
+      <p class="text-green-600">Passed: ${passed}</p>
+      <p class="text-red-600">Failed: ${failed}</p>
+      <p class="text-yellow-500">Warnings: ${warning}</p>
+    </div>
+  `;
+  card.addEventListener("click", ()=>{
+    const row = tableRows.find(r=>r.dataset.page===page);
+    if(row) row.scrollIntoView({behavior:"smooth", block:"start"});
+  });
+  container.appendChild(card);
+}
+
+// ---------------- Filters ----------------
+function updateTable(filter){
+  Object.values(pageTables).forEach(tbody=>{
+    Array.from(tbody.children).forEach(row=>{
+      if(filter==="all"||row.dataset.status===filter) row.style.display="";
+      else row.style.display="none";
+    });
+  });
+}
+buttons.forEach(btn=>{
+  btn.addEventListener("click",()=>updateTable(btn.dataset.filter));
+});
+
+// ---------------- Scroll to Top ----------------
+const scrollBtn=document.getElementById("scrollTopBtn");
+scrollBtn.addEventListener("click",()=>window.scrollTo({top:0,behavior:"smooth"}));
+window.addEventListener("scroll",()=>{scrollBtn.style.display=window.scrollY>200?"block":"none";});
+scrollBtn.style.display="none";
+
+// ---------------- Hero Banner Totals ----------------
+function updateTotals(passed, failed, warning){
+  document.getElementById("total-pass").innerText=passed;
+  document.getElementById("total-fail").innerText=failed;
+  document.getElementById("total-warning").innerText=warning;
+  const total=passed+failed+warning;
+  const ratio=total>0?passed/total:0;
+  const summaryEl=document.getElementById("summary");
+  summaryEl.classList.remove("text-green-500","text-yellow-400","text-red-500");
+  if(ratio<0.3) summaryEl.classList.add("text-red-500");
+  else if(ratio<0.7) summaryEl.classList.add("text-yellow-400");
+  else summaryEl.classList.add("text-green-500");
+}
+</script>
+
+</body>
+</html>

src/accessibility_v1/output/accessibility_dashboard_20251112_071804.html

@@ -0,0 +1,188 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+<meta charset="UTF-8">
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+<title>Accessibility Dashboard</title>
+<script src="https://cdn.tailwindcss.com"></script>
+<style>
+  .pass { color: #16a34a; }
+  .fail { color: #dc2626; }
+  .warning { color: #f59e0b; }
+  .summary-card { cursor: pointer; }
+</style>
+</head>
+<body class="bg-gray-100 font-sans">
+<header class="bg-blue-600 text-white p-6 shadow-md sticky top-0 z-50">
+  <h1 class="text-3xl font-bold" id="site-name">Site Accessibility Dashboard</h1>
+  <p class="mt-2" id="summary">
+    Summary: All Pages
+    | Passed: <span id="total-pass">0</span>
+    | Failed: <span id="total-fail">0</span>
+    | Warnings: <span id="total-warning">0</span>
+  </p>
+</header>
+
+<!-- Page Summary Cards -->
+<div class="flex flex-wrap gap-4 px-6 mb-4" id="summary-cards"></div>
+
+<!-- Filters -->
+<div class="flex space-x-4 mb-4 px-6">
+  <button class="filter-btn px-4 py-2 bg-gray-300 rounded" data-filter="all">All</button>
+  <button class="filter-btn px-4 py-2 bg-green-300 rounded" data-filter="pass">Passed</button>
+  <button class="filter-btn px-4 py-2 bg-red-300 rounded" data-filter="fail">Failed</button>
+  <button class="filter-btn px-4 py-2 bg-yellow-300 rounded" data-filter="warning">Warnings</button>
+</div>
+
+<!-- Audit Tables -->
+<div id="audit-tables" class="px-6 space-y-4"></div>
+
+<!-- Scroll-to-top button -->
+<button id="scrollTopBtn" 
+        class="fixed bottom-4 right-4 bg-blue-600 text-white px-4 py-2 rounded shadow-lg hover:bg-blue-700 transition-opacity opacity-75 hover:opacity-100">
+  ↑ Top
+</button>
+
+<!-- Inject audit data as JSON -->
+<script>
+const auditData = [{"page": "https://oauthapp.azurewebsites.net/", "rows": [{"level": "", "rule": "Level", "status": "Rule", "reason": "Pass/Fail", "recommendation": "Reason"}, {"level": "", "rule": ":----", "status": ":-----------------------", "reason": ":--------", "recommendation": ":-------------------------------------------------------------------------------------------------------------------------"}, {"level": "", "rule": "A", "status": "Document Title", "reason": "Pass", "recommendation": "The document has a non-empty `<title>` element."}, {"level": "", "rule": "A", "status": "HTML has lang", "reason": "Pass", "recommendation": "The `<html>` element has a lang attribute."}, {"level": "", "rule": "A", "status": "HTML lang valid", "reason": "Pass", "recommendation": "The lang attribute of the `<html>` element has a valid value."}, {"level": "", "rule": "A", "status": "Image alt", "reason": "Pass", "recommendation": "All `<img>` elements have alternate text or a role of none or presentation."}, {"level": "", "rule": "A", "status": "Link name", "reason": "Pass", "recommendation": "All links have discernible text."}, {"level": "", "rule": "A", "status": "List", "reason": "Pass", "recommendation": "Lists are structured correctly."}, {"level": "", "rule": "A", "status": "Listitem", "reason": "Pass", "recommendation": "`<li>` elements are used semantically."}, {"level": "", "rule": "AA", "status": "Meta viewport", "reason": "Pass", "recommendation": "`<meta name=\"viewport\">` does not disable text scaling and zooming."}, {"level": "", "rule": "A", "status": "Bypass", "reason": "Pass", "recommendation": "Each page has at least one mechanism for a user to bypass navigation and jump straight to the content."}, {"level": "", "rule": "AA", "status": "Color contrast", "reason": "Pass", "recommendation": "The contrast between foreground and background colors meets WCAG 2 AA minimum contrast ratio thresholds."}, {"level": "", "rule": "A", "status": "ARIA hidden body", "reason": "Pass", "recommendation": "`aria-hidden=\"true\"` is not present on the document body."}, {"level": "", "rule": "A", "status": "ARIA hidden focus", "reason": "Pass", "recommendation": "ARIA-hidden elements are not focusable and do not contain focusable elements"}, {"level": "", "rule": "A", "status": "Button name", "reason": "Pass", "recommendation": "Ensures buttons have discernible text"}, {"level": "", "rule": "A", "status": "Nested interactive", "reason": "Pass", "recommendation": "Ensures interactive controls are not nested"}, {"level": "", "rule": "A", "status": "Scrollable region focusable", "reason": "Pass", "recommendation": "Ensures elements that have scrollable content are accessible by keyboard"}, {"level": "", "rule": "N/A", "status": "role-img-missing-name", "reason": "Fail", "recommendation": "The `<img>` elements with a role of \"img\" are missing accessible names."}, {"level": "", "rule": "N/A", "status": "duplicate-id", "reason": "Fail", "recommendation": "There are two elements with the id \"docIcon\""}], "summary": {"pass": 1, "fail": 0, "warning": 0}}, {"page": "https://oauthapp.azurewebsites.net/code", "rows": [{"level": "", "rule": "Level", "status": "Rule", "reason": "Pass/Fail", "recommendation": "Reason"}, {"level": "", "rule": ":----", "status": ":-----------------------------------------------------------", "reason": ":--------", "recommendation": ":------------------------------------------------------------------"}, {"level": "", "rule": "A", "status": "`<ul>` and `<ol>` must only directly contain `<li>`, `<script>` or `<template>` elements", "reason": "Fail", "recommendation": "List element has direct children that are not allowed: `<pre>`"}, {"level": "", "rule": "A", "status": "ARIA commands must have an accessible name", "reason": "Fail", "recommendation": "role img missing name"}, {"level": "", "rule": "N/A", "status": "duplicate-id", "reason": "Fail", "recommendation": "Duplicate ID \"docIcon\""}, {"level": "", "rule": "Area", "status": "Status", "reason": "Issues", "recommendation": ""}, {"level": "", "rule": ":------------", "status": ":-----", "reason": ":-----", "recommendation": ""}, {"level": "", "rule": "Headings", "status": "Pass", "reason": "No H1, but headings are present.  Consider adding an H1 for better document structure.", "recommendation": ""}, {"level": "", "rule": "Language", "status": "Pass", "reason": "Language attribute is present.", "recommendation": ""}, {"level": "", "rule": "Images", "status": "Pass", "reason": "No missing alt text.", "recommendation": ""}, {"level": "", "rule": "Forms", "status": "Pass", "reason": "No missing labels.", "recommendation": ""}, {"level": "", "rule": "ARIA", "status": "Fail", "reason": "Several role-img-missing-name issues and duplicate IDs. See above table for fixes.", "recommendation": ""}, {"level": "", "rule": "Keyboard", "status": "Pass", "reason": "Focusable elements are in logical tab order.", "recommendation": ""}, {"level": "", "rule": "Videos", "status": "Pass", "reason": "No videos found.", "recommendation": ""}, {"level": "", "rule": "Contrast", "status": "Pass", "reason": "No contrast issues found.", "recommendation": ""}, {"level": "", "rule": "Semantics", "status": "Pass", "reason": "Landmarks are properly used.", "recommendation": ""}], "summary": {"pass": 8, "fail": 1, "warning": 0}}, {"page": "https://oauthapp.azurewebsites.net/credential", "rows": [{"level": "", "rule": "Level", "status": "Rule", "reason": "Pass/Fail", "recommendation": "Reason"}, {"level": "", "rule": "---", "status": "---", "reason": "---", "recommendation": "---"}, {"level": "", "rule": "A", "status": "List structure", "reason": "Fail", "recommendation": "`<ol>` element has `pre` element as a direct child, which is not allowed."}, {"level": "", "rule": "A/AA", "status": "ARIA", "reason": "Fail", "recommendation": "Some `role=\"img\"` elements are missing accessible names."}, {"level": "", "rule": "A", "status": "Headings", "reason": "N/A", "recommendation": "The page does not have an H1"}, {"level": "", "rule": "A/AA", "status": "Duplicate IDs", "reason": "N/A", "recommendation": "The page has duplicate IDs."}, {"level": "", "rule": "A/AA", "status": "Image Alt Text", "reason": "Pass", "recommendation": "All images have alt text."}, {"level": "", "rule": "A/AA", "status": "Color Contrast", "reason": "Pass", "recommendation": "All elements have sufficient color contrast."}, {"level": "", "rule": "A", "status": "Link Name", "reason": "Pass", "recommendation": "All links have discernible text."}, {"level": "", "rule": "A", "status": "HTML Lang", "reason": "Pass", "recommendation": "The `<html>` element has a valid `lang` attribute."}, {"level": "", "rule": "A", "status": "Document Title", "reason": "Pass", "recommendation": "The document has a non-empty `<title>` element."}, {"level": "", "rule": "A", "status": "Bypass Blocks", "reason": "Pass", "recommendation": "The page has a mechanism to bypass repeated blocks."}, {"level": "", "rule": "AA", "status": "Meta Viewport", "reason": "Pass", "recommendation": "The `<meta name=\"viewport\">` tag does not disable text scaling and zooming."}, {"level": "", "rule": "A/AA", "status": "Keyboard Access", "reason": "N/A", "recommendation": "The page has a scrollable region that contains focusable elements."}, {"level": "", "rule": "A/AA", "status": "ARIA", "reason": "N/A", "recommendation": "Some elements with `aria-hidden=\"true\"` are focusable or contain focusable elements"}, {"level": "", "rule": "A/AA", "status": "Button Name", "reason": "Pass", "recommendation": "All buttons have discernible text"}], "summary": {"pass": 1, "fail": 0, "warning": 0}}, {"page": "https://oauthapp.azurewebsites.net/implicit", "rows": [{"level": "", "rule": "Level", "status": "Rule", "reason": "Pass/Fail", "recommendation": "Reason"}, {"level": "", "rule": "---", "status": "---", "reason": "---", "recommendation": "---"}, {"level": "", "rule": "A", "status": "List Structure", "reason": "Fail", "recommendation": "`<ol>` element contains a `<pre>` element directly, which is not allowed."}, {"level": "", "rule": "A", "status": "List Structure", "reason": "Pass", "recommendation": "`<ul>` and `<ol>` must only directly contain `<li>`, `<script>` or `<template>` elements"}, {"level": "", "rule": "A", "status": "List Items", "reason": "Pass", "recommendation": "`<li>` elements must be contained in a `<ul>` or `<ol>`"}, {"level": "", "rule": "AA", "status": "Color Contrast", "reason": "Pass", "recommendation": "The contrast between foreground and background colors meets WCAG 2 AA minimum contrast ratio thresholds"}, {"level": "", "rule": "A", "status": "Document Title", "reason": "Pass", "recommendation": "Each HTML document contains a non-empty `<title>` element"}, {"level": "", "rule": "A", "status": "HTML Lang Attribute", "reason": "Pass", "recommendation": "Every HTML document has a `lang` attribute"}, {"level": "", "rule": "A", "status": "HTML Lang Attribute Value", "reason": "Pass", "recommendation": "The `lang` attribute of the `<html>` element has a valid value"}, {"level": "", "rule": "A", "status": "Image Alt Text", "reason": "Pass", "recommendation": "`<img>` elements have alternate text or a role of none or presentation"}, {"level": "", "rule": "A", "status": "Link Name", "reason": "Pass", "recommendation": "Links have discernible text"}, {"level": "", "rule": "AA", "status": "Meta Viewport", "reason": "Pass", "recommendation": "`<meta name=\"viewport\">` does not disable text scaling and zooming"}, {"level": "", "rule": "A", "status": "Bypass Blocks", "reason": "Pass", "recommendation": "Each page has at least one mechanism for a user to bypass navigation and jump straight to the content"}, {"level": "", "rule": "N/A", "status": "Nested Interactive Elements", "reason": "Pass", "recommendation": "Interactive controls are not nested"}, {"level": "", "rule": "N/A", "status": "Scrollable Region Focusable", "reason": "Pass", "recommendation": "Elements that have scrollable content are accessible by keyboard"}, {"level": "", "rule": "N/A", "status": "ARIA", "reason": "Fail", "recommendation": "`role=img` elements are missing accessible names"}, {"level": "", "rule": "N/A", "status": "ARIA", "reason": "Fail", "recommendation": "Duplicate IDs"}, {"level": "", "rule": "N/A", "status": "Headings", "reason": "Pass", "recommendation": "Heading checks passed"}, {"level": "", "rule": "N/A", "status": "Language", "reason": "Pass", "recommendation": "Language checks passed"}, {"level": "", "rule": "N/A", "status": "Images", "reason": "Pass", "recommendation": "Image checks passed"}, {"level": "", "rule": "N/A", "status": "Forms", "reason": "Pass", "recommendation": "Forms checks passed"}, {"level": "", "rule": "N/A", "status": "Keyboard", "reason": "Pass", "recommendation": "Keyboard checks passed"}, {"level": "", "rule": "N/A", "status": "Videos", "reason": "Pass", "recommendation": "Video checks passed"}, {"level": "", "rule": "N/A", "status": "Contrast", "reason": "Pass", "recommendation": "Contrast checks passed"}, {"level": "", "rule": "N/A", "status": "Semantics", "reason": "Pass", "recommendation": "Semantic checks passed"}], "summary": {"pass": 1, "fail": 0, "warning": 0}}, {"page": "https://oauthapp.azurewebsites.net/password", "rows": [{"level": "", "rule": "Level", "status": "Rule", "reason": "Pass/Fail", "recommendation": "Reason"}, {"level": "", "rule": "---", "status": "---", "reason": "---", "recommendation": "---"}, {"level": "", "rule": "A", "status": "1.3.1: Info and Relationships", "reason": "Fail", "recommendation": "The `<ol>` element contains a `<pre>` element directly, which is not allowed."}, {"level": "", "rule": "A", "status": "4.1.2: Name, Role, Value", "reason": "Fail", "recommendation": "ARIA attributes are used to define a role of `img` but there is no accessible name provided."}, {"level": "", "rule": "A", "status": "4.1.2: Name, Role, Value", "reason": "Fail", "recommendation": "Duplicate ID."}, {"level": "", "rule": "A", "status": "1.1.1: Non-text Content", "reason": "N/A", "recommendation": "Some `<img>` elements with `role=\"img\"` are missing alternative text."}], "summary": {"pass": 0, "fail": 0, "warning": 0}}];
+const tableRows = [];
+const pageTables = {};
+const buttons = document.querySelectorAll(".filter-btn");
+
+// Functions
+function addRow(page, level, rule, status, reason, recommendation) {
+  if(!pageTables[page]) {
+    const container = document.getElementById("audit-tables");
+    const header = document.createElement("div");
+    header.className = "bg-gray-200 px-4 py-2 rounded cursor-pointer shadow";
+    header.innerHTML = `<h2 class="font-bold">${page}</h2>`;
+    const tableDiv = document.createElement("div");
+    tableDiv.className = "overflow-x-auto mt-2 hidden";
+    const table = document.createElement("table");
+    table.className = "min-w-full bg-white shadow rounded";
+    table.innerHTML = `
+      <thead class="bg-gray-100">
+        <tr>
+          <th class="px-4 py-2">Level</th>
+          <th class="px-4 py-2">Rule</th>
+          <th class="px-4 py-2">Pass/Fail</th>
+          <th class="px-4 py-2">Reason</th>
+          <th class="px-4 py-2">Recommendation</th>
+        </tr>
+      </thead>
+      <tbody></tbody>
+    `;
+    tableDiv.appendChild(table);
+    container.appendChild(header);
+    container.appendChild(tableDiv);
+    header.addEventListener("click", () => tableDiv.classList.toggle("hidden"));
+    pageTables[page] = table.querySelector("tbody");
+  }
+
+  const tbody = pageTables[page];
+  const tr = document.createElement("tr");
+  tr.className = "border-b";
+  tr.dataset.status = status.toLowerCase();
+  tr.dataset.page = page;
+  tr.innerHTML = `
+    <td class="px-4 py-2">${level}</td>
+    <td class="px-4 py-2">${rule}</td>
+    <td class="px-4 py-2 ${status.toLowerCase()}">${status}</td>
+    <td class="px-4 py-2">${reason}</td>
+    <td class="px-4 py-2">${recommendation}</td>
+  `;
+  tableRows.push(tr);
+  tbody.appendChild(tr);
+}
+
+function addSummaryCard(page, passed, failed, warning) {
+  const container = document.getElementById("summary-cards");
+  const total = passed + failed + warning;
+  const passRatio = total>0?passed/total:0;
+  let colorClass="bg-green-400";
+  if(passRatio<0.3) colorClass="bg-red-500";
+  else if(passRatio<0.7) colorClass="bg-yellow-400";
+  const passPercent = total>0?(passed/total*100):0;
+  const failPercent = total>0?(failed/total*100):0;
+  const warnPercent = total>0?(warning/total*100):0;
+
+  const card = document.createElement("div");
+  card.className="summary-card bg-white shadow p-4 rounded w-64 hover:shadow-lg";
+  card.innerHTML=`
+    <div class="flex justify-between items-center mb-2">
+      <h3 class="font-bold text-lg">${page}</h3>
+      <span class="px-2 py-1 text-white rounded ${colorClass}">Pass: ${passPercent.toFixed(0)}%</span>
+    </div>
+    <div class="flex h-3 mb-2 w-full rounded overflow-hidden shadow-inner">
+      <div class="bg-green-500 h-full" style="width:${passPercent}%;"></div>
+      <div class="bg-red-600 h-full" style="width:${failPercent}%;"></div>
+      <div class="bg-yellow-400 h-full" style="width:${warnPercent}%;"></div>
+    </div>
+    <div class="text-sm">
+      <p class="text-green-600">Passed: ${passed}</p>
+      <p class="text-red-600">Failed: ${failed}</p>
+      <p class="text-yellow-500">Warnings: ${warning}</p>
+    </div>
+  `;
+  card.addEventListener("click", ()=>{
+    const row = tableRows.find(r=>r.dataset.page===page);
+    if(row) row.scrollIntoView({behavior:"smooth", block:"start"});
+  });
+  container.appendChild(card);
+}
+
+function updateTable(filter){
+  Object.values(pageTables).forEach(tbody=>{
+    Array.from(tbody.children).forEach(row=>{
+      if(filter==="all"||row.dataset.status===filter) row.style.display="";
+      else row.style.display="none";
+    });
+  });
+}
+
+buttons.forEach(btn=>{
+  btn.addEventListener("click",()=>updateTable(btn.dataset.filter));
+});
+
+// Scroll to top
+const scrollBtn=document.getElementById("scrollTopBtn");
+scrollBtn.addEventListener("click",()=>window.scrollTo({top:0,behavior:"smooth"}));
+window.addEventListener("scroll",()=>{scrollBtn.style.display=window.scrollY>200?"block":"none";});
+scrollBtn.style.display="none";
+
+// Update totals in hero banner
+function updateTotals(passed, failed, warning){
+  document.getElementById("total-pass").innerText=passed;
+  document.getElementById("total-fail").innerText=failed;
+  document.getElementById("total-warning").innerText=warning;
+  const total=passed+failed+warning;
+  const ratio=total>0?passed/total:0;
+  const summaryEl=document.getElementById("summary");
+  summaryEl.classList.remove("text-green-500","text-yellow-400","text-red-500");
+  if(ratio<0.3) summaryEl.classList.add("text-red-500");
+  else if(ratio<0.7) summaryEl.classList.add("text-yellow-400");
+  else summaryEl.classList.add("text-green-500");
+}
+
+// Render dashboard from auditData
+auditData.forEach(pageData=>{
+  const page = pageData.page;
+  const rows = pageData.rows;
+  const summary = pageData.summary;
+  addSummaryCard(page, summary.pass, summary.fail, summary.warning);
+  rows.forEach(r=>addRow(page, r.level, r.rule, r.status, r.reason, r.recommendation));
+});
+
+// Update totals
+let totalPass=0,totalFail=0,totalWarning=0;
+auditData.forEach(p=>{
+  totalPass+=p.summary.pass;
+  totalFail+=p.summary.fail;
+  totalWarning+=p.summary.warning;
+});
+updateTotals(totalPass,totalFail,totalWarning);
+</script>
+
+</body>
+</html>

src/accessibility_v1/output/accessibility_dashboard_20251112_072100.html

@@ -0,0 +1,188 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+<meta charset="UTF-8">
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+<title>Accessibility Dashboard</title>
+<script src="https://cdn.tailwindcss.com"></script>
+<style>
+  .pass { color: #16a34a; }
+  .fail { color: #dc2626; }
+  .warning { color: #f59e0b; }
+  .summary-card { cursor: pointer; }
+</style>
+</head>
+<body class="bg-gray-100 font-sans">
+<header class="bg-blue-600 text-white p-6 shadow-md sticky top-0 z-50">
+  <h1 class="text-3xl font-bold" id="site-name">Site Accessibility Dashboard</h1>
+  <p class="mt-2" id="summary">
+    Summary: All Pages
+    | Passed: <span id="total-pass">0</span>
+    | Failed: <span id="total-fail">0</span>
+    | Warnings: <span id="total-warning">0</span>
+  </p>
+</header>
+
+<!-- Page Summary Cards -->
+<div class="flex flex-wrap gap-4 px-6 mb-4" id="summary-cards"></div>
+
+<!-- Filters -->
+<div class="flex space-x-4 mb-4 px-6">
+  <button class="filter-btn px-4 py-2 bg-gray-300 rounded" data-filter="all">All</button>
+  <button class="filter-btn px-4 py-2 bg-green-300 rounded" data-filter="pass">Passed</button>
+  <button class="filter-btn px-4 py-2 bg-red-300 rounded" data-filter="fail">Failed</button>
+  <button class="filter-btn px-4 py-2 bg-yellow-300 rounded" data-filter="warning">Warnings</button>
+</div>
+
+<!-- Audit Tables -->
+<div id="audit-tables" class="px-6 space-y-4"></div>
+
+<!-- Scroll-to-top button -->
+<button id="scrollTopBtn" 
+        class="fixed bottom-4 right-4 bg-blue-600 text-white px-4 py-2 rounded shadow-lg hover:bg-blue-700 transition-opacity opacity-75 hover:opacity-100">
+  ↑ Top
+</button>
+
+<!-- Inject audit data as JSON -->
+<script>
+const auditData = [{"page": "https://www.microsoft.com/en-us/dynamics-365/blog/?msockid=303a71da1b9a63221fb467ea1a1462a0", "rows": [{"level": "", "rule": "Level", "status": "Rule", "reason": "Pass/Fail", "recommendation": "Reason"}, {"level": "", "rule": "-----", "status": "--------------------------", "reason": "---------", "recommendation": "----------------------------------------------------------"}, {"level": "", "rule": "A", "status": "Document Title", "reason": "Pass", "recommendation": "Document has a non-empty `<title>` element"}, {"level": "", "rule": "A", "status": "HTML has lang", "reason": "Pass", "recommendation": "The `<html>` element has a lang attribute"}, {"level": "", "rule": "A", "status": "HTML lang valid", "reason": "Pass", "recommendation": "The lang attribute of the `<html>` element has a valid value"}, {"level": "", "rule": "A", "status": "Bypass Blocks", "reason": "Pass", "recommendation": "Page has a heading and a landmark region"}, {"level": "", "rule": "AA", "status": "Color Contrast", "reason": "Pass", "recommendation": "Elements have sufficient color contrast"}, {"level": "", "rule": "AA", "status": "Meta Viewport", "reason": "Pass", "recommendation": "`<meta>` tag does not disable zooming on mobile devices"}, {"level": "", "rule": "A", "status": "Image Alt", "reason": "Fail", "recommendation": "Missing alternative text for some images"}, {"level": "", "rule": "A", "status": "Form Label", "reason": "Fail", "recommendation": "Form field missing a label"}, {"level": "", "rule": "A", "status": "ARIA Attributes", "reason": "Pass", "recommendation": "ARIA attributes are valid."}, {"level": "", "rule": "A", "status": "ARIA Roles", "reason": "Pass", "recommendation": "ARIA roles used are valid."}, {"level": "", "rule": "A", "status": "ARIA Required Attributes", "reason": "Pass", "recommendation": "Required ARIA attributes are present."}, {"level": "", "rule": "A", "status": "Unique ARIA ID", "reason": "Pass", "recommendation": "No duplicate ARIA IDs"}, {"level": "", "rule": "A", "status": "List Structure", "reason": "Pass", "recommendation": "Lists are structured correctly"}, {"level": "", "rule": "A", "status": "List Item Structure", "reason": "Pass", "recommendation": "List items are contained in a `<ul>` or `<ol>`"}, {"level": "", "rule": "A", "status": "Link Text", "reason": "Pass", "recommendation": "Links have discernible text"}, {"level": "", "rule": "A", "status": "Button Text", "reason": "Pass", "recommendation": "Buttons have discernible text"}, {"level": "", "rule": "A", "status": "Nested Interactive", "reason": "Pass", "recommendation": "No nested interactive elements"}, {"level": "", "rule": "A", "status": "SVG Alternative Text", "reason": "Pass", "recommendation": "SVG images have an alternative text"}, {"level": "", "rule": "A", "status": "Heading Order", "reason": "Fail", "recommendation": "Heading level should be one greater than previous heading"}], "summary": {"pass": 1, "fail": 0, "warning": 0}}];
+const tableRows = [];
+const pageTables = {};
+const buttons = document.querySelectorAll(".filter-btn");
+
+// Functions
+function addRow(page, level, rule, status, reason, recommendation) {
+  if(!pageTables[page]) {
+    const container = document.getElementById("audit-tables");
+    const header = document.createElement("div");
+    header.className = "bg-gray-200 px-4 py-2 rounded cursor-pointer shadow";
+    header.innerHTML = `<h2 class="font-bold">${page}</h2>`;
+    const tableDiv = document.createElement("div");
+    tableDiv.className = "overflow-x-auto mt-2 hidden";
+    const table = document.createElement("table");
+    table.className = "min-w-full bg-white shadow rounded";
+    table.innerHTML = `
+      <thead class="bg-gray-100">
+        <tr>
+          <th class="px-4 py-2">Level</th>
+          <th class="px-4 py-2">Rule</th>
+          <th class="px-4 py-2">Pass/Fail</th>
+          <th class="px-4 py-2">Reason</th>
+          <th class="px-4 py-2">Recommendation</th>
+        </tr>
+      </thead>
+      <tbody></tbody>
+    `;
+    tableDiv.appendChild(table);
+    container.appendChild(header);
+    container.appendChild(tableDiv);
+    header.addEventListener("click", () => tableDiv.classList.toggle("hidden"));
+    pageTables[page] = table.querySelector("tbody");
+  }
+
+  const tbody = pageTables[page];
+  const tr = document.createElement("tr");
+  tr.className = "border-b";
+  tr.dataset.status = status.toLowerCase();
+  tr.dataset.page = page;
+  tr.innerHTML = `
+    <td class="px-4 py-2">${level}</td>
+    <td class="px-4 py-2">${rule}</td>
+    <td class="px-4 py-2 ${status.toLowerCase()}">${status}</td>
+    <td class="px-4 py-2">${reason}</td>
+    <td class="px-4 py-2">${recommendation}</td>
+  `;
+  tableRows.push(tr);
+  tbody.appendChild(tr);
+}
+
+function addSummaryCard(page, passed, failed, warning) {
+  const container = document.getElementById("summary-cards");
+  const total = passed + failed + warning;
+  const passRatio = total>0?passed/total:0;
+  let colorClass="bg-green-400";
+  if(passRatio<0.3) colorClass="bg-red-500";
+  else if(passRatio<0.7) colorClass="bg-yellow-400";
+  const passPercent = total>0?(passed/total*100):0;
+  const failPercent = total>0?(failed/total*100):0;
+  const warnPercent = total>0?(warning/total*100):0;
+
+  const card = document.createElement("div");
+  card.className="summary-card bg-white shadow p-4 rounded w-64 hover:shadow-lg";
+  card.innerHTML=`
+    <div class="flex justify-between items-center mb-2">
+      <h3 class="font-bold text-lg">${page}</h3>
+      <span class="px-2 py-1 text-white rounded ${colorClass}">Pass: ${passPercent.toFixed(0)}%</span>
+    </div>
+    <div class="flex h-3 mb-2 w-full rounded overflow-hidden shadow-inner">
+      <div class="bg-green-500 h-full" style="width:${passPercent}%;"></div>
+      <div class="bg-red-600 h-full" style="width:${failPercent}%;"></div>
+      <div class="bg-yellow-400 h-full" style="width:${warnPercent}%;"></div>
+    </div>
+    <div class="text-sm">
+      <p class="text-green-600">Passed: ${passed}</p>
+      <p class="text-red-600">Failed: ${failed}</p>
+      <p class="text-yellow-500">Warnings: ${warning}</p>
+    </div>
+  `;
+  card.addEventListener("click", ()=>{
+    const row = tableRows.find(r=>r.dataset.page===page);
+    if(row) row.scrollIntoView({behavior:"smooth", block:"start"});
+  });
+  container.appendChild(card);
+}
+
+function updateTable(filter){
+  Object.values(pageTables).forEach(tbody=>{
+    Array.from(tbody.children).forEach(row=>{
+      if(filter==="all"||row.dataset.status===filter) row.style.display="";
+      else row.style.display="none";
+    });
+  });
+}
+
+buttons.forEach(btn=>{
+  btn.addEventListener("click",()=>updateTable(btn.dataset.filter));
+});
+
+// Scroll to top
+const scrollBtn=document.getElementById("scrollTopBtn");
+scrollBtn.addEventListener("click",()=>window.scrollTo({top:0,behavior:"smooth"}));
+window.addEventListener("scroll",()=>{scrollBtn.style.display=window.scrollY>200?"block":"none";});
+scrollBtn.style.display="none";
+
+// Update totals in hero banner
+function updateTotals(passed, failed, warning){
+  document.getElementById("total-pass").innerText=passed;
+  document.getElementById("total-fail").innerText=failed;
+  document.getElementById("total-warning").innerText=warning;
+  const total=passed+failed+warning;
+  const ratio=total>0?passed/total:0;
+  const summaryEl=document.getElementById("summary");
+  summaryEl.classList.remove("text-green-500","text-yellow-400","text-red-500");
+  if(ratio<0.3) summaryEl.classList.add("text-red-500");
+  else if(ratio<0.7) summaryEl.classList.add("text-yellow-400");
+  else summaryEl.classList.add("text-green-500");
+}
+
+// Render dashboard from auditData
+auditData.forEach(pageData=>{
+  const page = pageData.page;
+  const rows = pageData.rows;
+  const summary = pageData.summary;
+  addSummaryCard(page, summary.pass, summary.fail, summary.warning);
+  rows.forEach(r=>addRow(page, r.level, r.rule, r.status, r.reason, r.recommendation));
+});
+
+// Update totals
+let totalPass=0,totalFail=0,totalWarning=0;
+auditData.forEach(p=>{
+  totalPass+=p.summary.pass;
+  totalFail+=p.summary.fail;
+  totalWarning+=p.summary.warning;
+});
+updateTotals(totalPass,totalFail,totalWarning);
+</script>
+
+</body>
+</html>

src/accessibility_v1/output/accessibility_dashboard_20251211_051059.html

@@ -0,0 +1,188 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+<meta charset="UTF-8">
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+<title>Accessibility Dashboard</title>
+<script src="https://cdn.tailwindcss.com"></script>
+<style>
+  .pass { color: #16a34a; }
+  .fail { color: #dc2626; }
+  .warning { color: #f59e0b; }
+  .summary-card { cursor: pointer; }
+</style>
+</head>
+<body class="bg-gray-100 font-sans">
+<header class="bg-blue-600 text-white p-6 shadow-md sticky top-0 z-50">
+  <h1 class="text-3xl font-bold" id="site-name">Site Accessibility Dashboard</h1>
+  <p class="mt-2" id="summary">
+    Summary: All Pages
+    | Passed: <span id="total-pass">0</span>
+    | Failed: <span id="total-fail">0</span>
+    | Warnings: <span id="total-warning">0</span>
+  </p>
+</header>
+
+<!-- Page Summary Cards -->
+<div class="flex flex-wrap gap-4 px-6 mb-4" id="summary-cards"></div>
+
+<!-- Filters -->
+<div class="flex space-x-4 mb-4 px-6">
+  <button class="filter-btn px-4 py-2 bg-gray-300 rounded" data-filter="all">All</button>
+  <button class="filter-btn px-4 py-2 bg-green-300 rounded" data-filter="pass">Passed</button>
+  <button class="filter-btn px-4 py-2 bg-red-300 rounded" data-filter="fail">Failed</button>
+  <button class="filter-btn px-4 py-2 bg-yellow-300 rounded" data-filter="warning">Warnings</button>
+</div>
+
+<!-- Audit Tables -->
+<div id="audit-tables" class="px-6 space-y-4"></div>
+
+<!-- Scroll-to-top button -->
+<button id="scrollTopBtn" 
+        class="fixed bottom-4 right-4 bg-blue-600 text-white px-4 py-2 rounded shadow-lg hover:bg-blue-700 transition-opacity opacity-75 hover:opacity-100">
+  ↑ Top
+</button>
+
+<!-- Inject audit data as JSON -->
+<script>
+const auditData = [{"page": "https://oauthapp.azurewebsites.net/", "rows": [], "summary": {"pass": 0, "fail": 0, "warning": 0}}, {"page": "https://oauthapp.azurewebsites.net/code", "rows": [], "summary": {"pass": 0, "fail": 0, "warning": 0}}, {"page": "https://oauthapp.azurewebsites.net/credential", "rows": [], "summary": {"pass": 0, "fail": 0, "warning": 0}}, {"page": "https://oauthapp.azurewebsites.net/implicit", "rows": [], "summary": {"pass": 0, "fail": 0, "warning": 0}}, {"page": "https://oauthapp.azurewebsites.net/password", "rows": [], "summary": {"pass": 0, "fail": 0, "warning": 0}}];
+const tableRows = [];
+const pageTables = {};
+const buttons = document.querySelectorAll(".filter-btn");
+
+// Functions
+function addRow(page, level, rule, status, reason, recommendation) {
+  if(!pageTables[page]) {
+    const container = document.getElementById("audit-tables");
+    const header = document.createElement("div");
+    header.className = "bg-gray-200 px-4 py-2 rounded cursor-pointer shadow";
+    header.innerHTML = `<h2 class="font-bold">${page}</h2>`;
+    const tableDiv = document.createElement("div");
+    tableDiv.className = "overflow-x-auto mt-2 hidden";
+    const table = document.createElement("table");
+    table.className = "min-w-full bg-white shadow rounded";
+    table.innerHTML = `
+      <thead class="bg-gray-100">
+        <tr>
+          <th class="px-4 py-2">Level</th>
+          <th class="px-4 py-2">Rule</th>
+          <th class="px-4 py-2">Pass/Fail</th>
+          <th class="px-4 py-2">Reason</th>
+          <th class="px-4 py-2">Recommendation</th>
+        </tr>
+      </thead>
+      <tbody></tbody>
+    `;
+    tableDiv.appendChild(table);
+    container.appendChild(header);
+    container.appendChild(tableDiv);
+    header.addEventListener("click", () => tableDiv.classList.toggle("hidden"));
+    pageTables[page] = table.querySelector("tbody");
+  }
+
+  const tbody = pageTables[page];
+  const tr = document.createElement("tr");
+  tr.className = "border-b";
+  tr.dataset.status = status.toLowerCase();
+  tr.dataset.page = page;
+  tr.innerHTML = `
+    <td class="px-4 py-2">${level}</td>
+    <td class="px-4 py-2">${rule}</td>
+    <td class="px-4 py-2 ${status.toLowerCase()}">${status}</td>
+    <td class="px-4 py-2">${reason}</td>
+    <td class="px-4 py-2">${recommendation}</td>
+  `;
+  tableRows.push(tr);
+  tbody.appendChild(tr);
+}
+
+function addSummaryCard(page, passed, failed, warning) {
+  const container = document.getElementById("summary-cards");
+  const total = passed + failed + warning;
+  const passRatio = total>0?passed/total:0;
+  let colorClass="bg-green-400";
+  if(passRatio<0.3) colorClass="bg-red-500";
+  else if(passRatio<0.7) colorClass="bg-yellow-400";
+  const passPercent = total>0?(passed/total*100):0;
+  const failPercent = total>0?(failed/total*100):0;
+  const warnPercent = total>0?(warning/total*100):0;
+
+  const card = document.createElement("div");
+  card.className="summary-card bg-white shadow p-4 rounded w-64 hover:shadow-lg";
+  card.innerHTML=`
+    <div class="flex justify-between items-center mb-2">
+      <h3 class="font-bold text-lg">${page}</h3>
+      <span class="px-2 py-1 text-white rounded ${colorClass}">Pass: ${passPercent.toFixed(0)}%</span>
+    </div>
+    <div class="flex h-3 mb-2 w-full rounded overflow-hidden shadow-inner">
+      <div class="bg-green-500 h-full" style="width:${passPercent}%;"></div>
+      <div class="bg-red-600 h-full" style="width:${failPercent}%;"></div>
+      <div class="bg-yellow-400 h-full" style="width:${warnPercent}%;"></div>
+    </div>
+    <div class="text-sm">
+      <p class="text-green-600">Passed: ${passed}</p>
+      <p class="text-red-600">Failed: ${failed}</p>
+      <p class="text-yellow-500">Warnings: ${warning}</p>
+    </div>
+  `;
+  card.addEventListener("click", ()=>{
+    const row = tableRows.find(r=>r.dataset.page===page);
+    if(row) row.scrollIntoView({behavior:"smooth", block:"start"});
+  });
+  container.appendChild(card);
+}
+
+function updateTable(filter){
+  Object.values(pageTables).forEach(tbody=>{
+    Array.from(tbody.children).forEach(row=>{
+      if(filter==="all"||row.dataset.status===filter) row.style.display="";
+      else row.style.display="none";
+    });
+  });
+}
+
+buttons.forEach(btn=>{
+  btn.addEventListener("click",()=>updateTable(btn.dataset.filter));
+});
+
+// Scroll to top
+const scrollBtn=document.getElementById("scrollTopBtn");
+scrollBtn.addEventListener("click",()=>window.scrollTo({top:0,behavior:"smooth"}));
+window.addEventListener("scroll",()=>{scrollBtn.style.display=window.scrollY>200?"block":"none";});
+scrollBtn.style.display="none";
+
+// Update totals in hero banner
+function updateTotals(passed, failed, warning){
+  document.getElementById("total-pass").innerText=passed;
+  document.getElementById("total-fail").innerText=failed;
+  document.getElementById("total-warning").innerText=warning;
+  const total=passed+failed+warning;
+  const ratio=total>0?passed/total:0;
+  const summaryEl=document.getElementById("summary");
+  summaryEl.classList.remove("text-green-500","text-yellow-400","text-red-500");
+  if(ratio<0.3) summaryEl.classList.add("text-red-500");
+  else if(ratio<0.7) summaryEl.classList.add("text-yellow-400");
+  else summaryEl.classList.add("text-green-500");
+}
+
+// Render dashboard from auditData
+auditData.forEach(pageData=>{
+  const page = pageData.page;
+  const rows = pageData.rows;
+  const summary = pageData.summary;
+  addSummaryCard(page, summary.pass, summary.fail, summary.warning);
+  rows.forEach(r=>addRow(page, r.level, r.rule, r.status, r.reason, r.recommendation));
+});
+
+// Update totals
+let totalPass=0,totalFail=0,totalWarning=0;
+auditData.forEach(p=>{
+  totalPass+=p.summary.pass;
+  totalFail+=p.summary.fail;
+  totalWarning+=p.summary.warning;
+});
+updateTotals(totalPass,totalFail,totalWarning);
+</script>
+
+</body>
+</html>

src/accessibility_v1/output/accessibility_dashboard_20251211_051323.html

@@ -0,0 +1,188 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+<meta charset="UTF-8">
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+<title>Accessibility Dashboard</title>
+<script src="https://cdn.tailwindcss.com"></script>
+<style>
+  .pass { color: #16a34a; }
+  .fail { color: #dc2626; }
+  .warning { color: #f59e0b; }
+  .summary-card { cursor: pointer; }
+</style>
+</head>
+<body class="bg-gray-100 font-sans">
+<header class="bg-blue-600 text-white p-6 shadow-md sticky top-0 z-50">
+  <h1 class="text-3xl font-bold" id="site-name">Site Accessibility Dashboard</h1>
+  <p class="mt-2" id="summary">
+    Summary: All Pages
+    | Passed: <span id="total-pass">0</span>
+    | Failed: <span id="total-fail">0</span>
+    | Warnings: <span id="total-warning">0</span>
+  </p>
+</header>
+
+<!-- Page Summary Cards -->
+<div class="flex flex-wrap gap-4 px-6 mb-4" id="summary-cards"></div>
+
+<!-- Filters -->
+<div class="flex space-x-4 mb-4 px-6">
+  <button class="filter-btn px-4 py-2 bg-gray-300 rounded" data-filter="all">All</button>
+  <button class="filter-btn px-4 py-2 bg-green-300 rounded" data-filter="pass">Passed</button>
+  <button class="filter-btn px-4 py-2 bg-red-300 rounded" data-filter="fail">Failed</button>
+  <button class="filter-btn px-4 py-2 bg-yellow-300 rounded" data-filter="warning">Warnings</button>
+</div>
+
+<!-- Audit Tables -->
+<div id="audit-tables" class="px-6 space-y-4"></div>
+
+<!-- Scroll-to-top button -->
+<button id="scrollTopBtn" 
+        class="fixed bottom-4 right-4 bg-blue-600 text-white px-4 py-2 rounded shadow-lg hover:bg-blue-700 transition-opacity opacity-75 hover:opacity-100">
+  ↑ Top
+</button>
+
+<!-- Inject audit data as JSON -->
+<script>
+const auditData = [{"page": "https://oauthapp.azurewebsites.net/", "rows": [], "summary": {"pass": 0, "fail": 0, "warning": 0}}, {"page": "https://oauthapp.azurewebsites.net/code", "rows": [], "summary": {"pass": 0, "fail": 0, "warning": 0}}, {"page": "https://oauthapp.azurewebsites.net/credential", "rows": [], "summary": {"pass": 0, "fail": 0, "warning": 0}}, {"page": "https://oauthapp.azurewebsites.net/implicit", "rows": [], "summary": {"pass": 0, "fail": 0, "warning": 0}}, {"page": "https://oauthapp.azurewebsites.net/password", "rows": [], "summary": {"pass": 0, "fail": 0, "warning": 0}}];
+const tableRows = [];
+const pageTables = {};
+const buttons = document.querySelectorAll(".filter-btn");
+
+// Functions
+function addRow(page, level, rule, status, reason, recommendation) {
+  if(!pageTables[page]) {
+    const container = document.getElementById("audit-tables");
+    const header = document.createElement("div");
+    header.className = "bg-gray-200 px-4 py-2 rounded cursor-pointer shadow";
+    header.innerHTML = `<h2 class="font-bold">${page}</h2>`;
+    const tableDiv = document.createElement("div");
+    tableDiv.className = "overflow-x-auto mt-2 hidden";
+    const table = document.createElement("table");
+    table.className = "min-w-full bg-white shadow rounded";
+    table.innerHTML = `
+      <thead class="bg-gray-100">
+        <tr>
+          <th class="px-4 py-2">Level</th>
+          <th class="px-4 py-2">Rule</th>
+          <th class="px-4 py-2">Pass/Fail</th>
+          <th class="px-4 py-2">Reason</th>
+          <th class="px-4 py-2">Recommendation</th>
+        </tr>
+      </thead>
+      <tbody></tbody>
+    `;
+    tableDiv.appendChild(table);
+    container.appendChild(header);
+    container.appendChild(tableDiv);
+    header.addEventListener("click", () => tableDiv.classList.toggle("hidden"));
+    pageTables[page] = table.querySelector("tbody");
+  }
+
+  const tbody = pageTables[page];
+  const tr = document.createElement("tr");
+  tr.className = "border-b";
+  tr.dataset.status = status.toLowerCase();
+  tr.dataset.page = page;
+  tr.innerHTML = `
+    <td class="px-4 py-2">${level}</td>
+    <td class="px-4 py-2">${rule}</td>
+    <td class="px-4 py-2 ${status.toLowerCase()}">${status}</td>
+    <td class="px-4 py-2">${reason}</td>
+    <td class="px-4 py-2">${recommendation}</td>
+  `;
+  tableRows.push(tr);
+  tbody.appendChild(tr);
+}
+
+function addSummaryCard(page, passed, failed, warning) {
+  const container = document.getElementById("summary-cards");
+  const total = passed + failed + warning;
+  const passRatio = total>0?passed/total:0;
+  let colorClass="bg-green-400";
+  if(passRatio<0.3) colorClass="bg-red-500";
+  else if(passRatio<0.7) colorClass="bg-yellow-400";
+  const passPercent = total>0?(passed/total*100):0;
+  const failPercent = total>0?(failed/total*100):0;
+  const warnPercent = total>0?(warning/total*100):0;
+
+  const card = document.createElement("div");
+  card.className="summary-card bg-white shadow p-4 rounded w-64 hover:shadow-lg";
+  card.innerHTML=`
+    <div class="flex justify-between items-center mb-2">
+      <h3 class="font-bold text-lg">${page}</h3>
+      <span class="px-2 py-1 text-white rounded ${colorClass}">Pass: ${passPercent.toFixed(0)}%</span>
+    </div>
+    <div class="flex h-3 mb-2 w-full rounded overflow-hidden shadow-inner">
+      <div class="bg-green-500 h-full" style="width:${passPercent}%;"></div>
+      <div class="bg-red-600 h-full" style="width:${failPercent}%;"></div>
+      <div class="bg-yellow-400 h-full" style="width:${warnPercent}%;"></div>
+    </div>
+    <div class="text-sm">
+      <p class="text-green-600">Passed: ${passed}</p>
+      <p class="text-red-600">Failed: ${failed}</p>
+      <p class="text-yellow-500">Warnings: ${warning}</p>
+    </div>
+  `;
+  card.addEventListener("click", ()=>{
+    const row = tableRows.find(r=>r.dataset.page===page);
+    if(row) row.scrollIntoView({behavior:"smooth", block:"start"});
+  });
+  container.appendChild(card);
+}
+
+function updateTable(filter){
+  Object.values(pageTables).forEach(tbody=>{
+    Array.from(tbody.children).forEach(row=>{
+      if(filter==="all"||row.dataset.status===filter) row.style.display="";
+      else row.style.display="none";
+    });
+  });
+}
+
+buttons.forEach(btn=>{
+  btn.addEventListener("click",()=>updateTable(btn.dataset.filter));
+});
+
+// Scroll to top
+const scrollBtn=document.getElementById("scrollTopBtn");
+scrollBtn.addEventListener("click",()=>window.scrollTo({top:0,behavior:"smooth"}));
+window.addEventListener("scroll",()=>{scrollBtn.style.display=window.scrollY>200?"block":"none";});
+scrollBtn.style.display="none";
+
+// Update totals in hero banner
+function updateTotals(passed, failed, warning){
+  document.getElementById("total-pass").innerText=passed;
+  document.getElementById("total-fail").innerText=failed;
+  document.getElementById("total-warning").innerText=warning;
+  const total=passed+failed+warning;
+  const ratio=total>0?passed/total:0;
+  const summaryEl=document.getElementById("summary");
+  summaryEl.classList.remove("text-green-500","text-yellow-400","text-red-500");
+  if(ratio<0.3) summaryEl.classList.add("text-red-500");
+  else if(ratio<0.7) summaryEl.classList.add("text-yellow-400");
+  else summaryEl.classList.add("text-green-500");
+}
+
+// Render dashboard from auditData
+auditData.forEach(pageData=>{
+  const page = pageData.page;
+  const rows = pageData.rows;
+  const summary = pageData.summary;
+  addSummaryCard(page, summary.pass, summary.fail, summary.warning);
+  rows.forEach(r=>addRow(page, r.level, r.rule, r.status, r.reason, r.recommendation));
+});
+
+// Update totals
+let totalPass=0,totalFail=0,totalWarning=0;
+auditData.forEach(p=>{
+  totalPass+=p.summary.pass;
+  totalFail+=p.summary.fail;
+  totalWarning+=p.summary.warning;
+});
+updateTotals(totalPass,totalFail,totalWarning);
+</script>
+
+</body>
+</html>

src/accessibility_v1/output/accessibility_dashboard_20251211_052404.html

@@ -0,0 +1,188 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+<meta charset="UTF-8">
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+<title>Accessibility Dashboard</title>
+<script src="https://cdn.tailwindcss.com"></script>
+<style>
+  .pass { color: #16a34a; }
+  .fail { color: #dc2626; }
+  .warning { color: #f59e0b; }
+  .summary-card { cursor: pointer; }
+</style>
+</head>
+<body class="bg-gray-100 font-sans">
+<header class="bg-blue-600 text-white p-6 shadow-md sticky top-0 z-50">
+  <h1 class="text-3xl font-bold" id="site-name">Site Accessibility Dashboard</h1>
+  <p class="mt-2" id="summary">
+    Summary: All Pages
+    | Passed: <span id="total-pass">0</span>
+    | Failed: <span id="total-fail">0</span>
+    | Warnings: <span id="total-warning">0</span>
+  </p>
+</header>
+
+<!-- Page Summary Cards -->
+<div class="flex flex-wrap gap-4 px-6 mb-4" id="summary-cards"></div>
+
+<!-- Filters -->
+<div class="flex space-x-4 mb-4 px-6">
+  <button class="filter-btn px-4 py-2 bg-gray-300 rounded" data-filter="all">All</button>
+  <button class="filter-btn px-4 py-2 bg-green-300 rounded" data-filter="pass">Passed</button>
+  <button class="filter-btn px-4 py-2 bg-red-300 rounded" data-filter="fail">Failed</button>
+  <button class="filter-btn px-4 py-2 bg-yellow-300 rounded" data-filter="warning">Warnings</button>
+</div>
+
+<!-- Audit Tables -->
+<div id="audit-tables" class="px-6 space-y-4"></div>
+
+<!-- Scroll-to-top button -->
+<button id="scrollTopBtn" 
+        class="fixed bottom-4 right-4 bg-blue-600 text-white px-4 py-2 rounded shadow-lg hover:bg-blue-700 transition-opacity opacity-75 hover:opacity-100">
+  ↑ Top
+</button>
+
+<!-- Inject audit data as JSON -->
+<script>
+const auditData = [{"page": "https://oauthapp.azurewebsites.net/", "rows": [], "summary": {"pass": 0, "fail": 0, "warning": 0}}, {"page": "https://oauthapp.azurewebsites.net/code", "rows": [], "summary": {"pass": 0, "fail": 0, "warning": 0}}, {"page": "https://oauthapp.azurewebsites.net/credential", "rows": [], "summary": {"pass": 0, "fail": 0, "warning": 0}}, {"page": "https://oauthapp.azurewebsites.net/implicit", "rows": [], "summary": {"pass": 0, "fail": 0, "warning": 0}}, {"page": "https://oauthapp.azurewebsites.net/password", "rows": [], "summary": {"pass": 0, "fail": 0, "warning": 0}}];
+const tableRows = [];
+const pageTables = {};
+const buttons = document.querySelectorAll(".filter-btn");
+
+// Functions
+function addRow(page, level, rule, status, reason, recommendation) {
+  if(!pageTables[page]) {
+    const container = document.getElementById("audit-tables");
+    const header = document.createElement("div");
+    header.className = "bg-gray-200 px-4 py-2 rounded cursor-pointer shadow";
+    header.innerHTML = `<h2 class="font-bold">${page}</h2>`;
+    const tableDiv = document.createElement("div");
+    tableDiv.className = "overflow-x-auto mt-2 hidden";
+    const table = document.createElement("table");
+    table.className = "min-w-full bg-white shadow rounded";
+    table.innerHTML = `
+      <thead class="bg-gray-100">
+        <tr>
+          <th class="px-4 py-2">Level</th>
+          <th class="px-4 py-2">Rule</th>
+          <th class="px-4 py-2">Pass/Fail</th>
+          <th class="px-4 py-2">Reason</th>
+          <th class="px-4 py-2">Recommendation</th>
+        </tr>
+      </thead>
+      <tbody></tbody>
+    `;
+    tableDiv.appendChild(table);
+    container.appendChild(header);
+    container.appendChild(tableDiv);
+    header.addEventListener("click", () => tableDiv.classList.toggle("hidden"));
+    pageTables[page] = table.querySelector("tbody");
+  }
+
+  const tbody = pageTables[page];
+  const tr = document.createElement("tr");
+  tr.className = "border-b";
+  tr.dataset.status = status.toLowerCase();
+  tr.dataset.page = page;
+  tr.innerHTML = `
+    <td class="px-4 py-2">${level}</td>
+    <td class="px-4 py-2">${rule}</td>
+    <td class="px-4 py-2 ${status.toLowerCase()}">${status}</td>
+    <td class="px-4 py-2">${reason}</td>
+    <td class="px-4 py-2">${recommendation}</td>
+  `;
+  tableRows.push(tr);
+  tbody.appendChild(tr);
+}
+
+function addSummaryCard(page, passed, failed, warning) {
+  const container = document.getElementById("summary-cards");
+  const total = passed + failed + warning;
+  const passRatio = total>0?passed/total:0;
+  let colorClass="bg-green-400";
+  if(passRatio<0.3) colorClass="bg-red-500";
+  else if(passRatio<0.7) colorClass="bg-yellow-400";
+  const passPercent = total>0?(passed/total*100):0;
+  const failPercent = total>0?(failed/total*100):0;
+  const warnPercent = total>0?(warning/total*100):0;
+
+  const card = document.createElement("div");
+  card.className="summary-card bg-white shadow p-4 rounded w-64 hover:shadow-lg";
+  card.innerHTML=`
+    <div class="flex justify-between items-center mb-2">
+      <h3 class="font-bold text-lg">${page}</h3>
+      <span class="px-2 py-1 text-white rounded ${colorClass}">Pass: ${passPercent.toFixed(0)}%</span>
+    </div>
+    <div class="flex h-3 mb-2 w-full rounded overflow-hidden shadow-inner">
+      <div class="bg-green-500 h-full" style="width:${passPercent}%;"></div>
+      <div class="bg-red-600 h-full" style="width:${failPercent}%;"></div>
+      <div class="bg-yellow-400 h-full" style="width:${warnPercent}%;"></div>
+    </div>
+    <div class="text-sm">
+      <p class="text-green-600">Passed: ${passed}</p>
+      <p class="text-red-600">Failed: ${failed}</p>
+      <p class="text-yellow-500">Warnings: ${warning}</p>
+    </div>
+  `;
+  card.addEventListener("click", ()=>{
+    const row = tableRows.find(r=>r.dataset.page===page);
+    if(row) row.scrollIntoView({behavior:"smooth", block:"start"});
+  });
+  container.appendChild(card);
+}
+
+function updateTable(filter){
+  Object.values(pageTables).forEach(tbody=>{
+    Array.from(tbody.children).forEach(row=>{
+      if(filter==="all"||row.dataset.status===filter) row.style.display="";
+      else row.style.display="none";
+    });
+  });
+}
+
+buttons.forEach(btn=>{
+  btn.addEventListener("click",()=>updateTable(btn.dataset.filter));
+});
+
+// Scroll to top
+const scrollBtn=document.getElementById("scrollTopBtn");
+scrollBtn.addEventListener("click",()=>window.scrollTo({top:0,behavior:"smooth"}));
+window.addEventListener("scroll",()=>{scrollBtn.style.display=window.scrollY>200?"block":"none";});
+scrollBtn.style.display="none";
+
+// Update totals in hero banner
+function updateTotals(passed, failed, warning){
+  document.getElementById("total-pass").innerText=passed;
+  document.getElementById("total-fail").innerText=failed;
+  document.getElementById("total-warning").innerText=warning;
+  const total=passed+failed+warning;
+  const ratio=total>0?passed/total:0;
+  const summaryEl=document.getElementById("summary");
+  summaryEl.classList.remove("text-green-500","text-yellow-400","text-red-500");
+  if(ratio<0.3) summaryEl.classList.add("text-red-500");
+  else if(ratio<0.7) summaryEl.classList.add("text-yellow-400");
+  else summaryEl.classList.add("text-green-500");
+}
+
+// Render dashboard from auditData
+auditData.forEach(pageData=>{
+  const page = pageData.page;
+  const rows = pageData.rows;
+  const summary = pageData.summary;
+  addSummaryCard(page, summary.pass, summary.fail, summary.warning);
+  rows.forEach(r=>addRow(page, r.level, r.rule, r.status, r.reason, r.recommendation));
+});
+
+// Update totals
+let totalPass=0,totalFail=0,totalWarning=0;
+auditData.forEach(p=>{
+  totalPass+=p.summary.pass;
+  totalFail+=p.summary.fail;
+  totalWarning+=p.summary.warning;
+});
+updateTotals(totalPass,totalFail,totalWarning);
+</script>
+
+</body>
+</html>

src/accessibility_v1/templates/dashboard_template.html

@@ -0,0 +1,188 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+<meta charset="UTF-8">
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+<title>Accessibility Dashboard</title>
+<script src="https://cdn.tailwindcss.com"></script>
+<style>
+  .pass { color: #16a34a; }
+  .fail { color: #dc2626; }
+  .warning { color: #f59e0b; }
+  .summary-card { cursor: pointer; }
+</style>
+</head>
+<body class="bg-gray-100 font-sans">
+<header class="bg-blue-600 text-white p-6 shadow-md sticky top-0 z-50">
+  <h1 class="text-3xl font-bold" id="site-name">Site Accessibility Dashboard</h1>
+  <p class="mt-2" id="summary">
+    Summary: All Pages
+    | Passed: <span id="total-pass">0</span>
+    | Failed: <span id="total-fail">0</span>
+    | Warnings: <span id="total-warning">0</span>
+  </p>
+</header>
+
+<!-- Page Summary Cards -->
+<div class="flex flex-wrap gap-4 px-6 mb-4" id="summary-cards"></div>
+
+<!-- Filters -->
+<div class="flex space-x-4 mb-4 px-6">
+  <button class="filter-btn px-4 py-2 bg-gray-300 rounded" data-filter="all">All</button>
+  <button class="filter-btn px-4 py-2 bg-green-300 rounded" data-filter="pass">Passed</button>
+  <button class="filter-btn px-4 py-2 bg-red-300 rounded" data-filter="fail">Failed</button>
+  <button class="filter-btn px-4 py-2 bg-yellow-300 rounded" data-filter="warning">Warnings</button>
+</div>
+
+<!-- Audit Tables -->
+<div id="audit-tables" class="px-6 space-y-4"></div>
+
+<!-- Scroll-to-top button -->
+<button id="scrollTopBtn" 
+        class="fixed bottom-4 right-4 bg-blue-600 text-white px-4 py-2 rounded shadow-lg hover:bg-blue-700 transition-opacity opacity-75 hover:opacity-100">
+  ↑ Top
+</button>
+
+<!-- Inject audit data as JSON -->
+<script>
+const auditData = <!--AUDIT_JSON_PLACEHOLDER-->;
+const tableRows = [];
+const pageTables = {};
+const buttons = document.querySelectorAll(".filter-btn");
+
+// Functions
+function addRow(page, level, rule, status, reason, recommendation) {
+  if(!pageTables[page]) {
+    const container = document.getElementById("audit-tables");
+    const header = document.createElement("div");
+    header.className = "bg-gray-200 px-4 py-2 rounded cursor-pointer shadow";
+    header.innerHTML = `<h2 class="font-bold">${page}</h2>`;
+    const tableDiv = document.createElement("div");
+    tableDiv.className = "overflow-x-auto mt-2 hidden";
+    const table = document.createElement("table");
+    table.className = "min-w-full bg-white shadow rounded";
+    table.innerHTML = `
+      <thead class="bg-gray-100">
+        <tr>
+          <th class="px-4 py-2">Level</th>
+          <th class="px-4 py-2">Rule</th>
+          <th class="px-4 py-2">Pass/Fail</th>
+          <th class="px-4 py-2">Reason</th>
+          <th class="px-4 py-2">Recommendation</th>
+        </tr>
+      </thead>
+      <tbody></tbody>
+    `;
+    tableDiv.appendChild(table);
+    container.appendChild(header);
+    container.appendChild(tableDiv);
+    header.addEventListener("click", () => tableDiv.classList.toggle("hidden"));
+    pageTables[page] = table.querySelector("tbody");
+  }
+
+  const tbody = pageTables[page];
+  const tr = document.createElement("tr");
+  tr.className = "border-b";
+  tr.dataset.status = status.toLowerCase();
+  tr.dataset.page = page;
+  tr.innerHTML = `
+    <td class="px-4 py-2">${level}</td>
+    <td class="px-4 py-2">${rule}</td>
+    <td class="px-4 py-2 ${status.toLowerCase()}">${status}</td>
+    <td class="px-4 py-2">${reason}</td>
+    <td class="px-4 py-2">${recommendation}</td>
+  `;
+  tableRows.push(tr);
+  tbody.appendChild(tr);
+}
+
+function addSummaryCard(page, passed, failed, warning) {
+  const container = document.getElementById("summary-cards");
+  const total = passed + failed + warning;
+  const passRatio = total>0?passed/total:0;
+  let colorClass="bg-green-400";
+  if(passRatio<0.3) colorClass="bg-red-500";
+  else if(passRatio<0.7) colorClass="bg-yellow-400";
+  const passPercent = total>0?(passed/total*100):0;
+  const failPercent = total>0?(failed/total*100):0;
+  const warnPercent = total>0?(warning/total*100):0;
+
+  const card = document.createElement("div");
+  card.className="summary-card bg-white shadow p-4 rounded w-64 hover:shadow-lg";
+  card.innerHTML=`
+    <div class="flex justify-between items-center mb-2">
+      <h3 class="font-bold text-lg">${page}</h3>
+      <span class="px-2 py-1 text-white rounded ${colorClass}">Pass: ${passPercent.toFixed(0)}%</span>
+    </div>
+    <div class="flex h-3 mb-2 w-full rounded overflow-hidden shadow-inner">
+      <div class="bg-green-500 h-full" style="width:${passPercent}%;"></div>
+      <div class="bg-red-600 h-full" style="width:${failPercent}%;"></div>
+      <div class="bg-yellow-400 h-full" style="width:${warnPercent}%;"></div>
+    </div>
+    <div class="text-sm">
+      <p class="text-green-600">Passed: ${passed}</p>
+      <p class="text-red-600">Failed: ${failed}</p>
+      <p class="text-yellow-500">Warnings: ${warning}</p>
+    </div>
+  `;
+  card.addEventListener("click", ()=>{
+    const row = tableRows.find(r=>r.dataset.page===page);
+    if(row) row.scrollIntoView({behavior:"smooth", block:"start"});
+  });
+  container.appendChild(card);
+}
+
+function updateTable(filter){
+  Object.values(pageTables).forEach(tbody=>{
+    Array.from(tbody.children).forEach(row=>{
+      if(filter==="all"||row.dataset.status===filter) row.style.display="";
+      else row.style.display="none";
+    });
+  });
+}
+
+buttons.forEach(btn=>{
+  btn.addEventListener("click",()=>updateTable(btn.dataset.filter));
+});
+
+// Scroll to top
+const scrollBtn=document.getElementById("scrollTopBtn");
+scrollBtn.addEventListener("click",()=>window.scrollTo({top:0,behavior:"smooth"}));
+window.addEventListener("scroll",()=>{scrollBtn.style.display=window.scrollY>200?"block":"none";});
+scrollBtn.style.display="none";
+
+// Update totals in hero banner
+function updateTotals(passed, failed, warning){
+  document.getElementById("total-pass").innerText=passed;
+  document.getElementById("total-fail").innerText=failed;
+  document.getElementById("total-warning").innerText=warning;
+  const total=passed+failed+warning;
+  const ratio=total>0?passed/total:0;
+  const summaryEl=document.getElementById("summary");
+  summaryEl.classList.remove("text-green-500","text-yellow-400","text-red-500");
+  if(ratio<0.3) summaryEl.classList.add("text-red-500");
+  else if(ratio<0.7) summaryEl.classList.add("text-yellow-400");
+  else summaryEl.classList.add("text-green-500");
+}
+
+// Render dashboard from auditData
+auditData.forEach(pageData=>{
+  const page = pageData.page;
+  const rows = pageData.rows;
+  const summary = pageData.summary;
+  addSummaryCard(page, summary.pass, summary.fail, summary.warning);
+  rows.forEach(r=>addRow(page, r.level, r.rule, r.status, r.reason, r.recommendation));
+});
+
+// Update totals
+let totalPass=0,totalFail=0,totalWarning=0;
+auditData.forEach(p=>{
+  totalPass+=p.summary.pass;
+  totalFail+=p.summary.fail;
+  totalWarning+=p.summary.warning;
+});
+updateTotals(totalPass,totalFail,totalWarning);
+</script>
+
+</body>
+</html>

src/accessibility_v2/app.py

@@ -0,0 +1,27 @@
+import streamlit as st
+import asyncio
+from src.accessibility_v2.patterns.orchestrator import AccessibilityOrchestrator
+
+st.set_page_config(page_title="Accessibility V2", layout="wide", page_icon="♿")
+
+st.title("♿ AI Accessibility Auditor")
+st.markdown("Enter a URL to perform a comprehensive WCAG 2.1 AA audit powered by Playwright and GPT-4o.")
+
+url = st.text_input("Website URL", "https://example.com")
+
+if st.button("Run Audit", type="primary"):
+    orchestrator = AccessibilityOrchestrator()
+    placeholder = st.empty()
+    
+    async def run():
+        full_response = ""
+        async for update in orchestrator.audit_site(url):
+            if update.startswith("🔍") or update.startswith("🧠"):
+                placeholder.info(update)
+            else:
+                full_response = update # The final markdown
+        
+        placeholder.empty()
+        st.markdown(full_response)
+        
+    asyncio.run(run())

src/accessibility_v2/layers/action.py

@@ -0,0 +1,20 @@
+from src.accessibility_v2.tools.web_auditor import WebAuditor
+from typing import Dict, Any
+
+class ActionLayer:
+    """
+    Executes the accessibility audit.
+    """
+    def __init__(self):
+        self.auditor = WebAuditor()
+
+    async def execute(self, action: str, params: Dict[str, Any]) -> Dict[str, Any]:
+        if action == "audit_url":
+            url = params.get("url")
+            if not url:
+                return {"error": "No URL provided"}
+            
+            print(f"[Action] Auditing {url}...")
+            return await self.auditor.full_audit(url)
+        
+        return {"error": f"Unknown action: {action}"}

src/accessibility_v2/layers/cognition.py

@@ -0,0 +1,46 @@
+import json
+import os
+from openai import AsyncOpenAI
+
+class CognitionLayer:
+    """
+    Analyzes audit data and generates readable reports.
+    """
+    def __init__(self):
+        api_key = os.environ.get("OPENAI_API_KEY")
+        self.client = AsyncOpenAI(api_key=api_key)
+        self.model_name = "gpt-4o"
+
+    async def analyze(self, audit_data: dict) -> str:
+        """
+        Takes raw audit JSON and produces a markdown summary with recommendations.
+        """
+        if not audit_data.get("success"):
+             return f"❌ Audit Failed: {audit_data.get('error')}"
+             
+        summary_json = json.dumps(audit_data.get("data", {}).get("summary", {}), indent=2)
+        
+        system_prompt = """
+        You are an **Accessibility Expert** (WCAG 2.1 AA Specialist).
+        You will receive a JSON summary of accessibility violations found on a webpage.
+        
+        Your Goal:
+        1. Summarize the key issues.
+        2. Explain WHY they are barriers to users (e.g. screen readers, low vision).
+        3. Provide actionable code snippets or recommendations to fix them.
+        
+        Ouput Format:
+        Markdown. Use tables for lists of violations.
+        """
+        
+        try:
+             completion = await self.client.chat.completions.create(
+                model=self.model_name,
+                messages=[
+                    {"role": "system", "content": system_prompt},
+                    {"role": "user", "content": f"Audit Data:\n{summary_json}"}
+                ]
+            )
+             return completion.choices[0].message.content
+        except Exception as e:
+            return f"Error analyzing results: {e}"

src/accessibility_v2/layers/perception.py

@@ -0,0 +1,33 @@
+from dataclasses import dataclass
+import datetime
+from urllib.parse import urlparse
+
+@dataclass
+class EnvironmentState:
+    url: str
+    timestamp: str
+    is_valid_url: bool
+    error_message: str = None
+
+class PerceptionLayer:
+    """
+    Validates and accepts the target URL.
+    """
+    
+    def perceive(self, raw_input: str) -> EnvironmentState:
+        url = raw_input.strip()
+        is_valid = self._validate_url(url)
+        
+        return EnvironmentState(
+            url=url,
+            timestamp=datetime.datetime.now().isoformat(),
+            is_valid_url=is_valid,
+            error_message=None if is_valid else "Invalid URL format."
+        )
+
+    def _validate_url(self, url: str) -> bool:
+        try:
+            result = urlparse(url)
+            return all([result.scheme, result.netloc])
+        except:
+            return False

src/accessibility_v2/patterns/orchestrator.py

@@ -0,0 +1,30 @@
+from src.accessibility_v2.layers.perception import PerceptionLayer
+from src.accessibility_v2.layers.action import ActionLayer
+from src.accessibility_v2.layers.cognition import CognitionLayer
+
+class AccessibilityOrchestrator:
+    def __init__(self):
+        self.perception = PerceptionLayer()
+        self.action = ActionLayer()
+        self.cognition = CognitionLayer()
+
+    async def audit_site(self, url: str):
+        # 1. Perception
+        state = self.perception.perceive(url)
+        if not state.is_valid_url:
+            yield f"❌ Invalid URL: {state.url}"
+            return
+
+        # 2. Action (Run Audit)
+        yield f"🔍 Auditing {state.url}..."
+        audit_result = await self.action.execute("audit_url", {"url": state.url})
+        
+        if not audit_result.get("success"):
+            yield f"❌ Audit failed: {audit_result.get('error')}"
+            return
+
+        # 3. Cognition (Analyze)
+        yield "🧠 Analyzing results with AI..."
+        analysis = await self.cognition.analyze(audit_result)
+        
+        yield analysis

src/accessibility_v2/tools/web_auditor.py

@@ -0,0 +1,88 @@
+import os
+import asyncio
+from typing import Any, Dict, List, Optional
+from playwright.async_api import async_playwright, Page
+
+# Path to axe script
+DEFAULT_AXE_PATH = os.path.join(os.path.dirname(__file__), "axe.min.js")
+AXE_JS_PATH = os.environ.get("AXE_JS_PATH", DEFAULT_AXE_PATH)
+
+class WebAuditor:
+    """
+    Encapsulates Playwright based accessibility auditing logic.
+    """
+
+    async def _open_page(self, url: str, timeout: int = 30000, wait_until: str = "load"):
+        playwright = await async_playwright().start()
+        browser = await playwright.chromium.launch(args=["--no-sandbox"], headless=True)
+        context = await browser.new_context()
+        page = await context.new_page()
+        try:
+            await page.goto(url, timeout=timeout, wait_until=wait_until)
+            await asyncio.sleep(0.5) # Settle
+        except Exception as e:
+            await context.close()
+            await browser.close()
+            await playwright.stop()
+            raise e
+            
+        return playwright, browser, context, page
+
+    async def _ensure_axe(self, page: Page):
+        if not os.path.exists(AXE_JS_PATH):
+            raise FileNotFoundError(f"axe.min.js not found at {AXE_JS_PATH}")
+        with open(AXE_JS_PATH, "r", encoding="utf-8") as f:
+            axe_source = f.read()
+        await page.add_init_script(axe_source)
+        # Ensure it loaded
+        await page.evaluate("() => { window.__axe_injected = typeof axe !== 'undefined'; }")
+        
+    async def _run_axe(self, page: Page, tags: Optional[List[str]] = None):
+        tags = tags or ["wcag2a", "wcag2aa"]
+        return await page.evaluate("""(tags) => {
+            return axe.run(document, {runOnly: {type: 'tag', values: tags}});
+        }""", tags)
+
+    async def full_audit(self, url: str) -> Dict[str, Any]:
+        playwright = browser = context = page = None
+        results = {}
+        
+        try:
+            playwright, browser, context, page = await self._open_page(url)
+            
+            # 1. Axe Audit
+            try:
+                await self._ensure_axe(page)
+                axe_res = await self._run_axe(page)
+                results["axe"] = axe_res
+            except Exception as e:
+                results["axe_error"] = str(e)
+                
+            # 2. Simple Custom Checks (simplified for brevity here, can expand later)
+            results["title"] = await page.title()
+            
+            # Map Axe violations to a simpler summary
+            violations = results.get("axe", {}).get("violations", [])
+            simple_violations = []
+            for v in violations:
+                simple_violations.append({
+                    "id": v.get("id"),
+                    "impact": v.get("impact"),
+                    "description": v.get("description"),
+                    "help": v.get("help"),
+                    "nodes_count": len(v.get("nodes", []))
+                })
+            
+            results["summary"] = {
+                "violation_count": len(violations),
+                "violations": simple_violations
+            }
+            
+            return {"url": url, "success": True, "data": results}
+
+        except Exception as e:
+            return {"url": url, "success": False, "error": str(e)}
+        finally:
+            if context: await context.close()
+            if browser: await browser.close()
+            if playwright: await playwright.stop()

src/chatbot_v1/Dockerfile

@@ -0,0 +1,35 @@
+FROM python:3.12-slim
+
+ENV PYTHONUNBUFFERED=1 \
+    DEBIAN_FRONTEND=noninteractive \
+    PYTHONPATH=/app:/app/common:$PYTHONPATH
+
+WORKDIR /app
+
+# System deps
+RUN apt-get update && apt-get install -y \
+    git build-essential curl \
+    && rm -rf /var/lib/apt/lists/*
+
+# Install uv
+RUN curl -LsSf https://astral.sh/uv/install.sh | sh
+ENV PATH="/root/.local/bin:$PATH"
+
+# Copy project metadata
+COPY pyproject.toml .
+COPY uv.lock .
+
+# Copy required folders
+COPY common/ ./common/
+COPY src/chatbot/ ./src/chatbot/
+
+# Install dependencies using uv, then export and install with pip to system
+RUN uv sync --frozen --no-dev && \
+    uv pip install -e . --system
+
+# Copy entry point
+COPY run.py .
+
+EXPOSE 7860
+
+CMD ["python", "run.py", "chatbot", "--port", "7860"]

src/chatbot_v1/README.md

@@ -0,0 +1,223 @@
+---
+title: AI Chatbot
+emoji: 🤖
+colorFrom: pink
+colorTo: yellow
+sdk: docker
+sdk_version: "0.0.1"
+app_file: app.py
+pinned: false
+license: mit
+tags:
+  - text-generation
+  - agentic-ai
+  - openai-sdk
+short_description: An Experimental Agentic Chatbot (uses OpenAI Agent SDK)
+---
+
+# AI Chatbot
+
+This is an experimental chatbot for chatting with AI. It is equipped with agents & tools to give you realtime data from the web. It uses **OpenAI - SDK** and **OpenAI - Agents**...
+
+## Features
+- Predefined prompts for quick analysis
+- Chat interface with AI responses
+- Enter key support and responsive design
+- Latest messages appear on top
+
+## Usage
+1. Type a message or select a predefined prompt
+2. Press **Enter** or click **Send**
+3. AI responses appear instantly in the chat interface
+
+## Supported APIs
+- OpenAI
+- Google
+- GROQ
+- SERPER
+- News API
+
+## Notes
+- Make sure your API keys are configured in the Space secrets
+- Built using Streamlit and deployed as a Docker Space
+
+## References
+
+https://openai.github.io/openai-agents-python/
+
+https://github.com/openai/openai-agents-python/tree/main/examples/mcp
+
+## Project Folder Structure
+
+```
+chatbot/
+├── app.py                    # Main Streamlit chatbot interface
+├── appagents/
+│   ├── __init__.py               # Package initialization
+│   ├── OrchestratorAgent.py      # Main orchestrator - coordinates all agents
+│   ├── FinancialAgent.py         # Financial data and analysis agent
+│   ├── NewsAgent.py              # News retrieval and summarization agent
+│   ├── SearchAgent.py            # General web search agent
+│   └── InputValidationAgent.py   # Input validation and sanitization agent
+├── core/
+│   ├── __init__.py               # Package initialization
+│   └── logger.py                 # Centralized logging configuration
+├── tools/
+│   ├── __init__.py               # Package initialization
+│   ├── google_tools.py           # Google search API wrapper
+│   ├── yahoo_tools.py            # Yahoo Finance API wrapper
+│   ├── news_tools.py             # News API wrapper
+│   └── time_tools.py             # Time-related utility functions
+├── prompts/
+│   ├── economic_news.txt         # Prompt for economic news analysis
+│   ├── market_sentiment.txt      # Prompt for market sentiment analysis
+│   ├── news_headlines.txt        # Prompt for news headline summarization
+│   ├── trade_recommendation.txt  # Prompt for trade recommendations
+│   └── upcoming_earnings.txt     # Prompt for upcoming earnings alerts
+├── Dockerfile                     # Docker configuration for container deployment
+├── pyproject.toml                 # Project metadata and dependencies (copied from root)
+├── uv.lock                        # Locked dependency versions (copied from root)
+├── README.md                      # Project documentation
+└── run.py                         # Script to run the application locally
+```
+
+## File Descriptions
+
+### UI Layer
+- **app.py** - Main Streamlit chatbot interface that provides:
+  - Chat message display with user and AI messages
+  - Text input for user queries
+  - Predefined prompt buttons for quick analysis
+  - Real-time AI responses
+  - Support for Enter key submission
+  - Responsive design with latest messages appearing first
+
+### Agents (`appagents/`)
+- **OrchestratorAgent.py** - Main orchestrator that:
+  - Coordinates communication between all specialized agents
+  - Routes user queries to appropriate agents
+  - Manages conversation flow and context
+  - Integrates tool responses
+
+- **FinancialAgent.py** - Financial data and analysis:
+  - Retrieves stock prices and financial metrics
+  - Performs financial analysis using Yahoo Finance API
+  - Provides market insights and recommendations
+  - Integrates with yahoo_tools for data fetching
+
+- **NewsAgent.py** - News retrieval and summarization:
+  - Fetches latest news articles
+  - Summarizes news content
+  - Integrates with News API for real-time updates
+  - Provides news-based market insights
+
+- **SearchAgent.py** - General web search:
+  - Performs web searches for general queries
+  - Integrates with Google Search / Serper API
+  - Returns relevant search results
+  - Supports multi-source data gathering
+
+- **InputValidationAgent.py** - Input validation:
+  - Sanitizes user input
+  - Validates query format and content
+  - Prevents malicious inputs
+  - Ensures appropriate content
+
+### Core Utilities (`core/`)
+- **logger.py** - Centralized logging configuration:
+  - Provides consistent logging across agents
+  - Handles different log levels
+  - Formats log messages for clarity
+
+### Tools (`tools/`)
+- **google_tools.py** - Google Search API wrapper:
+  - Executes web searches via Google Search / Serper API
+  - Parses and returns search results
+  - Handles API authentication
+
+- **yahoo_tools.py** - Yahoo Finance API integration:
+  - Retrieves stock price data
+  - Fetches financial metrics and indicators
+  - Provides historical price data
+  - Returns earnings information
+
+- **news_tools.py** - News API integration:
+  - Fetches latest news articles
+  - Filters news by category and keywords
+  - Returns news headlines and summaries
+  - Provides market-related news feeds
+
+- **time_tools.py** - Time utility functions:
+  - Provides current time information
+  - Formats timestamps
+  - Handles timezone conversions
+
+### Prompts (`prompts/`)
+Predefined prompts for specialized analysis:
+- **economic_news.txt** - Analyzes economic news and implications
+- **market_sentiment.txt** - Analyzes market sentiment trends
+- **news_headlines.txt** - Summarizes and explains news headlines
+- **trade_recommendation.txt** - Provides trading recommendations
+- **upcoming_earnings.txt** - Alerts about upcoming earnings reports
+
+### Configuration Files
+- **Dockerfile** - Container deployment:
+  - Builds Docker image with Python 3.12
+  - Installs dependencies using `uv`
+  - Sets up Streamlit server on port 8501
+  - Configures PYTHONPATH for module imports
+
+- **pyproject.toml** - Project metadata:
+  - Package name: "agents"
+  - Python version requirement: 3.12
+  - Lists all dependencies (OpenAI, LangChain, Streamlit, etc.)
+
+- **uv.lock** - Dependency lock file:
+  - Ensures reproducible builds
+  - Pins exact versions of all dependencies
+
+## Key Technologies
+
+| Component | Technology | Purpose |
+|-----------|-----------|---------|
+| LLM Framework | OpenAI Agents | Multi-agent orchestration |
+| Chat Interface | Streamlit | User interaction and display |
+| Web Search | Google Search / Serper API | Web search results |
+| Financial Data | Yahoo Finance API | Stock prices and metrics |
+| News Data | News API | Latest news articles |
+| Async Operations | AsyncIO | Parallel agent execution |
+| Dependencies | UV | Fast Python package management |
+| Containerization | Docker | Cloud deployment |
+
+## Predefined Prompts
+
+The chatbot includes quick-access buttons for common analysis:
+
+1. **Economic News** - Analyzes current economic trends and news
+2. **Market Sentiment** - Provides market sentiment analysis
+3. **News Headlines** - Summarizes latest news headlines
+4. **Trade Recommendation** - Suggests trading strategies
+5. **Upcoming Earnings** - Lists upcoming company earnings
+
+## Running Locally
+
+```bash
+# Install dependencies
+uv sync
+
+# Set environment variables defined in .env.name file
+export OPENAI_API_KEY="your-key"
+export SERPER_API_KEY="your-key"
+export NEWS_API_KEY="your-key"
+
+# Run the Streamlit app (from the root)
+python run.py chatbot
+```
+
+## Deployment
+
+The project is deployed on Hugging Face Spaces as a Docker container:
+- **Space**: https://huggingface.co/spaces/mishrabp/chatbot-app
+- **URL**: https://mishrabp-chatbot-app.hf.space
+- **Trigger**: Automatic deployment on push to `main` branch
+- **Configuration**: `.github/workflows/chatbot-app-hf.yml`

src/chatbot_v1/aagents/input_validation_agent.py

@@ -0,0 +1,58 @@
+
+import os
+import json
+from agents import Agent, OpenAIChatCompletionsModel, Runner, GuardrailFunctionOutput
+from pydantic import BaseModel
+from openai import AsyncOpenAI
+from core.model import get_model_client
+
+class ValidatedOutput(BaseModel):
+    is_valid: bool
+    reasoning: str
+
+input_validation_agent = Agent(
+    name="Guardrail Input Validation Agent",
+    instructions="""
+        You are a highly efficient and specialized **Agent** 🌐. Your sole function is to validate the user inputs.
+        
+        ## Core Directives & Priorities
+        1. You should flag if the user uses unparaliamentary language ONLY.
+        2. You MUST give reasoning for the same.
+        
+        ## Rules
+        - If it contains any of these, mark `"is_valid": false` and explain **why** in `"reasoning"`.
+        - Otherwise, mark `"is_valid": true` with reasoning like "The input follows respectful communication guidelines."
+
+
+        ## Output Format (MANDATORY)
+        * Return a JSON object with the following structure:
+        {
+            "is_valid": <boolean>,
+            "reasoning": <string>
+        }
+    """,
+    model=get_model_client(),
+    output_type=ValidatedOutput,
+)
+input_validation_agent.description = "A guardrail agent that validates user input for unparliamentary language."
+
+async def input_validation_guardrail(ctx, agent, input_data):
+    result = await Runner.run(input_validation_agent, input_data, context=ctx.context)
+    raw_output = result.final_output
+
+    # Handle different return shapes gracefully
+    if isinstance(raw_output, ValidatedOutput):
+        final_output = raw_output
+        print("Parsed ValidatedOutput:", final_output)
+    else:
+        final_output = ValidatedOutput(
+            is_valid=False,
+            reasoning=f"Unexpected output type: {type(raw_output)}"
+        )
+
+    return GuardrailFunctionOutput(
+        output_info=final_output,
+        tripwire_triggered=not final_output.is_valid,
+    )
+
+__all__ = ["input_validation_agent", "input_validation_guardrail", "ValidatedOutput"]

src/chatbot_v1/aagents/orchestrator_agent.py

@@ -0,0 +1,96 @@
+
+import os
+import asyncio
+from common.aagents.search_agent import search_agent
+from common.aagents.news_agent import news_agent
+from common.aagents.yf_agent import yf_agent
+from aagents.input_validation_agent import input_validation_guardrail
+from agents import Agent, OpenAIChatCompletionsModel, Runner, function_tool
+from openai import AsyncOpenAI
+from core.model import get_model_client
+
+# ----------------------------------------------------------
+# PARALLEL EXECUTION TOOL
+# ----------------------------------------------------------
+@function_tool
+async def prompt_broadcaster(query: str, include_finance: bool = True, include_news: bool = True, include_search: bool = True) -> str:
+    """
+    Broadcasts the search query to selected specialized agents in parallel and aggregates their responses.
+    
+    Args:
+        query: The user's question or topic to research.
+        include_finance: Whether to include the Yahoo Finance agent (default: True).
+        include_news: Whether to include the News agent (default: True).
+        include_search: Whether to include the Web Search agent (default: True).
+
+    Returns:
+        Combined reports from the selected agents.
+    """
+    
+    
+    # A better approach for variable tasks is to map them.
+    active_agents = []
+    if include_finance: active_agents.append(("YahooFinanceAgent", Runner.run(yf_agent, query)))
+    if include_news: active_agents.append(("NewsAgent", Runner.run(news_agent, query)))
+    if include_search: active_agents.append(("WebSearchAgent", Runner.run(search_agent, query)))
+
+    if not active_agents:
+        return "No agents were selected for this query."
+
+    # Run in parallel
+    agent_names = [name for name, _ in active_agents]
+    coroutines = [coro for _, coro in active_agents]
+    
+    results = await asyncio.gather(*coroutines, return_exceptions=True)
+    
+    outputs = []
+    for name, res in zip(agent_names, results):
+        if isinstance(res, Exception):
+            outputs.append(f"❌ {name} Error: {str(res)}")
+        else:
+            outputs.append(f"✅ {name} Report:\n{res.final_output}")
+            
+    combined_response = "\n--- START OF AGENT REPORTS ---\n\n" + "\n\n-----------------------------------\n\n".join(outputs) + "\n\n--- END OF AGENT REPORTS ---"
+    
+    return combined_response
+
+orchestrator_agent = Agent(
+    name="AI Chat Orchestrator",
+    tools=[prompt_broadcaster],
+    instructions="""
+    You are the **AI Chat Orchestrator**. 
+    Your goal is to provide a comprehensive, multi-perspective answer by synthesizing data from specialized sub-agents.
+
+    **Workflow**:
+    1.  **Analyze Request**: Understand the user's question.
+    2.  **Determine Needs**: Decide which specialized agents are required.
+        *   **Finance**: For stock prices, market trends, company financials, or analyst ratings.
+        *   **News**: For recent events, headlines, or breaking news.
+        *   **Web Search**: For general knowledge, history, facts, or broad research.
+    3.  **Broadcast Query**: Call the `prompt_broadcaster` tool with the `query` and set the `include_*` flags to True/False accordingly.
+        *   *Optimization Tip*: efficiently select ONLY the necessary agents to reduce latency.
+    4.  **Synthesize Results**: Read the returned "Agent Reports".
+        *   Combine the financial data (prices, sentiment), news headlines, and general search context.
+        *   Compare and contrast findings if necessary.
+        *   Resolve conflicts by prioritizing specific data (e.g., Yahoo Finance for prices) over general text.
+    5.  **Final Response**: Generate a clear, professional, and well-structured summary for the user. Do not simply paste the individual reports.
+
+    **Final Response Structure**:
+    You should adapt the response structure based on the user's query type:
+
+    *   **For Market/Finance Queries**: Use the "Market Analysis" style with a Financial Snapshot (Price, Sentinel, Ratings), Key Developments, and Synthesis.
+    *   **For News/Research**: Use a clear "Executive Summary" followed by "Key Findings" and "Details".
+    *   **For General Chat**: Maintain a conversational but professional tone. Use markdown for clarity (bullet points, bold text).
+    *   **For Coding Requests**: Provide clear code blocks and explanations.
+
+    **Constraint**:
+    *   Do NOT try to answer based on your own knowledge if live data is needed/requested.
+    *   Use `prompt_broadcaster` when the query implies a need for external information.
+    *   If agents return "No data", explicitly state that in the relevant section.
+    """,
+    model=get_model_client(),
+)
+orchestrator_agent.description = "An intelligent orchestrator that queries Finance, News, and Search agents in parallel and synthesizes a comprehensive response."
+
+
+__all__ = ["orchestrator_agent"]

src/chatbot_v1/app.py

@@ -0,0 +1,317 @@
+import os
+import glob
+import uuid
+import asyncio
+# import trace_config
+import logging
+import streamlit as st
+from aagents.orchestrator_agent import orchestrator_agent
+from agents import Runner, trace, SQLiteSession
+from agents.exceptions import InputGuardrailTripwireTriggered
+# from langsmith import traceable
+
+from traceloop.sdk import Traceloop
+from opentelemetry.sdk.trace import Span
+
+# --- Monkeypatch to fix "Invalid type Omit" errors ---
+# This filters out 'NotGiven'/'Omit' values from OpenAI that crash the OTel exporter
+_original_set_attribute = Span.set_attribute
+
+def _safe_set_attribute(self, key, value):
+    # Check string representation of type to avoid importing specific internal types
+    type_str = str(type(value))
+    if "Omit" in type_str or "NotGiven" in type_str:
+        return self
+    return _original_set_attribute(self, key, value)
+
+Span.set_attribute = _safe_set_attribute
+# -----------------------------------------------------
+
+Traceloop.init(
+  disable_batch=True,
+  api_key="tl_1c19b8e8fcfd411fb9fcdb02d381faef"
+)
+
+# -----------------------------
+# Configuration & Utils
+# -----------------------------
+st.set_page_config(
+    page_title="AI Assistant",
+    layout="wide",
+    page_icon="🤖"
+)
+
+def load_prompts(folder="prompts"):
+    prompts = []
+    prompt_labels = []
+    if os.path.exists(folder):
+        for file_path in glob.glob(os.path.join(folder, "*.txt")):
+            with open(file_path, "r", encoding="utf-8") as f:
+                content = f.read().strip()
+                if content:
+                    prompts.append(content)
+
+            prompt_labels.append(os.path.basename(file_path).replace("_", " ").replace(".txt", "").title())
+    return prompts, prompt_labels
+
+prompts, prompt_labels = load_prompts()
+
+# -----------------------------
+# Session State
+# -----------------------------
+if "messages" not in st.session_state:
+    st.session_state.messages = []
+
+if "ai_session_id" not in st.session_state:
+    st.session_state.ai_session_id = str(uuid.uuid4())
+
+# Persistent SQLite session
+if "ai_session" not in st.session_state:
+    st.session_state.ai_session = SQLiteSession(f"conversation_{st.session_state.ai_session_id}.db")
+
+session = st.session_state.ai_session
+
+# -----------------------------
+# Premium Styling
+# -----------------------------
+st.markdown("""
+<style>
+    /* ---------------------------------------------------------------------
+       1. GLOBAL & RESET
+       --------------------------------------------------------------------- */
+    * {
+        box-sizing: border-box;
+    }
+    
+    .stApp, [data-testid="stAppViewContainer"] {
+        /* Standard Streamlit background */
+        background-color: #f8f9fa;
+        font-family: 'Inter', -apple-system, BlinkMacSystemFont, sans-serif, 'Apple Color Emoji', 'Segoe UI Emoji';
+    }
+    
+    html {
+        -webkit-text-size-adjust: 100%; /* Prevent iOS font boosting */
+    }
+    
+    /* ---------------------------------------------------------------------
+       2. LAYOUT & HERO BANNER
+       --------------------------------------------------------------------- */
+    
+    /* Mobile font optimization */
+    @media (max-width: 768px) {
+        /* Target all markdown text specifically */
+        .stMarkdown p, .stMarkdown li, .stChatMessage p, .message-content, .stDataFrame, .stTable {
+            font-size: 16px !important;
+            line-height: 1.6 !important;
+            color: #1a1a1a !important;
+        }
+        
+        h1, h2, h3, h4, h5, h6 {
+            color: #1a1a1a !important;
+        }
+    }
+    
+    /* Desktop Layout */
+    @media (min-width: 769px) {
+        .block-container {
+            padding-top: 0 !important;
+            padding-bottom: 2rem !important;
+            padding-left: 5rem !important;
+            padding-right: 5rem !important;
+            max-width: 100% !important;
+        }
+        
+        .hero-container {
+            margin-top: -3rem;
+            margin-left: -5rem;
+            margin-right: -5rem;
+            /* Simple negative margins to pull edge-to-edge */
+            padding: 2.5rem 1rem 2rem 1rem; /* Compact desktop padding */
+        }
+    }
+    
+    /* Mobile Layout */
+    @media (max-width: 768px) {
+        .block-container {
+            padding-left: 1rem !important;
+            padding-right: 1rem !important;
+            padding-top: 0 !important;
+        }
+        
+        .hero-container {
+            margin-top: -2rem;
+            margin-left: -1rem;
+            margin-right: -1rem;
+            /* Break out of the 1rem padding */
+            padding: 2rem 1rem 1.5rem 1rem; /* Compact mobile padding */
+            border-radius: 0 0 12px 12px;
+        }
+        
+        /* Ensure font sizes are standard (Streamlit defaults is ~16px) */
+        /* We DO NOT override them to 17px/fixed, allowing system zoom to work. */
+    }
+
+    /* Hero Styling */
+    .hero-container {
+        background: linear-gradient(135deg, #667eea 0%, #764ba2 100%);
+        color: white;
+        text-align: center;
+        border-radius: 0 0 16px 16px;
+        box-shadow: 0 4px 15px rgba(0,0,0,0.1);
+        margin-bottom: 2rem;
+    }
+
+    .hero-title {
+        font-size: 2rem; /* Slightly smaller */
+        font-weight: 700;
+        margin-bottom: 0.25rem;
+        color: white !important;
+    }
+    .hero-subtitle {
+        font-size: 1rem;
+        opacity: 0.95;
+        font-weight: 400;
+        color: rgba(255,255,255,0.95) !important;
+    }
+    
+    /* Remove Header Decoration */
+    header[data-testid="stHeader"] {
+        background-color: transparent !important;
+        height: 0 !important;
+        z-index: 100;
+    }
+    div[data-testid="stDecoration"] { display: none; }
+    
+    /* ---------------------------------------------------------------------
+       3. COMPONENT STYLING (Healthcare-like)
+       --------------------------------------------------------------------- */
+    
+    /* Chat Bubbles - Clean & Readable */
+    .stChatMessage {
+        background-color: white;
+        border-radius: 12px;
+        border: 1px solid #e5e5e5;
+        box-shadow: 0 1px 2px rgba(0,0,0,0.05);
+        padding: 1rem;
+    }
+    
+    .stChatMessage[data-testid="stChatMessage"]:nth-of-type(odd) {
+         background-color: #f8f9fa;
+    }
+    
+    /* Input Fields */
+    .stTextInput input {
+        border-radius: 20px; /* Matching healthcare-assistant roundness */
+        border: 1px solid #ddd;
+        padding: 0.75rem 1rem;
+    }
+    
+    /* Buttons */
+    .stButton button {
+        border-radius: 20px; /* Matching healthcare-assistant */
+        min-height: 48px;
+        font-weight: 500;
+    }
+
+    /* Sidebar */
+    section[data-testid="stSidebar"] {
+        background-color: #ffffff;
+        border-right: 1px solid #eaeaea;
+    }
+    
+    /* Minimize Sidebar Top Padding */
+    section[data-testid="stSidebar"] .block-container {
+        padding-top: 0rem !important;
+        padding-bottom: 0rem !important;
+    }
+</style>
+""", unsafe_allow_html=True)
+
+# -----------------------------
+# Logic
+# -----------------------------
+# @traceable(name="chatbot")
+async def get_ai_response(prompt: str) -> str:
+    try:
+        agent = orchestrator_agent
+        # Ensure session is valid
+        current_session = st.session_state.ai_session
+        current_session = st.session_state.ai_session
+        with trace("Chatbot Agent Run"): # Keep existing custom trace wrapper
+            # Run agent
+            result = await Runner.run(agent, prompt, session=current_session)
+            return result.final_output
+    except InputGuardrailTripwireTriggered as e:
+        reasoning = getattr(e, "reasoning", None) \
+            or getattr(getattr(e, "output", None), "reasoning", None) \
+            or getattr(getattr(e, "guardrail_output", None), "reasoning", None) \
+            or "Guardrail triggered, but no reasoning provided."
+        return f"⚠️ **Guardrail Blocked Input**\n\n{reasoning}"
+    except Exception as e:
+        return f"❌ **Error**: {str(e)}"
+
+# -----------------------------
+# Sidebar - Quick Actions
+# -----------------------------
+with st.sidebar:
+    st.markdown("### ⚡ Quick Starters")
+    st.markdown("Select a prompt to start:")
+    
+    # We use a trick with st.button to act as input triggers
+    # If a button is clicked, we'll handle it in the main loop logic
+    selected_prompt = None
+    for idx, prompt_text in enumerate(prompts):
+        label = prompt_labels[idx] if idx < len(prompt_labels) else f"Prompt {idx+1}"
+        if st.button(label, key=f"sidebar_btn_{idx}", use_container_width=True):
+            # Reset conversation
+            st.session_state.messages = []
+            st.session_state.ai_session_id = str(uuid.uuid4())
+            # Recreate session object with new ID
+            st.session_state.ai_session = SQLiteSession(f"conversation_{st.session_state.ai_session_id}.db")
+            selected_prompt = prompt_text
+
+    st.markdown("---")
+    if st.button("🗑️ Clear Conversation", use_container_width=True):
+        st.session_state.messages = []
+        st.rerun()
+
+# -----------------------------
+# Main Content
+# -----------------------------
+
+# Hero Banner (Always visible & Sticky)
+st.markdown("""
+    <div class="hero-container" role="banner">
+        <div class="hero-title">🤖 AI Companion</div>
+        <div class="hero-subtitle">Your intelligent partner for research, analysis, and more.</div>
+    </div>
+""", unsafe_allow_html=True)
+
+# Display Chat History
+for message in st.session_state.messages:
+    with st.chat_message(message["role"]):
+        st.markdown(message["content"], unsafe_allow_html=True)
+
+# Chat Input Handling
+# We handle both the chat input widget and the sidebar selection here
+if prompt := (st.chat_input("Type your message...") or selected_prompt):
+    # User Message
+    st.session_state.messages.append({"role": "user", "content": prompt})
+    with st.chat_message("user"):
+        st.markdown(prompt)
+
+    # Assistant Response
+    with st.chat_message("assistant"):
+        with st.spinner("Thinking..."):
+            response_text = asyncio.run(get_ai_response(prompt))
+            st.markdown(response_text, unsafe_allow_html=True)
+
+
+            
+    st.session_state.messages.append({"role": "assistant", "content": response_text})
+    
+    # If it was a sidebar click, we need to rerun to clear the selection state potentially, 
+    # but st.chat_input usually handles focus. With buttons, a rerun happens automatically 
+    # but we want to make sure the input box is cleared (which 'selected_prompt' doesn't use).
+    if selected_prompt:
+        st.rerun()

src/chatbot_v1/core/__init__.py

@@ -0,0 +1,4 @@
+
+from .model import get_model_client
+
+__all__ = ["get_model_client"]

src/chatbot_v1/core/model.py

@@ -0,0 +1,36 @@
+from common.utility.openai_model_factory  import OpenAIModelFactory
+
+def get_model_client(provider:str = "openai"):
+    if provider.lower() == "google":
+        return OpenAIModelFactory.get_model(
+            provider="google",
+            model_name="gemini-2.5-flash",
+            temperature=0
+    )
+    elif provider.lower() == "openai":
+        return OpenAIModelFactory.get_model(
+            provider="openai",
+            model_name="gpt-4o-mini",
+            temperature=0
+    )
+    elif provider.lower() == "azure":
+        return OpenAIModelFactory.get_model(
+            provider="azure",
+            model_name="gpt-4o-mini",
+            temperature=0
+    )
+    elif provider.lower() == "groq":
+        return OpenAIModelFactory.get_model(
+            provider="groq",
+            model_name="gpt-4o-mini",
+            temperature=0
+    )
+    elif provider.lower() == "ollama":
+        return OpenAIModelFactory.get_model(
+            provider="ollama",
+            model_name="gpt-4o-mini",
+            temperature=0
+    )
+    else: 
+        raise  ValueError(f"Unsupported provider: {provider}")
+

src/chatbot_v1/prompts/economic_news.txt

@@ -0,0 +1,27 @@
+##### Task
+Provide a concise update on **major economic indicators released recently** in USA.
+
+###### Include
+- **Interest Rates**: Latest central bank decisions, current policy rates, and forward guidance.
+- **Labor Market**: Unemployment rate, job creation figures, and key labor metrics (if available).
+- **Inflation**: CPI, PCE, or other inflation data with MoM and YoY changes.
+- **Growth Indicators**: GDP, PMIs, or industrial production released recently.
+- **Market Reaction**: Brief impact on equities, bonds, FX, and commodities.
+
+###### Guidelines
+- Compare results against forecasts and prior releases
+- Highlight notable surprises and their implications
+- Keep the summary brief, factual, and structured
+- **Always retrieve numerical data from primary or authoritative sources**
+
+###### Fallback
+- If no relevant data was released recently, explicitly state **“No major economic indicators were released during this period.”**
+- If data is partially unavailable, summarize what is available and clearly note missing indicators.
+- Do not infer or fabricate numbers under any circumstance.
+
+###### Output Style
+- Concise, factual, and well-structured
+- Use clear bullet points or short paragraphs
+- Avoid speculation unless explicitly labeled as interpretation
+- **Cite data sources clearly**
+- Use color and emoji to make it more engaging.

src/chatbot_v1/prompts/entertainment_updates.txt

@@ -0,0 +1,26 @@
+##### Task
+Provide the **top 5 recent movie or series updates** that are trending or newly released in USA.
+
+###### For each title, include:
+- **Title in bold** and optionally use **color or emojis** to make it fun (e.g., 🎬, 🍿, 🌟)  
+- A **short, 2–3 line snippet** that generates excitement or humor about the plot, cast, or vibe  
+- **Platform or source** where it can be watched (Netflix, Prime, Disney+, etc.)  
+- **Release date or premiere date**  
+
+###### Requirements / Guidelines
+- Focus on **recent releases** (last 2–4 weeks) or currently trending content  
+- Keep the tone **fun, witty, and engaging**, like a friend recommending a show  
+- Use **emojis liberally** to emphasize excitement, genre, or humor
+- Call out the **main actors and actresses** to build the interest  
+- Where possible, add a **light humorous quip or pun** about the movie/series  
+- If color is supported, use HTML span tags, e.g., `<span style="color:orange">Title</span>` for emphasis
+
+###### Fallback
+- If fewer than 5 titles are available, provide what is available and indicate:  
+  **“Only X recent releases found.”**  
+- Do not fabricate platforms or release dates — only use verified sources
+
+###### Output Style
+- List format (1–5) sorted by **popularity or release date**  
+- **Title + snippet + watch source + release date** per entry  
+- Use **color, emojis, and humor** to make the output visually appealing and fun to read

src/chatbot_v1/prompts/india_news.txt

@@ -0,0 +1,26 @@
+##### Task
+Tell me the **top 3 headlines from India**.
+
+###### For each headline, provide:
+- **Title in bold**
+- A **3‑line summary**
+- **Publish date and time**
+- A **link to the exact source URL**
+
+###### Requirements
+- Use authoritative news sources (e.g., major national/regional news outlets)
+- Headlines should be **recent (last 24 hours)**
+- Provide timestamps in **UTC**
+- If publish date/time is not available, indicate “Date/Time not provided”
+
+###### Fallback
+- If fewer than 3 headlines are found, provide what is available and state:
+  **“Only X recent headlines found for India.”**
+- Do not fabricate headlines, dates, or URLs
+
+###### Output Style
+- Structured list sorted by **most recent first**
+- Clear and concise formatting as requested
+- Use color and emoji to make it more engaging.
+- Use `<span style="color:...">` for coloring the title if the renderer supports it
+- Keep the output **concise, factual, and visually engaging**

src/chatbot_v1/prompts/market_sentiment.txt

@@ -0,0 +1,34 @@
+##### Task
+Act as a **Senior Market Analyst** and provide a concise market sentiment update for the **US Stock Market / S&P 500**.
+
+###### Steps
+1. **Data Gathering**: Search for the **top 5 financial news headlines** from the last 24 hours related to the [US Stock Market / S&P 500].
+2. **Market Check**: Retrieve the **current value** and **today’s percentage change** for:
+   - **S&P 500 (SPX)**
+   - **VIX (Volatility Index)**
+3. **Synthesis**: Based on the **tone of the news headlines** and the **index performance**, determine whether the **current market sentiment** is:
+   - **Bullish**
+   - **Bearish**
+   - **Neutral**
+4. **Output**: Provide a:
+   - **Sentiment Score (1–10)**
+   - **Top 3 key drivers** influencing this sentiment
+
+###### Guidelines
+- Prioritize **reliable financial news sources** (e.g., Bloomberg, Reuters, WSJ, CNBC)
+- Use **accurate, real-time market data** for indices
+- Base sentiment on both **news tone** and **market movement**
+- Avoid subjective or unsupported judgments
+
+###### Fallback
+- If no relevant financial headlines are found in the last 24 hours, clearly state:  
+  **“No significant market news available in the last 24 hours.”**
+- If either index value or change is unavailable, report available data and note missing values explicitly
+- Do not invent or estimate values — only use verified data
+
+###### Output Style
+- Concise, factual, and structured
+- Use clear bullet points or short paragraphs
+- Include numerical values and data timestamps
+- Provide **sources for headlines and index data**
+- Use color and emoji to make it more engaging.

src/chatbot_v1/prompts/news_headlines.txt

@@ -0,0 +1,28 @@
+##### Task
+Tell me the **top 3 USA headlines**. Use **emojis** and, where supported, **HTML color tags** to make the output engaging.
+
+###### For each headline, provide:
+- **Title in bold** and optionally in color, e.g., `<span style="color:blue">Title</span>`  
+- A **3-line summary** with an emoji indicating the type of news:
+  - 📰 Politics
+  - 💼 Business
+  - 🌎 World
+  - ⚡ Breaking news
+- **Publish date and time** (UTC)
+- A **link to the exact source URL**
+
+###### Requirements
+- Use **credible news sources** (Reuters, AP, BBC, Guardian, etc.)
+- Headlines should be **recent (last 24 hours)**
+- If publish time is unavailable, indicate **“Time not provided”**
+
+###### Fallback
+- If fewer than 3 headlines are found, state:  
+  **“Only X recent headlines found for the USA.”**
+- Do not fabricate headlines, dates, or URLs
+
+###### Output Style
+- Structured list sorted by **most recent first**
+- Use emojis consistently to indicate news type
+- Use `<span style="color:...">` for coloring the title if the renderer supports it
+- Keep the output **concise, factual, and visually engaging**

src/chatbot_v1/prompts/odia_news.txt

@@ -0,0 +1,26 @@
+##### Task
+Tell me the **top 3 headlines from Odisha**.
+
+###### For each headline, provide:
+- **Title in bold**
+- A **3‑line summary**
+- **Publish date and time**
+- A **link to the exact source URL**
+
+###### Requirements
+- Use authoritative news sources (e.g., major national/regional news outlets)
+- Headlines should be **recent (last 24 hours)**
+- Provide timestamps in **UTC**
+- If publish date/time is not available, indicate “Date/Time not provided”
+
+###### Fallback
+- If fewer than 3 headlines are found, provide what is available and state:
+  **“Only X recent headlines found for Odisha.”**
+- Do not fabricate headlines, dates, or URLs
+
+###### Output Style
+- Structured list sorted by **most recent first**
+- Clear and concise formatting as requested
+- Use color and emoji to make it more engaging.
+- Use `<span style="color:...">` for coloring the title if the renderer supports it
+- Keep the output **concise, factual, and visually engaging**

src/chatbot_v1/prompts/trade_recommendation.txt

@@ -0,0 +1,40 @@
+##### Task
+Recommend **three option spreads** with **>80% probability of profit**. Perform a thorough analysis of each underlying’s **3-month price trend** and current **market sentiment** before selecting spreads.
+
+###### Steps
+1. **Stock selection & analysis**
+   - Analyze the **last 3 months** of price action (trend, volatility, support/resistance).
+   - Assess market sentiment from the **last 7 days** of headlines and social/analyst tone.
+2. **Spread construction**
+   - For each of the **3 recommended spreads**, specify:
+     - **Underlying ticker**
+     - **Spread type** (e.g., bull put, bear call, iron condor)
+     - **Exact expiry date** (YYYY-MM-DD)
+     - **Each leg**: side (sell/buy), option type (put/call), **strike price**
+     - **Premium entry**: exact net credit/debit per share (use live bid/ask midpoint)
+     - **Position size guidance** (risk per trade as % of portfolio) — optional
+3. **Probability & rationale**
+   - Provide a **quantitative probability of profit (%)** (clearly state model/method used).
+   - Give a concise **rationale** linking 3-month trend, implied volatility, and sentiment to the spread choice.
+   - Show key supporting numbers: current spot, IV30, recent volatility, and relevant news headlines (with timestamps).
+
+###### Requirements / Guidelines
+- Target **>80% probability of profit** for each spread. Explain how the probability was computed (IV-based log-normal, normal approximation, or risk-neutral model).
+- **Always** use live option-chain quotes (bid/ask midpoint) and authoritative sources for prices/IV (e.g., exchange data, major market data providers).
+- Compare outcomes **vs. forecasts / recent range** and note any idiosyncratic risk (earnings, events).
+- Include **exact timestamps** (UTC) for all quoted prices.
+- Provide **sources** for price, IV, and headlines.
+
+###### Fallback
+- If live option-chain or price data is unavailable, state: **“Live market data unavailable — cannot generate exact strike/premium. Provide analysis based on most recent available snapshot.”**
+- If sentiment or 3-month history is incomplete, present what is available and **explicitly list missing items**.
+- **Do not fabricate** strikes, premiums, probabilities, or news — only use verified data.
+
+###### Output Style
+- For each spread, use a compact block with:
+  - Ticker — Spread type — Expiry (YYYY-MM-DD) — Net premium — PO P (%)
+  - Legs: bullet list of exact leg details (sell/buy, put/call, strike, premium)
+  - Rationale: 2–3 short sentences linking trend & sentiment to the trade
+  - Sources & timestamps
+- Keep language concise, factual, and machine/agent friendly for downstream parsing.
+- Use color and emoji to make it more engaging.

src/chatbot_v1/prompts/upcoming_earnings.txt

@@ -0,0 +1,27 @@
+##### Task
+Search for **upcoming critical earnings announcements** in the stock market.
+
+###### Include
+- **Ticker**
+- **Company name**
+- **Earnings date & time**
+- **Expected EPS & revenue consensus**
+- **Last quarter’s actual EPS & revenue**
+- **Implied volatility trend ahead of earnings**
+
+###### Requirements / Guidelines
+- Focus on **high‑impact names** (large cap, high volume, sector leaders)
+- Include **earnings expected within the next 7 calendar days**
+- Use **primary/authoritative sources** for earnings dates and estimates (e.g., exchange calendars, Bloomberg/Refinitiv/Estimize)
+- Show **timestamped data** (UTC)
+
+###### Fallback
+- If no critical earnings are found in the next 7 days, state:  
+  **“No upcoming critical earnings announcements found within the specified period.”**
+- If consensus estimates are unavailable, list the earnings date/time and note missing metrics.
+
+###### Output Style
+- Structured list sorted by **earnings date**
+- Use clear bullet points or short paragraphs
+- Provide **sources** for each item
+- Use color and emoji to make it more engaging.

src/chatbot_v1/trace_config.py

@@ -0,0 +1,37 @@
+# trace_config.py
+import openai
+from langsmith.wrappers import wrap_openai
+import os
+
+print("🔌 APPLYING LANGSMITH TRACE PATCH...")
+
+# 1. Save original classes
+_OriginalOpenAI = openai.OpenAI
+_OriginalAsyncOpenAI = openai.AsyncOpenAI
+
+# 2. Define the shim
+def PatchedOpenAI(*args, **kwargs):
+    print("✨ Creating Wrapped OpenAI Client (Sync)") # Debug print
+    client = _OriginalOpenAI(*args, **kwargs)
+    return wrap_openai(client)
+
+def PatchedAsyncOpenAI(*args, **kwargs):
+    print("✨ Creating Wrapped OpenAI Client (Async)") # Debug print
+    client = _OriginalAsyncOpenAI(*args, **kwargs)
+    return wrap_openai(client)
+
+# 3. Apply patch
+openai.OpenAI = PatchedOpenAI
+openai.AsyncOpenAI = PatchedAsyncOpenAI
+
+from langsmith import traceable
+
+# You can't decorate the class directly with @traceable, 
+# but you can use this helper to wrap all methods:
+
+def instrument_class(cls):
+    for attr_name, attr_value in cls.__dict__.items():
+        if callable(attr_value) and not attr_name.startswith("__"):
+            setattr(cls, attr_name, traceable(attr_value, run_type="tool"))
+    return cls
+

src/chatbot_v2/Dockerfile

@@ -0,0 +1,35 @@
+FROM python:3.12-slim
+
+ENV PYTHONUNBUFFERED=1 \
+    DEBIAN_FRONTEND=noninteractive \
+    PYTHONPATH=/app:/app/common:$PYTHONPATH
+
+WORKDIR /app
+
+# System deps
+RUN apt-get update && apt-get install -y \
+    git build-essential curl \
+    && rm -rf /var/lib/apt/lists/*
+
+# Install uv
+RUN curl -LsSf https://astral.sh/uv/install.sh | sh
+ENV PATH="/root/.local/bin:$PATH"
+
+# Copy project metadata
+COPY pyproject.toml .
+COPY uv.lock .
+
+# Copy required folders
+COPY common/ ./common/
+COPY src/chatbot_v2/ ./src/chatbot_v2/
+
+# Install dependencies using uv, then export and install with pip to system
+RUN uv sync --frozen --no-dev && \
+    uv pip install -e . --system
+
+# Copy entry point
+COPY run.py .
+
+EXPOSE 7860
+
+CMD ["python", "run.py", "chatbot_v2", "--port", "7860"]

src/chatbot_v2/README.md

@@ -0,0 +1,223 @@
+---
+title: AI Chatbot
+emoji: 🤖
+colorFrom: pink
+colorTo: yellow
+sdk: docker
+sdk_version: "0.0.1"
+app_file: app.py
+pinned: false
+license: mit
+tags:
+  - text-generation
+  - agentic-ai
+  - openai-sdk
+short_description: An Experimental Agentic Chatbot (uses OpenAI Agent SDK)
+---
+
+# AI Chatbot
+
+This is an experimental chatbot for chatting with AI. It is equipped with agents & tools to give you realtime data from the web. It uses **OpenAI - SDK** and **OpenAI - Agents**...
+
+## Features
+- Predefined prompts for quick analysis
+- Chat interface with AI responses
+- Enter key support and responsive design
+- Latest messages appear on top
+
+## Usage
+1. Type a message or select a predefined prompt
+2. Press **Enter** or click **Send**
+3. AI responses appear instantly in the chat interface
+
+## Supported APIs
+- OpenAI
+- Google
+- GROQ
+- SERPER
+- News API
+
+## Notes
+- Make sure your API keys are configured in the Space secrets
+- Built using Streamlit and deployed as a Docker Space
+
+## References
+
+https://openai.github.io/openai-agents-python/
+
+https://github.com/openai/openai-agents-python/tree/main/examples/mcp
+
+## Project Folder Structure
+
+```
+chatbot/
+├── app.py                    # Main Streamlit chatbot interface
+├── appagents/
+│   ├── __init__.py               # Package initialization
+│   ├── OrchestratorAgent.py      # Main orchestrator - coordinates all agents
+│   ├── FinancialAgent.py         # Financial data and analysis agent
+│   ├── NewsAgent.py              # News retrieval and summarization agent
+│   ├── SearchAgent.py            # General web search agent
+│   └── InputValidationAgent.py   # Input validation and sanitization agent
+├── core/
+│   ├── __init__.py               # Package initialization
+│   └── logger.py                 # Centralized logging configuration
+├── tools/
+│   ├── __init__.py               # Package initialization
+│   ├── google_tools.py           # Google search API wrapper
+│   ├── yahoo_tools.py            # Yahoo Finance API wrapper
+│   ├── news_tools.py             # News API wrapper
+│   └── time_tools.py             # Time-related utility functions
+├── prompts/
+│   ├── economic_news.txt         # Prompt for economic news analysis
+│   ├── market_sentiment.txt      # Prompt for market sentiment analysis
+│   ├── news_headlines.txt        # Prompt for news headline summarization
+│   ├── trade_recommendation.txt  # Prompt for trade recommendations
+│   └── upcoming_earnings.txt     # Prompt for upcoming earnings alerts
+├── Dockerfile                     # Docker configuration for container deployment
+├── pyproject.toml                 # Project metadata and dependencies (copied from root)
+├── uv.lock                        # Locked dependency versions (copied from root)
+├── README.md                      # Project documentation
+└── run.py                         # Script to run the application locally
+```
+
+## File Descriptions
+
+### UI Layer
+- **app.py** - Main Streamlit chatbot interface that provides:
+  - Chat message display with user and AI messages
+  - Text input for user queries
+  - Predefined prompt buttons for quick analysis
+  - Real-time AI responses
+  - Support for Enter key submission
+  - Responsive design with latest messages appearing first
+
+### Agents (`appagents/`)
+- **OrchestratorAgent.py** - Main orchestrator that:
+  - Coordinates communication between all specialized agents
+  - Routes user queries to appropriate agents
+  - Manages conversation flow and context
+  - Integrates tool responses
+
+- **FinancialAgent.py** - Financial data and analysis:
+  - Retrieves stock prices and financial metrics
+  - Performs financial analysis using Yahoo Finance API
+  - Provides market insights and recommendations
+  - Integrates with yahoo_tools for data fetching
+
+- **NewsAgent.py** - News retrieval and summarization:
+  - Fetches latest news articles
+  - Summarizes news content
+  - Integrates with News API for real-time updates
+  - Provides news-based market insights
+
+- **SearchAgent.py** - General web search:
+  - Performs web searches for general queries
+  - Integrates with Google Search / Serper API
+  - Returns relevant search results
+  - Supports multi-source data gathering
+
+- **InputValidationAgent.py** - Input validation:
+  - Sanitizes user input
+  - Validates query format and content
+  - Prevents malicious inputs
+  - Ensures appropriate content
+
+### Core Utilities (`core/`)
+- **logger.py** - Centralized logging configuration:
+  - Provides consistent logging across agents
+  - Handles different log levels
+  - Formats log messages for clarity
+
+### Tools (`tools/`)
+- **google_tools.py** - Google Search API wrapper:
+  - Executes web searches via Google Search / Serper API
+  - Parses and returns search results
+  - Handles API authentication
+
+- **yahoo_tools.py** - Yahoo Finance API integration:
+  - Retrieves stock price data
+  - Fetches financial metrics and indicators
+  - Provides historical price data
+  - Returns earnings information
+
+- **news_tools.py** - News API integration:
+  - Fetches latest news articles
+  - Filters news by category and keywords
+  - Returns news headlines and summaries
+  - Provides market-related news feeds
+
+- **time_tools.py** - Time utility functions:
+  - Provides current time information
+  - Formats timestamps
+  - Handles timezone conversions
+
+### Prompts (`prompts/`)
+Predefined prompts for specialized analysis:
+- **economic_news.txt** - Analyzes economic news and implications
+- **market_sentiment.txt** - Analyzes market sentiment trends
+- **news_headlines.txt** - Summarizes and explains news headlines
+- **trade_recommendation.txt** - Provides trading recommendations
+- **upcoming_earnings.txt** - Alerts about upcoming earnings reports
+
+### Configuration Files
+- **Dockerfile** - Container deployment:
+  - Builds Docker image with Python 3.12
+  - Installs dependencies using `uv`
+  - Sets up Streamlit server on port 8501
+  - Configures PYTHONPATH for module imports
+
+- **pyproject.toml** - Project metadata:
+  - Package name: "agents"
+  - Python version requirement: 3.12
+  - Lists all dependencies (OpenAI, LangChain, Streamlit, etc.)
+
+- **uv.lock** - Dependency lock file:
+  - Ensures reproducible builds
+  - Pins exact versions of all dependencies
+
+## Key Technologies
+
+| Component | Technology | Purpose |
+|-----------|-----------|---------|
+| LLM Framework | OpenAI Agents | Multi-agent orchestration |
+| Chat Interface | Streamlit | User interaction and display |
+| Web Search | Google Search / Serper API | Web search results |
+| Financial Data | Yahoo Finance API | Stock prices and metrics |
+| News Data | News API | Latest news articles |
+| Async Operations | AsyncIO | Parallel agent execution |
+| Dependencies | UV | Fast Python package management |
+| Containerization | Docker | Cloud deployment |
+
+## Predefined Prompts
+
+The chatbot includes quick-access buttons for common analysis:
+
+1. **Economic News** - Analyzes current economic trends and news
+2. **Market Sentiment** - Provides market sentiment analysis
+3. **News Headlines** - Summarizes latest news headlines
+4. **Trade Recommendation** - Suggests trading strategies
+5. **Upcoming Earnings** - Lists upcoming company earnings
+
+## Running Locally
+
+```bash
+# Install dependencies
+uv sync
+
+# Set environment variables defined in .env.name file
+export OPENAI_API_KEY="your-key"
+export SERPER_API_KEY="your-key"
+export NEWS_API_KEY="your-key"
+
+# Run the Streamlit app (from the root)
+python run.py chatbot
+```
+
+## Deployment
+
+The project is deployed on Hugging Face Spaces as a Docker container:
+- **Space**: https://huggingface.co/spaces/mishrabp/chatbot-app
+- **URL**: https://mishrabp-chatbot-app.hf.space
+- **Trigger**: Automatic deployment on push to `main` branch
+- **Configuration**: `.github/workflows/chatbot-app-hf.yml`

src/chatbot_v2/app.py

@@ -0,0 +1,274 @@
+import os
+import glob
+import uuid
+import asyncio
+import logging
+import streamlit as st
+
+# Import the new Orchestrator Pattern
+from src.chatbot_v2.patterns.orchestrator import ChatbotOrchestrator
+
+# -----------------------------
+# Configuration & Utils
+# -----------------------------
+st.set_page_config(
+    page_title="Layered AI Assistant",
+    layout="wide",
+    page_icon="🧠"
+)
+
+def load_prompts(folder="prompts"):
+    prompts = []
+    prompt_labels = []
+    if os.path.exists(folder):
+        for file_path in glob.glob(os.path.join(folder, "*.txt")):
+            with open(file_path, "r", encoding="utf-8") as f:
+                content = f.read().strip()
+                if content:
+                    prompts.append(content)
+
+            prompt_labels.append(os.path.basename(file_path).replace("_", " ").replace(".txt", "").title())
+    return prompts, prompt_labels
+
+prompts, prompt_labels = load_prompts()
+
+# -----------------------------
+# Session State
+# -----------------------------
+if "messages" not in st.session_state:
+    st.session_state.messages = []
+
+# Initialize the Agent
+if "agent" not in st.session_state:
+    st.session_state.agent = ChatbotOrchestrator()
+
+# -----------------------------
+# Premium Styling
+# -----------------------------
+st.markdown("""
+<style>
+    /* ---------------------------------------------------------------------
+       1. GLOBAL & RESET
+       --------------------------------------------------------------------- */
+    * {
+        box-sizing: border-box;
+    }
+    
+    .stApp, [data-testid="stAppViewContainer"] {
+        /* Standard Streamlit background */
+        background-color: #f8f9fa;
+        font-family: 'Inter', -apple-system, BlinkMacSystemFont, sans-serif, 'Apple Color Emoji', 'Segoe UI Emoji';
+    }
+    
+    html {
+        -webkit-text-size-adjust: 100%; /* Prevent iOS font boosting */
+    }
+    
+    /* ---------------------------------------------------------------------
+       2. LAYOUT & HERO BANNER
+       --------------------------------------------------------------------- */
+    
+    /* Mobile font optimization */
+    @media (max-width: 768px) {
+        /* Target all markdown text specifically */
+        .stMarkdown p, .stMarkdown li, .stChatMessage p, .message-content, .stDataFrame, .stTable {
+            font-size: 16px !important;
+            line-height: 1.6 !important;
+            color: #1a1a1a !important;
+        }
+        
+        h1, h2, h3, h4, h5, h6 {
+            color: #1a1a1a !important;
+        }
+    }
+    
+    /* Desktop Layout */
+    @media (min-width: 769px) {
+        .block-container {
+            padding-top: 0 !important;
+            padding-bottom: 2rem !important;
+            padding-left: 5rem !important;
+            padding-right: 5rem !important;
+            max-width: 100% !important;
+        }
+        
+        .hero-container {
+            margin-top: -3rem;
+            margin-left: -5rem;
+            margin-right: -5rem;
+            /* Simple negative margins to pull edge-to-edge */
+            padding: 2.5rem 1rem 2rem 1rem; /* Compact desktop padding */
+        }
+    }
+    
+    /* Mobile Layout */
+    @media (max-width: 768px) {
+        .block-container {
+            padding-left: 1rem !important;
+            padding-right: 1rem !important;
+            padding-top: 0 !important;
+            padding-bottom: 0rem !important;
+        }
+        
+        .hero-container {
+            margin-top: -2rem;
+            margin-left: -1rem;
+            margin-right: -1rem;
+            /* Break out of the 1rem padding */
+            padding: 2rem 1rem 1.5rem 1rem; /* Compact mobile padding */
+            border-radius: 0 0 12px 12px;
+        }
+    }
+
+    /* Hero Styling */
+    .hero-container {
+        background: linear-gradient(135deg, #667eea 0%, #764ba2 100%);
+        color: white;
+        text-align: center;
+        border-radius: 0 0 16px 16px;
+        box-shadow: 0 4px 15px rgba(0,0,0,0.1);
+        margin-bottom: 2rem;
+    }
+
+    .hero-title {
+        font-size: 2rem; /* Slightly smaller */
+        font-weight: 700;
+        margin-bottom: 0.25rem;
+        color: white !important;
+    }
+    .hero-subtitle {
+        font-size: 1rem;
+        opacity: 0.95;
+        font-weight: 400;
+        color: rgba(255,255,255,0.95) !important;
+    }
+    
+    /* Remove Header Decoration */
+    header[data-testid="stHeader"] {
+        background-color: transparent !important;
+        height: 0 !important;
+        z-index: 100;
+    }
+    div[data-testid="stDecoration"] { display: none; }
+    
+    /* ---------------------------------------------------------------------
+       3. COMPONENT STYLING (Healthcare-like)
+       --------------------------------------------------------------------- */
+    
+    /* Chat Bubbles - Clean & Readable */
+    .stChatMessage {
+        background-color: white;
+        border-radius: 12px;
+        border: 1px solid #e5e5e5;
+        box-shadow: 0 1px 2px rgba(0,0,0,0.05);
+        padding: 1rem;
+    }
+    
+    .stChatMessage[data-testid="stChatMessage"]:nth-of-type(odd) {
+         background-color: #f8f9fa;
+    }
+    
+    /* Input Fields */
+    .stTextInput input {
+        border-radius: 20px; /* Matching healthcare-assistant roundness */
+        border: 1px solid #ddd;
+        padding: 0.75rem 1rem;
+    }
+    
+    /* Buttons */
+    .stButton button {
+        border-radius: 20px; /* Matching healthcare-assistant */
+        min-height: 48px;
+        font-weight: 500;
+    }
+
+    /* Sidebar */
+    section[data-testid="stSidebar"] {
+        background-color: #ffffff;
+        border-right: 1px solid #eaeaea;
+    }
+    
+    /* Minimize Sidebar Top Padding */
+    section[data-testid="stSidebar"] .block-container {
+        padding-top: 0rem !important;
+        padding-bottom: 0rem !important;
+    }
+</style>
+""", unsafe_allow_html=True)
+
+# -----------------------------
+# Logic
+# -----------------------------
+async def get_ai_response(prompt: str) -> str:
+    try:
+        agent: ChatbotOrchestrator = st.session_state.agent
+        
+        # We pass the *previous* history (messages excluding the latest one which we just appended)
+        # Actually, st.session_state.messages ALREADY has the new user message appended below.
+        # So we pass messages[:-1] as "history"
+        history = st.session_state.messages[:-1]
+        
+        result = await agent.run(user_input=prompt, external_history=history)
+        return result
+    except Exception as e:
+        return f"❌ **Error**: {str(e)}"
+
+# -----------------------------
+# Sidebar - Quick Actions
+# -----------------------------
+with st.sidebar:
+    st.markdown("### ⚡ Quick Starters")
+    st.markdown("Select a prompt to start:")
+    
+    # We use a trick with st.button to act as input triggers
+    # If a button is clicked, we'll handle it in the main loop logic
+    selected_prompt = None
+    for idx, prompt_text in enumerate(prompts):
+        label = prompt_labels[idx] if idx < len(prompt_labels) else f"Prompt {idx+1}"
+        if st.button(label, key=f"sidebar_btn_{idx}", use_container_width=True):
+            # Reset conversation
+            st.session_state.messages = []
+            st.session_state.agent = ChatbotOrchestrator() # Reset agent memory too
+            selected_prompt = prompt_text
+
+    st.markdown("---")
+    if st.button("🗑️ Clear Conversation", use_container_width=True):
+        st.session_state.messages = []
+        st.session_state.agent = ChatbotOrchestrator()
+        st.rerun()
+
+# -----------------------------
+# Main Content
+# -----------------------------
+
+# Hero Banner (Always visible & Sticky)
+st.markdown("""
+    <div class="hero-container" role="banner">
+        <div class="hero-title">🧠 Layered AI Agent</div>
+        <div class="hero-subtitle">Architecture: Perception ➜ Cognition ➜ Action</div>
+    </div>
+""", unsafe_allow_html=True)
+
+# Display Chat History
+for message in st.session_state.messages:
+    with st.chat_message(message["role"]):
+        st.markdown(message["content"], unsafe_allow_html=True)
+
+# Chat Input Handling
+# We handle both the chat input widget and the sidebar selection here
+if prompt := (st.chat_input("Type your message...") or selected_prompt):
+    # User Message
+    st.session_state.messages.append({"role": "user", "content": prompt})
+    with st.chat_message("user"):
+        st.markdown(prompt)
+
+    # Assistant Response
+    with st.chat_message("assistant"):
+        with st.spinner("🧠 Thinking (Layers Active)..."):
+            response_text = asyncio.run(get_ai_response(prompt))
+            st.markdown(response_text, unsafe_allow_html=True)
+
+    st.session_state.messages.append({"role": "assistant", "content": response_text})
+    
+    if selected_prompt:
+        st.rerun()

src/chatbot_v2/layers/action.py

@@ -0,0 +1,71 @@
+import asyncio
+from typing import Any, Dict, List
+from agents import Runner
+from common.aagents.search_agent import search_agent
+from common.aagents.news_agent import news_agent
+from common.aagents.yf_agent import yf_agent
+
+class ActionLayer:
+    """
+    The 'Hands' of the agent.
+    Responsibility: Execute specific, well-defined tools or side-effects.
+    Does NOT reason about 'why'.
+    """
+    
+    def __init__(self):
+        # Register available tools
+        self.tools = {
+            "web_search": self._tool_web_search,
+            "financial_data": self._tool_financial_data,
+            "news_search": self._tool_news_search,
+            "broadcast_research": self._tool_broadcast_research
+        }
+    
+    async def execute(self, tool_name: str, args: Dict[str, Any]) -> str:
+        if tool_name not in self.tools:
+            return f"Error: Tool '{tool_name}' not found."
+        
+        print(f"[Action] Executing tool: {tool_name} with args: {args}")
+        try:
+            return await self.tools[tool_name](**args)
+        except Exception as e:
+            return f"Error executing {tool_name}: {str(e)}"
+
+    async def _tool_web_search(self, query: str) -> str:
+        result = await Runner.run(search_agent, query)
+        return f"Web Search Result:\n{result.final_output}"
+
+    async def _tool_financial_data(self, query: str) -> str:
+        result = await Runner.run(yf_agent, query)
+        return f"Financial Data:\n{result.final_output}"
+
+    async def _tool_news_search(self, query: str) -> str:
+        result = await Runner.run(news_agent, query)
+        return f"News Result:\n{result.final_output}"
+
+    async def _tool_broadcast_research(self, query: str, include_finance: bool = True, include_news: bool = True, include_search: bool = True) -> str:
+        """
+        Broadcasts the search query to selected specialized agents in parallel and aggregates their responses.
+        """
+        active_agents = []
+        if include_finance: active_agents.append(("YahooFinanceAgent", Runner.run(yf_agent, query)))
+        if include_news: active_agents.append(("NewsAgent", Runner.run(news_agent, query)))
+        if include_search: active_agents.append(("WebSearchAgent", Runner.run(search_agent, query)))
+
+        if not active_agents:
+            return "No agents were selected for this query."
+
+        # Run in parallel
+        agent_names = [name for name, _ in active_agents]
+        coroutines = [coro for _, coro in active_agents]
+        
+        results = await asyncio.gather(*coroutines, return_exceptions=True)
+        
+        outputs = []
+        for name, res in zip(agent_names, results):
+            if isinstance(res, Exception):
+                outputs.append(f"❌ {name} Error: {str(res)}")
+            else:
+                outputs.append(f"✅ {name} Report:\n{res.final_output}")
+                
+        return "\n--- START OF AGENT REPORTS ---\n\n" + "\n\n-----------------------------------\n\n".join(outputs) + "\n\n--- END OF AGENT REPORTS ---"

src/chatbot_v2/layers/cognition.py

@@ -0,0 +1,111 @@
+import json
+import os
+from typing import List, Dict, Optional
+from common.utility.openai_model_factory import OpenAIModelFactory
+from openai import OpenAI, AsyncOpenAI
+
+class CognitiveOutput:
+    def __init__(self, thought: str, action: Optional[str] = None, action_input: Optional[Dict] = None, final_answer: Optional[str] = None):
+        self.thought = thought
+        self.action = action
+        self.action_input = action_input
+        self.final_answer = final_answer
+
+class CognitionLayer:
+    """
+    The 'Brain' of the agent.
+    Uses OpenAI GPT-4o (via OpenAIModelFactory) to reason and decide which tools to use.
+    """
+    
+    
+    def __init__(self):
+        # Direct OpenAI client usage for maximum compatibility
+        # We circumvent the factory wrapper to access the raw client directly for JSON mode
+        api_key = os.environ.get("OPENAI_API_KEY")
+        self.client = OpenAI(api_key=api_key) if api_key else None
+        
+        # If we wanted to use the factory strictly, we'd need to know the exact internal attribute
+        # self.model_wrapper = OpenAIModelFactory.get_model(...)
+        # self.client = self.model_wrapper.client  # guessing 'client' vs 'openai_client'
+        # But to be safe and fix the user's error immediately:
+        from openai import AsyncOpenAI
+        self.client = AsyncOpenAI(api_key=api_key)
+
+        self.model_name = "gpt-4o"
+        
+        self.system_prompt = """
+You are the **AI Chat Orchestrator**. 
+Your goal is to provide a comprehensive, multi-perspective answer by synthesizing data from specialized sub-agents.
+
+**Available Tools**:
+1. `broadcast_research(query: str, include_finance: bool, include_news: bool, include_search: bool)`: 
+   Broadcasts the query to specialized agents (Finance, News, Web Search). Use this for complex queries needing external info.
+2. `web_search(query: str)`: Single web search.
+3. `financial_data(query: str)`: Single financial check.
+4. `news_search(query: str)`: Single news check.
+
+**Workflow**:
+1.  **Analyze Request**: Understand the user's question.
+2.  **Determine Needs**: Decide calls are needed.
+    *   **Finance**: For stock prices, market trends, company financials.
+    *   **News**: For recent events, headlines.
+    *   **Web Search**: For general knowledge, history.
+3.  **Action**: 
+    If you need external info, PREFER `broadcast_research` to query multiple sources in parallel.
+    If it's a simple greeting or general chat not requiring data, just answer.
+4.  **Synthesize Results**: 
+    When you receive tool outputs ("Agent Reports"), combine them into a clear, professional summary.
+    Do NOT simply paste the reports. Synthesize them.
+
+**Output Format**:
+You must output valid JSON only:
+{
+  "thought": "Reasoning...",
+  "action": "tool_name_or_null",
+  "action_input": { "arg": "value" } or null,
+  "final_answer": "Final output to user" or null
+}
+"""
+
+    async def decide(self, history: List[Dict[str, str]]) -> CognitiveOutput:
+        # 1. Construct Messages
+        messages = [{"role": "system", "content": self.system_prompt}]
+        
+        for entry in history:
+            role = entry['role']
+            content = entry['content']
+            
+            # Map roles. 'system' in our history layer usually means tool output.
+            if role == 'user':
+                messages.append({"role": "user", "content": content})
+            elif role == 'assistant':
+                messages.append({"role": "assistant", "content": content})
+            elif role == 'system':
+                messages.append({"role": "user", "content": f"Observation/Tool Output: {content}"})
+
+        # 2. Call LLM (Async)
+        try:
+            completion = await self.client.chat.completions.create(
+                model=self.model_name,
+                messages=messages,
+                response_format={"type": "json_object"}
+            )
+            
+            response_text = completion.choices[0].message.content
+            if response_text.startswith("```"):
+                response_text = response_text.strip("`").replace("json", "").strip()
+
+            data = json.loads(response_text)
+            
+            return CognitiveOutput(
+                thought=data.get("thought", ""),
+                action=data.get("action"),
+                action_input=data.get("action_input"),
+                final_answer=data.get("final_answer")
+            )
+            
+        except Exception as e:
+            return CognitiveOutput(
+                thought=f"Error: {str(e)}",
+                final_answer="I encountered an error processing your request."
+            )

src/chatbot_v2/layers/memory.py

@@ -0,0 +1,20 @@
+from typing import List, Dict
+
+class MemoryLayer:
+    """
+    The 'Memory' of the agent.
+    Responsibility: Store and retrieve conversation history.
+    """
+    
+    def __init__(self):
+        self.history: List[Dict[str, str]] = []
+
+    def add_entry(self, role: str, content: str):
+        self.history.append({"role": role, "content": content})
+
+    def get_history(self) -> List[Dict[str, str]]:
+        return self.history
+    
+    def set_history(self, messages: List[Dict[str, str]]):
+        """Allows initializing/overwriting memory from external source (e.g. Streamlit session)"""
+        self.history = messages