deploy: Hugging Face Space clean release

.env.example

@@ -0,0 +1,4 @@
+GEMINI_API_KEY=your-api-key
+GROQ_API_KEY=your-api-key
+FIRECRAWL_API_KEY=your-api-key
+OPENROUTER_API_KEY=your-api-key

.gitignore

@@ -0,0 +1,52 @@
+# Environments & Virtual Envs
+.env
+.env.local
+venv/
+.venv/
+env/
+ENV/
+
+# Python Cache & Bytecode
+__pycache__/
+*.py[cod]
+*$py.class
+.pytest_cache/
+
+# Agentic Workspaces / Temp Sandboxes
+temp/
+
+# OS specific files
+.DS_Store
+Thumbs.db
+db.sqlite3
+
+# IDE files
+.vscode/
+.idea/
+*.suo
+*.ntvs*
+*.njsproj
+*.sln
+*.swp
+
+#teach
+MISSION.md
+NOTES.md
+RESOURCES.md
+/lessons
+AboutMe.md
+/learning-records
+
+#PRD
+PRD.md
+
+#Security Report
+ArchitectureSecurityReport.md
+
+#test
+test/
+deploy.ps1
+README.hf.md
+
+#venv
+dev/

Dockerfile

@@ -0,0 +1,40 @@
+# Start with a slim Python base image
+FROM python:3.11-slim
+
+# Install system dependencies (Node.js, Go, Java JDK, and compilation tools)
+RUN apt-get update && apt-get install -y \
+    curl \
+    gnupg \
+    build-essential \
+    git \
+    golang \
+    default-jdk \
+    && curl -fsSL https://deb.nodesource.com/setup_18.x | bash - \
+    && apt-get install -y nodejs \
+    && rm -rf /var/lib/apt/lists/*
+
+# Pre-install typescript and ts-node globally as root for fast and offline TypeScript test executions
+RUN npm install -g typescript ts-node
+
+# Set up a new non-root user named "user" with UID 1000 for Hugging Face Spaces security compliance
+RUN useradd -m -u 1000 user
+USER user
+ENV HOME=/home/user \
+    PATH=/home/user/.local/bin:$PATH
+
+# Set up working directory inside the user's home folder
+WORKDIR $HOME/app
+
+# Copy and install Python dependencies as the user
+COPY --chown=user requirements.txt .
+RUN pip install --no-cache-dir --user -r requirements.txt
+
+# Copy application assets with proper ownership
+COPY --chown=user . $HOME/app
+
+# Hugging Face Spaces always expose port 7860
+EXPOSE 7860
+
+# Run FastAPI using uvicorn (serving main:app)
+CMD ["uvicorn", "main:app", "--host", "0.0.0.0", "--port", "7860"]
+

OutputFormat.md

@@ -0,0 +1,194 @@
+# Code Generation & Output Format Specification
+
+This document details how the Smart API DevTool packages, displays, and delivers generated code assets and test files to the developer.
+
+---
+
+## 1. User Interface Display (Tabbed Preview)
+When the LangGraph self-healing agent completes generation, the Web UI renders a tabbed workspace containing five distinct views:
+
+1. **Overview & Auth Tab**: Displays extracted auth methods and the integration path recommendation (REST vs. SDK).
+2. **Endpoints Explorer Tab**: Shows an interactive dictionary of endpoints (GET, POST, DELETE), headers, query params, and request payloads.
+3. **Wrapper Class Tab**: Displays the syntax-highlighted source code of the generated client wrapper.
+4. **Unit Tests Tab**: Displays the generated testing suite script.
+5. **README Guide Tab**: Displays markdown usage instructions, library dependencies, and instantiation examples.
+
+---
+
+## 2. Download Deliverables & File Structure
+Developers can download files individually or as a unified bundle.
+
+### Option A: The Integration Bundle (ZIP)
+Clicking the **"Download Integration Bundle (ZIP)"** button packages all generated files into a single ZIP file dynamically in the browser using `JSZip`. The extracted bundle structure varies by language:
+
+#### Python
+```text
+my-api-integration/
+├── README.md          # Setup instructions, dependencies, and code import examples
+├── client.py          # The generated, type-safe wrapper class
+└── test_client.py     # The Pytest test suite for validation (unittest.mock)
+```
+
+#### JavaScript
+```text
+my-api-integration/
+├── README.md          # Setup instructions and CommonJS import examples
+├── client.js          # The client class (exported via module.exports = { MyClientClass };)
+└── test_client.test.js # Standalone Node test script using named require and global fetch patch
+```
+
+#### TypeScript
+```text
+my-api-integration/
+├── README.md          # Setup instructions and TS import examples
+├── client.ts          # The client class (exported via export class MyClientClass { ... })
+├── test_client.test.ts # Standalone TS test script using named imports
+└── tsconfig.json      # Minimal TypeScript config for sandbox/ts-node runtimes
+```
+
+#### Go
+```text
+my-api-integration/
+├── README.md          # Setup instructions and go package import examples
+├── client.go          # Go package source file defining the client struct
+├── client_test.go     # Native Go test suite using testing package and httptest.NewServer
+└── go.mod             # Temporary Go module name definition
+```
+
+#### Java
+```text
+my-api-integration/
+├── README.md          # Setup instructions and compilation steps
+├── MyAPIClient.java   # The Java client class (using java.net.http.HttpClient)
+└── TestClient.java    # Standalone Java class with main() method running assertions (-ea)
+```
+
+---
+
+## 3. Reference Output Code Structures
+
+Below are the standard, production-ready structures of generated client wrappers and test suites.
+
+### Python Client (Requests + Tenacity Retry)
+The Python client utilizes `requests.Session` for connection pooling, type hints, custom error wrappers, and `tenacity.Retrying` dynamically at runtime to respect user configurations:
+
+```python
+import requests
+from tenacity import Retrying, stop_after_attempt, wait_exponential, retry_if_exception_type
+from typing import Dict, Any, Optional
+
+class APIError(Exception):
+    """Base exception for API errors."""
+    pass
+
+class APIRateLimitError(APIError):
+    """Exception for rate limits (429)."""
+    pass
+
+class APIServerError(APIError):
+    """Exception for server-side downtime (5xx)."""
+    pass
+
+class APIClient:
+    def __init__(self, api_key: str, base_url: str = "https://api.example.com/v1", max_retries: int = 3):
+        if not api_key:
+            raise ValueError("API key cannot be empty.")
+        self.api_key = api_key
+        self.base_url = base_url.rstrip("/")
+        self.max_retries = max_retries
+        self.session = requests.Session()
+        self.session.headers.update({
+            "Authorization": f"Bearer {self.api_key}",
+            "Content-Type": "application/json"
+        })
+
+    def _retry_request(self, func):
+        """Dynamic tenacity runner to enforce instance-level retry limits."""
+        retrier = Retrying(
+            stop=stop_after_attempt(self.max_retries + 1),
+            wait=wait_exponential(multiplier=0.5, min=1, max=30),
+            retry=(
+                retry_if_exception_type(APIRateLimitError) |
+                retry_if_exception_type(APIServerError)
+            ),
+            reraise=True
+        )
+        return retrier(func)
+
+    def _make_request(self, method: str, path: str, json_data=None) -> Dict[str, Any]:
+        url = f"{self.base_url}/{path.lstrip('/')}"
+        response = self.session.request(method, url, json=json_data, timeout=10)
+        
+        if response.status_code == 429:
+            raise APIRateLimitError(f"Rate limited: {response.text}")
+        elif response.status_code >= 500:
+            raise APIServerError(f"Server error: {response.status_code}")
+        
+        response.raise_for_status()
+        return response.json()
+
+    def get_resource(self, resource_id: str) -> Dict[str, Any]:
+        return self._retry_request(lambda: self._make_request("GET", f"/resources/{resource_id}"))
+```
+
+### JavaScript Client & Test (CommonJS + Async IIFE Test Harness)
+The JavaScript client uses named exports, the global `fetch` API, and standard Node.js assertions inside a self-contained sequential test block:
+
+```javascript
+// client.js
+class APIClient {
+   constructor(apiKey) {
+      if (!apiKey) throw new Error('API key cannot be empty.');
+      this.apiKey = apiKey;
+      this.baseUrl = 'https://api.example.com/v1';
+   }
+
+   async getResource(resourceId) {
+      const response = await fetch(`${this.baseUrl}/resources/${resourceId}`, {
+         method: 'GET',
+         headers: {
+            'Authorization': `Bearer ${this.apiKey}`,
+            'Content-Type': 'application/json'
+         }
+      });
+      if (!response.ok) throw new Error(`HTTP Error ${response.status}`);
+      return await response.json();
+   }
+}
+
+module.exports = { APIClient };
+```
+
+```javascript
+// test_client.test.js
+const assert = require('assert');
+const { APIClient } = require('./client');
+
+async function runTests() {
+   const originalFetch = globalThis.fetch;
+   try {
+      // Setup local request mock
+      globalThis.fetch = async (url, options) => {
+         assert.strictEqual(options.headers['Authorization'], 'Bearer test-key');
+         return {
+            ok: true,
+            json: async () => ({ id: '123', name: 'Sample' })
+         };
+      };
+
+      const client = new APIClient('test-key');
+      const data = await client.getResource('123');
+      assert.deepStrictEqual(data, { id: '123', name: 'Sample' });
+      
+      console.log('All tests passed successfully.');
+   } catch (error) {
+      console.error('Test execution failed:', error);
+      process.exit(1);
+   } finally {
+      globalThis.fetch = originalFetch;
+   }
+   process.exit(0);
+}
+
+runTests();
+```

ProjectPlan.md

@@ -0,0 +1,212 @@
+# Project Master Plan: Smart API DevTool
+
+This document serves as the master coordinator for the **Smart API DevTool** project. It outlines our architectural roadmap, directory structure, Git workflow, and connects all local configuration, lesson, and implementation tracking files.
+
+---
+
+## 1. Project Overview & Architecture
+
+This tool is designed to demonstrate python-based backend engineering, docker configurations, and modern agentic architectures:
+1. **Interactive Web Dashboard**: A local Python FastAPI server hosting a premium, dark-themed responsive single-page HTML/CSS/JS frontend.
+2. **Model Context Protocol (MCP) Server**: A standard protocol wrapper enabling AI agents (like Claude Desktop or Cursor) to call your scraping and wrapper-generation engine natively from the IDE.
+
+### System Architecture Flow (Unified Core Engine)
+
+Our Core Engine uses **LangGraph** to orchestrate a single-agent **Self-Healing Test Loop** that runs generated unit tests inside our Docker container, captures failures, and auto-corrects code errors.
+
+```
+                  ┌────────────────────────────────┐
+                  │    Developer Request / Input   │
+                  └───────────────┬────────────────┘
+                                  │ (URL or Paste Docs)
+                                  ▼
+                  ┌────────────────────────────────┐
+                  │     Core Scraping Service      │
+                  │   (Firecrawl Keyless / Local)  │
+                  └───────────────┬────────────────┘
+                                  │ (Clean Markdown Docs)
+                                  ▼
+                  ┌────────────────────────────────┐
+                  │ Pre-Generation Grounding Check │
+                  │  (Validate REST API Specs)     │
+                  └───────┬────────────────┬───────┘
+                          │                │
+            (Specs Found) ▼                ▼ (No Specs Found)
+                  ┌────────────────┐  ┌────────────────┐
+                  │ Proceed to Gen │  │ Raise error    │
+                  └───────┬────────┘  │ (Fail Fast UI) │
+                          │           └────────────────┘
+                          ▼
+                  ┌────────────────────────────────┐
+                  │    Unified Provider Router     │
+                  │ (Gemini, Groq, OpenRouter,     │
+                  │         or Ollama)             │
+                  └───────┬────────────────┬───────┘
+                          │                │
+             (Cloud API)  ▼                ▼ (Local: qwen2.5-coder)
+                  ┌──────────────┐  ┌──────────────┐
+                  │   Cloud API  │  │  Ollama API  │
+                  │ (Gemini/Groq/│  └──────┬───────┘
+                  │  OpenRouter) │         │
+                  └──────┬───────┘         │
+                         │                 │
+                         └────────┬────────┘
+                                  │ (Initial Wrapper & Test Suite Code)
+                                  ▼
+                  ┌────────────────────────────────┐
+                  │    LangGraph: Generate Node    │◄──────────┐
+                  │  (State: code, tests, errors)  │           │
+                  └───────────────┬────────────────┘           │ (Failed)
+                                  │                            │ Route back
+                                  ▼                            │ with error
+                  ┌────────────────────────────────┐           │ logs
+                  │      LangGraph: Test Node      │           │
+                  │  (Executes tests inside the    │           │
+                  │   Docker container using local │           │
+                  │   subprocesses: pytest, node,  │           │
+                  │   ts-node, go, java)           │           │
+                  └───────────────┬────────────────┘           │
+                                  │                            │
+                                  ├─► [Test Fails & Retries < 3]─┘
+                                  │
+                                  ▼ [Test Passes OR Retries >= 3]
+                  ┌────────────────────────────────┐
+                  │         END / Deliver          │
+                  └───────┬────────────────┬───────┘
+                           │                │
+                           ▼                ▼
+              ┌────────────────────────┐┌────────────────────────┐
+              │  Web UI Output Panel   ││  MCP Client Response   │
+              │  (Browser Download)    ││  (IDE Code Write)      │
+              └────────────────────────┘└────────────────────────┘
+```
+
+---
+
+## 2. Directory Structure
+
+```
+smart-api-devtool/
+├── requirements.txt        - Python dependencies (fastapi, uvicorn, langgraph, google-genai)
+├── main.py                 - Entrypoint: launches FastAPI server or MCP server mode
+├── Dockerfile              - Docker setup pre-installing Python, Node, Go, and Java runtimes
+├── ProjectPlan.md          - Master coordination plan (This file)
+├── MISSION.md              - Project goals and learning mission
+├── RESOURCES.md            - Curated list of documentation and wisdom links
+├── NOTES.md                - Local notes & preferences
+├── OutputFormat.md         - Layout formats for code outputs
+├── AboutMe.md              - Author profile and hackathon directives
+├── PRD.md                  - Product Requirements Document
+├── src/
+│   ├── config.py           - Application configurations & env validation
+│   ├── app.py              - FastAPI server routes, static assets serving, and CORS config
+│   ├── mcp_server.py       - Model Context Protocol integration handler
+│   ├── agent.py            - LangGraph Agent Definition (State, Nodes, validation, and Graph)
+│   └── services/
+│       ├── scraper.py      - Firecrawl HTTP client (supports keyless & API keys)
+│       └── executor.py     - Subprocess code runner executing python/node/go/java sandboxes
+├── public/                 - Web Dashboard Assets
+│   ├── index.html          - High-end dark theme dashboard
+│   ├── style.css           - Custom glassmorphic styles & animations
+│   └── app.js              - Frontend application controller
+├── lessons/                - Curriculum for developer topics
+└── learning-records/       - Log of key decisions and insights
+```
+
+---
+
+## 3. Project References
+
+Use these clickable file links to inspect details, check tasks, and verify progress:
+
+### Core Configuration Files
+* **[MISSION.md](file:///d:/Downloads/Projects/My%20College%20Projects/Smart%20DevTool%20for%20API%20Integration/MISSION.md)**: Goals and scope boundaries.
+* **[RESOURCES.md](file:///d:/Downloads/Projects/My%20College%20Projects/Smart%20DevTool%20for%20API%20Integration/RESOURCES.md)**: Curated scraping and API development guides.
+* **[NOTES.md](file:///d:/Downloads/Projects/My%20College%20Projects/Smart%20DevTool%20for%20API%20Integration/NOTES.md)**: Scratchpad of active work items and preferences.
+* **[Output Format Guide](file:///d:/Downloads/Projects/My%20College%20Projects/Smart%20DevTool%20for%20API%20Integration/OutputFormat.md)**: Details on ZIP structures and generated code client classes.
+* **[Developer Profile](file:///d:/Downloads/Projects/My%20College%20Projects/Smart%20DevTool%20for%20API%20Integration/AboutMe.md)**: Bio and hackathon placement goals.
+* **[PRD Specifications](file:///d:/Downloads/Projects/My%20College%20Projects/Smart%20DevTool%20for%20API%20Integration/PRD.md)**: Product Requirements Document with user stories and decisions.
+
+### System-Generated Artifacts
+* **[Implementation Plan](file:///C:/Users/yashw/.gemini/antigravity/brain/bfcca984-987f-419e-96de-3d92c17e1877/implementation_plan.md)**: Detailed technical specifications for backend services, API structures, and frontend routes.
+* **[Active Task Checklist](file:///C:/Users/yashw/.gemini/antigravity/brain/bfcca984-987f-419e-96de-3d92c17e1877/task.md)**: Current completion status of specific development steps.
+* **[Walkthrough Report](file:///C:/Users/yashw/.gemini/antigravity/brain/bfcca984-987f-419e-96de-3d92c17e1877/walkthrough.md)**: Summary of final work, validations, and testing outputs.
+
+---
+
+## 4. Phase-by-Phase Roadmap
+
+### **Phase 1: Project Setup & Core Services (Completed)**
+* Configure Python virtual environment and `requirements.txt`.
+* Write the `Dockerfile` installing Python, Node, Go, and Java runtimes.
+* Set up FastAPI app boilerplate (`main.py`, `src/app.py`).
+* Code `scraper.py` using Firecrawl REST interface.
+* Code test runner `executor.py` utilizing Python subprocesses to execute language-specific test runs inside a `/temp` folder sandbox.
+* *Verification*: Verify URL scraping and local test-suite executions via scripts.
+
+### **Phase 2: LangGraph Self-Healing Agent (Completed)**
+* Define the LangGraph State, `generate` Node, and `test` Node.
+* Code the conditional transition edge (Self-Heal Loop up to 3 retries).
+* Connect the compiled LangGraph to the FastAPI endpoints.
+* *Verification*: Verify self-healing loop by running local tests.
+
+### **Phase 3: MCP Server Integration (Completed)**
+* Implement `mcp_server.py` using standard Model Context Protocol stream handlers.
+* Bind standard CLI flag (`python main.py --mcp`) to run the MCP server.
+
+### **Phase 4: Premium Web UI & Exporter (Completed)**
+* Design HTML5 layout with glassmorphism CSS aesthetics.
+* Incorporate model selector dropdowns (Gemini, Ollama, Groq, OpenRouter), and live terminal logging showing the self-healing test runs.
+* Expose code exports (downloading wrapper, unit tests, and README file in a single ZIP).
+
+### **Phase 5: Hugging Face Spaces Deployment (Completed)**
+* Deploy the application to a Hugging Face Space using the custom Dockerfile.
+* *Verification*: Test the hosted web service dynamically in the cloud.
+
+### **Phase 6: Grounding Hardening & Git Delivery (Completed)**
+* Implement LLM-based pre-generation documentation checks to prevent endpoint hallucinations.
+* Apply strict dependency-free test execution rules across all five supported languages.
+* Format the codebase, compile the walkthrough report, and commit changes using Conventional Commit patterns.
+
+---
+
+## 5. Future System Design Proposals
+
+### Architectural Question: Concurrency & Sandbox Isolation on Free Cloud Runtimes
+> *"If there are 10 to 100 users using a local host, when they are using local host and if they do not have the package installed, we do not want to disturb their local system. If we use the Docker availability in Hugging Face and make it a common platform to run all the tasks for those 100 users, there is a resources bottleneck on the free tier (2 vCPUs, 16 GB RAM). How can we resolve this on a free-tier basis to improve project system design?"*
+
+### Proposed Solution: Piston-Based Serverless Code Execution
+To eliminate compiler installation overhead inside the host Docker image and prevent CPU/RAM resource starvation under concurrent user spikes, we propose offloading sandbox executions to a serverless code execution engine:
+
+#### 1. How it Works
+- Instead of executing tests locally via Python subprocesses (`pytest`, `node`, `go test`, `javac`), the sandbox executor (`src/services/executor.py`) delegates execution to a **Piston API** endpoint.
+- The executor constructs an HTTP POST request containing the generated wrapper source code, the test file code, and the language identifier, sending it to a public or private Piston API instance:
+  ```http
+  POST /api/v2/execute HTTP/1.1
+  Host: emkc.org
+  Content-Type: application/json
+
+  {
+    "language": "python",
+    "version": "3.10.0",
+    "files": [
+      {
+        "name": "client.py",
+        "content": "class MyAPIClient: ..."
+      },
+      {
+        "name": "test_client.py",
+        "content": "def test_get_user(): ..."
+      }
+    ]
+  }
+  ```
+- The Piston container runs the tests in isolation and returns structured JSON containing the stdout, stderr, and process exit code.
+
+#### 2. Architectural Impact
+* **Pros:**
+  - **Ultra-Lightweight Containers:** Deletes heavy compilers (golang, default-jdk, nodejs) from the custom Dockerfile, shrinking the image size from ~2GB to <200MB.
+  - **Zero CPU/RAM Contention:** Shifting the compilation work off the Hugging Face Space protects it from OOM (Out of Memory) crashes when 100 concurrent users trigger code executions.
+  - **No Local Installs:** Users do not need any local compiler packages on their system, maintaining complete environment isolation.
+* **Cons:**
+  - Introduces a network dependency on third-party public execution endpoints, which may be subject to external rate limits or availability.

README.md

@@ -0,0 +1,108 @@
+---
+title: Smart API DevTool
+emoji: 🚀
+colorFrom: indigo
+colorTo: blue
+sdk: docker
+app_port: 7860
+pinned: false
+---
+
+# Smart API DevTool
+
+A local developer utility that automates third-party API integration. By taking an API documentation URL (or raw pasted text) and a description of your target use case, it scrapes endpoints, recommends integration paths, generates type-safe wrapper classes, and automatically compiles and self-heals any code bugs using localized sandboxes.
+
+The engine validates the scraped content using an LLM **Pre-Check Grounding Validation** step to ensure REST specifications exist (failing fast on high-level landing pages), and uses **LangGraph** to coordinate a self-correcting loop that feeds compiler and test logs back to the LLM (up to 3 retries) until the generated assets compile and pass mock checks.
+
+> [!NOTE]
+> This application is built as a hybrid workspace: it serves both a premium **Web Dashboard** (FastAPI backend + Glassmorphic HTML/CSS/JS frontend) and a local **Model Context Protocol (MCP) Server** to let IDE agents (like Claude Desktop or Cursor) call the scraping and wrapper generation natively.
+
+---
+
+## Technical Stack & Runtimes
+
+* **Core Engine**: Python 3.12, FastAPI, Uvicorn, Pydantic Settings
+* **Agentic Graph**: LangGraph state machine orchestrator
+* **AI Generation**: Google Gemini API (via official `google-genai` SDK), Groq API, OpenRouter API, & local Ollama (`qwen2.5-coder`)
+* **Scraper**: Firecrawl REST scraping service (supporting both API keys and keyless fallback)
+* **Sandboxed Compilers**: Spawns isolated local runtimes for Python (`pytest`), JavaScript (`node`), TypeScript (`ts-node`), Go (`go test`), and Java (`javac`/`java`)
+
+> [!IMPORTANT]
+> To execute multi-language sandboxes, the corresponding compilers/runtimes (like `node`, `go`, and `jdk`) must be installed on your local host system. If a runtime is absent, the execution service traps the exception and returns the diagnostic failure cleanly without crashing the core agent thread.
+
+---
+
+## Project Structure
+
+```text
+├── main.py                 # Entrypoint (CLI flags to launch FastAPI Web Server or MCP Server)
+├── requirements.txt        # Virtual environment python dependencies
+├── Dockerfile              # Unified build image containing Node, Go, Java, and Python runtimes
+├── src/
+│   ├── app.py              # FastAPI server routes, static assets serving, and CORS config
+│   ├── config.py           # Configuration manager validating env parameters via Pydantic
+│   ├── agent.py            # LangGraph StateGraph, pre-check validation, and code execution nodes
+│   └── services/
+│       ├── scraper.py      # Firecrawl client featuring SSL and rate limit retries
+│       └── executor.py     # Sandbox subprocess runner with dynamic compiler timeouts
+├── public/                 # Web Dashboard assets (HTML, glassmorphism CSS, and controllers)
+├── lessons/                # Academic curriculum detailing sandbox patterns and state machines
+└── learning-records/       # Technical log tracking system designs and key architectural choices
+```
+
+---
+
+## Local Setup
+
+### 1. Clone & Set Up Python Environment
+
+Ensure Python 3.12+ is installed:
+
+```bash
+python -m venv venv
+venv\Scripts\activate      # On Windows
+source venv/bin/activate    # On Unix/macOS
+pip install -r requirements.txt
+```
+
+### 2. Configure Environment Variables
+
+Create a `.env` file in the project root:
+
+```ini
+GEMINI_API_KEY=your_gemini_api_key_here
+GROQ_API_KEY=your_groq_api_key_here
+OPENROUTER_API_KEY=your_openrouter_api_key_here
+FIRECRAWL_API_KEY=optional_firecrawl_api_key
+OLLAMA_BASE_URL=http://localhost:11434
+HOST=0.0.0.0
+PORT=7860
+```
+
+> [!TIP]
+> If you don't supply a Firecrawl API key, the scraping service automatically falls back to Firecrawl's Cloud Keyless Mode. Similarly, if you want a local-only setup with zero costs, you can select the **Ollama** model provider in the interface to route generations to your local `qwen2.5-coder` instance.
+
+### 3. Run the FastAPI Web Server
+
+```bash
+python main.py
+```
+
+Open `http://localhost:7860` in your web browser to explore the dashboard.
+
+---
+
+## How the Self-Healing Loop Works
+
+```text
+  [Docs Scraping] ──► [Grounding Pre-Check] ──► [Initial Generator Node] ──► [Sandbox Test Node]
+                              │                          ▲                         │
+                              ▼ (No Specs Found)         │ (Test Fails, Retry < 3) │
+                        [Fail Fast UI]                   └─────────────────────────┴─► [Passes / Deliver]
+```
+
+1. **State Dictionary Initialization**: The agent state stores the scraped markdown, use case details, target language, and diagnostic records.
+2. **Pre-Check Grounding Validation**: Inspects the scraped content first. If the documentation does not contain actual REST specifications or routes, the workflow raises a validation error immediately, prompting the user for a correct URL.
+3. **Predict (Generator Node)**: The model outputs structured JSON matching the Pydantic schema containing wrapper code, README, endpoints list, and a test suite.
+4. **Act & Verify (Executor Node)**: The Python executor creates an isolated UUID directory under `temp/run_{uuid}`, writes code files, and triggers the language's native test runner (e.g. `pytest`, `node`, `ts-node`, `go test`, `javac`).
+5. **Self-Heal (Loop)**: If the test returns a non-zero exit code, the logs (stdout/stderr) are saved to the state, and the graph loops back to the generator, instructing the model to repair the code. If tests pass, it terminates immediately and packages the clean deliverables.

main.py

@@ -0,0 +1,32 @@
+import sys
+import argparse
+import uvicorn
+from src.config import settings
+from src.app import app
+
+def main():
+    parser = argparse.ArgumentParser(description="Smart API DevTool - FastAPI Server or MCP Server Mode")
+    parser.add_argument(
+        "--mcp",
+        action="store_true",
+        help="Run the tool in Model Context Protocol (MCP) server mode using stdin/stdout streams."
+    )
+    
+    args = parser.parse_args()
+    
+    if args.mcp:
+        print("Model Context Protocol (MCP) mode selected.", file=sys.stderr)
+        try:
+            from src.mcp_server import run_mcp_server
+            run_mcp_server()
+        except ImportError:
+            print("Error: MCP server module 'src/mcp_server.py' is not implemented yet (Phase 3). Please run without --mcp to start the FastAPI server.", file=sys.stderr)
+            sys.exit(1)
+    else:
+        # Launch FastAPI server
+        print(f"Starting FastAPI Web Server on http://{settings.host}:{settings.port}", file=sys.stderr)
+        uvicorn.run("src.app:app", host=settings.host, port=settings.port, reload=settings.reload, access_log=settings.access_log)
+
+if __name__ == "__main__":
+    main()
+

public/assets/index-Dq8pwRiF.css

@@ -0,0 +1,2 @@
+/*! tailwindcss v4.3.1 | MIT License | https://tailwindcss.com */
+@layer properties{@supports (((-webkit-hyphens:none)) and (not (margin-trim:inline))) or ((-moz-orient:inline) and (not (color:rgb(from red r g b)))){*,:before,:after,::backdrop{--tw-scale-x:1;--tw-scale-y:1;--tw-scale-z:1;--tw-rotate-x:initial;--tw-rotate-y:initial;--tw-rotate-z:initial;--tw-skew-x:initial;--tw-skew-y:initial;--tw-space-y-reverse:0;--tw-border-style:solid;--tw-gradient-position:initial;--tw-gradient-from:#0000;--tw-gradient-via:#0000;--tw-gradient-to:#0000;--tw-gradient-stops:initial;--tw-gradient-via-stops:initial;--tw-gradient-from-position:0%;--tw-gradient-via-position:50%;--tw-gradient-to-position:100%;--tw-leading:initial;--tw-font-weight:initial;--tw-tracking:initial;--tw-shadow:0 0 #0000;--tw-shadow-color:initial;--tw-shadow-alpha:100%;--tw-inset-shadow:0 0 #0000;--tw-inset-shadow-color:initial;--tw-inset-shadow-alpha:100%;--tw-ring-color:initial;--tw-ring-shadow:0 0 #0000;--tw-inset-ring-color:initial;--tw-inset-ring-shadow:0 0 #0000;--tw-ring-inset:initial;--tw-ring-offset-width:0px;--tw-ring-offset-color:#fff;--tw-ring-offset-shadow:0 0 #0000;--tw-blur:initial;--tw-brightness:initial;--tw-contrast:initial;--tw-grayscale:initial;--tw-hue-rotate:initial;--tw-invert:initial;--tw-opacity:initial;--tw-saturate:initial;--tw-sepia:initial;--tw-drop-shadow:initial;--tw-drop-shadow-color:initial;--tw-drop-shadow-alpha:100%;--tw-drop-shadow-size:initial;--tw-backdrop-blur:initial;--tw-backdrop-brightness:initial;--tw-backdrop-contrast:initial;--tw-backdrop-grayscale:initial;--tw-backdrop-hue-rotate:initial;--tw-backdrop-invert:initial;--tw-backdrop-opacity:initial;--tw-backdrop-saturate:initial;--tw-backdrop-sepia:initial;--tw-duration:initial;--tw-translate-x:0;--tw-translate-y:0;--tw-translate-z:0}}}@layer theme{:root,:host{--font-sans:"Inter", sans-serif;--font-mono:"JetBrains Mono", monospace;--color-red-400:oklch(70.4% .191 22.216);--color-red-500:oklch(63.7% .237 25.331);--color-red-950:oklch(25.8% .092 26.042);--color-amber-400:oklch(82.8% .189 84.429);--color-amber-500:oklch(76.9% .188 70.08);--color-amber-900:oklch(41.4% .112 45.904);--color-amber-950:oklch(27.9% .077 45.635);--color-yellow-500:oklch(79.5% .184 86.047);--color-green-500:oklch(72.3% .219 149.579);--color-emerald-400:oklch(76.5% .177 163.223);--color-emerald-500:oklch(69.6% .17 162.48);--color-emerald-700:oklch(50.8% .118 165.612);--color-emerald-950:oklch(26.2% .051 172.552);--color-indigo-400:oklch(67.3% .182 276.935);--color-purple-500:oklch(62.7% .265 303.9);--color-pink-400:oklch(71.8% .202 349.761);--color-slate-100:oklch(96.8% .007 247.896);--color-slate-200:oklch(92.9% .013 255.508);--color-slate-300:oklch(86.9% .022 252.894);--color-slate-400:oklch(70.4% .04 256.788);--color-slate-500:oklch(55.4% .046 257.417);--color-slate-600:oklch(44.6% .043 257.281);--color-slate-700:oklch(37.2% .044 257.287);--color-slate-900:oklch(20.8% .042 265.755);--color-slate-950:oklch(12.9% .042 264.695);--color-zinc-100:oklch(96.7% .001 286.375);--color-zinc-200:oklch(92% .004 286.32);--color-zinc-300:oklch(87.1% .006 286.286);--color-zinc-400:oklch(70.5% .015 286.067);--color-zinc-500:oklch(55.2% .016 285.938);--color-zinc-700:oklch(37% .013 285.805);--color-zinc-800:oklch(27.4% .006 286.033);--color-zinc-900:oklch(21% .006 285.885);--color-zinc-950:oklch(14.1% .005 285.823);--color-black:#000;--color-white:#fff;--spacing:.25rem;--container-xs:20rem;--container-sm:24rem;--container-md:28rem;--container-2xl:42rem;--container-4xl:56rem;--container-6xl:72rem;--container-7xl:80rem;--text-xs:.75rem;--text-xs--line-height:calc(1 / .75);--text-sm:.875rem;--text-sm--line-height:calc(1.25 / .875);--text-base:1rem;--text-base--line-height:calc(1.5 / 1);--text-lg:1.125rem;--text-lg--line-height:calc(1.75 / 1.125);--text-2xl:1.5rem;--text-2xl--line-height:calc(2 / 1.5);--text-3xl:1.875rem;--text-3xl--line-height:calc(2.25 / 1.875);--text-4xl:2.25rem;--text-4xl--line-height:calc(2.5 / 2.25);--text-6xl:3.75rem;--text-6xl--line-height:1;--font-weight-normal:400;--font-weight-semibold:600;--font-weight-bold:700;--font-weight-extrabold:800;--tracking-tight:-.025em;--tracking-wide:.025em;--tracking-wider:.05em;--leading-tight:1.25;--leading-normal:1.5;--leading-relaxed:1.625;--radius-sm:.25rem;--radius-lg:.5rem;--radius-xl:.75rem;--radius-2xl:1rem;--animate-spin:spin 1s linear infinite;--animate-ping:ping 1s cubic-bezier(0, 0, .2, 1) infinite;--animate-pulse:pulse 2s cubic-bezier(.4, 0, .6, 1) infinite;--blur-sm:8px;--blur-md:12px;--default-transition-duration:.15s;--default-transition-timing-function:cubic-bezier(.4, 0, .2, 1);--default-font-family:var(--font-sans);--default-mono-font-family:var(--font-mono);--font-heading:"Outfit", sans-serif}}@layer base{*,:after,:before,::backdrop{box-sizing:border-box;border:0 solid;margin:0;padding:0}::file-selector-button{box-sizing:border-box;border:0 solid;margin:0;padding:0}html,:host{-webkit-text-size-adjust:100%;tab-size:4;line-height:1.5;font-family:var(--default-font-family,ui-sans-serif, system-ui, sans-serif, "Apple Color Emoji", "Segoe UI Emoji", "Segoe UI Symbol", "Noto Color Emoji");font-feature-settings:var(--default-font-feature-settings,normal);font-variation-settings:var(--default-font-variation-settings,normal);-webkit-tap-highlight-color:transparent}hr{height:0;color:inherit;border-top-width:1px}abbr:where([title]){-webkit-text-decoration:underline dotted;text-decoration:underline dotted}h1,h2,h3,h4,h5,h6{font-size:inherit;font-weight:inherit}a{color:inherit;-webkit-text-decoration:inherit;-webkit-text-decoration:inherit;-webkit-text-decoration:inherit;-webkit-text-decoration:inherit;text-decoration:inherit}b,strong{font-weight:bolder}code,kbd,samp,pre{font-family:var(--default-mono-font-family,ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, "Liberation Mono", "Courier New", monospace);font-feature-settings:var(--default-mono-font-feature-settings,normal);font-variation-settings:var(--default-mono-font-variation-settings,normal);font-size:1em}small{font-size:80%}sub,sup{vertical-align:baseline;font-size:75%;line-height:0;position:relative}sub{bottom:-.25em}sup{top:-.5em}table{text-indent:0;border-color:inherit;border-collapse:collapse}:-moz-focusring{outline:auto}progress{vertical-align:baseline}summary{display:list-item}ol,ul,menu{list-style:none}img,svg,video,canvas,audio,iframe,embed,object{vertical-align:middle;display:block}img,video{max-width:100%;height:auto}button,input,select,optgroup,textarea{font:inherit;font-feature-settings:inherit;font-variation-settings:inherit;letter-spacing:inherit;color:inherit;opacity:1;background-color:#0000;border-radius:0}::file-selector-button{font:inherit;font-feature-settings:inherit;font-variation-settings:inherit;letter-spacing:inherit;color:inherit;opacity:1;background-color:#0000;border-radius:0}:where(select:is([multiple],[size])) optgroup{font-weight:bolder}:where(select:is([multiple],[size])) optgroup option{padding-inline-start:20px}::file-selector-button{margin-inline-end:4px}::placeholder{opacity:1}@supports (not ((-webkit-appearance:-apple-pay-button))) or (contain-intrinsic-size:1px){::placeholder{color:currentColor}@supports (color:color-mix(in lab, red, red)){::placeholder{color:color-mix(in oklab, currentcolor 50%, transparent)}}}textarea{resize:vertical}::-webkit-search-decoration{-webkit-appearance:none}::-webkit-date-and-time-value{min-height:1lh;text-align:inherit}::-webkit-datetime-edit{display:inline-flex}::-webkit-datetime-edit-fields-wrapper{padding:0}::-webkit-datetime-edit{padding-block:0}::-webkit-datetime-edit-year-field{padding-block:0}::-webkit-datetime-edit-month-field{padding-block:0}::-webkit-datetime-edit-day-field{padding-block:0}::-webkit-datetime-edit-hour-field{padding-block:0}::-webkit-datetime-edit-minute-field{padding-block:0}::-webkit-datetime-edit-second-field{padding-block:0}::-webkit-datetime-edit-millisecond-field{padding-block:0}::-webkit-datetime-edit-meridiem-field{padding-block:0}::-webkit-calendar-picker-indicator{line-height:1}:-moz-ui-invalid{box-shadow:none}button,input:where([type=button],[type=reset],[type=submit]){appearance:button}::file-selector-button{appearance:button}::-webkit-inner-spin-button{height:auto}::-webkit-outer-spin-button{height:auto}[hidden]:where(:not([hidden=until-found])){display:none!important}}@layer components;@layer utilities{.pointer-events-auto{pointer-events:auto}.pointer-events-none{pointer-events:none}.visible{visibility:visible}.absolute{position:absolute}.fixed{position:fixed}.relative{position:relative}.static{position:static}.sticky{position:sticky}.-inset-1\.5{inset:calc(var(--spacing) * -1.5)}.inset-0{inset:0}.inset-x-0{inset-inline:0}.inset-y-0{inset-block:0}.-top-1{top:calc(var(--spacing) * -1)}.-top-20{top:calc(var(--spacing) * -20)}.top-0{top:0}.top-4{top:calc(var(--spacing) * 4)}.top-\[20vh\]{top:20vh}.top-\[40vh\]{top:40vh}.-right-1{right:calc(var(--spacing) * -1)}.-right-20{right:calc(var(--spacing) * -20)}.-right-40{right:calc(var(--spacing) * -40)}.right-0{right:0}.right-1\/4{right:25%}.right-4{right:calc(var(--spacing) * 4)}.-bottom-1{bottom:calc(var(--spacing) * -1)}.-bottom-20{bottom:calc(var(--spacing) * -20)}.bottom-0{bottom:0}.-left-1{left:calc(var(--spacing) * -1)}.-left-20{left:calc(var(--spacing) * -20)}.-left-40{left:calc(var(--spacing) * -40)}.left-1\/4{left:25%}.z-0{z-index:0}.z-10{z-index:10}.z-20{z-index:20}.z-50{z-index:50}.z-\[9999\]{z-index:9999}.col-span-1{grid-column:span 1/span 1}.container{width:100%}@media (width>=40rem){.container{max-width:40rem}}@media (width>=48rem){.container{max-width:48rem}}@media (width>=64rem){.container{max-width:64rem}}@media (width>=80rem){.container{max-width:80rem}}@media (width>=96rem){.container{max-width:96rem}}.mx-auto{margin-inline:auto}.my-3{margin-block:calc(var(--spacing) * 3)}.my-auto{margin-block:auto}.mt-0\.5{margin-top:calc(var(--spacing) * .5)}.mt-1{margin-top:var(--spacing)}.mt-1\.5{margin-top:calc(var(--spacing) * 1.5)}.mt-2{margin-top:calc(var(--spacing) * 2)}.mt-3{margin-top:calc(var(--spacing) * 3)}.mt-4{margin-top:calc(var(--spacing) * 4)}.mt-6{margin-top:calc(var(--spacing) * 6)}.mt-8{margin-top:calc(var(--spacing) * 8)}.mt-12{margin-top:calc(var(--spacing) * 12)}.mt-16{margin-top:calc(var(--spacing) * 16)}.mt-auto{margin-top:auto}.mr-1\.5{margin-right:calc(var(--spacing) * 1.5)}.mb-1{margin-bottom:var(--spacing)}.mb-2{margin-bottom:calc(var(--spacing) * 2)}.mb-3{margin-bottom:calc(var(--spacing) * 3)}.mb-4{margin-bottom:calc(var(--spacing) * 4)}.mb-6{margin-bottom:calc(var(--spacing) * 6)}.mb-8{margin-bottom:calc(var(--spacing) * 8)}.mb-12{margin-bottom:calc(var(--spacing) * 12)}.ml-3{margin-left:calc(var(--spacing) * 3)}.ml-4{margin-left:calc(var(--spacing) * 4)}.block{display:block}.contents{display:contents}.flex{display:flex}.grid{display:grid}.hidden{display:none}.inline-flex{display:inline-flex}.h-0\.5{height:calc(var(--spacing) * .5)}.h-1{height:var(--spacing)}.h-1\.5{height:calc(var(--spacing) * 1.5)}.h-2{height:calc(var(--spacing) * 2)}.h-2\.5{height:calc(var(--spacing) * 2.5)}.h-3{height:calc(var(--spacing) * 3)}.h-3\.5{height:calc(var(--spacing) * 3.5)}.h-4{height:calc(var(--spacing) * 4)}.h-4\.5{height:calc(var(--spacing) * 4.5)}.h-6{height:calc(var(--spacing) * 6)}.h-7{height:calc(var(--spacing) * 7)}.h-8{height:calc(var(--spacing) * 8)}.h-9{height:calc(var(--spacing) * 9)}.h-10{height:calc(var(--spacing) * 10)}.h-24{height:calc(var(--spacing) * 24)}.h-80{height:calc(var(--spacing) * 80)}.h-\[2px\]{height:2px}.h-\[400px\]{height:400px}.h-\[500px\]{height:500px}.h-\[600px\]{height:600px}.h-full{height:100%}.h-screen{height:100vh}.max-h-\[300px\]{max-height:300px}.max-h-\[350px\]{max-height:350px}.min-h-0{min-height:0}.min-h-\[220px\]{min-height:220px}.min-h-\[350px\]{min-height:350px}.min-h-\[380px\]{min-height:380px}.min-h-screen{min-height:100vh}.w-1{width:var(--spacing)}.w-1\.5{width:calc(var(--spacing) * 1.5)}.w-2{width:calc(var(--spacing) * 2)}.w-2\.5{width:calc(var(--spacing) * 2.5)}.w-3{width:calc(var(--spacing) * 3)}.w-3\.5{width:calc(var(--spacing) * 3.5)}.w-4{width:calc(var(--spacing) * 4)}.w-4\.5{width:calc(var(--spacing) * 4.5)}.w-6{width:calc(var(--spacing) * 6)}.w-7{width:calc(var(--spacing) * 7)}.w-8{width:calc(var(--spacing) * 8)}.w-9{width:calc(var(--spacing) * 9)}.w-10{width:calc(var(--spacing) * 10)}.w-24{width:calc(var(--spacing) * 24)}.w-64{width:calc(var(--spacing) * 64)}.w-80{width:calc(var(--spacing) * 80)}.w-\[200\%\]{width:200%}.w-\[400px\]{width:400px}.w-\[500px\]{width:500px}.w-full{width:100%}.w-screen{width:100vw}.max-w-2xl{max-width:var(--container-2xl)}.max-w-4xl{max-width:var(--container-4xl)}.max-w-6xl{max-width:var(--container-6xl)}.max-w-7xl{max-width:var(--container-7xl)}.max-w-md{max-width:var(--container-md)}.max-w-sm{max-width:var(--container-sm)}.max-w-xs{max-width:var(--container-xs)}.min-w-0{min-width:0}.min-w-\[15px\]{min-width:15px}.min-w-\[70px\]{min-width:70px}.flex-1{flex:1}.flex-shrink-0{flex-shrink:0}.flex-grow{flex-grow:1}.scale-105{--tw-scale-x:105%;--tw-scale-y:105%;--tw-scale-z:105%;scale:var(--tw-scale-x) var(--tw-scale-y)}.transform{transform:var(--tw-rotate-x,) var(--tw-rotate-y,) var(--tw-rotate-z,) var(--tw-skew-x,) var(--tw-skew-y,)}.animate-\[spin_20s_linear_infinite\]{animation:20s linear infinite spin}.animate-ping{animation:var(--animate-ping)}.animate-pulse{animation:var(--animate-pulse)}.animate-spin{animation:var(--animate-spin)}.cursor-col-resize{cursor:col-resize}.cursor-pointer{cursor:pointer}.cursor-row-resize{cursor:row-resize}.list-inside{list-style-position:inside}.list-disc{list-style-type:disc}.grid-cols-1{grid-template-columns:repeat(1,minmax(0,1fr))}.grid-cols-2{grid-template-columns:repeat(2,minmax(0,1fr))}.flex-col{flex-direction:column}.flex-wrap{flex-wrap:wrap}.items-center{align-items:center}.items-start{align-items:flex-start}.justify-between{justify-content:space-between}.justify-center{justify-content:center}.justify-end{justify-content:flex-end}.gap-1{gap:var(--spacing)}.gap-1\.5{gap:calc(var(--spacing) * 1.5)}.gap-2{gap:calc(var(--spacing) * 2)}.gap-3{gap:calc(var(--spacing) * 3)}.gap-4{gap:calc(var(--spacing) * 4)}.gap-6{gap:calc(var(--spacing) * 6)}.gap-8{gap:calc(var(--spacing) * 8)}.gap-12{gap:calc(var(--spacing) * 12)}:where(.space-y-0\.5>:not(:last-child)){--tw-space-y-reverse:0;margin-block-start:calc(calc(var(--spacing) * .5) * var(--tw-space-y-reverse));margin-block-end:calc(calc(var(--spacing) * .5) * calc(1 - var(--tw-space-y-reverse)))}:where(.space-y-1>:not(:last-child)){--tw-space-y-reverse:0;margin-block-start:calc(var(--spacing) * var(--tw-space-y-reverse));margin-block-end:calc(var(--spacing) * calc(1 - var(--tw-space-y-reverse)))}:where(.space-y-1\.5>:not(:last-child)){--tw-space-y-reverse:0;margin-block-start:calc(calc(var(--spacing) * 1.5) * var(--tw-space-y-reverse));margin-block-end:calc(calc(var(--spacing) * 1.5) * calc(1 - var(--tw-space-y-reverse)))}:where(.space-y-2>:not(:last-child)){--tw-space-y-reverse:0;margin-block-start:calc(calc(var(--spacing) * 2) * var(--tw-space-y-reverse));margin-block-end:calc(calc(var(--spacing) * 2) * calc(1 - var(--tw-space-y-reverse)))}:where(.space-y-2\.5>:not(:last-child)){--tw-space-y-reverse:0;margin-block-start:calc(calc(var(--spacing) * 2.5) * var(--tw-space-y-reverse));margin-block-end:calc(calc(var(--spacing) * 2.5) * calc(1 - var(--tw-space-y-reverse)))}:where(.space-y-3>:not(:last-child)){--tw-space-y-reverse:0;margin-block-start:calc(calc(var(--spacing) * 3) * var(--tw-space-y-reverse));margin-block-end:calc(calc(var(--spacing) * 3) * calc(1 - var(--tw-space-y-reverse)))}:where(.space-y-3\.5>:not(:last-child)){--tw-space-y-reverse:0;margin-block-start:calc(calc(var(--spacing) * 3.5) * var(--tw-space-y-reverse));margin-block-end:calc(calc(var(--spacing) * 3.5) * calc(1 - var(--tw-space-y-reverse)))}:where(.space-y-4>:not(:last-child)){--tw-space-y-reverse:0;margin-block-start:calc(calc(var(--spacing) * 4) * var(--tw-space-y-reverse));margin-block-end:calc(calc(var(--spacing) * 4) * calc(1 - var(--tw-space-y-reverse)))}:where(.space-y-6>:not(:last-child)){--tw-space-y-reverse:0;margin-block-start:calc(calc(var(--spacing) * 6) * var(--tw-space-y-reverse));margin-block-end:calc(calc(var(--spacing) * 6) * calc(1 - var(--tw-space-y-reverse)))}.self-stretch{align-self:stretch}.truncate{text-overflow:ellipsis;white-space:nowrap;overflow:hidden}.overflow-hidden{overflow:hidden}.overflow-x-auto{overflow-x:auto}.overflow-x-hidden{overflow-x:hidden}.overflow-y-auto{overflow-y:auto}.rounded{border-radius:.25rem}.rounded-2xl{border-radius:var(--radius-2xl)}.rounded-full{border-radius:3.40282e38px}.rounded-lg{border-radius:var(--radius-lg)}.rounded-sm{border-radius:var(--radius-sm)}.rounded-xl{border-radius:var(--radius-xl)}.rounded-t-lg{border-top-left-radius:var(--radius-lg);border-top-right-radius:var(--radius-lg)}.rounded-bl-lg{border-bottom-left-radius:var(--radius-lg)}.border{border-style:var(--tw-border-style);border-width:1px}.border-2{border-style:var(--tw-border-style);border-width:2px}.border-y{border-block-style:var(--tw-border-style);border-block-width:1px}.border-t{border-top-style:var(--tw-border-style);border-top-width:1px}.border-t-2{border-top-style:var(--tw-border-style);border-top-width:2px}.border-r{border-right-style:var(--tw-border-style);border-right-width:1px}.border-b{border-bottom-style:var(--tw-border-style);border-bottom-width:1px}.border-l{border-left-style:var(--tw-border-style);border-left-width:1px}.border-dashed{--tw-border-style:dashed;border-style:dashed}.border-\[\#1d2d4c\]{border-color:#1d2d4c}.border-\[\#050505\]{border-color:#050505}.border-amber-500\/20{border-color:#f99c0033}@supports (color:color-mix(in lab, red, red)){.border-amber-500\/20{border-color:color-mix(in oklab, var(--color-amber-500) 20%, transparent)}}.border-amber-900\/30{border-color:#7b33064d}@supports (color:color-mix(in lab, red, red)){.border-amber-900\/30{border-color:color-mix(in oklab, var(--color-amber-900) 30%, transparent)}}.border-black\/20{border-color:#0003}@supports (color:color-mix(in lab, red, red)){.border-black\/20{border-color:color-mix(in oklab, var(--color-black) 20%, transparent)}}.border-emerald-500{border-color:var(--color-emerald-500)}.border-emerald-500\/20{border-color:#00bb7f33}@supports (color:color-mix(in lab, red, red)){.border-emerald-500\/20{border-color:color-mix(in oklab, var(--color-emerald-500) 20%, transparent)}}.border-red-500{border-color:var(--color-red-500)}.border-white{border-color:var(--color-white)}.border-white\/5{border-color:#ffffff0d}@supports (color:color-mix(in lab, red, red)){.border-white\/5{border-color:color-mix(in oklab, var(--color-white) 5%, transparent)}}.border-white\/10{border-color:#ffffff1a}@supports (color:color-mix(in lab, red, red)){.border-white\/10{border-color:color-mix(in oklab, var(--color-white) 10%, transparent)}}.border-white\/15{border-color:#ffffff26}@supports (color:color-mix(in lab, red, red)){.border-white\/15{border-color:color-mix(in oklab, var(--color-white) 15%, transparent)}}.border-white\/20{border-color:#fff3}@supports (color:color-mix(in lab, red, red)){.border-white\/20{border-color:color-mix(in oklab, var(--color-white) 20%, transparent)}}.border-white\/30{border-color:#ffffff4d}@supports (color:color-mix(in lab, red, red)){.border-white\/30{border-color:color-mix(in oklab, var(--color-white) 30%, transparent)}}.border-zinc-400{border-color:var(--color-zinc-400)}.border-t-black{border-top-color:var(--color-black)}.bg-\[\#0a0c10\]{background-color:#0a0c10}.bg-\[\#0a0c10\]\/40{background-color:oklab(15.4018% -.0009171 -.00915512/.4)}.bg-\[\#0a0c10\]\/60{background-color:oklab(15.4018% -.000917099 -.00915512/.6)}.bg-\[\#0a0c10\]\/80{background-color:oklab(15.4018% -.0009171 -.00915512/.8)}.bg-\[\#0b0f19\]{background-color:#0b0f19}.bg-\[\#0d0d0d\]{background-color:#0d0d0d}.bg-\[\#0d0d0d\]\/90{background-color:oklab(15.9066% 7.45058e-9 0/.9)}.bg-\[\#0e0e0e\]\/20{background-color:oklab(16.3758% -1.49012e-8 0/.2)}.bg-\[\#0e0e0e\]\/50{background-color:oklab(16.3758% -1.49012e-8 0/.5)}.bg-\[\#0f111a\]{background-color:#0f111a}.bg-\[\#131b2e\]{background-color:#131b2e}.bg-\[\#07090e\]{background-color:#07090e}.bg-\[\#050505\]{background-color:#050505}.bg-\[\#050505\]\/45{background-color:oklab(11.4918% 7.45058e-9 7.45058e-9/.45)}.bg-\[\#050505\]\/50{background-color:oklab(11.4918% 7.45058e-9 7.45058e-9/.5)}.bg-\[\#050505\]\/60{background-color:oklab(11.4918% 7.45058e-9 7.45058e-9/.6)}.bg-\[\#050505\]\/80{background-color:oklab(11.4918% 7.45058e-9 7.45058e-9/.8)}.bg-\[\#050505\]\/95{background-color:oklab(11.4918% 7.45058e-9 7.45058e-9/.95)}.bg-\[\#080808\]{background-color:#080808}.bg-\[\#080808\]\/20{background-color:oklab(13.4409% 3.72529e-9 7.45058e-9/.2)}.bg-\[\#080808\]\/40{background-color:oklab(13.4409% 3.72529e-9 7.45058e-9/.4)}.bg-\[\#080808\]\/60{background-color:oklab(13.4409% 3.72529e-9 7.45058e-9/.6)}.bg-\[\#080808\]\/95{background-color:oklab(13.4409% 3.72529e-9 7.45058e-9/.95)}.bg-\[\#090909\]{background-color:#090909}.bg-\[\#121212\]{background-color:#121212}.bg-amber-500\/10{background-color:#f99c001a}@supports (color:color-mix(in lab, red, red)){.bg-amber-500\/10{background-color:color-mix(in oklab, var(--color-amber-500) 10%, transparent)}}.bg-amber-950\/40{background-color:#46190166}@supports (color:color-mix(in lab, red, red)){.bg-amber-950\/40{background-color:color-mix(in oklab, var(--color-amber-950) 40%, transparent)}}.bg-black{background-color:var(--color-black)}.bg-black\/35{background-color:#00000059}@supports (color:color-mix(in lab, red, red)){.bg-black\/35{background-color:color-mix(in oklab, var(--color-black) 35%, transparent)}}.bg-black\/40{background-color:#0006}@supports (color:color-mix(in lab, red, red)){.bg-black\/40{background-color:color-mix(in oklab, var(--color-black) 40%, transparent)}}.bg-black\/45{background-color:#00000073}@supports (color:color-mix(in lab, red, red)){.bg-black\/45{background-color:color-mix(in oklab, var(--color-black) 45%, transparent)}}.bg-black\/60{background-color:#0009}@supports (color:color-mix(in lab, red, red)){.bg-black\/60{background-color:color-mix(in oklab, var(--color-black) 60%, transparent)}}.bg-emerald-400{background-color:var(--color-emerald-400)}.bg-emerald-400\/10{background-color:#00d2941a}@supports (color:color-mix(in lab, red, red)){.bg-emerald-400\/10{background-color:color-mix(in oklab, var(--color-emerald-400) 10%, transparent)}}.bg-emerald-500{background-color:var(--color-emerald-500)}.bg-emerald-500\/10{background-color:#00bb7f1a}@supports (color:color-mix(in lab, red, red)){.bg-emerald-500\/10{background-color:color-mix(in oklab, var(--color-emerald-500) 10%, transparent)}}.bg-emerald-500\/20{background-color:#00bb7f33}@supports (color:color-mix(in lab, red, red)){.bg-emerald-500\/20{background-color:color-mix(in oklab, var(--color-emerald-500) 20%, transparent)}}.bg-emerald-500\/70{background-color:#00bb7fb3}@supports (color:color-mix(in lab, red, red)){.bg-emerald-500\/70{background-color:color-mix(in oklab, var(--color-emerald-500) 70%, transparent)}}.bg-emerald-500\/\[0\.02\]{background-color:#00bb7f05}@supports (color:color-mix(in lab, red, red)){.bg-emerald-500\/\[0\.02\]{background-color:color-mix(in oklab, var(--color-emerald-500) 2%, transparent)}}.bg-emerald-950\/20{background-color:#002c2233}@supports (color:color-mix(in lab, red, red)){.bg-emerald-950\/20{background-color:color-mix(in oklab, var(--color-emerald-950) 20%, transparent)}}.bg-green-500\/40{background-color:#00c75866}@supports (color:color-mix(in lab, red, red)){.bg-green-500\/40{background-color:color-mix(in oklab, var(--color-green-500) 40%, transparent)}}.bg-green-500\/80{background-color:#00c758cc}@supports (color:color-mix(in lab, red, red)){.bg-green-500\/80{background-color:color-mix(in oklab, var(--color-green-500) 80%, transparent)}}.bg-purple-500\/\[0\.02\]{background-color:#ac4bff05}@supports (color:color-mix(in lab, red, red)){.bg-purple-500\/\[0\.02\]{background-color:color-mix(in oklab, var(--color-purple-500) 2%, transparent)}}.bg-red-500\/40{background-color:#fb2c3666}@supports (color:color-mix(in lab, red, red)){.bg-red-500\/40{background-color:color-mix(in oklab, var(--color-red-500) 40%, transparent)}}.bg-red-500\/80{background-color:#fb2c36cc}@supports (color:color-mix(in lab, red, red)){.bg-red-500\/80{background-color:color-mix(in oklab, var(--color-red-500) 80%, transparent)}}.bg-red-950\/20{background-color:#46080933}@supports (color:color-mix(in lab, red, red)){.bg-red-950\/20{background-color:color-mix(in oklab, var(--color-red-950) 20%, transparent)}}.bg-slate-900{background-color:var(--color-slate-900)}.bg-slate-950{background-color:var(--color-slate-950)}.bg-transparent{background-color:#0000}.bg-white{background-color:var(--color-white)}.bg-white\/5{background-color:#ffffff0d}@supports (color:color-mix(in lab, red, red)){.bg-white\/5{background-color:color-mix(in oklab, var(--color-white) 5%, transparent)}}.bg-white\/10{background-color:#ffffff1a}@supports (color:color-mix(in lab, red, red)){.bg-white\/10{background-color:color-mix(in oklab, var(--color-white) 10%, transparent)}}.bg-white\/30{background-color:#ffffff4d}@supports (color:color-mix(in lab, red, red)){.bg-white\/30{background-color:color-mix(in oklab, var(--color-white) 30%, transparent)}}.bg-white\/\[0\.01\]{background-color:#ffffff03}@supports (color:color-mix(in lab, red, red)){.bg-white\/\[0\.01\]{background-color:color-mix(in oklab, var(--color-white) 1%, transparent)}}.bg-white\/\[0\.02\]{background-color:#ffffff05}@supports (color:color-mix(in lab, red, red)){.bg-white\/\[0\.02\]{background-color:color-mix(in oklab, var(--color-white) 2%, transparent)}}.bg-white\/\[0\.03\]{background-color:#ffffff08}@supports (color:color-mix(in lab, red, red)){.bg-white\/\[0\.03\]{background-color:color-mix(in oklab, var(--color-white) 3%, transparent)}}.bg-yellow-500\/40{background-color:#edb20066}@supports (color:color-mix(in lab, red, red)){.bg-yellow-500\/40{background-color:color-mix(in oklab, var(--color-yellow-500) 40%, transparent)}}.bg-yellow-500\/80{background-color:#edb200cc}@supports (color:color-mix(in lab, red, red)){.bg-yellow-500\/80{background-color:color-mix(in oklab, var(--color-yellow-500) 80%, transparent)}}.bg-zinc-500\/5{background-color:#71717b0d}@supports (color:color-mix(in lab, red, red)){.bg-zinc-500\/5{background-color:color-mix(in oklab, var(--color-zinc-500) 5%, transparent)}}.bg-zinc-500\/\[0\.02\]{background-color:#71717b05}@supports (color:color-mix(in lab, red, red)){.bg-zinc-500\/\[0\.02\]{background-color:color-mix(in oklab, var(--color-zinc-500) 2%, transparent)}}.bg-zinc-900{background-color:var(--color-zinc-900)}.bg-zinc-950\/20{background-color:#09090b33}@supports (color:color-mix(in lab, red, red)){.bg-zinc-950\/20{background-color:color-mix(in oklab, var(--color-zinc-950) 20%, transparent)}}.bg-zinc-950\/45{background-color:#09090b73}@supports (color:color-mix(in lab, red, red)){.bg-zinc-950\/45{background-color:color-mix(in oklab, var(--color-zinc-950) 45%, transparent)}}.bg-gradient-to-b{--tw-gradient-position:to bottom in oklab;background-image:linear-gradient(var(--tw-gradient-stops))}.bg-gradient-to-r{--tw-gradient-position:to right in oklab;background-image:linear-gradient(var(--tw-gradient-stops))}.bg-gradient-to-tr{--tw-gradient-position:to top right in oklab;background-image:linear-gradient(var(--tw-gradient-stops))}.bg-\[linear-gradient\(to_right\,\#ffffff03_1px\,transparent_1px\)\,linear-gradient\(to_bottom\,\#ffffff03_1px\,transparent_1px\)\]{background-image:linear-gradient(90deg,#ffffff03 1px,#0000 1px),linear-gradient(#ffffff03 1px,#0000 1px)}.from-transparent{--tw-gradient-from:transparent;--tw-gradient-stops:var(--tw-gradient-via-stops,var(--tw-gradient-position), var(--tw-gradient-from) var(--tw-gradient-from-position), var(--tw-gradient-to) var(--tw-gradient-to-position))}.from-white{--tw-gradient-from:var(--color-white);--tw-gradient-stops:var(--tw-gradient-via-stops,var(--tw-gradient-position), var(--tw-gradient-from) var(--tw-gradient-from-position), var(--tw-gradient-to) var(--tw-gradient-to-position))}.from-white\/\[0\.02\]{--tw-gradient-from:#ffffff05}@supports (color:color-mix(in lab, red, red)){.from-white\/\[0\.02\]{--tw-gradient-from:color-mix(in oklab, var(--color-white) 2%, transparent)}}.from-white\/\[0\.02\]{--tw-gradient-stops:var(--tw-gradient-via-stops,var(--tw-gradient-position), var(--tw-gradient-from) var(--tw-gradient-from-position), var(--tw-gradient-to) var(--tw-gradient-to-position))}.via-transparent{--tw-gradient-via:transparent;--tw-gradient-via-stops:var(--tw-gradient-position), var(--tw-gradient-from) var(--tw-gradient-from-position), var(--tw-gradient-via) var(--tw-gradient-via-position), var(--tw-gradient-to) var(--tw-gradient-to-position);--tw-gradient-stops:var(--tw-gradient-via-stops)}.via-white\/15{--tw-gradient-via:#ffffff26}@supports (color:color-mix(in lab, red, red)){.via-white\/15{--tw-gradient-via:color-mix(in oklab, var(--color-white) 15%, transparent)}}.via-white\/15{--tw-gradient-via-stops:var(--tw-gradient-position), var(--tw-gradient-from) var(--tw-gradient-from-position), var(--tw-gradient-via) var(--tw-gradient-via-position), var(--tw-gradient-to) var(--tw-gradient-to-position);--tw-gradient-stops:var(--tw-gradient-via-stops)}.via-zinc-200{--tw-gradient-via:var(--color-zinc-200);--tw-gradient-via-stops:var(--tw-gradient-position), var(--tw-gradient-from) var(--tw-gradient-from-position), var(--tw-gradient-via) var(--tw-gradient-via-position), var(--tw-gradient-to) var(--tw-gradient-to-position);--tw-gradient-stops:var(--tw-gradient-via-stops)}.via-zinc-400{--tw-gradient-via:var(--color-zinc-400);--tw-gradient-via-stops:var(--tw-gradient-position), var(--tw-gradient-from) var(--tw-gradient-from-position), var(--tw-gradient-via) var(--tw-gradient-via-position), var(--tw-gradient-to) var(--tw-gradient-to-position);--tw-gradient-stops:var(--tw-gradient-via-stops)}.to-transparent{--tw-gradient-to:transparent;--tw-gradient-stops:var(--tw-gradient-via-stops,var(--tw-gradient-position), var(--tw-gradient-from) var(--tw-gradient-from-position), var(--tw-gradient-to) var(--tw-gradient-to-position))}.to-zinc-400{--tw-gradient-to:var(--color-zinc-400);--tw-gradient-stops:var(--tw-gradient-via-stops,var(--tw-gradient-position), var(--tw-gradient-from) var(--tw-gradient-from-position), var(--tw-gradient-to) var(--tw-gradient-to-position))}.to-zinc-500{--tw-gradient-to:var(--color-zinc-500);--tw-gradient-stops:var(--tw-gradient-via-stops,var(--tw-gradient-position), var(--tw-gradient-from) var(--tw-gradient-from-position), var(--tw-gradient-to) var(--tw-gradient-to-position))}.to-zinc-700{--tw-gradient-to:var(--color-zinc-700);--tw-gradient-stops:var(--tw-gradient-via-stops,var(--tw-gradient-position), var(--tw-gradient-from) var(--tw-gradient-from-position), var(--tw-gradient-to) var(--tw-gradient-to-position))}.bg-\[size\:14px_14px\]{background-size:14px 14px}.bg-clip-text{-webkit-background-clip:text;background-clip:text}.fill-emerald-950\/20{fill:#002c2233}@supports (color:color-mix(in lab, red, red)){.fill-emerald-950\/20{fill:color-mix(in oklab, var(--color-emerald-950) 20%, transparent)}}.fill-red-950\/20{fill:#46080933}@supports (color:color-mix(in lab, red, red)){.fill-red-950\/20{fill:color-mix(in oklab, var(--color-red-950) 20%, transparent)}}.fill-white\/15{fill:#ffffff26}@supports (color:color-mix(in lab, red, red)){.fill-white\/15{fill:color-mix(in oklab, var(--color-white) 15%, transparent)}}.fill-white\/\[0\.02\]{fill:#ffffff05}@supports (color:color-mix(in lab, red, red)){.fill-white\/\[0\.02\]{fill:color-mix(in oklab, var(--color-white) 2%, transparent)}}.stroke-emerald-500{stroke:var(--color-emerald-500)}.stroke-white{stroke:var(--color-white)}.stroke-white\/10{stroke:#ffffff1a}@supports (color:color-mix(in lab, red, red)){.stroke-white\/10{stroke:color-mix(in oklab, var(--color-white) 10%, transparent)}}.object-cover{object-fit:cover}.p-1{padding:var(--spacing)}.p-1\.5{padding:calc(var(--spacing) * 1.5)}.p-2{padding:calc(var(--spacing) * 2)}.p-2\.5{padding:calc(var(--spacing) * 2.5)}.p-3{padding:calc(var(--spacing) * 3)}.p-4{padding:calc(var(--spacing) * 4)}.p-5{padding:calc(var(--spacing) * 5)}.p-6{padding:calc(var(--spacing) * 6)}.p-8{padding:calc(var(--spacing) * 8)}.px-1{padding-inline:var(--spacing)}.px-1\.5{padding-inline:calc(var(--spacing) * 1.5)}.px-2{padding-inline:calc(var(--spacing) * 2)}.px-2\.5{padding-inline:calc(var(--spacing) * 2.5)}.px-3{padding-inline:calc(var(--spacing) * 3)}.px-3\.5{padding-inline:calc(var(--spacing) * 3.5)}.px-4{padding-inline:calc(var(--spacing) * 4)}.px-5{padding-inline:calc(var(--spacing) * 5)}.px-6{padding-inline:calc(var(--spacing) * 6)}.py-0\.5{padding-block:calc(var(--spacing) * .5)}.py-1{padding-block:var(--spacing)}.py-1\.5{padding-block:calc(var(--spacing) * 1.5)}.py-2{padding-block:calc(var(--spacing) * 2)}.py-2\.5{padding-block:calc(var(--spacing) * 2.5)}.py-3{padding-block:calc(var(--spacing) * 3)}.py-3\.5{padding-block:calc(var(--spacing) * 3.5)}.py-4{padding-block:calc(var(--spacing) * 4)}.py-6{padding-block:calc(var(--spacing) * 6)}.py-12{padding-block:calc(var(--spacing) * 12)}.py-16{padding-block:calc(var(--spacing) * 16)}.py-20{padding-block:calc(var(--spacing) * 20)}.pt-2{padding-top:calc(var(--spacing) * 2)}.pt-4{padding-top:calc(var(--spacing) * 4)}.pt-6{padding-top:calc(var(--spacing) * 6)}.pt-16{padding-top:calc(var(--spacing) * 16)}.pr-1{padding-right:var(--spacing)}.pr-4{padding-right:calc(var(--spacing) * 4)}.pb-1\.5{padding-bottom:calc(var(--spacing) * 1.5)}.pb-3{padding-bottom:calc(var(--spacing) * 3)}.pb-4{padding-bottom:calc(var(--spacing) * 4)}.pb-12{padding-bottom:calc(var(--spacing) * 12)}.pl-2{padding-left:calc(var(--spacing) * 2)}.pl-3{padding-left:calc(var(--spacing) * 3)}.pl-4{padding-left:calc(var(--spacing) * 4)}.pl-8{padding-left:calc(var(--spacing) * 8)}.text-center{text-align:center}.text-left{text-align:left}.text-right{text-align:right}.font-heading{font-family:var(--font-heading)}.font-mono{font-family:var(--font-mono)}.font-sans{font-family:var(--font-sans)}.text-2xl{font-size:var(--text-2xl);line-height:var(--tw-leading,var(--text-2xl--line-height))}.text-3xl{font-size:var(--text-3xl);line-height:var(--tw-leading,var(--text-3xl--line-height))}.text-4xl{font-size:var(--text-4xl);line-height:var(--tw-leading,var(--text-4xl--line-height))}.text-base{font-size:var(--text-base);line-height:var(--tw-leading,var(--text-base--line-height))}.text-lg{font-size:var(--text-lg);line-height:var(--tw-leading,var(--text-lg--line-height))}.text-sm{font-size:var(--text-sm);line-height:var(--tw-leading,var(--text-sm--line-height))}.text-xs{font-size:var(--text-xs);line-height:var(--tw-leading,var(--text-xs--line-height))}.text-\[8px\]{font-size:8px}.text-\[9px\]{font-size:9px}.text-\[10px\]{font-size:10px}.text-\[11px\]{font-size:11px}.leading-\[1\.1\]{--tw-leading:1.1;line-height:1.1}.leading-normal{--tw-leading:var(--leading-normal);line-height:var(--leading-normal)}.leading-relaxed{--tw-leading:var(--leading-relaxed);line-height:var(--leading-relaxed)}.leading-tight{--tw-leading:var(--leading-tight);line-height:var(--leading-tight)}.font-bold{--tw-font-weight:var(--font-weight-bold);font-weight:var(--font-weight-bold)}.font-extrabold{--tw-font-weight:var(--font-weight-extrabold);font-weight:var(--font-weight-extrabold)}.font-normal{--tw-font-weight:var(--font-weight-normal);font-weight:var(--font-weight-normal)}.font-semibold{--tw-font-weight:var(--font-weight-semibold);font-weight:var(--font-weight-semibold)}.tracking-tight{--tw-tracking:var(--tracking-tight);letter-spacing:var(--tracking-tight)}.tracking-wide{--tw-tracking:var(--tracking-wide);letter-spacing:var(--tracking-wide)}.tracking-wider{--tw-tracking:var(--tracking-wider);letter-spacing:var(--tracking-wider)}.whitespace-pre-wrap{white-space:pre-wrap}.text-\[\#5f87e2\]{color:#5f87e2}.text-\[\#64748b\]{color:#64748b}.text-amber-400{color:var(--color-amber-400)}.text-amber-500{color:var(--color-amber-500)}.text-black{color:var(--color-black)}.text-emerald-400{color:var(--color-emerald-400)}.text-indigo-400{color:var(--color-indigo-400)}.text-pink-400{color:var(--color-pink-400)}.text-red-400{color:var(--color-red-400)}.text-slate-100{color:var(--color-slate-100)}.text-slate-200{color:var(--color-slate-200)}.text-slate-300{color:var(--color-slate-300)}.text-slate-400{color:var(--color-slate-400)}.text-slate-500{color:var(--color-slate-500)}.text-slate-600{color:var(--color-slate-600)}.text-slate-700{color:var(--color-slate-700)}.text-transparent{color:#0000}.text-white{color:var(--color-white)}.text-white\/15{color:#ffffff26}@supports (color:color-mix(in lab, red, red)){.text-white\/15{color:color-mix(in oklab, var(--color-white) 15%, transparent)}}.text-white\/20{color:#fff3}@supports (color:color-mix(in lab, red, red)){.text-white\/20{color:color-mix(in oklab, var(--color-white) 20%, transparent)}}.text-zinc-100{color:var(--color-zinc-100)}.text-zinc-300{color:var(--color-zinc-300)}.text-zinc-400{color:var(--color-zinc-400)}.text-zinc-500{color:var(--color-zinc-500)}.uppercase{text-transform:uppercase}.italic{font-style:italic}.underline{text-decoration-line:underline}.antialiased{-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale}.placeholder-slate-600::placeholder{color:var(--color-slate-600)}.opacity-0{opacity:0}.opacity-20{opacity:.2}.opacity-50{opacity:.5}.opacity-75{opacity:.75}.shadow{--tw-shadow:0 1px 3px 0 var(--tw-shadow-color,#0000001a), 0 1px 2px -1px var(--tw-shadow-color,#0000001a);box-shadow:var(--tw-inset-shadow), var(--tw-inset-ring-shadow), var(--tw-ring-offset-shadow), var(--tw-ring-shadow), var(--tw-shadow)}.shadow-2xl{--tw-shadow:0 25px 50px -12px var(--tw-shadow-color,#00000040);box-shadow:var(--tw-inset-shadow), var(--tw-inset-ring-shadow), var(--tw-ring-offset-shadow), var(--tw-ring-shadow), var(--tw-shadow)}.shadow-\[0_0_12px_rgba\(255\,255\,255\,0\.05\)\]{--tw-shadow:0 0 12px var(--tw-shadow-color,#ffffff0d);box-shadow:var(--tw-inset-shadow), var(--tw-inset-ring-shadow), var(--tw-ring-offset-shadow), var(--tw-ring-shadow), var(--tw-shadow)}.shadow-\[0_0_20px_rgba\(255\,255\,255\,0\.02\)\]{--tw-shadow:0 0 20px var(--tw-shadow-color,#ffffff05);box-shadow:var(--tw-inset-shadow), var(--tw-inset-ring-shadow), var(--tw-ring-offset-shadow), var(--tw-ring-shadow), var(--tw-shadow)}.shadow-inner{--tw-shadow:inset 0 2px 4px 0 var(--tw-shadow-color,#0000000d);box-shadow:var(--tw-inset-shadow), var(--tw-inset-ring-shadow), var(--tw-ring-offset-shadow), var(--tw-ring-shadow), var(--tw-shadow)}.shadow-lg{--tw-shadow:0 10px 15px -3px var(--tw-shadow-color,#0000001a), 0 4px 6px -4px var(--tw-shadow-color,#0000001a);box-shadow:var(--tw-inset-shadow), var(--tw-inset-ring-shadow), var(--tw-ring-offset-shadow), var(--tw-ring-shadow), var(--tw-shadow)}.shadow-md{--tw-shadow:0 4px 6px -1px var(--tw-shadow-color,#0000001a), 0 2px 4px -2px var(--tw-shadow-color,#0000001a);box-shadow:var(--tw-inset-shadow), var(--tw-inset-ring-shadow), var(--tw-ring-offset-shadow), var(--tw-ring-shadow), var(--tw-shadow)}.shadow-sm{--tw-shadow:0 1px 3px 0 var(--tw-shadow-color,#0000001a), 0 1px 2px -1px var(--tw-shadow-color,#0000001a);box-shadow:var(--tw-inset-shadow), var(--tw-inset-ring-shadow), var(--tw-ring-offset-shadow), var(--tw-ring-shadow), var(--tw-shadow)}.shadow-xl{--tw-shadow:0 20px 25px -5px var(--tw-shadow-color,#0000001a), 0 8px 10px -6px var(--tw-shadow-color,#0000001a);box-shadow:var(--tw-inset-shadow), var(--tw-inset-ring-shadow), var(--tw-ring-offset-shadow), var(--tw-ring-shadow), var(--tw-shadow)}.shadow-emerald-500\/10{--tw-shadow-color:#00bb7f1a}@supports (color:color-mix(in lab, red, red)){.shadow-emerald-500\/10{--tw-shadow-color:color-mix(in oklab, color-mix(in oklab, var(--color-emerald-500) 10%, transparent) var(--tw-shadow-alpha), transparent)}}.shadow-white\/5{--tw-shadow-color:#ffffff0d}@supports (color:color-mix(in lab, red, red)){.shadow-white\/5{--tw-shadow-color:color-mix(in oklab, color-mix(in oklab, var(--color-white) 5%, transparent) var(--tw-shadow-alpha), transparent)}}.shadow-white\/10{--tw-shadow-color:#ffffff1a}@supports (color:color-mix(in lab, red, red)){.shadow-white\/10{--tw-shadow-color:color-mix(in oklab, color-mix(in oklab, var(--color-white) 10%, transparent) var(--tw-shadow-alpha), transparent)}}.blur-\[80px\]{--tw-blur:blur(80px);filter:var(--tw-blur,) var(--tw-brightness,) var(--tw-contrast,) var(--tw-grayscale,) var(--tw-hue-rotate,) var(--tw-invert,) var(--tw-saturate,) var(--tw-sepia,) var(--tw-drop-shadow,)}.blur-\[100px\]{--tw-blur:blur(100px);filter:var(--tw-blur,) var(--tw-brightness,) var(--tw-contrast,) var(--tw-grayscale,) var(--tw-hue-rotate,) var(--tw-invert,) var(--tw-saturate,) var(--tw-sepia,) var(--tw-drop-shadow,)}.blur-\[120px\]{--tw-blur:blur(120px);filter:var(--tw-blur,) var(--tw-brightness,) var(--tw-contrast,) var(--tw-grayscale,) var(--tw-hue-rotate,) var(--tw-invert,) var(--tw-saturate,) var(--tw-sepia,) var(--tw-drop-shadow,)}.blur-sm{--tw-blur:blur(var(--blur-sm));filter:var(--tw-blur,) var(--tw-brightness,) var(--tw-contrast,) var(--tw-grayscale,) var(--tw-hue-rotate,) var(--tw-invert,) var(--tw-saturate,) var(--tw-sepia,) var(--tw-drop-shadow,)}.filter{filter:var(--tw-blur,) var(--tw-brightness,) var(--tw-contrast,) var(--tw-grayscale,) var(--tw-hue-rotate,) var(--tw-invert,) var(--tw-saturate,) var(--tw-sepia,) var(--tw-drop-shadow,)}.backdrop-blur-md{--tw-backdrop-blur:blur(var(--blur-md));-webkit-backdrop-filter:var(--tw-backdrop-blur,) var(--tw-backdrop-brightness,) var(--tw-backdrop-contrast,) var(--tw-backdrop-grayscale,) var(--tw-backdrop-hue-rotate,) var(--tw-backdrop-invert,) var(--tw-backdrop-opacity,) var(--tw-backdrop-saturate,) var(--tw-backdrop-sepia,);backdrop-filter:var(--tw-backdrop-blur,) var(--tw-backdrop-brightness,) var(--tw-backdrop-contrast,) var(--tw-backdrop-grayscale,) var(--tw-backdrop-hue-rotate,) var(--tw-backdrop-invert,) var(--tw-backdrop-opacity,) var(--tw-backdrop-saturate,) var(--tw-backdrop-sepia,)}.backdrop-blur-sm{--tw-backdrop-blur:blur(var(--blur-sm));-webkit-backdrop-filter:var(--tw-backdrop-blur,) var(--tw-backdrop-brightness,) var(--tw-backdrop-contrast,) var(--tw-backdrop-grayscale,) var(--tw-backdrop-hue-rotate,) var(--tw-backdrop-invert,) var(--tw-backdrop-opacity,) var(--tw-backdrop-saturate,) var(--tw-backdrop-sepia,);backdrop-filter:var(--tw-backdrop-blur,) var(--tw-backdrop-brightness,) var(--tw-backdrop-contrast,) var(--tw-backdrop-grayscale,) var(--tw-backdrop-hue-rotate,) var(--tw-backdrop-invert,) var(--tw-backdrop-opacity,) var(--tw-backdrop-saturate,) var(--tw-backdrop-sepia,)}.transition{transition-property:color,background-color,border-color,outline-color,text-decoration-color,fill,stroke,--tw-gradient-from,--tw-gradient-via,--tw-gradient-to,opacity,box-shadow,transform,translate,scale,rotate,filter,-webkit-backdrop-filter,backdrop-filter,display,content-visibility,overlay,pointer-events;transition-timing-function:var(--tw-ease,var(--default-transition-timing-function));transition-duration:var(--tw-duration,var(--default-transition-duration))}.transition-all{transition-property:all;transition-timing-function:var(--tw-ease,var(--default-transition-timing-function));transition-duration:var(--tw-duration,var(--default-transition-duration))}.transition-colors{transition-property:color,background-color,border-color,outline-color,text-decoration-color,fill,stroke,--tw-gradient-from,--tw-gradient-via,--tw-gradient-to;transition-timing-function:var(--tw-ease,var(--default-transition-timing-function));transition-duration:var(--tw-duration,var(--default-transition-duration))}.transition-transform{transition-property:transform,translate,scale,rotate;transition-timing-function:var(--tw-ease,var(--default-transition-timing-function));transition-duration:var(--tw-duration,var(--default-transition-duration))}.duration-150{--tw-duration:.15s;transition-duration:.15s}.duration-200{--tw-duration:.2s;transition-duration:.2s}.duration-300{--tw-duration:.3s;transition-duration:.3s}.duration-500{--tw-duration:.5s;transition-duration:.5s}.select-all{-webkit-user-select:all;user-select:all}.select-none{-webkit-user-select:none;user-select:none}.select-text{-webkit-user-select:text;user-select:text}@media (hover:hover){.group-hover\:translate-x-0\.5:is(:where(.group):hover *){--tw-translate-x:calc(var(--spacing) * .5);translate:var(--tw-translate-x) var(--tw-translate-y)}.group-hover\:translate-x-1:is(:where(.group):hover *){--tw-translate-x:var(--spacing);translate:var(--tw-translate-x) var(--tw-translate-y)}.group-hover\:-translate-y-0\.5:is(:where(.group):hover *){--tw-translate-y:calc(var(--spacing) * -.5);translate:var(--tw-translate-x) var(--tw-translate-y)}.group-hover\:opacity-100:is(:where(.group):hover *){opacity:1}.hover\:w-1\.5:hover{width:calc(var(--spacing) * 1.5)}.hover\:scale-105:hover{--tw-scale-x:105%;--tw-scale-y:105%;--tw-scale-z:105%;scale:var(--tw-scale-x) var(--tw-scale-y)}.hover\:scale-\[1\.01\]:hover{scale:1.01}.hover\:border-red-500\/30:hover{border-color:#fb2c364d}@supports (color:color-mix(in lab, red, red)){.hover\:border-red-500\/30:hover{border-color:color-mix(in oklab, var(--color-red-500) 30%, transparent)}}.hover\:border-white\/10:hover{border-color:#ffffff1a}@supports (color:color-mix(in lab, red, red)){.hover\:border-white\/10:hover{border-color:color-mix(in oklab, var(--color-white) 10%, transparent)}}.hover\:border-white\/20:hover{border-color:#fff3}@supports (color:color-mix(in lab, red, red)){.hover\:border-white\/20:hover{border-color:color-mix(in oklab, var(--color-white) 20%, transparent)}}.hover\:border-white\/30:hover{border-color:#ffffff4d}@supports (color:color-mix(in lab, red, red)){.hover\:border-white\/30:hover{border-color:color-mix(in oklab, var(--color-white) 30%, transparent)}}.hover\:bg-emerald-700:hover{background-color:var(--color-emerald-700)}.hover\:bg-white\/5:hover{background-color:#ffffff0d}@supports (color:color-mix(in lab, red, red)){.hover\:bg-white\/5:hover{background-color:color-mix(in oklab, var(--color-white) 5%, transparent)}}.hover\:bg-white\/10:hover{background-color:#ffffff1a}@supports (color:color-mix(in lab, red, red)){.hover\:bg-white\/10:hover{background-color:color-mix(in oklab, var(--color-white) 10%, transparent)}}.hover\:bg-white\/20:hover{background-color:#fff3}@supports (color:color-mix(in lab, red, red)){.hover\:bg-white\/20:hover{background-color:color-mix(in oklab, var(--color-white) 20%, transparent)}}.hover\:bg-white\/\[0\.04\]:hover{background-color:#ffffff0a}@supports (color:color-mix(in lab, red, red)){.hover\:bg-white\/\[0\.04\]:hover{background-color:color-mix(in oklab, var(--color-white) 4%, transparent)}}.hover\:bg-zinc-200:hover{background-color:var(--color-zinc-200)}.hover\:bg-zinc-800:hover{background-color:var(--color-zinc-800)}.hover\:bg-zinc-950\/40:hover{background-color:#09090b66}@supports (color:color-mix(in lab, red, red)){.hover\:bg-zinc-950\/40:hover{background-color:color-mix(in oklab, var(--color-zinc-950) 40%, transparent)}}.hover\:text-red-400:hover{color:var(--color-red-400)}.hover\:text-slate-300:hover{color:var(--color-slate-300)}.hover\:text-white:hover{color:var(--color-white)}.hover\:text-zinc-300:hover{color:var(--color-zinc-300)}}.focus\:border-white\/30:focus{border-color:#ffffff4d}@supports (color:color-mix(in lab, red, red)){.focus\:border-white\/30:focus{border-color:color-mix(in oklab, var(--color-white) 30%, transparent)}}.focus\:bg-\[\#0d0f15\]:focus{background-color:#0d0f15}.focus\:ring-1:focus{--tw-ring-shadow:var(--tw-ring-inset,) 0 0 0 calc(1px + var(--tw-ring-offset-width)) var(--tw-ring-color,currentcolor);box-shadow:var(--tw-inset-shadow), var(--tw-inset-ring-shadow), var(--tw-ring-offset-shadow), var(--tw-ring-shadow), var(--tw-shadow)}.focus\:ring-white\/20:focus{--tw-ring-color:#fff3}@supports (color:color-mix(in lab, red, red)){.focus\:ring-white\/20:focus{--tw-ring-color:color-mix(in oklab, var(--color-white) 20%, transparent)}}.focus\:outline-none:focus{--tw-outline-style:none;outline-style:none}.active\:scale-95:active{--tw-scale-x:95%;--tw-scale-y:95%;--tw-scale-z:95%;scale:var(--tw-scale-x) var(--tw-scale-y)}.active\:scale-\[0\.98\]:active{scale:.98}.active\:scale-\[0\.99\]:active{scale:.99}.disabled\:opacity-50:disabled{opacity:.5}@media (width>=40rem){.sm\:flex-row{flex-direction:row}}@media (width>=48rem){.md\:col-span-2{grid-column:span 2/span 2}.md\:col-span-3{grid-column:span 3/span 3}.md\:col-span-4{grid-column:span 4/span 4}.md\:col-span-5{grid-column:span 5/span 5}.md\:col-span-7{grid-column:span 7/span 7}.md\:block{display:block}.md\:flex{display:flex}.md\:grid-cols-2{grid-template-columns:repeat(2,minmax(0,1fr))}.md\:grid-cols-12{grid-template-columns:repeat(12,minmax(0,1fr))}.md\:flex-row{flex-direction:row}.md\:gap-5{gap:calc(var(--spacing) * 5)}.md\:border-r{border-right-style:var(--tw-border-style);border-right-width:1px}.md\:border-b-0{border-bottom-style:var(--tw-border-style);border-bottom-width:0}.md\:p-8{padding:calc(var(--spacing) * 8)}.md\:px-6{padding-inline:calc(var(--spacing) * 6)}.md\:text-left{text-align:left}.md\:text-4xl{font-size:var(--text-4xl);line-height:var(--tw-leading,var(--text-4xl--line-height))}.md\:text-6xl{font-size:var(--text-6xl);line-height:var(--tw-leading,var(--text-6xl--line-height))}.md\:text-base{font-size:var(--text-base);line-height:var(--tw-leading,var(--text-base--line-height))}.md\:text-xs{font-size:var(--text-xs);line-height:var(--tw-leading,var(--text-xs--line-height))}}}::-webkit-scrollbar{width:5px;height:5px}::-webkit-scrollbar-track{background:0 0}::-webkit-scrollbar-thumb{background:#ffffff14;border-radius:3px}::-webkit-scrollbar-thumb:hover{background:#ffffff2e}@keyframes blink{0%,to{opacity:1}50%{opacity:0}}.terminal-caret{animation:1s step-end infinite blink}@keyframes infiniteScroll{0%{transform:translate(0)}to{transform:translate(-50%)}}.animate-infinite-scroll{animation:25s linear infinite infiniteScroll}@keyframes breathe{0%,to{opacity:.08;transform:scale(1)translate(0)}50%{opacity:.15;transform:scale(1.05)translate(5px,-10px)}}.aurora-glow-1{animation:15s ease-in-out infinite breathe}.aurora-glow-2{animation:10s ease-in-out infinite alternate breathe}.glass-panel{-webkit-backdrop-filter:blur(20px);backdrop-filter:blur(20px);background:#050505bf;border:1px solid #ffffff14}.glass-card-hover{transition:all .2s cubic-bezier(.4,0,.2,1)}.glass-card-hover:hover{border-color:#ffffff26;transform:translateY(-1.5px);box-shadow:0 0 30px #ffffff05}.markdown-body{font-size:.875rem;line-height:1.6}.markdown-body h1,.markdown-body h2,.markdown-body h3{color:#fff;margin-top:1.25rem;margin-bottom:.5rem;font-family:Outfit,sans-serif;font-weight:700}.markdown-body h1{border-bottom:1px solid #ffffff14;padding-bottom:.25rem;font-size:1.2rem}.markdown-body h2{font-size:1.05rem}.markdown-body h3{font-size:.95rem}.markdown-body p{color:#94a3b8;margin-bottom:.75rem}.markdown-body ul,.markdown-body ol{margin-bottom:.75rem;padding-left:1.25rem}.markdown-body li{color:#94a3b8;margin-bottom:.25rem}.markdown-body code{color:#fff;background-color:#ffffff0f;border-radius:.25rem;padding:.125rem .25rem;font-family:JetBrains Mono,monospace;font-size:.75rem;font-weight:600}.markdown-body pre code{color:inherit;background-color:#0000;padding:0;font-weight:400}.results-card-fullscreen{z-index:9999!important;background-color:#070708!important;border:1px solid #ffffff1f!important;border-radius:12px!important;width:auto!important;height:auto!important;position:fixed!important;inset:1rem!important;box-shadow:0 25px 50px -12px #000c!important}.markdown-light p,.markdown-light li{color:#374151}.markdown-light h1,.markdown-light h2,.markdown-light h3{color:#09090b;border-color:#00000014}.markdown-light code{color:#18181b;background-color:#0000000d}@property --tw-scale-x{syntax:"*";inherits:false;initial-value:1}@property --tw-scale-y{syntax:"*";inherits:false;initial-value:1}@property --tw-scale-z{syntax:"*";inherits:false;initial-value:1}@property --tw-rotate-x{syntax:"*";inherits:false}@property --tw-rotate-y{syntax:"*";inherits:false}@property --tw-rotate-z{syntax:"*";inherits:false}@property --tw-skew-x{syntax:"*";inherits:false}@property --tw-skew-y{syntax:"*";inherits:false}@property --tw-space-y-reverse{syntax:"*";inherits:false;initial-value:0}@property --tw-border-style{syntax:"*";inherits:false;initial-value:solid}@property --tw-gradient-position{syntax:"*";inherits:false}@property --tw-gradient-from{syntax:"<color>";inherits:false;initial-value:#0000}@property --tw-gradient-via{syntax:"<color>";inherits:false;initial-value:#0000}@property --tw-gradient-to{syntax:"<color>";inherits:false;initial-value:#0000}@property --tw-gradient-stops{syntax:"*";inherits:false}@property --tw-gradient-via-stops{syntax:"*";inherits:false}@property --tw-gradient-from-position{syntax:"<length-percentage>";inherits:false;initial-value:0%}@property --tw-gradient-via-position{syntax:"<length-percentage>";inherits:false;initial-value:50%}@property --tw-gradient-to-position{syntax:"<length-percentage>";inherits:false;initial-value:100%}@property --tw-leading{syntax:"*";inherits:false}@property --tw-font-weight{syntax:"*";inherits:false}@property --tw-tracking{syntax:"*";inherits:false}@property --tw-shadow{syntax:"*";inherits:false;initial-value:0 0 #0000}@property --tw-shadow-color{syntax:"*";inherits:false}@property --tw-shadow-alpha{syntax:"<percentage>";inherits:false;initial-value:100%}@property --tw-inset-shadow{syntax:"*";inherits:false;initial-value:0 0 #0000}@property --tw-inset-shadow-color{syntax:"*";inherits:false}@property --tw-inset-shadow-alpha{syntax:"<percentage>";inherits:false;initial-value:100%}@property --tw-ring-color{syntax:"*";inherits:false}@property --tw-ring-shadow{syntax:"*";inherits:false;initial-value:0 0 #0000}@property --tw-inset-ring-color{syntax:"*";inherits:false}@property --tw-inset-ring-shadow{syntax:"*";inherits:false;initial-value:0 0 #0000}@property --tw-ring-inset{syntax:"*";inherits:false}@property --tw-ring-offset-width{syntax:"<length>";inherits:false;initial-value:0}@property --tw-ring-offset-color{syntax:"*";inherits:false;initial-value:#fff}@property --tw-ring-offset-shadow{syntax:"*";inherits:false;initial-value:0 0 #0000}@property --tw-blur{syntax:"*";inherits:false}@property --tw-brightness{syntax:"*";inherits:false}@property --tw-contrast{syntax:"*";inherits:false}@property --tw-grayscale{syntax:"*";inherits:false}@property --tw-hue-rotate{syntax:"*";inherits:false}@property --tw-invert{syntax:"*";inherits:false}@property --tw-opacity{syntax:"*";inherits:false}@property --tw-saturate{syntax:"*";inherits:false}@property --tw-sepia{syntax:"*";inherits:false}@property --tw-drop-shadow{syntax:"*";inherits:false}@property --tw-drop-shadow-color{syntax:"*";inherits:false}@property --tw-drop-shadow-alpha{syntax:"<percentage>";inherits:false;initial-value:100%}@property --tw-drop-shadow-size{syntax:"*";inherits:false}@property --tw-backdrop-blur{syntax:"*";inherits:false}@property --tw-backdrop-brightness{syntax:"*";inherits:false}@property --tw-backdrop-contrast{syntax:"*";inherits:false}@property --tw-backdrop-grayscale{syntax:"*";inherits:false}@property --tw-backdrop-hue-rotate{syntax:"*";inherits:false}@property --tw-backdrop-invert{syntax:"*";inherits:false}@property --tw-backdrop-opacity{syntax:"*";inherits:false}@property --tw-backdrop-saturate{syntax:"*";inherits:false}@property --tw-backdrop-sepia{syntax:"*";inherits:false}@property --tw-duration{syntax:"*";inherits:false}@property --tw-translate-x{syntax:"*";inherits:false;initial-value:0}@property --tw-translate-y{syntax:"*";inherits:false;initial-value:0}@property --tw-translate-z{syntax:"*";inherits:false;initial-value:0}@keyframes spin{to{transform:rotate(360deg)}}@keyframes ping{75%,to{opacity:0;transform:scale(2)}}@keyframes pulse{50%{opacity:.5}}

public/index.html

@@ -0,0 +1,19 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <link rel="icon" type="image/svg+xml" href="data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 32 32'%3E%3Ccircle cx='16' cy='16' r='16' fill='white'/%3E%3Cpolygon points='13 2 3 14 12 14 11 22 21 10 12 10' fill='none' stroke='black' stroke-width='2' stroke-linecap='round' stroke-linejoin='round' transform='translate(7, 7) scale(0.75)'/%3E%3C/svg%3E" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>Smart API DevTool - Developer Workspace</title>
+    
+    <!-- Google Fonts -->
+    <link rel="preconnect" href="https://fonts.googleapis.com">
+    <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
+    <link href="https://fonts.googleapis.com/css2?family=Inter:wght@300;400;500;600;700&family=Outfit:wght@400;500;600;700;800&family=JetBrains+Mono:wght@400;500;600&display=swap" rel="stylesheet">
+    <script type="module" crossorigin src="/assets/index-BpkGHxff.js"></script>
+    <link rel="stylesheet" crossorigin href="/assets/index-Dq8pwRiF.css">
+  </head>
+  <body class="bg-[#0b0f19] text-slate-100 min-h-screen antialiased overflow-x-hidden">
+    <div id="root"></div>
+  </body>
+</html>

requirements.txt

@@ -0,0 +1,11 @@
+fastapi
+uvicorn[standard]
+pydantic
+pydantic-settings
+google-genai
+langgraph
+langchain-google-genai
+langchain-community
+requests
+pytest
+python-dotenv

src/__init__.py

@@ -0,0 +1 @@
+# Smart API DevTool source package

src/agent.py

@@ -0,0 +1,750 @@
+import os
+import re
+import json
+import time
+import logging
+import requests
+from typing import Dict, Any, Optional
+from typing_extensions import TypedDict
+from pydantic import BaseModel, Field
+
+from google import genai
+from google.genai import types
+from langgraph.graph import StateGraph, END
+
+from src.config import settings
+from src.services.executor import run_tests
+
+logger = logging.getLogger(__name__)
+
+def retry_api_call(func, *args, max_attempts=5, initial_wait=2, backoff_factor=2, **kwargs):
+    """
+    Retries an API call with exponential backoff for transient errors (429, 5xx, or specific API errors).
+    """
+    attempt = 0
+    wait = initial_wait
+    while True:
+        try:
+            return func(*args, **kwargs)
+        except Exception as e:
+            attempt += 1
+            if attempt >= max_attempts:
+                raise e
+            
+            # Check if the error is retryable
+            err_msg = str(e).lower()
+            is_retryable = False
+            
+            # 1. Check Gemini API errors
+            if "genai" in type(e).__module__ or "APIError" in type(e).__name__:
+                status_code = getattr(e, "code", None) or getattr(e, "status", None)
+                if status_code in (429, 500, 502, 503, 504) or any(msg in err_msg for msg in ["503", "429", "temporary", "quota", "rate limit", "overloaded", "unavailable"]):
+                    is_retryable = True
+            
+            # 2. Check requests errors (Groq, OpenRouter, Ollama)
+            elif isinstance(e, requests.RequestException):
+                status_code = None
+                if e.response is not None:
+                    status_code = e.response.status_code
+                if status_code in (429, 500, 502, 503, 504) or any(msg in err_msg for msg in ["503", "429", "rate limit", "overloaded"]):
+                    is_retryable = True
+                elif isinstance(e, (requests.exceptions.ConnectionError, requests.exceptions.Timeout)):
+                    is_retryable = True
+            
+            # 3. General check
+            elif any(msg in err_msg for msg in ["rate limit", "429", "503", "502", "500", "overloaded", "unavailable", "timeout"]):
+                is_retryable = True
+                
+            if not is_retryable:
+                raise e
+                
+            print(f"[Agent] API call failed with {type(e).__name__}: {e}. Retrying in {wait}s (attempt {attempt}/{max_attempts})...")
+            time.sleep(wait)
+            wait *= backoff_factor
+
+# State definition
+class AgentState(TypedDict):
+    scraped_text: str
+    use_case: str
+    language: str
+    model_provider: str
+    gemini_key: Optional[str]
+    gemini_model: Optional[str]
+    groq_key: Optional[str]
+    groq_model: Optional[str]
+    openrouter_key: Optional[str]
+    openrouter_model: Optional[str]
+    firecrawl_key: Optional[str]
+    retry_count: int
+    error_logs: str
+    overview: str
+    endpoints: str
+    code: str
+    tests: str
+    readme: str
+    test_passed: bool
+
+# Output model for Gemini structured JSON
+class APIIntegrationOutput(BaseModel):
+    overview: str = Field(..., description="Details on authentication methods and recommendation on REST vs SDK integration path.")
+    endpoints: str = Field(..., description="Interactive structured list of endpoints, including URLs, parameters, headers, and payload structures.")
+    code: str = Field(..., description="The complete, production-ready, type-safe API client wrapper class.")
+    tests: str = Field(..., description="The unit tests code suite designed to test the client wrapper class.")
+    readme: str = Field(..., description="Markdown usage instructions and setup guide for the wrapper.")
+
+# Output model for pre-generation validation
+class APIValidationOutput(BaseModel):
+    has_rest_apis: bool = Field(..., description="True if the text contains actual REST API endpoints, HTTP routes, paths, or API specifications. False if it is just a landing page, marketing text, generic tutorials, or contains no endpoints.")
+    explanation: str = Field(..., description="A brief explanation of why the document does or does not contain REST APIs or specifications.")
+
+def parse_json_response(response_text: str, provider: str = "model") -> Dict[str, Any]:
+    """
+    Defensively extracts and parses a JSON object from a model's response.
+    """
+    cleaned_text = response_text.strip()
+    
+    # 1. Try parsing directly
+    try:
+        return json.loads(cleaned_text)
+    except json.JSONDecodeError:
+        pass
+    
+    # 2. Try extracting markdown json block
+    match = re.search(r"```json\s*(.*?)\s*```", cleaned_text, re.DOTALL)
+    if match:
+        try:
+            return json.loads(match.group(1).strip())
+        except json.JSONDecodeError:
+            pass
+            
+    # 3. Try finding the first '{' and last '}'
+    start = cleaned_text.find('{')
+    end = cleaned_text.rfind('}')
+    if start != -1 and end != -1:
+        try:
+            return json.loads(cleaned_text[start:end+1].strip())
+        except json.JSONDecodeError:
+            pass
+            
+    # Check if the JSON appears to be truncated (e.g. no closing '}' at the end of the text)
+    is_truncated = False
+    if cleaned_text and not cleaned_text.endswith('}'):
+        is_truncated = True
+        
+    error_msg = f"Failed to parse JSON response from {provider}."
+    if is_truncated:
+        error_msg += " The response appears to be truncated (it does not end with a closing brace '}')."
+    
+    error_msg += f" Raw response:\n{response_text}"
+    raise ValueError(error_msg)
+
+def validate_documentation(
+    scraped_text: str,
+    model_provider: str,
+    gemini_key: Optional[str] = None,
+    gemini_model: Optional[str] = None,
+    groq_key: Optional[str] = None,
+    groq_model: Optional[str] = None,
+    openrouter_key: Optional[str] = None,
+    openrouter_model: Optional[str] = None
+):
+    """
+    Validates that the scraped text contains actual REST API specifications or endpoints.
+    If not, raises a ValueError with an explanation.
+    """
+    sample_text = scraped_text[:15000].strip()
+    if not sample_text:
+        raise ValueError("Documentation content is empty. Please provide valid API reference content.")
+
+    validation_prompt = f"""You are a senior API architect. Analyze the following scraped text from a documentation source and determine if it contains actual REST API endpoint specifications (such as HTTP methods: GET, POST, PUT, DELETE, etc., endpoint paths/routes, request headers, parameters, or JSON payload structures).
+
+If the text contains actual REST API endpoint specifications or routes, set "has_rest_apis" to true.
+If the text is just a high-level landing page, generic documentation, tutorials without endpoint paths, marketing text, or contains no actual REST API endpoints/routes, set "has_rest_apis" to false.
+
+DOCUMENTATION CONTENT:
+{sample_text}
+"""
+
+    has_rest_apis = True
+    explanation = ""
+
+    if model_provider == "gemini":
+        g_key = gemini_key or settings.gemini_api_key
+        g_model = gemini_model or "gemini-2.5-flash"
+        if not g_key:
+            raise ValueError("Google Gemini API Key is required but not provided. Please supply one in your configuration or UI.")
+        
+        client = genai.Client(api_key=g_key)
+        response = retry_api_call(
+            client.models.generate_content,
+            model=g_model,
+            contents=validation_prompt,
+            config=types.GenerateContentConfig(
+                response_mime_type="application/json",
+                response_schema=APIValidationOutput,
+                temperature=0.0,
+            ),
+        )
+        parsed = response.parsed
+        has_rest_apis = parsed.has_rest_apis
+        explanation = parsed.explanation
+
+    elif model_provider == "groq":
+        g_key = groq_key or settings.groq_api_key
+        g_model = groq_model or "llama-3.3-70b-versatile"
+        if not g_key:
+            raise ValueError("Groq API Key is required but not provided. Please supply one in your configuration or UI.")
+            
+        url = "https://api.groq.com/openai/v1/chat/completions"
+        headers = {
+            "Authorization": f"Bearer {g_key}",
+            "Content-Type": "application/json"
+        }
+        
+        prompt_with_format = validation_prompt + "\n\nCRITICAL: Return ONLY a valid JSON object matching this schema:\n" + json.dumps({
+            "has_rest_apis": "boolean (True if the text contains actual REST API endpoints, HTTP routes, paths, or API specifications)",
+            "explanation": "string (Brief explanation of why)"
+        }, indent=2)
+        
+        payload = {
+            "model": g_model,
+            "messages": [
+                {"role": "user", "content": prompt_with_format}
+            ],
+            "temperature": 0.0,
+            "max_tokens": 1000,
+            "response_format": {"type": "json_object"}
+        }
+        
+        response = retry_api_call(requests.post, url, json=payload, headers=headers, timeout=60)
+        response.raise_for_status()
+        result = response.json()
+        response_text = result["choices"][0]["message"]["content"]
+        
+        parsed = parse_json_response(response_text, f"Groq validation ({g_model})")
+        has_rest_apis = parsed.get("has_rest_apis", True)
+        explanation = parsed.get("explanation", "")
+
+    elif model_provider == "ollama":
+        prompt_with_format = validation_prompt + "\n\nCRITICAL: Return ONLY a valid JSON object matching this schema:\n" + json.dumps({
+            "has_rest_apis": "boolean (True if the text contains actual REST API endpoints, HTTP routes, paths, or API specifications)",
+            "explanation": "string (Brief explanation of why)"
+        }, indent=2)
+        
+        url = f"{settings.ollama_base_url.rstrip('/')}/api/generate"
+        payload = {
+            "model": "qwen2.5-coder",
+            "prompt": prompt_with_format,
+            "format": "json",
+            "stream": False,
+            "options": {
+                "temperature": 0.0,
+                "num_predict": 1000
+            }
+        }
+        
+        response = retry_api_call(requests.post, url, json=payload, timeout=60)
+        response.raise_for_status()
+        result = response.json()
+        response_text = result.get("response", "")
+        
+        parsed = parse_json_response(response_text, "Ollama validation")
+        has_rest_apis = parsed.get("has_rest_apis", True)
+        explanation = parsed.get("explanation", "")
+
+    elif model_provider == "openrouter":
+        or_key = openrouter_key or settings.openrouter_api_key
+        or_model = openrouter_model or "openrouter/free"
+        if not or_key:
+            raise ValueError("OpenRouter API Key is required but not provided. Please supply one in your configuration or UI.")
+            
+        url = "https://openrouter.ai/api/v1/chat/completions"
+        headers = {
+            "Authorization": f"Bearer {or_key}",
+            "Content-Type": "application/json",
+            "HTTP-Referer": "https://github.com/Yashwant00CR7/Smart-API-Integration-Dev-Tool",
+            "X-Title": "Smart API DevTool"
+        }
+        
+        prompt_with_format = validation_prompt + "\n\nCRITICAL: Return ONLY a valid JSON object matching this schema:\n" + json.dumps({
+            "has_rest_apis": "boolean (True if the text contains actual REST API endpoints, HTTP routes, paths, or API specifications)",
+            "explanation": "string (Brief explanation of why)"
+        }, indent=2)
+        
+        payload = {
+            "model": or_model,
+            "messages": [
+                {"role": "user", "content": prompt_with_format}
+            ],
+            "temperature": 0.0,
+            "max_tokens": 1000
+        }
+        
+        response = retry_api_call(requests.post, url, json=payload, headers=headers, timeout=60)
+        response.raise_for_status()
+        result = response.json()
+        response_text = result["choices"][0]["message"]["content"]
+        
+        parsed = parse_json_response(response_text, f"OpenRouter validation ({or_model})")
+        has_rest_apis = parsed.get("has_rest_apis", True)
+        explanation = parsed.get("explanation", "")
+
+    if not has_rest_apis:
+        raise ValueError(
+            f"REST APIs or specifications were not found in the scraped content. "
+            f"Explanation: {explanation} "
+            f"Please provide a different URL or paste the raw REST API specifications directly."
+        )
+
+LANGUAGE_SPECS = {
+    "python": {
+        "framework": "pytest/unittest",
+        "import_instruction": "Import the client wrapper from the 'client' module (e.g., `from client import MyAPIClient`).",
+        "rules": [
+            "DO NOT use class-level static decorators (e.g., @retry) on instance methods when retry/timeout configuration is dynamic. Instead, instantiate the retrier dynamically inside the instance method (e.g., using tenacity.Retrying) to respect self.max_retries and self.timeout.",
+            "Ensure mock side_effect lists have enough elements to match maximum attempts (e.g., max_retries + 1) to prevent mock iterator exhaustion (StopIteration).",
+            "DO NOT import or use third-party mocking libraries (e.g., requests_mock, responses). ONLY use the Python standard library's `unittest.mock` module (such as `patch` and `MagicMock`) for all request mocking.",
+            "Ensure transient network errors (such as connection timeouts and connection errors) are included in the retrier's retry-conditions alongside rate limits (429) and server errors (5xx).",
+            "Use tenacity.Retrying as a dynamic context wrapper directly (e.g., `retrier = Retrying(...)` and `return retrier(lambda: ...)` or similar) rather than defining dynamic inner decorator functions.",
+            "Ensure exception regex string patterns in tests (e.g., `assertRaisesRegex`) exactly match the formatting of messages raised by the client wrapper class (do not assume extra prefixes or text unless present in both).",
+            "When mocking `requests.exceptions.HTTPError` in unit tests, always initialize it with a descriptive message string matching the HTTP status (e.g., `requests.exceptions.HTTPError('500 Server Error...', response=mock_response)`) so that `str(e)` does not return empty.",
+            "Wrap any JSON parsing (e.g., `response.json()`) in a try-except block to catch `ValueError` / `json.JSONDecodeError` and raise your custom API exception (e.g., ChargesAPIError), ensuring JSON parsing errors do not bubble up as raw ValueErrors."
+        ]
+    },
+    "javascript": {
+        "framework": "standard built-in assert module and node.js",
+        "import_instruction": "Import the client class from `./client` using a named import (e.g., `const { MyClientClass } = require('./client');`).",
+        "rules": [
+            "DO NOT use ES6 module import/export syntax. Use CommonJS require() and module.exports instead.",
+            "DO NOT use the 'import' keyword or the 'import()' function anywhere in either the client or the test code.",
+            "In the client code, always export the client class as a named property of module.exports matching the class name (e.g. `module.exports = { MyClientClass };`). In the test code, always import using named destructuring: `const { MyClientClass } = require('./client');`.",
+            "DO NOT require or import any third-party npm packages (such as node-fetch, loglevel, axios, lodash, etc.) in either the client or test script. Use only standard Node.js built-in modules (e.g. assert, fs, path).",
+            "DO NOT use Node's built-in http or https modules to perform network requests. You MUST use the global fetch API (fetch() or globalThis.fetch()) directly. DO NOT require or import fetch; it is globally available in Node.js v18+.",
+            "DO NOT use global test functions or runners like describe(), it(), test(), before(), or after(). Write the tests inside a single top-level async function execution harness `async function runTests() { ... } runTests();`. Wrap all assertions inside a single try/catch block. If any error or assertion fails, log the error and call `process.exit(1)`. If all tests pass, call `process.exit(0)`. Ensure every asynchronous client call is awaited inside this block.",
+            "To mock HTTP responses, assign a mock function directly to globalThis.fetch inside the test script instead of using external mock packages.",
+            "Wrap any JSON parsing (e.g., `await response.json()`) in a try-catch block to handle syntax errors, throwing a custom descriptive error."
+        ]
+    },
+    "typescript": {
+        "framework": "ts-node execution with standard assert",
+        "import_instruction": "Import the client class from `./client` using named imports (e.g. `import { MyClientClass } from './client';`).",
+        "rules": [
+            "DO NOT use third-party test libraries (e.g. Jest, Mocha, Expect). Write tests as a self-contained TypeScript file using the built-in assert module.",
+            "In the client code, export the class using named export (e.g. `export class MyClientClass { ... }`). In the test code, import it accordingly (e.g. `import { MyClientClass } from './client';`).",
+            "DO NOT import or require any third-party npm packages (such as node-fetch, loglevel, axios, etc.) in the client or test script.",
+            "DO NOT use Node's built-in http or https modules to perform network requests. You MUST use the global fetch API (fetch() or globalThis.fetch()) directly. DO NOT import fetch; it is globally available in Node.js v18+.",
+            "DO NOT use global test runner functions like describe(), it(), test(), before(), or after(). Write tests inside a single top-level `async function runTests() { ... } runTests();` harness using the built-in assert module, catching errors and exiting with `process.exit(1)` on failure, and exiting with `process.exit(0)` on success. Ensure all asynchronous calls are awaited.",
+            "To mock HTTP responses, assign a mock function directly to globalThis.fetch inside the test script.",
+            "Wrap any JSON parsing (e.g., `await response.json()`) in a try-catch block to handle syntax errors, throwing a custom descriptive error."
+        ]
+    },
+    "go": {
+        "framework": "native 'testing' package",
+        "import_instruction": "Import the sandbox package.",
+        "rules": [
+            "DO NOT use third-party HTTP mocking libraries (e.g. jarcoal/httpmock). Mock HTTP requests using standard library httptest.NewServer or by injecting a custom http.RoundTripper.",
+            "Reuse TCP connections by reusing the http.Client instance.",
+            "Write standard Go unit tests matching the signature func TestXxx(t *testing.T) from the 'testing' package.",
+            "Implement exponential backoff retry logic for rate limits (429) and server errors (5xx) dynamically using time.Sleep."
+        ]
+    },
+    "java": {
+        "framework": "Standard public Java class with public static void main(String[] args)",
+        "import_instruction": "Import the client class directly.",
+        "rules": [
+            "DO NOT use JUnit, TestNG, or third-party assertion libraries (e.g. AssertJ, Hamcrest). All assertions MUST use Java's native `assert` keyword.",
+            "The test file MUST be a single, standalone Java class with a `public static void main(String[] args)` method that executes all assertions sequentially. If any assertion fails, the program should crash, translating to a non-zero exit code in the sandbox.",
+            "DO NOT use third-party HTTP clients (e.g. OkHttp, Apache HttpClient). Use Java 11's built-in java.net.http.HttpClient or HttpURLConnection.",
+            "DO NOT use external mocking libraries (e.g. Mockito). Mock API responses by implementing a mock HTTP handler or a custom HttpClient request runner inside the test code.",
+            "Ensure that tests run successfully with assertions enabled via the -ea flag (configured in the executor environment)."
+        ]
+    }
+}
+
+def generate_code(state: AgentState) -> Dict[str, Any]:
+    """
+    Node that calls Gemini or Ollama to generate/regenerate API client wrapper code.
+    """
+    scraped_text = state.get("scraped_text", "").strip()
+    if not scraped_text or (("forbidden" in scraped_text.lower() or "failed" in scraped_text.lower() or "error" in scraped_text.lower()) and len(scraped_text) < 500):
+        raise ValueError("Scraped documentation is empty or represents a scraping error. Please provide valid API reference content.")
+    use_case = state.get("use_case", "")
+    language = state.get("language", "python").lower().strip()
+    model_provider = state.get("model_provider", "gemini")
+    gemini_key = state.get("gemini_key") or settings.gemini_api_key
+    groq_key = state.get("groq_key") or settings.groq_api_key
+    groq_model = state.get("groq_model") or "llama-3.3-70b-versatile"
+    openrouter_key = state.get("openrouter_key") or settings.openrouter_api_key
+    openrouter_model = state.get("openrouter_model") or "openrouter/free"
+    retry_count = state.get("retry_count", 0)
+    error_logs = state.get("error_logs", "")
+    
+    print(f"[Agent] Generating code iteration {retry_count + 1} for language: {language}")
+
+    # Build dynamic language rules
+    spec = LANGUAGE_SPECS.get(language, {
+        "framework": "standard test framework",
+        "import_instruction": "Import client from `./client`.",
+        "rules": []
+    })
+    rules_list = [
+        f"Test Framework: Use {spec['framework']}.",
+        f"For the unit test suite script ('tests'): {spec['import_instruction']}"
+    ] + spec['rules']
+    language_rules_str = "\n".join(f"- {rule}" for rule in rules_list)
+
+    # Build prompt
+    if retry_count == 0 or not error_logs:
+        # Initial prompt
+        prompt = f"""You are a Staff Software Engineer. Your task is to generate a fully-functional, production-ready client API wrapper class and an accompanying unit test suite.
+
+TARGET LANGUAGE:
+{language}
+
+USE CASE DETAILS:
+{use_case}
+
+API REFERENCE DOCUMENTATION:
+{scraped_text}
+
+CORE REQUIREMENTS:
+1. 'overview': Outline the authentication mechanism(s) used by the API and recommend the integration path (REST client vs native SDK). Keep it clean and concise.
+2. 'endpoints': Summarize the endpoints, HTTP methods, parameters, request headers, and payloads required for the use case.
+3. 'code': Write the full client wrapper class code. The code must:
+   - Handle connection timeouts, session reuse, and authorization headers.
+   - Include robust error handling and throw custom descriptive exceptions.
+   - Implement exponential backoff retry logic for transient errors (e.g., HTTP 429, 5xx) that honors user-configured retry/timeout parameters.
+   - NOT contain any placeholders, mock code, or incomplete implementations.
+   - Strictly utilize only the paths, HTTP methods, parameters, and payload schemas defined in the provided API Reference Documentation. DO NOT invent, guess, or hallucinate fictional endpoints.
+   - Never hardcode API keys or credentials. Retrieve keys dynamically (e.g., using environment variables or configuration files).
+   - Integrate production-grade logging using the target language's standard library logging utilities to record requests, retries, and errors, rather than bare print statements (For JavaScript/TypeScript, use standard console.warn/console.error instead of importing loglevel or other third-party npm packages).
+   - For JavaScript/TypeScript: DO NOT import, require, or reference any external npm packages (like node-fetch, axios, loglevel, etc.). You MUST use the global fetch API directly (available as fetch() or globalThis.fetch(), do not import it).
+4. 'tests': Write a complete, executable unit test suite script to validate the wrapper class. The tests must:
+   - Compile and run successfully in the target language environment.
+   - Use mock servers or standard library mock utilities rather than calling the real API.
+   - For JavaScript/TypeScript: DO NOT use global testing hooks like describe(), it(), test(), before(), or after() which are undefined in raw node executions. Write the tests as a sequentially executed script using Node's built-in assert module, catching errors and calling process.exit(1) on failure. Mock requests by patching globalThis.fetch directly.
+5. 'readme': Write a markdown usage guide explaining setup, configuration, and a quick-start example.
+
+LANGUAGE-SPECIFIC RULES:
+{language_rules_str}
+"""
+    else:
+        # Self-healing prompt
+        prompt = f"""You are a Staff Software Engineer. The previously generated API client wrapper or test suite failed verification.
+Analyze the error logs and regenerate the complete files to fix the issue.
+
+TARGET LANGUAGE:
+{language}
+
+USE CASE DETAILS:
+{use_case}
+
+API REFERENCE DOCUMENTATION:
+{scraped_text}
+
+ERROR LOGS FROM SANDBOX RUN:
+{error_logs}
+
+PREVIOUSLY GENERATED CLIENT CODE:
+{state.get("code", "")}
+
+PREVIOUSLY GENERATED TEST CODE:
+{state.get("tests", "")}
+
+INSTRUCTIONS:
+1. Correct the wrapper code ('code') or the test suite ('tests') or both to resolve the error.
+2. Ensure that standard library mocks are correctly imported and used.
+3. If the error shows missing package imports or runtime path issues, ensure imports are aligned with standard local directory layouts.
+4. Ensure the wrapper strictly adheres to the provided API Reference Documentation, handles credentials securely without hardcoding, and uses standard logging libraries.
+5. For JavaScript/TypeScript: NEVER require or import third-party packages (axios, node-fetch, loglevel, etc.), use the global fetch API directly, and do not use describe/it/test hooks.
+6. Output the complete updated fields: 'overview', 'endpoints', 'code', 'tests', and 'readme'.
+"""
+
+    if model_provider == "gemini":
+        if not gemini_key:
+            raise ValueError("Google Gemini API Key is required but not provided. Please supply one in your configuration or UI.")
+            
+        gemini_model = state.get("gemini_model") or "gemini-2.5-flash"
+        client = genai.Client(api_key=gemini_key)
+        response = retry_api_call(
+            client.models.generate_content,
+            model=gemini_model,
+            contents=prompt,
+            config=types.GenerateContentConfig(
+                response_mime_type="application/json",
+                response_schema=APIIntegrationOutput,
+                temperature=0.1,
+            ),
+        )
+        
+        parsed = response.parsed
+        return {
+            "overview": parsed.overview,
+            "endpoints": parsed.endpoints,
+            "code": parsed.code,
+            "tests": parsed.tests,
+            "readme": parsed.readme,
+        }
+        
+    elif model_provider == "ollama":
+        prompt_with_format = prompt + "\n\nCRITICAL: Return ONLY a valid JSON object matching this schema:\n" + json.dumps({
+            "overview": "string (Overview of auth methods, integration path recommendation)",
+            "endpoints": "string (List of endpoints, request payloads, headers, query parameters)",
+            "code": "string (The complete client wrapper code)",
+            "tests": "string (The complete unit test suite)",
+            "readme": "string (README markdown guide)"
+        }, indent=2)
+        
+        url = f"{settings.ollama_base_url.rstrip('/')}/api/generate"
+        payload = {
+            "model": "qwen2.5-coder",
+            "prompt": prompt_with_format,
+            "format": "json",
+            "stream": False,
+            "options": {
+                "temperature": 0.1,
+                "num_predict": 4096
+            }
+        }
+        
+        response = retry_api_call(requests.post, url, json=payload, timeout=120)
+        response.raise_for_status()
+        result = response.json()
+        response_text = result.get("response", "")
+        
+        if not result.get("done", True):
+            raise ValueError(
+                "Ollama generation was truncated (done is false). "
+                "The model ran out of token prediction space before completing the JSON wrapper. "
+                "Try reducing the size of your input documentation or choosing a larger context/predict limit."
+            )
+            
+        parsed = parse_json_response(response_text, "Ollama model")
+        return {
+            "overview": parsed.get("overview", ""),
+            "endpoints": parsed.get("endpoints", ""),
+            "code": parsed.get("code", ""),
+            "tests": parsed.get("tests", ""),
+            "readme": parsed.get("readme", ""),
+        }
+    elif model_provider == "groq":
+        if not groq_key:
+            raise ValueError("Groq API Key is required but not provided. Please supply one in your configuration or UI.")
+            
+        url = "https://api.groq.com/openai/v1/chat/completions"
+        headers = {
+            "Authorization": f"Bearer {groq_key}",
+            "Content-Type": "application/json"
+        }
+        
+        is_reasoning_model = "qwen" in groq_model.lower() or "deepseek" in groq_model.lower()
+        
+        # Instruct reasoning models to be concise in their thinking/reasoning process to avoid output token limits
+        thinking_instruction = ""
+        if is_reasoning_model:
+            thinking_instruction = (
+                "\nNOTE: Since you are a reasoning model, keep your thinking process concise. "
+                "Ensure that the final JSON object is completely generated and not truncated due to output token limits."
+            )
+            
+        prompt_with_format = prompt + thinking_instruction + "\n\nCRITICAL: Return ONLY a valid JSON object matching this schema:\n" + json.dumps({
+            "overview": "string (Overview of auth methods, integration path recommendation)",
+            "endpoints": "string (List of endpoints, request payloads, headers, query parameters)",
+            "code": "string (The complete client wrapper code)",
+            "tests": "string (The complete unit test suite)",
+            "readme": "string (README markdown guide)"
+        }, indent=2)
+        
+        payload = {
+            "model": groq_model,
+            "messages": [
+                {"role": "user", "content": prompt_with_format}
+            ],
+            "temperature": 0.1,
+            "max_tokens": 4096
+        }
+        
+        # Qwen and reasoning models do not support JSON Object mode on Groq when thinking/reasoning is enabled
+        if not is_reasoning_model:
+            payload["response_format"] = {"type": "json_object"}
+        
+        response = retry_api_call(requests.post, url, json=payload, headers=headers, timeout=120)
+        response.raise_for_status()
+        result = response.json()
+        
+        choice = result["choices"][0]
+        response_text = choice["message"]["content"]
+        finish_reason = choice.get("finish_reason")
+        
+        if finish_reason == "length":
+            raise ValueError(
+                f"Groq ({groq_model}) generation was truncated (finish_reason: length). "
+                f"The model ran out of output tokens before completing the JSON wrapper. "
+                f"Try reducing the size of your input documentation or using a model with a larger output limit."
+            )
+            
+        parsed = parse_json_response(response_text, f"Groq model ({groq_model})")
+        return {
+            "overview": parsed.get("overview", ""),
+            "endpoints": parsed.get("endpoints", ""),
+            "code": parsed.get("code", ""),
+            "tests": parsed.get("tests", ""),
+            "readme": parsed.get("readme", ""),
+        }
+    elif model_provider == "openrouter":
+        if not openrouter_key:
+            raise ValueError("OpenRouter API Key is required but not provided. Please supply one in your configuration or .env file.")
+            
+        url = "https://openrouter.ai/api/v1/chat/completions"
+        headers = {
+            "Authorization": f"Bearer {openrouter_key}",
+            "Content-Type": "application/json",
+            "HTTP-Referer": "https://github.com/Yashwant00CR7/Smart-API-Integration-Dev-Tool",
+            "X-Title": "Smart API DevTool"
+        }
+        
+        prompt_with_format = prompt + "\n\nCRITICAL: Return ONLY a valid JSON object matching this schema:\n" + json.dumps({
+            "overview": "string (Overview of auth methods, integration path recommendation)",
+            "endpoints": "string (List of endpoints, request payloads, headers, query parameters)",
+            "code": "string (The complete client wrapper code)",
+            "tests": "string (The complete unit test suite)",
+            "readme": "string (README markdown guide)"
+        }, indent=2)
+        
+        payload = {
+            "model": openrouter_model,
+            "messages": [
+                {"role": "user", "content": prompt_with_format}
+            ],
+            "temperature": 0.1,
+            "max_tokens": 4096
+        }
+        
+        response = retry_api_call(requests.post, url, json=payload, headers=headers, timeout=120)
+        response.raise_for_status()
+        result = response.json()
+        
+        choice = result["choices"][0]
+        response_text = choice["message"]["content"]
+        finish_reason = choice.get("finish_reason")
+        
+        if finish_reason == "length":
+            raise ValueError(
+                f"OpenRouter ({openrouter_model}) generation was truncated (finish_reason: length). "
+                f"The model ran out of output tokens before completing the JSON wrapper. "
+                f"Try reducing the size of your input documentation or using a model with a larger output limit."
+            )
+            
+        parsed = parse_json_response(response_text, f"OpenRouter model ({openrouter_model})")
+        return {
+            "overview": parsed.get("overview", ""),
+            "endpoints": parsed.get("endpoints", ""),
+            "code": parsed.get("code", ""),
+            "tests": parsed.get("tests", ""),
+            "readme": parsed.get("readme", ""),
+        }
+    else:
+        raise ValueError(f"Unsupported model provider: {model_provider}")
+
+def execute_sandbox(state: AgentState) -> Dict[str, Any]:
+    """
+    Node that runs the generated client wrapper and unit tests in the isolated sandbox.
+    """
+    language = state.get("language", "python")
+    code = state.get("code", "")
+    tests = state.get("tests", "")
+    retry_count = state.get("retry_count", 0)
+    
+    print(f"[Agent] Executing tests inside isolated sandbox (Iteration {retry_count + 1})...")
+    
+    try:
+        test_passed, console_logs = run_tests(language, code, tests)
+    except Exception as e:
+        test_passed = False
+        console_logs = f"Subprocess executor failed with exception: {str(e)}"
+        
+    print(f"[Agent] Test execution finished. Passed: {test_passed}")
+    
+    return {
+        "test_passed": test_passed,
+        "error_logs": "" if test_passed else console_logs,
+        "retry_count": retry_count + 1
+    }
+
+def should_continue(state: AgentState) -> str:
+    """
+    Conditional edge deciding whether to self-heal or exit.
+    """
+    if state.get("test_passed") or state.get("retry_count", 0) >= 3:
+        return "end"
+    return "generate"
+
+# Build LangGraph workflow
+workflow = StateGraph(AgentState)
+workflow.add_node("generate", generate_code)
+workflow.add_node("execute", execute_sandbox)
+
+workflow.set_entry_point("generate")
+workflow.add_edge("generate", "execute")
+workflow.add_conditional_edges(
+    "execute",
+    should_continue,
+    {
+        "end": END,
+        "generate": "generate"
+    }
+)
+
+compiled_graph = workflow.compile()
+
+def run_agent_workflow(
+    scraped_text: str,
+    use_case: str,
+    language: str,
+    model_provider: str,
+    gemini_key: Optional[str] = None,
+    gemini_model: Optional[str] = None,
+    groq_key: Optional[str] = None,
+    groq_model: Optional[str] = None,
+    openrouter_key: Optional[str] = None,
+    openrouter_model: Optional[str] = None,
+    firecrawl_key: Optional[str] = None
+) -> Dict[str, Any]:
+    """
+    Main entrypoint to trigger the self-healing agent loop.
+    """
+    # Pre-generation validation
+    validate_documentation(
+        scraped_text=scraped_text,
+        model_provider=model_provider,
+        gemini_key=gemini_key,
+        gemini_model=gemini_model,
+        groq_key=groq_key,
+        groq_model=groq_model,
+        openrouter_key=openrouter_key,
+        openrouter_model=openrouter_model
+    )
+
+    initial_state = {
+        "scraped_text": scraped_text,
+        "use_case": use_case,
+        "language": language,
+        "model_provider": model_provider,
+        "gemini_key": gemini_key,
+        "gemini_model": gemini_model,
+        "groq_key": groq_key,
+        "groq_model": groq_model,
+        "openrouter_key": openrouter_key,
+        "openrouter_model": openrouter_model,
+        "firecrawl_key": firecrawl_key,
+        "retry_count": 0,
+        "error_logs": "",
+        "overview": "",
+        "endpoints": "",
+        "code": "",
+        "tests": "",
+        "readme": "",
+        "test_passed": False
+    }
+    
+    return compiled_graph.invoke(initial_state)

src/app.py

@@ -0,0 +1,115 @@
+import os
+from fastapi import FastAPI, HTTPException, Body, Response
+from fastapi.middleware.cors import CORSMiddleware
+from fastapi.staticfiles import StaticFiles
+from pydantic import BaseModel, Field
+from typing import Optional, List, Dict, Any
+
+from src.config import settings
+from src.services.scraper import scrape_url
+from src.services.executor import run_tests
+from src.agent import run_agent_workflow
+
+
+app = FastAPI(
+    title="Smart API DevTool",
+    description="Backend API for crawling docs and auto-generating self-healing API wrappers.",
+    version="1.0.0"
+)
+
+# Enable CORS for frontend dashboard
+app.add_middleware(
+    CORSMiddleware,
+    allow_origins=["*"],
+    allow_credentials=True,
+    allow_methods=["*"],
+    allow_headers=["*"],
+)
+
+class AnalyzeRequest(BaseModel):
+    url: Optional[str] = Field(None, description="The URL of the API documentation.")
+    raw_docs: Optional[str] = Field(None, description="Raw pasted API documentation text.")
+    use_case: str = Field(..., description="Details on what the wrapper will do.")
+    language: str = Field("python", description="Target programming language.")
+    model_provider: str = Field("gemini", description="Either 'gemini', 'ollama', 'groq' or 'openrouter'.")
+    gemini_key: Optional[str] = Field(None, description="Optional Google Gemini API Key.")
+    gemini_model: Optional[str] = Field("gemini-2.5-flash", description="Optional Google Gemini Model ID.")
+    groq_key: Optional[str] = Field(None, description="Optional Groq API Key.")
+    groq_model: Optional[str] = Field(None, description="Optional Groq Model ID.")
+    openrouter_key: Optional[str] = Field(None, description="Optional OpenRouter API Key.")
+    openrouter_model: Optional[str] = Field("openrouter/free", description="Optional OpenRouter Model ID.")
+    firecrawl_key: Optional[str] = Field(None, description="Optional Firecrawl API Key.")
+
+@app.get("/api/health")
+def health_check():
+    """Simple endpoint to verify server status."""
+    return {
+        "status": "healthy",
+        "configuration": {
+            "has_gemini_key": bool(settings.gemini_api_key),
+            "has_groq_key": bool(settings.groq_api_key),
+            "has_openrouter_key": bool(settings.openrouter_api_key),
+            "has_firecrawl_key": bool(settings.firecrawl_api_key),
+            "ollama_base_url": settings.ollama_base_url
+        }
+    }
+
+@app.get("/favicon.ico", include_in_schema=False)
+def favicon():
+    """Handles browser favicon requests with 204 No Content to prevent console 404 log littering."""
+    return Response(status_code=204)
+
+@app.post("/api/analyze")
+async def analyze_api(request: AnalyzeRequest):
+    """
+    Analyzes API documentation (via URL scraping or raw text) and triggers
+    the LangGraph self-healing agent loop to output verified wrapper classes.
+    """
+    try:
+        scraped_text = ""
+        if request.url:
+            scraped_text = scrape_url(request.url)
+        elif request.raw_docs:
+            scraped_text = request.raw_docs
+        else:
+            raise HTTPException(status_code=400, detail="Must provide either a URL or raw_docs.")
+            
+        result = run_agent_workflow(
+            scraped_text=scraped_text,
+            use_case=request.use_case,
+            language=request.language,
+            model_provider=request.model_provider,
+            gemini_key=request.gemini_key,
+            gemini_model=request.gemini_model,
+            groq_key=request.groq_key,
+            groq_model=request.groq_model,
+            openrouter_key=request.openrouter_key,
+            openrouter_model=request.openrouter_model,
+            firecrawl_key=request.firecrawl_key
+        )
+        
+        return {
+            "success": result.get("test_passed", False),
+            "overview": result.get("overview", ""),
+            "endpoints": result.get("endpoints", ""),
+            "code": result.get("code", ""),
+            "tests": result.get("tests", ""),
+            "readme": result.get("readme", ""),
+            "retry_count": result.get("retry_count", 0),
+            "error_logs": result.get("error_logs", ""),
+            "test_passed": result.get("test_passed", False)
+        }
+    except Exception as e:
+        raise HTTPException(status_code=500, detail=str(e))
+
+# Mount static files programmatically if the public folder exists
+public_path = os.path.abspath(os.path.join(os.path.dirname(__file__), "..", "public"))
+if os.path.isdir(public_path):
+    app.mount("/", StaticFiles(directory=public_path, html=True), name="public")
+else:
+    # Fallback message route for clean dev experience before frontend is built
+    @app.get("/")
+    def read_root():
+        return {
+            "message": "Welcome to Smart API DevTool Backend! The 'public' directory is not yet present. Exposing API routes at /api/health."
+        }

src/config.py

@@ -0,0 +1,29 @@
+import os
+from pydantic_settings import BaseSettings, SettingsConfigDict
+from typing import Optional
+
+class Settings(BaseSettings):
+    # API Keys & Third-party integrations
+    gemini_api_key: Optional[str] = None
+    groq_api_key: Optional[str] = None
+    openrouter_api_key: Optional[str] = None
+    firecrawl_api_key: Optional[str] = None
+    ollama_base_url: str = "http://localhost:11434"
+    
+    # Server configuration
+    host: str = "0.0.0.0"
+    port: int = 7860
+    reload: bool = False
+    access_log: bool = False
+    gemini_model: str = "gemini-2.5-flash"
+    openrouter_model: str = "openrouter/free"
+    
+    # Environment config
+    model_config = SettingsConfigDict(
+        env_file=".env",
+        env_file_encoding="utf-8",
+        extra="ignore"
+    )
+
+settings = Settings()
+

src/mcp_server.py

@@ -0,0 +1,369 @@
+import sys
+import json
+import traceback
+import logging
+from typing import Dict, Any, Optional
+
+from src.services.scraper import scrape_url
+from src.agent import run_agent_workflow
+
+def run_mcp_server():
+    """
+    Runs the Model Context Protocol (MCP) server over standard I/O (stdin/stdout).
+    To prevent any print statements, logs, or external library debug outputs from
+    corrupting the JSON-RPC stream, sys.stdout is redirected to sys.stderr, while
+    original stdout is preserved specifically for sending JSON-RPC response frames.
+    """
+    # Preserve original stdout for JSON-RPC communication
+    original_stdout = sys.stdout
+    
+    # Redirect global stdout to stderr so all general print() calls go to stderr
+    sys.stdout = sys.stderr
+
+    # Reconfigure stdin/stdout text streams to use UTF-8 and handle encoding errors gracefully (especially on Windows)
+    if hasattr(sys.stdin, "reconfigure"):
+        try:
+            sys.stdin.reconfigure(encoding="utf-8", errors="replace")
+        except Exception as e:
+            print(f"[MCP Server] Warning reconfiguring stdin encoding: {str(e)}", file=sys.stderr)
+            
+    if hasattr(original_stdout, "reconfigure"):
+        try:
+            original_stdout.reconfigure(encoding="utf-8", errors="replace")
+        except Exception as e:
+            print(f"[MCP Server] Warning reconfiguring stdout encoding: {str(e)}", file=sys.stderr)
+    
+    # Redirect any existing standard logging stream handlers pointing to stdout to prevent JSON-RPC contamination
+    try:
+        for handler in logging.root.handlers:
+            if isinstance(handler, logging.StreamHandler) and handler.stream in (sys.__stdout__, original_stdout):
+                handler.setStream(sys.stderr)
+    except Exception as e:
+        print(f"[MCP Server] Warning redirecting logging handlers: {str(e)}", file=sys.stderr)
+    
+    print("[MCP Server] Starting hardened MCP server stream loop...", file=sys.stderr)
+    print("[MCP Server] Redirected sys.stdout and standard logging handlers to sys.stderr to protect stream channel.", file=sys.stderr)
+
+    # Process standard input line by line
+    for line in sys.stdin:
+        if not line.strip():
+            continue
+            
+        req_id = None
+        is_notification = True
+        
+        def send_response(response: Dict[str, Any], force: bool = False):
+            # Notifications MUST NOT receive responses per JSON-RPC 2.0 spec,
+            # except for severe Parse/Invalid Request errors where we force a response.
+            if is_notification and not force:
+                return
+            try:
+                out_line = json.dumps(response) + "\n"
+                original_stdout.write(out_line)
+                original_stdout.flush()
+            except Exception as e:
+                print(f"[MCP Server] Error writing response to stdout: {str(e)}", file=sys.stderr)
+
+        def send_error(code: int, message: str, r_id: Optional[Any] = None, data: Optional[Any] = None):
+            err_resp = {
+                "jsonrpc": "2.0",
+                "error": {
+                    "code": code,
+                    "message": message
+                }
+            }
+            if data is not None:
+                err_resp["error"]["data"] = data
+            if r_id is not None:
+                err_resp["id"] = r_id
+            else:
+                err_resp["id"] = None
+                
+            # Severe protocol validation errors (parse error, invalid request) are sent back
+            force_reply = code in [-32700, -32600]
+            send_response(err_resp, force=force_reply)
+
+        try:
+            request = json.loads(line)
+            if not isinstance(request, dict):
+                send_error(-32600, "Invalid Request: expected JSON object")
+                continue
+                
+            # Determine if this message is a request or notification
+            is_notification = "id" not in request
+            req_id = request.get("id")
+            method = request.get("method")
+            jsonrpc = request.get("jsonrpc")
+            
+            # Verify JSON-RPC version
+            if jsonrpc and jsonrpc != "2.0":
+                print(f"[MCP Server] Warning: received JSON-RPC version {jsonrpc}, expecting 2.0", file=sys.stderr)
+                
+            if not method or not isinstance(method, str):
+                send_error(-32600, "Invalid Request: missing or invalid method field", req_id)
+                continue
+
+            # Parse parameters safely
+            params = request.get("params")
+            if params is None:
+                params = {}
+            elif not isinstance(params, dict):
+                send_error(-32602, "Invalid params: expected JSON object", req_id)
+                continue
+
+            print(f"[MCP Server] Received method: '{method}' (id: {req_id}, notification: {is_notification})", file=sys.stderr)
+
+            # 1. Protocol Lifecycle Handshake
+            if method == "initialize":
+                protocol_version = params.get("protocolVersion", "2024-11-05")
+                response = {
+                    "jsonrpc": "2.0",
+                    "id": req_id,
+                    "result": {
+                        "protocolVersion": protocol_version,
+                        "capabilities": {
+                            "tools": {}
+                        },
+                        "serverInfo": {
+                            "name": "Smart-API-DevTool-Server",
+                            "version": "1.0.0"
+                        }
+                    }
+                }
+                send_response(response)
+                
+            elif method == "notifications/initialized":
+                print("[MCP Server] Initialized notification received.", file=sys.stderr)
+                
+            elif method == "ping":
+                response = {
+                    "jsonrpc": "2.0",
+                    "id": req_id,
+                    "result": {}
+                }
+                send_response(response)
+
+            # 2. Tool Discovery
+            elif method == "tools/list":
+                tools = [
+                    {
+                        "name": "scrape_url",
+                        "description": "Scrapes the target API documentation URL using Firecrawl and returns the clean markdown content.",
+                        "inputSchema": {
+                            "type": "object",
+                            "properties": {
+                                "url": {
+                                    "type": "string",
+                                    "description": "The HTTP or HTTPS URL of the API documentation page to scrape."
+                                },
+                                "api_key": {
+                                    "type": "string",
+                                    "description": "Optional Firecrawl API Key. If not provided, it falls back to the server configuration."
+                                }
+                            },
+                            "required": ["url"]
+                        }
+                    },
+                    {
+                        "name": "generate_wrapper",
+                        "description": "Generates a complete, verified API client wrapper class, usage README guide, and unit tests using a self-healing LangGraph agentic loop.",
+                        "inputSchema": {
+                            "type": "object",
+                            "properties": {
+                                "scraped_text": {
+                                    "type": "string",
+                                    "description": "The raw text or scraped markdown documentation of the API."
+                                },
+                                "use_case": {
+                                    "type": "string",
+                                    "description": "Details of the target use case and functions to implement in the wrapper."
+                                },
+                                "language": {
+                                    "type": "string",
+                                    "description": "Target programming language (e.g. 'python', 'typescript', 'go', 'java'). Default is 'python'."
+                                },
+                                "model_provider": {
+                                    "type": "string",
+                                    "description": "The model provider to use ('gemini', 'ollama', 'groq', or 'openrouter'). Default is 'gemini'."
+                                },
+                                "gemini_key": {
+                                    "type": "string",
+                                    "description": "Optional Google Gemini API Key. Required if model_provider is 'gemini' and the server has no key configured."
+                                },
+                                "gemini_model": {
+                                    "type": "string",
+                                    "description": "Optional Google Gemini Model ID (e.g. 'gemini-2.5-flash')."
+                                },
+                                "groq_key": {
+                                    "type": "string",
+                                    "description": "Optional Groq API Key. Required if model_provider is 'groq' and the server has no key configured."
+                                },
+                                "groq_model": {
+                                    "type": "string",
+                                    "description": "Optional Groq Model ID (e.g., 'llama-3.3-70b-versatile')."
+                                },
+                                "openrouter_key": {
+                                    "type": "string",
+                                    "description": "Optional OpenRouter API Key. Required if model_provider is 'openrouter' and the server has no key configured."
+                                },
+                                "openrouter_model": {
+                                    "type": "string",
+                                    "description": "Optional OpenRouter Model ID (e.g., 'openrouter/free')."
+                                },
+                                "firecrawl_key": {
+                                    "type": "string",
+                                    "description": "Optional Firecrawl API Key."
+                                }
+                            },
+                            "required": ["scraped_text", "use_case"]
+                        }
+                    }
+                ]
+                response = {
+                    "jsonrpc": "2.0",
+                    "id": req_id,
+                    "result": {
+                        "tools": tools
+                    }
+                }
+                send_response(response)
+
+            # 3. Tool Execution
+            elif method == "tools/call":
+                tool_name = params.get("name")
+                arguments = params.get("arguments")
+                
+                if not tool_name or not isinstance(tool_name, str):
+                    send_error(-32602, "Invalid params: missing or invalid tool name", req_id)
+                    continue
+                    
+                if arguments is None:
+                    arguments = {}
+                elif not isinstance(arguments, dict):
+                    send_response({
+                        "jsonrpc": "2.0",
+                        "id": req_id,
+                        "result": {
+                            "content": [{"type": "text", "text": "Error: 'arguments' must be a JSON object matching tool schema."}],
+                            "isError": True
+                        }
+                    })
+                    continue
+                    
+                print(f"[MCP Server] Calling tool '{tool_name}' (arguments present: {list(arguments.keys())})", file=sys.stderr)
+                
+                if tool_name == "scrape_url":
+                    url = arguments.get("url")
+                    if not url or not isinstance(url, str):
+                        send_response({
+                            "jsonrpc": "2.0",
+                            "id": req_id,
+                            "result": {
+                                "content": [{"type": "text", "text": "Error: 'url' parameter is required and must be a string."}],
+                                "isError": True
+                            }
+                        })
+                        continue
+                        
+                    try:
+                        scraped_markdown = scrape_url(url, api_key=arguments.get("api_key"))
+                        send_response({
+                            "jsonrpc": "2.0",
+                            "id": req_id,
+                            "result": {
+                                "content": [{"type": "text", "text": scraped_markdown}]
+                            }
+                        })
+                    except Exception as e:
+                        print(f"[MCP Server] Error in scrape_url: {traceback.format_exc()}", file=sys.stderr)
+                        send_response({
+                            "jsonrpc": "2.0",
+                            "id": req_id,
+                            "result": {
+                                "content": [{"type": "text", "text": f"Scrape failed: {str(e)}"}],
+                                "isError": True
+                            }
+                        })
+                        
+                elif tool_name == "generate_wrapper":
+                    scraped_text = arguments.get("scraped_text")
+                    use_case = arguments.get("use_case")
+                    language = arguments.get("language", "python")
+                    model_provider = arguments.get("model_provider", "gemini")
+                    gemini_key = arguments.get("gemini_key")
+                    gemini_model = arguments.get("gemini_model")
+                    groq_key = arguments.get("groq_key")
+                    groq_model = arguments.get("groq_model")
+                    openrouter_key = arguments.get("openrouter_key")
+                    openrouter_model = arguments.get("openrouter_model")
+                    firecrawl_key = arguments.get("firecrawl_key")
+                    
+                    if not scraped_text or not isinstance(scraped_text, str) or not use_case or not isinstance(use_case, str):
+                        send_response({
+                            "jsonrpc": "2.0",
+                            "id": req_id,
+                            "result": {
+                                "content": [{"type": "text", "text": "Error: 'scraped_text' and 'use_case' parameters must be non-empty strings."}],
+                                "isError": True
+                            }
+                        })
+                        continue
+                        
+                    try:
+                        agent_result = run_agent_workflow(
+                            scraped_text=scraped_text,
+                            use_case=use_case,
+                            language=str(language),
+                            model_provider=str(model_provider),
+                            gemini_key=gemini_key,
+                            gemini_model=gemini_model,
+                            groq_key=groq_key,
+                            groq_model=groq_model,
+                            openrouter_key=openrouter_key,
+                            openrouter_model=openrouter_model,
+                            firecrawl_key=firecrawl_key
+                        )
+                        
+                        cleaned_result = {
+                            "success": agent_result.get("test_passed", False),
+                            "overview": agent_result.get("overview", ""),
+                            "endpoints": agent_result.get("endpoints", ""),
+                            "code": agent_result.get("code", ""),
+                            "tests": agent_result.get("tests", ""),
+                            "readme": agent_result.get("readme", ""),
+                            "retry_count": agent_result.get("retry_count", 0),
+                            "error_logs": agent_result.get("error_logs", "")
+                        }
+                        
+                        send_response({
+                            "jsonrpc": "2.0",
+                            "id": req_id,
+                            "result": {
+                                "content": [{"type": "text", "text": json.dumps(cleaned_result, indent=2)}]
+                            }
+                        })
+                    except Exception as e:
+                        print(f"[MCP Server] Error in generate_wrapper: {traceback.format_exc()}", file=sys.stderr)
+                        send_response({
+                            "jsonrpc": "2.0",
+                            "id": req_id,
+                            "result": {
+                                "content": [{"type": "text", "text": f"Wrapper generation failed: {str(e)}"}],
+                                "isError": True
+                            }
+                        })
+                else:
+                    send_error(-32601, f"Method '{method}' tool '{tool_name}' not found", req_id)
+            else:
+                send_error(-32601, f"Method '{method}' not found", req_id)
+                
+        except json.JSONDecodeError:
+            send_error(-32700, "Parse error: invalid JSON received")
+        except Exception as e:
+            print(f"[MCP Server] Unexpected exception: {traceback.format_exc()}", file=sys.stderr)
+            send_error(-32603, f"Internal error: {str(e)}", req_id)
+            
+    print("[MCP Server] Stdin EOF reached. Exiting server.", file=sys.stderr)
+
+if __name__ == "__main__":
+    run_mcp_server()

src/services/__init__.py

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

src/services/executor.py

@@ -0,0 +1,184 @@
+import os
+import re
+import sys
+import uuid
+import stat
+import shutil
+import subprocess
+from typing import Tuple
+
+def remove_readonly(func, path, excinfo):
+    """
+    On Windows, files can sometimes be marked read-only or locked,
+    preventing shutil.rmtree from working. This helper removes
+    the read-only attribute and retries the removal.
+    """
+    try:
+        os.chmod(path, stat.S_IWRITE)
+        func(path)
+    except Exception:
+        pass
+
+def run_tests(language: str, code: str, tests: str) -> Tuple[bool, str]:
+    """
+    Writes the wrapper code and unit test code to an isolated temporary sandbox directory,
+    runs the language-specific test suite via a subprocess, and returns a tuple
+    of (test_passed, console_logs).
+    """
+    # Create a unique sandbox directory under a root 'temp' folder
+    root_temp_dir = os.path.abspath(os.path.join(os.path.dirname(__file__), "..", "..", "temp"))
+    os.makedirs(root_temp_dir, exist_ok=True)
+    
+    run_id = str(uuid.uuid4())
+    sandbox_dir = os.path.join(root_temp_dir, f"run_{run_id}")
+    os.makedirs(sandbox_dir, exist_ok=True)
+    
+    language = language.lower().strip()
+    timeout_val = 30 if language in ["go", "golang", "java"] else 15
+    
+    code_filename = ""
+    test_filename = ""
+    run_args = []
+    env = os.environ.copy()
+    
+    # Enable Java assertions by default
+    if "JAVA_TOOL_OPTIONS" not in env:
+        env["JAVA_TOOL_OPTIONS"] = "-ea"
+    else:
+        env["JAVA_TOOL_OPTIONS"] += " -ea"
+
+    try:
+        if language in ["python", "py"]:
+            code_filename = "client.py"
+            test_filename = "test_client.py"
+            # Add sandbox directory to PYTHONPATH so pytest can import the client module
+            env["PYTHONPATH"] = f"{sandbox_dir}{os.pathsep}{env.get('PYTHONPATH', '')}"
+            # Use sys.executable to ensure we use the virtual environment's interpreter
+            run_args = [sys.executable, "-m", "pytest", "--tb=short", test_filename]
+            
+        elif language in ["javascript", "js"]:
+            code_filename = "client.js"
+            test_filename = "test_client.test.js"
+            run_args = ["node", test_filename]
+            
+        elif language in ["typescript", "ts"]:
+            code_filename = "client.ts"
+            test_filename = "test_client.test.ts"
+            
+            # Write a basic tsconfig.json so ts-node works consistently
+            tsconfig_path = os.path.join(sandbox_dir, "tsconfig.json")
+            tsconfig_content = """{
+  "compilerOptions": {
+    "target": "es2020",
+    "module": "commonjs",
+    "esModuleInterop": true,
+    "strict": false,
+    "skipLibCheck": true
+  }
+}"""
+            with open(tsconfig_path, "w", encoding="utf-8") as f:
+                f.write(tsconfig_content)
+                
+            run_args = ["npx", "ts-node", "--transpile-only", test_filename]
+            
+        elif language in ["go", "golang"]:
+            code_filename = "client.go"
+            test_filename = "client_test.go"
+            
+            # Initialize a temporary go module to prevent module loading errors
+            subprocess.run(
+                ["go", "mod", "init", "sandbox"],
+                cwd=sandbox_dir,
+                capture_output=True,
+                timeout=5
+            )
+            
+            run_args = ["go", "test", "-v", code_filename, test_filename]
+            
+        elif language in ["java"]:
+            # Strip package declarations to avoid compile/runtime classpath resolution issues
+            code = re.sub(r"^\s*package\s+[\w\.]+;\s*", "", code, flags=re.MULTILINE)
+            tests = re.sub(r"^\s*package\s+[\w\.]+;\s*", "", tests, flags=re.MULTILINE)
+            
+            def find_class_name(source: str, default: str) -> str:
+                # Matches public/non-public class names safely
+                match = re.search(r"(?:public\s+)?class\s+(\w+)", source)
+                return match.group(1) if match else default
+                
+            code_classname = find_class_name(code, "MyAPIClient")
+            test_classname = find_class_name(tests, "TestClient")
+            
+            code_filename = f"{code_classname}.java"
+            test_filename = f"{test_classname}.java"
+            
+        else:
+            raise ValueError(f"Unsupported language for self-healing execution: {language}")
+            
+        # Write files to sandbox
+        code_path = os.path.join(sandbox_dir, code_filename)
+        test_path = os.path.join(sandbox_dir, test_filename)
+        
+        with open(code_path, "w", encoding="utf-8") as f:
+            f.write(code)
+        with open(test_path, "w", encoding="utf-8") as f:
+            f.write(tests)
+            
+        # Execute the subprocess
+        if language == "java":
+            # 1. Compile Java files
+            compile_process = subprocess.run(
+                ["javac", code_filename, test_filename],
+                cwd=sandbox_dir,
+                capture_output=True,
+                text=True,
+                timeout=timeout_val
+            )
+            
+            if compile_process.returncode != 0:
+                return False, f"Compilation Error:\n{compile_process.stderr}\nStdout:\n{compile_process.stdout}"
+                
+            # 2. Execute Java test entrypoint
+            test_class = test_filename[:-5]
+            run_process = subprocess.run(
+                ["java", "-ea", test_class],
+                cwd=sandbox_dir,
+                capture_output=True,
+                text=True,
+                timeout=timeout_val,
+                env=env
+            )
+            
+            success = (run_process.returncode == 0)
+            logs = f"Stdout:\n{run_process.stdout}\nStderr:\n{run_process.stderr}"
+            return success, logs
+            
+        else:
+            # On Windows, prepend cmd.exe /c for CMD-based tools like npx
+            actual_args = run_args
+            if os.name == "nt" and run_args and run_args[0] == "npx":
+                actual_args = ["cmd.exe", "/c"] + run_args
+
+            # Run the command with strict timeout to prevent CPU hung states
+            process = subprocess.run(
+                actual_args,
+                cwd=sandbox_dir,
+                capture_output=True,
+                text=True,
+                timeout=timeout_val,
+                env=env
+            )
+            
+            success = (process.returncode == 0)
+            logs = f"Stdout:\n{process.stdout}\nStderr:\n{process.stderr}"
+            return success, logs
+            
+    except subprocess.TimeoutExpired as e:
+        return False, f"Execution timed out after 15 seconds.\nStdout:\n{e.stdout}\nStderr:\n{e.stderr}"
+    except Exception as e:
+        return False, f"Executor encountered an internal exception: {str(e)}"
+    finally:
+        # Clean up sandbox directory using the Windows-resilient onerror handler
+        try:
+            shutil.rmtree(sandbox_dir, onerror=remove_readonly)
+        except Exception:
+            pass

src/services/scraper.py

@@ -0,0 +1,73 @@
+import time
+import requests
+from typing import Optional
+from urllib.parse import urlparse
+from src.config import settings
+
+def scrape_url(url: str, api_key: Optional[str] = None) -> str:
+    """
+    Scrapes the target URL using Firecrawl API and returns the markdown content.
+    If no api_key is provided, it falls back to settings.firecrawl_api_key.
+    If both are absent, it operates in Firecrawl Keyless mode (no Authorization header).
+    
+    Includes security scheme validation and exponential backoff retry for HTTP 429 (Rate Limits).
+    """
+    # Security Validation: Enforce http/https to prevent internal file or protocol attacks
+    parsed = urlparse(url)
+    if parsed.scheme not in ["http", "https"]:
+        raise ValueError("Invalid URL protocol. Only HTTP and HTTPS schemes are supported.")
+        
+    endpoint = "https://api.firecrawl.dev/v2/scrape"
+    
+    headers = {
+        "Content-Type": "application/json"
+    }
+    
+    # Use the passed key, or fallback to the environment configuration
+    key_to_use = api_key or settings.firecrawl_api_key
+    if key_to_use:
+        headers["Authorization"] = f"Bearer {key_to_use}"
+        
+    payload = {
+        "url": url,
+        "formats": ["markdown"]
+    }
+    
+    max_retries = 3
+    backoff = 1.0
+    
+    for attempt in range(max_retries):
+        try:
+            response = requests.post(endpoint, json=payload, headers=headers, timeout=30)
+            
+            # Handle rate limiting with backoff
+            if response.status_code == 429:
+                if attempt == max_retries - 1:
+                    raise RuntimeError("Firecrawl rate limit exceeded. Max retries reached.")
+                time.sleep(backoff)
+                backoff *= 2
+                continue
+                
+            if response.status_code == 401:
+                raise ValueError("Firecrawl authentication failed. Please check your API key.")
+                
+            response.raise_for_status()
+            
+            data = response.json()
+            if not data.get("success"):
+                error_msg = data.get("error", "Unknown error occurred during Firecrawl scraping.")
+                raise ValueError(f"Firecrawl scraping failed: {error_msg}")
+                
+            markdown_content = data.get("data", {}).get("markdown", "")
+            if not markdown_content:
+                raise ValueError("Firecrawl succeeded but returned empty markdown content.")
+                
+            return markdown_content
+            
+        except requests.exceptions.RequestException as e:
+            if attempt == max_retries - 1:
+                raise RuntimeError(f"Network request to Firecrawl failed after {max_retries} attempts: {str(e)}")
+            time.sleep(backoff)
+            backoff *= 2
+            
+    raise RuntimeError("Firecrawl scraping failed due to retry exhaustion.")