Upload folder using huggingface_hub

.github/workflows/sync.yml

@@ -0,0 +1,23 @@
+name: Sync to Hugging Face Hub
+on:
+  push:
+    branches: [main]
+  workflow_dispatch:
+
+jobs:
+  sync-to-hub:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v3
+        with:
+          fetch-depth: 0
+      - name: Install HF Hub
+        run: pip install huggingface_hub
+      - name: Push to HF
+        env:
+          HF_TOKEN: ${{ secrets.HF_TOKEN }}
+        run: |
+          python -c "from huggingface_hub import HfApi; \
+          api = HfApi(); \
+          api.upload_folder(folder_path='.', repo_id='gahugo2020/Smart_Grad_UI', repo_type='space', token='$HF_TOKEN', \
+          ignore_patterns=['.git', '.gitignore', 'target/', '*.class', 'nb-configuration.xml', 'nbactions.xml'])"

Dockerfile

@@ -1,34 +1,30 @@
-FROM tomcat:9.0-jdk11
+# Stage 1: Build
+# Using JDK 11 as it has better compatibility with Java 8 source code
+FROM maven:3.8.5-openjdk-11 AS build
+WORKDIR /app
 
-# Install git and maven
-RUN apt-get update && \
-    apt-get install -y git maven && \
-    rm -rf /var/lib/apt/lists/*
+# Copy only pom.xml first to cache dependencies
+COPY pom.xml .
+RUN mvn dependency:go-offline -B
 
-# Set working directory
-WORKDIR /build
+# Copy source and build
+COPY src ./src
+RUN mvn clean package -DskipTests
 
-# Build argument — passed at runtime from HF secret
-ARG GITHUB_PAT
+# Stage 2: Run (Tomcat 9 is correct for Java 8/11 and javax.servlet)
+FROM tomcat:9.0-jdk11-openjdk
 
-# Clone private Java Maven repo
-RUN --mount=type=secret,id=GITHUB_PAT \
-    GITHUB_PAT=$(cat /run/secrets/GITHUB_PAT) && \
-    git clone --depth 1 \
-    https://${GITHUB_PAT}@github.com/pgacirane/Smart_Grad_UI.git \
-    app
-
-# Build the WAR file
-RUN cd app && mvn clean package -DskipTests -q
+# Standard port adjustment for Hugging Face/Cloud environments
+RUN sed -i 's/port="8080"/port="7860"/' /usr/local/tomcat/conf/server.xml
 
-# Deploy WAR to Tomcat
-RUN cp app/target/*.war /usr/local/tomcat/webapps/ROOT.war
+# Wipe default apps to prevent conflicts
+RUN rm -rf /usr/local/tomcat/webapps/ROOT /usr/local/tomcat/webapps/ROOT.war
 
-# HuggingFace requires port 7860
-RUN sed -i 's/port="8080"/port="7860"/' /usr/local/tomcat/conf/server.xml
+# Copy the built WAR from the build stage
+# Your pom.xml defines <finalName>MyWebApp</finalName>, so it will be MyWebApp.war
+COPY --from=build /app/target/MyWebApp.war /usr/local/tomcat/webapps/ROOT.war
 
-# Expose port
 EXPOSE 7860
+ENV PORT 7860
 
-# Start Tomcat
 CMD ["catalina.sh", "run"]

LICENSE

@@ -0,0 +1,201 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

pom.xml

@@ -0,0 +1,212 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project xmlns="http://maven.apache.org/POM/4.0.0" 
+         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 
+                             http://maven.apache.org/xsd/maven-4.0.0.xsd">
+    <modelVersion>4.0.0</modelVersion>
+
+    <groupId>com.myapp</groupId>
+    <artifactId>CRM</artifactId>
+    <version>1.0</version>
+    <packaging>war</packaging>
+
+    <properties>
+        <maven.compiler.source>1.8</maven.compiler.source>
+        <maven.compiler.target>1.8</maven.compiler.target>
+        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
+        <failOnMissingWebXml>false</failOnMissingWebXml>
+    </properties>
+
+    <dependencies>
+
+
+
+        <!-- Bcrypt for password hashing -->
+        <dependency>
+            <groupId>org.mindrot</groupId>
+            <artifactId>jbcrypt</artifactId>
+            <version>0.4</version>
+        </dependency>
+
+        <!-- PostgreSQL JDBC Driver -->
+        <dependency>
+            <groupId>org.postgresql</groupId>
+            <artifactId>postgresql</artifactId>
+            <version>42.7.2</version>
+            <scope>runtime</scope>
+        </dependency>
+        
+
+<dependency>
+    <groupId>io.github.cdimascio</groupId>
+    <artifactId>java-dotenv</artifactId>
+    <version>5.2.2</version>
+</dependency>
+
+        <!-- JavaMail API -->
+        <dependency>
+            <groupId>com.sun.mail</groupId>
+            <artifactId>jakarta.mail</artifactId>
+            <version>2.0.1</version>
+        </dependency>
+
+        <!-- JSTL (Jakarta version) -->
+       <!-- <dependency>
+            <groupId>jakarta.servlet.jsp.jstl</groupId>
+            <artifactId>jakarta.servlet.jsp.jstl-api</artifactId>
+            <version>3.0.0</version>
+        </dependency>
+        
+        -->
+        
+        <dependency>
+    <groupId>javax.servlet</groupId>
+    <artifactId>jstl</artifactId>
+    <version>1.2</version>
+</dependency>
+
+<dependency>
+    <groupId>org.apache.commons</groupId>
+    <artifactId>commons-lang3</artifactId>
+    <version>3.12.0</version>
+</dependency>
+
+<dependency>
+    <groupId>com.google.code.gson</groupId>
+    <artifactId>gson</artifactId>
+    <version>2.10.1</version>
+</dependency>
+
+        
+        
+ 
+
+        <!-- WebApp Runner for Heroku -->
+        <dependency>
+            <groupId>com.heroku</groupId>
+            <artifactId>webapp-runner</artifactId>
+            <version>9.0.41.0</version>
+            <scope>provided</scope>
+        </dependency>
+        
+        <dependency>
+    <groupId>javax.servlet</groupId>
+    <artifactId>javax.servlet-api</artifactId>
+    <version>4.0.1</version> <!-- matches Tomcat 9 -->
+    <scope>provided</scope>
+</dependency>
+
+ 
+
+        <dependency>
+            <groupId>javax</groupId>
+            <artifactId>javaee-web-api</artifactId>
+            <version>7.0</version>
+            <scope>provided</scope>
+        </dependency>
+        
+            <dependency>
+        <groupId>org.json</groupId>
+        <artifactId>json</artifactId>
+        <version>20231013</version>
+    </dependency>
+    
+
+    <!-- Jackson Core -->
+    <dependency>
+        <groupId>com.fasterxml.jackson.core</groupId>
+        <artifactId>jackson-core</artifactId>
+        <version>2.13.5</version>
+    </dependency>
+
+    <!-- Jackson Databind (contains ObjectMapper) -->
+    <dependency>
+        <groupId>com.fasterxml.jackson.core</groupId>
+        <artifactId>jackson-databind</artifactId>
+        <version>2.13.5</version>
+    </dependency>
+
+    <!-- Jackson Annotations -->
+    <dependency>
+        <groupId>com.fasterxml.jackson.core</groupId>
+        <artifactId>jackson-annotations</artifactId>
+        <version>2.13.5</version>
+    </dependency>
+
+
+
+
+    </dependencies>
+
+    <build>
+        <finalName>MyWebApp</finalName>
+        <plugins>
+            <!-- WAR packaging plugin -->
+            <plugin>
+                <artifactId>maven-war-plugin</artifactId>
+                <version>3.3.1</version>
+                <configuration>
+                    <failOnMissingWebXml>false</failOnMissingWebXml>
+                </configuration>
+            </plugin>
+
+            <!-- Heroku Maven Plugin -->
+            <plugin>
+                <groupId>com.heroku.sdk</groupId>
+                <artifactId>heroku-maven-plugin</artifactId>
+                <version>3.0.4</version>
+                <configuration>
+                    <appName>your-heroku-app-name</appName>
+                </configuration>
+            </plugin>
+
+            <!-- Maven Compiler Plugin -->
+            <plugin>
+                <artifactId>maven-compiler-plugin</artifactId>
+                <version>3.8.1</version>
+                <configuration>
+                    <source>1.8</source>
+                    <target>1.8</target>
+                </configuration>
+            </plugin>
+
+            <!-- Dependency plugin for copying webapp-runner -->
+            <plugin>
+                <groupId>org.apache.maven.plugins</groupId>
+                <artifactId>maven-dependency-plugin</artifactId>
+                <version>3.1.1</version>
+                <executions>
+                    <execution>
+                        <phase>package</phase>
+                        <goals><goal>copy</goal></goals>
+                        <configuration>
+                            <artifactItems>
+                                <artifactItem>
+                                    <groupId>com.heroku</groupId>
+                                    <artifactId>webapp-runner</artifactId>
+                                    <version>9.0.41.0</version>
+                                    <destFileName>webapp-runner.jar</destFileName>
+                                </artifactItem>
+                            </artifactItems>
+                        </configuration>
+                    </execution>
+                </executions>
+            </plugin>
+        </plugins>
+    </build>
+
+    <repositories>
+        <repository>
+            <id>central</id>
+            <url>https://repo.maven.apache.org/maven2</url>
+        </repository>
+    </repositories>
+
+    <pluginRepositories>
+        <pluginRepository>
+            <id>central</id>
+            <url>https://repo.maven.apache.org/maven2</url>
+        </pluginRepository>
+    </pluginRepositories>
+    <name>Smart_Grad_UI</name>
+</project>

src/main/java/CrewAIUtil/Communicator.java

@@ -0,0 +1,253 @@
+package CrewAIUtil;
+
+import io.github.cdimascio.dotenv.Dotenv;
+import java.io.*;
+import java.net.HttpURLConnection;
+import java.net.SocketTimeoutException;
+import java.net.URL;
+import org.json.JSONObject;
+import org.json.JSONTokener;
+
+/**
+ * Robust Communicator for CrewAI backend (HuggingFace Space)
+ */
+public class Communicator {
+
+        
+        private static final Dotenv dotenv;
+    static {
+        Dotenv tempDotenv = null;
+        try {
+            tempDotenv = Dotenv.configure()
+                    .filename("/.env") // Leading slash instructs classpath lookup
+                    .ignoreIfMalformed()
+                    .ignoreIfMissing()
+                    .load();
+        } catch (Exception e) {
+            // Suppress initialization container logging errors safely
+        }
+        dotenv = tempDotenv;
+    }
+
+    private static String getEnvVar(String key) {
+        if (dotenv != null) {
+            String value = dotenv.get(key);
+            if (value != null && !value.trim().isEmpty()) {
+                return value.trim();
+            }
+        }
+        // Fallback directly to System OS Environment or Properties
+        String systemVal = System.getenv(key);
+        if (systemVal != null && !systemVal.trim().isEmpty()) {
+            return systemVal.trim();
+        }
+        return System.getProperty(key, "");
+    }
+
+    private static final String BASE_URL = getEnvVar("BASE_URL");
+
+    private static final int CONNECT_TIMEOUT = 15000;   // 15 sec
+    private static final int READ_TIMEOUT = 300000;     // 5 min
+    private static final int MAX_RETRIES = 3;
+
+    // ─── Wake up HF Space ─────────────────────────────────────────────
+    public static void wakeUpSpace() {
+        try {
+            URL url = new URL(BASE_URL + "/");
+            HttpURLConnection conn = (HttpURLConnection) url.openConnection();
+            conn.setRequestMethod("GET");
+            conn.setConnectTimeout(CONNECT_TIMEOUT);
+            conn.setReadTimeout(CONNECT_TIMEOUT);
+
+            int responseCode = conn.getResponseCode();
+            System.out.println("Wake-up ping response: " + responseCode);
+
+            conn.disconnect();
+        } catch (Exception e) {
+            System.out.println("Wake-up failed: " + e.getMessage());
+        }
+    }
+
+    // ─── Blocking call ────────────────────────────────────────────────
+    public static String returnOutputFromCrew(String userQuery) {
+        try {
+            JSONObject payload = new JSONObject();
+            //payload.put("customer_id", customerId);
+            payload.put("user_query", userQuery);
+
+            System.out.println("Sending request to /run ...");
+
+            JSONObject responseJson = postRequestWithRetry(BASE_URL + "/kickoff", payload);
+
+            if (responseJson == null) {
+                return "Error: No response from server after retries.";
+            }
+
+            String result = responseJson.optString("result", null);
+            if (result != null) return result;
+
+            return "Unexpected response: " + responseJson.toString(2);
+
+        } catch (Exception e) {
+            e.printStackTrace();
+            return "Exception: " + e.getMessage();
+        }
+    }
+
+    // ─── Streaming-style output (still backend must support SSE for true streaming) ───
+    public static void returnOutputFromCrew(String userQuery, PrintWriter writer) {
+        try {
+            JSONObject payload = new JSONObject();
+            //payload.put("customer_id", customerId);
+            payload.put("user_query", userQuery);
+
+            writer.println("data: ⏳ Processing request...\n");
+            writer.flush();
+
+            JSONObject responseJson = postRequestWithRetry(BASE_URL + "/run-mega", payload);
+
+            if (responseJson == null) {
+                writer.println("data: ❌ No response after retries.\n\n");
+                writer.println("data: [END]\n\n");
+                writer.flush();
+                return;
+            }
+
+            String result = responseJson.optString("result", null);
+
+            if (result != null) {
+                for (String line : result.split("\n")) {
+                    writer.println("data: " + line);
+                    writer.flush();
+                }
+            } else {
+                writer.println("data: ⚠️ Unexpected response: " + responseJson.toString().replace("\n", " "));
+            }
+
+            writer.println("data: [END]\n\n");
+            writer.flush();
+
+        } catch (Exception e) {
+            writer.println("data: ❌ Exception: " + e.getMessage() + "\n\n");
+            writer.println("data: [END]\n\n");
+            writer.flush();
+        }
+    }
+
+    // ─── POST with retry logic ──────────────────��─────────────────────
+    public static JSONObject postRequestWithRetry(String urlString, JSONObject jsonData) {
+
+        for (int attempt = 1; attempt <= MAX_RETRIES; attempt++) {
+            try {
+                System.out.println("Attempt " + attempt + "...");
+
+                JSONObject response = postRequest(urlString, jsonData);
+
+                if (response != null) {
+                    return response;
+                }
+
+            } catch (Exception e) {
+                System.out.println("Attempt " + attempt + " failed: " + e.getMessage());
+            }
+
+            // wait before retry
+            try {
+                Thread.sleep(3000);
+            } catch (InterruptedException ignored) {}
+        }
+
+        return null;
+    }
+
+    // ─── POST helper ──────────────────────────────────────────────────
+    public static JSONObject postRequest(String urlString, JSONObject jsonData) {
+
+        HttpURLConnection conn = null;
+
+        try {
+            URL url = new URL(urlString);
+            conn = (HttpURLConnection) url.openConnection();
+
+            conn.setConnectTimeout(CONNECT_TIMEOUT);
+            conn.setReadTimeout(READ_TIMEOUT);
+            conn.setRequestMethod("POST");
+            conn.setRequestProperty("Content-Type", "application/json");
+            conn.setDoOutput(true);
+
+            // Send request
+            try (OutputStream os = conn.getOutputStream()) {
+                os.write(jsonData.toString().getBytes("UTF-8"));
+                os.flush();
+            }
+
+            long startTime = System.currentTimeMillis();
+
+            int status = conn.getResponseCode();
+
+            long duration = System.currentTimeMillis() - startTime;
+            System.out.println("Response time: " + duration + " ms");
+
+            // Accept 200 OK and 202 Accepted (/kickoff returns 202)
+            if (status != 200 && status != 202) {
+                System.out.println("POST failed: " + status + " " + conn.getResponseMessage());
+                return null;
+            }
+
+            try (InputStream is = conn.getInputStream()) {
+                return new JSONObject(new JSONTokener(is));
+            }
+
+        } catch (SocketTimeoutException e) {
+            System.out.println("Timeout: server took too long.");
+            return null;
+
+        } catch (IOException e) {
+            System.out.println("POST request failed: " + e.getMessage());
+            return null;
+
+        } finally {
+            if (conn != null) conn.disconnect();
+        }
+    }
+
+    // ─── GET helper ───────────────────────────────────────────────────
+    public static JSONObject getRequest(String urlString) {
+
+        HttpURLConnection conn = null;
+
+        try {
+            URL url = new URL(urlString);
+            conn = (HttpURLConnection) url.openConnection();
+
+            conn.setConnectTimeout(CONNECT_TIMEOUT);
+            conn.setReadTimeout(60000);
+            conn.setRequestMethod("GET");
+
+            int status = conn.getResponseCode();
+
+            if (status != 200) {
+                System.out.println("GET failed: " + status);
+                return null;
+            }
+
+            try (InputStream is = conn.getInputStream()) {
+                return new JSONObject(new JSONTokener(is));
+            }
+
+        } catch (IOException e) {
+            System.out.println("GET request failed: " + e.getMessage());
+            return null;
+
+        } finally {
+            if (conn != null) conn.disconnect();
+        }
+    }
+//ok
+    // ─── Test ─────────────────────────────────────────────────────────
+    public static void main(String[] args) {
+        wakeUpSpace();
+        String result = returnOutputFromCrew("What is ART?");
+        System.out.println("Final result:\n" + result);
+    }
+}

src/main/java/CrewAIUtil/CrewResponseStream.java

@@ -0,0 +1,238 @@
+package CrewAIUtil;
+
+import io.github.cdimascio.dotenv.Dotenv;
+import org.json.JSONObject;
+import javax.servlet.ServletException;
+import javax.servlet.annotation.WebServlet;
+import javax.servlet.http.*;
+import java.io.IOException;
+import java.io.PrintWriter;
+
+/**
+ * SSE Servlet for SmartGrad AI Advisory System.
+ * Handles the async kickoff → polling pattern:
+ *   1. POST to /kickoff → receive job_id
+ *   2. Poll /status/{job_id} until complete
+ *   3. Stream progress + final result via SSE
+ *
+ * Called by think.jsp:
+ *   /CrewResponseStream?student_name=...&program=...&country=...&...
+ *
+ * @author patrick.gacirane
+ */
+@WebServlet(name = "CrewResponseStreamServlet", urlPatterns = {"/CrewResponseStream"})
+public class CrewResponseStream extends HttpServlet {
+    
+    
+        private static final Dotenv dotenv;
+    static {
+        Dotenv tempDotenv = null;
+        try {
+            tempDotenv = Dotenv.configure()
+                    .filename("/.env") // Leading slash instructs classpath lookup
+                    .ignoreIfMalformed()
+                    .ignoreIfMissing()
+                    .load();
+        } catch (Exception e) {
+            // Suppress initialization container logging errors safely
+        }
+        dotenv = tempDotenv;
+    }
+
+    private static String getEnvVar(String key) {
+        if (dotenv != null) {
+            String value = dotenv.get(key);
+            if (value != null && !value.trim().isEmpty()) {
+                return value.trim();
+            }
+        }
+        // Fallback directly to System OS Environment or Properties
+        String systemVal = System.getenv(key);
+        if (systemVal != null && !systemVal.trim().isEmpty()) {
+            return systemVal.trim();
+        }
+        return System.getProperty(key, "");
+    }
+
+    private static final String BASE_URL = getEnvVar("BASE_URL");
+
+
+
+   
+    private static final int    POLL_DELAY  = 5000;   // ms between status polls
+    private static final int    MAX_POLLS   = 72;     // 72 × 5s = 6 minutes max wait
+
+    @Override
+    protected void doGet(HttpServletRequest request, HttpServletResponse response)
+            throws ServletException, IOException {
+
+        // ── Cache control ─────────────────────────────────────────────────────
+        response.setHeader("Cache-Control", "no-cache, no-store, must-revalidate");
+        response.setHeader("Pragma", "no-cache");
+        response.setDateHeader("Expires", 0);
+
+        // ── SSE headers ───────────────────────────────────────────────────────
+        response.setContentType("text/event-stream");
+        response.setCharacterEncoding("UTF-8");
+
+        PrintWriter out = response.getWriter();
+
+        // ── Read all student fields ───────────────────────────────────────────
+        String studentName      = param(request, "student_name");
+        String lowerLevel       = param(request, "lower_level",  "high school");
+        String higherLevel      = param(request, "higher_level", "undergraduate");
+        String grade            = param(request, "grade");
+        String major            = param(request, "major");
+        String subjects         = param(request, "subjects");
+        String program          = param(request, "program");
+        String country          = param(request, "country");
+        String destinationCountry = param(request, "destination_country");
+        String state            = param(request, "state");
+        String agentName        = param(request, "agent_name",   "SmartGrad AI Advisor");
+        String institution      = param(request, "institution",  "SmartGrad Education Services");
+
+        // ── Validate required fields ──────────────────────────────────────────
+        if (studentName.isEmpty() || program.isEmpty() || country.isEmpty() || destinationCountry.isEmpty()) {
+            sendMessage(out, "❌ Error: Required fields missing (student_name, program, country, destination_country).");
+            endStream(out);
+            return;
+        }
+
+        try {
+            // ── Step 0: Wake up the HF Space ─────────────────────────────────
+            sendStatus(out, "Connecting to SmartGrad advisory system...");
+            Communicator.wakeUpSpace();
+
+            // ── Step 1: Build payload and POST to /kickoff ────────────────────
+            JSONObject payload = new JSONObject();
+            payload.put("student_name",        studentName);
+            payload.put("lower_level",         lowerLevel);
+            payload.put("higher_level",        higherLevel);
+            payload.put("grade",               grade);
+            payload.put("major",               major);
+            payload.put("subjects",            subjects);
+            payload.put("program",             program);
+            payload.put("country",             country);
+            payload.put("destination_country", destinationCountry);
+            payload.put("state",               state);
+            payload.put("agent_name",          agentName);
+            payload.put("institution",         institution);
+
+            sendStatus(out, "Submitting student profile to agents...");
+
+            JSONObject kickoffResp = Communicator.postRequest(BASE_URL + "/kickoff", payload);
+
+            if (kickoffResp == null) {
+                sendMessage(out, "❌ Error: Could not reach the advisory system. Please try again.");
+                endStream(out);
+                return;
+            }
+
+            String jobId = kickoffResp.optString("job_id", null);
+            if (jobId == null || jobId.isEmpty()) {
+                sendMessage(out, "❌ Error: No job ID returned from server.");
+                endStream(out);
+                return;
+            }
+
+            sendStatus(out, "Crew started (Job ID: " + jobId.substring(0, 8) + "...). Agents are researching...");
+
+            // ── Step 2: Poll /status/{job_id} until done ──────────────────────
+            String statusUrl = BASE_URL + "/status/" + jobId;
+            int    polls     = 0;
+            int    stepsLogged = 0;
+
+            while (polls < MAX_POLLS) {
+                Thread.sleep(POLL_DELAY);
+                polls++;
+
+                JSONObject statusResp = Communicator.getRequest(statusUrl);
+
+                if (statusResp == null) {
+                    sendStatus(out, "Still waiting for agents... (attempt " + polls + ")");
+                    continue;
+                }
+
+                String status      = statusResp.optString("status", "unknown");
+                int    newSteps    = statusResp.optInt("steps_logged", 0);
+
+                // Show progress when new steps arrive
+                if (newSteps > stepsLogged) {
+                    int diff = newSteps - stepsLogged;
+                    stepsLogged = newSteps;
+                    sendStatus(out, "Agents completed " + newSteps + " step" + (newSteps == 1 ? "" : "s") + "...");
+                }
+
+                if ("complete".equals(status)) {
+                    String result = statusResp.optString("result", null);
+
+                    if (result != null && !result.isEmpty()) {
+                        // Stream the result line by line
+                        for (String line : result.split("\n")) {
+                            sendMessage(out, line);
+                        }
+                    } else {
+                        sendMessage(out, "⚠️ Agents completed but returned an empty result.");
+                    }
+                    endStream(out);
+                    return;
+
+                } else if ("error".equals(status)) {
+                    String error = statusResp.optString("error", "Unknown error from advisory system.");
+                    sendMessage(out, "❌ Advisory system error: " + error);
+                    endStream(out);
+                    return;
+
+                } else if ("pending".equals(status) || "running".equals(status)) {
+                    // Still working — keep polling
+                    String label = "running".equals(status)
+                            ? "Agents are analyzing your profile... (" + polls + "/" + MAX_POLLS + ")"
+                            : "Waiting for crew to start... (" + polls + "/" + MAX_POLLS + ")";
+                    sendStatus(out, label);
+                }
+            }
+
+            // Timeout
+            sendMessage(out, "⚠️ The advisory system is taking longer than expected. Please check back using job ID: " + jobId);
+            endStream(out);
+
+        } catch (InterruptedException ie) {
+            Thread.currentThread().interrupt();
+            sendMessage(out, "❌ Request interrupted.");
+            endStream(out);
+        } catch (Exception e) {
+            e.printStackTrace();
+            sendMessage(out, "❌ Exception: " + e.getMessage());
+            endStream(out);
+        }
+    }
+
+    // ── Helpers ───────────────────────────────────────────────────────────────
+
+    private String param(HttpServletRequest req, String name) {
+        String v = req.getParameter(name);
+        return (v != null) ? v.trim() : "";
+    }
+
+    private String param(HttpServletRequest req, String name, String defaultVal) {
+        String v = req.getParameter(name);
+        return (v != null && !v.trim().isEmpty()) ? v.trim() : defaultVal;
+    }
+
+    /** Sends a result/content line to the browser. */
+    private void sendMessage(PrintWriter out, String message) {
+        out.write("data: " + message.replace("\n", "\ndata: ") + "\n\n");
+        out.flush();
+    }
+
+    /** Sends a STATUS: prefix line — picked up by JS as a progress update. */
+    private void sendStatus(PrintWriter out, String statusMsg) {
+        out.write("data: STATUS:" + statusMsg + "\n\n");
+        out.flush();
+    }
+
+    private void endStream(PrintWriter out) {
+        out.write("data: [END]\n\n");
+        out.flush();
+    }
+}

src/main/java/servlet/ChatServlet.java

@@ -0,0 +1,51 @@
+package servlet;
+
+
+
+import javax.servlet.*;
+import javax.servlet.http.*;
+import java.io.IOException;
+import java.sql.SQLException;
+import java.util.logging.Level;
+import java.util.logging.Logger;
+import javax.servlet.annotation.WebServlet;
+
+@WebServlet(name = "/ChatServlet", urlPatterns = {"/chat"})
+public class ChatServlet extends HttpServlet {
+
+    /**
+     * Handles the HTTP GET request.
+     * Displays the login page.
+     */
+    @Override
+    protected void doGet(HttpServletRequest request, HttpServletResponse response) 
+            throws ServletException, IOException {
+        // Forward to the login JSP located in the protected WEB-INF folder
+        request.getRequestDispatcher("/WEB-INF/query_pages/think.jsp").forward(request, response);
+    }
+
+    /**
+     * Handles the HTTP POST request.
+     * Validates credentials and redirects based on user role.
+     */
+    @Override
+    protected void doPost(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
+        //String email = request.getParameter("email");
+        //String password = request.getParameter("password");
+
+       
+
+        try {
+           
+
+            
+                response.sendRedirect(request.getContextPath() + "/CrewResponseStream");
+
+
+        } catch (Exception e) {
+            e.printStackTrace();
+            request.setAttribute("error", "Database error: " + e.getMessage());
+            request.getRequestDispatcher("/WEB-INF/query_pages/think.jsp").forward(request, response);
+        } 
+    }
+}

src/main/resources/META-INF/persistence.xml

@@ -0,0 +1,7 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<persistence version="2.2" xmlns="http://xmlns.jcp.org/xml/ns/persistence" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://xmlns.jcp.org/xml/ns/persistence http://xmlns.jcp.org/xml/ns/persistence/persistence_2_2.xsd">
+    <!-- Define Persistence Unit -->
+    <persistence-unit name="my_persistence_unit">
+        
+    </persistence-unit>
+</persistence>

src/main/webapp/META-INF/context.xml

@@ -0,0 +1,2 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<Context path="/Smart_Grad_UI"/>

src/main/webapp/WEB-INF/beans.xml

@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<beans xmlns="http://xmlns.jcp.org/xml/ns/javaee"
+       xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+       xsi:schemaLocation="http://xmlns.jcp.org/xml/ns/javaee http://xmlns.jcp.org/xml/ns/javaee/beans_2_0.xsd"
+       bean-discovery-mode="all">
+</beans>

src/main/webapp/WEB-INF/query_pages/think.jsp

@@ -0,0 +1,867 @@
+<%@ page contentType="text/html;charset=UTF-8" language="java" %>
+<%
+    response.setHeader("Cache-Control", "no-cache, no-store, must-revalidate");
+    response.setHeader("Pragma", "no-cache");
+    response.setDateHeader("Expires", 0);
+    String ctxPath = request.getContextPath();
+%>
+<!DOCTYPE html>
+<html lang="en">
+<head>
+<meta charset="UTF-8"/>
+<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=no"/>
+<title>SmartGrad AI Advisor</title>
+<link rel="preconnect" href="https://fonts.googleapis.com"/>
+<link href="https://fonts.googleapis.com/css2?family=DM+Sans:ital,wght@0,400;0,500;0,600&family=Syne:wght@600;700&display=swap" rel="stylesheet"/>
+<script src="https://cdn.jsdelivr.net/npm/marked/marked.min.js"></script>
+<script src="https://cdnjs.cloudflare.com/ajax/libs/jspdf/2.5.1/jspdf.umd.min.js"></script>
+<style>
+/* ─── TOKENS ──────────────────────────────────────────── */
+:root {
+  --bg:        #0f0f13;
+  --surf:      #16161d;
+  --surf2:     #1c1c26;
+  --bdr:       #24242f;
+  --bdr2:      #2e2e3d;
+  --txt:       #e8e8f0;
+  --txt2:      #7a7a95;
+  --txt3:      #44445a;
+  --acc:       #6c47ff;
+  --acc2:      #9b7aff;
+  --acc-hi:    #b39aff;
+  --acc-glow:  rgba(108,71,255,.18);
+  --green:     #22d87a;
+  --red:       #ff6b6b;
+  --yellow:    #ffc85c;
+  --hh:        56px;   /* header height */
+  --fw:        318px;  /* form panel width desktop */
+  --fn:        'DM Sans', sans-serif;
+  --fd:        'Syne', sans-serif;
+  --drawer-ease: cubic-bezier(.32,1,.28,1);
+}
+
+/* ─── RESET ───────────────────────────────────────────── */
+*,*::before,*::after{box-sizing:border-box;margin:0;padding:0}
+html{height:100%;-webkit-text-size-adjust:100%}
+body{
+  height:100%;
+  background:var(--bg);
+  color:var(--txt);
+  font-family:var(--fn);
+  font-size:14px;
+  line-height:1.65;
+  overflow:hidden;
+}
+
+/* ─── APP SHELL ───────────────────────────────────────── */
+#app{position:fixed;inset:0;display:flex;flex-direction:column}
+
+/* ─── HEADER ──────────────────────────────────────────── */
+#hdr{
+  flex-shrink:0;
+  height:var(--hh);
+  background:#0c0c11;
+  border-bottom:1px solid var(--bdr2);
+  display:flex;align-items:center;justify-content:space-between;
+  padding:0 clamp(12px,3vw,22px);
+  gap:10px;
+  z-index:400;
+  position:relative;
+}
+.hl{display:flex;align-items:center;gap:10px;min-width:0}
+.hi{
+  width:34px;height:34px;flex-shrink:0;
+  background:linear-gradient(135deg,var(--acc),var(--acc2));
+  border-radius:9px;
+  display:flex;align-items:center;justify-content:center;
+  font-size:17px;
+  box-shadow:0 0 14px var(--acc-glow);
+}
+.ht{font-family:var(--fd);font-size:clamp(13px,2.5vw,15px);font-weight:700;color:#fff;white-space:nowrap;overflow:hidden;text-overflow:ellipsis}
+.hs{font-size:11px;color:var(--txt2);white-space:nowrap;overflow:hidden;text-overflow:ellipsis}
+.hr{display:flex;align-items:center;gap:8px;flex-shrink:0}
+
+/* quota pill */
+#qpill{
+  border:1px solid var(--bdr2);background:#16161d;
+  border-radius:20px;padding:4px 10px;
+  font-size:11px;color:var(--txt2);white-space:nowrap;
+}
+#qpill.warn{border-color:var(--yellow);color:var(--yellow)}
+#qpill.full{border-color:var(--red);color:var(--red)}
+
+.spill{
+  display:flex;align-items:center;gap:6px;
+  background:#16161d;border:1px solid var(--bdr2);
+  border-radius:20px;padding:4px 12px;
+  font-size:clamp(10px,1.8vw,12px);color:var(--txt2);white-space:nowrap;
+}
+.sdot{
+  width:7px;height:7px;border-radius:50%;
+  background:var(--green);box-shadow:0 0 6px var(--green);
+  animation:blink 2.2s infinite;
+}
+@keyframes blink{0%,100%{opacity:1}50%{opacity:.2}}
+
+/* ─── MOBILE FORM TOGGLE BAR ──────────────────────────── */
+/* Shown only on mobile; sits just below the main header  */
+#mob-toggle{
+  display:none; /* shown via media query */
+  flex-shrink:0;
+  align-items:center;justify-content:space-between;
+  background:var(--surf);
+  border-bottom:1px solid var(--bdr2);
+  padding:0 16px;
+  height:44px;
+  cursor:pointer;
+  user-select:none;
+  -webkit-tap-highlight-color:transparent;
+  transition:background .15s;
+  z-index:10;
+}
+#mob-toggle:active{background:var(--surf2)}
+.mt-left{display:flex;align-items:center;gap:8px}
+.mt-icon{
+  width:28px;height:28px;
+  background:linear-gradient(135deg,var(--acc),var(--acc2));
+  border-radius:7px;
+  display:flex;align-items:center;justify-content:center;
+  font-size:14px;flex-shrink:0;
+}
+.mt-label{font-family:var(--fd);font-size:12px;font-weight:700;color:var(--acc-hi);letter-spacing:.5px;text-transform:uppercase}
+.mt-hint{font-size:11px;color:var(--txt3)}
+.mt-arrow{
+  font-size:11px;color:var(--txt2);
+  transition:transform .3s var(--drawer-ease);
+  flex-shrink:0;
+}
+.mt-arrow.open{transform:rotate(180deg)}
+
+/* ─── PROGRESS BAR ────────────────────────────────────── */
+#pbar{display:none;flex-shrink:0;height:3px;background:var(--bdr)}
+#pfill{
+  height:100%;width:0%;
+  background:linear-gradient(90deg,var(--acc),var(--acc2));
+  transition:width .5s ease;
+}
+
+/* ─── MAIN ROW ────────────────────────────────────────── */
+#main{flex:1;display:flex;overflow:hidden;position:relative}
+
+/* ─── DESKTOP FORM PANEL ──────────────────────────────── */
+#form-panel{
+  width:var(--fw);
+  flex-shrink:0;
+  background:var(--surf);
+  border-right:1px solid var(--bdr);
+  overflow-y:auto;
+  padding:18px 14px 22px;
+  -webkit-overflow-scrolling:touch;
+}
+#form-panel::-webkit-scrollbar{width:4px}
+#form-panel::-webkit-scrollbar-thumb{background:var(--bdr2);border-radius:2px}
+
+/* ─── SHARED FORM STYLES (used in both panel & drawer) ── */
+.form-ttl{
+  font-family:var(--fd);font-size:11px;font-weight:700;
+  color:var(--acc-hi);letter-spacing:.8px;text-transform:uppercase;
+  margin-bottom:14px;
+}
+.fld{margin-bottom:10px}
+.fld label{display:block;font-size:11px;color:var(--txt2);margin-bottom:4px;font-weight:500}
+.fld input,.fld select,.fld textarea{
+  width:100%;
+  background:var(--surf2);
+  border:1px solid var(--bdr2);
+  border-radius:8px;color:var(--txt);
+  font-family:var(--fn);font-size:13px;
+  padding:8px 10px;outline:none;
+  transition:border-color .15s,box-shadow .15s;
+  -webkit-appearance:none;appearance:none;
+}
+.fld input:focus,.fld select:focus,.fld textarea:focus{
+  border-color:var(--acc);
+  box-shadow:0 0 0 3px var(--acc-glow);
+}
+.fld select{
+  background-image:url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' width='11' height='7' viewBox='0 0 11 7'%3E%3Cpath d='M1 1l4.5 4.5L10 1' stroke='%237a7a95' stroke-width='1.5' fill='none' stroke-linecap='round'/%3E%3C/svg%3E");
+  background-repeat:no-repeat;background-position:right 10px center;padding-right:28px;
+}
+.fld select option{background:var(--surf2)}
+.fld textarea{resize:vertical;min-height:52px}
+.fld input.invalid{border-color:var(--red)!important;box-shadow:0 0 0 3px rgba(255,107,107,.15)!important}
+
+.sub-btn{
+  width:100%;margin-top:8px;padding:11px;
+  background:linear-gradient(135deg,var(--acc),var(--acc2));
+  border:none;border-radius:9px;color:#fff;
+  font-family:var(--fd);font-size:13px;font-weight:700;
+  cursor:pointer;
+  transition:opacity .15s,transform .1s;
+  touch-action:manipulation;
+  box-shadow:0 4px 18px var(--acc-glow);
+}
+.sub-btn:hover:not(:disabled){opacity:.88}
+.sub-btn:active:not(:disabled){transform:scale(.97)}
+.sub-btn:disabled{opacity:.45;cursor:not-allowed;box-shadow:none}
+
+.qwarn{
+  display:none;margin-top:10px;
+  padding:10px 12px;
+  border-radius:8px;font-size:12px;line-height:1.5;text-align:center;
+}
+.qwarn.lim{background:rgba(255,107,107,.08);border:1px solid rgba(255,107,107,.3);color:#ff9999}
+.qwarn.one{background:rgba(255,200,92,.06);border:1px solid rgba(255,200,92,.3);color:var(--yellow)}
+
+/* ─── MOBILE DRAWER ───────────────────────────────────── */
+/* Slides down from just below the toggle bar             */
+#mob-drawer{
+  display:none; /* shown via media query */
+  position:fixed;
+  /* top is set by JS after layout */
+  left:0;right:0;
+  z-index:300;
+  background:var(--surf);
+  border-bottom:1px solid var(--bdr2);
+  overflow:hidden;
+  /* height transitions for smooth open/close */
+  max-height:0;
+  transition:max-height .38s var(--drawer-ease);
+  box-shadow:0 8px 32px rgba(0,0,0,.55);
+}
+#mob-drawer.open{
+  max-height:80dvh; /* clamp to 80% of viewport */
+  overflow-y:auto;
+}
+#mob-drawer::-webkit-scrollbar{width:4px}
+#mob-drawer::-webkit-scrollbar-thumb{background:var(--bdr2);border-radius:2px}
+
+#mob-drawer-inner{padding:14px 16px 20px}
+
+/* ─── CHAT PANEL ──────────────────────────────────────── */
+#chat-panel{flex:1;display:flex;flex-direction:column;overflow:hidden;min-width:0}
+#msgs-area{
+  flex:1;overflow-y:auto;overflow-x:hidden;
+  padding:clamp(16px,4vw,28px) 0 12px;
+  scroll-behavior:smooth;
+  -webkit-overflow-scrolling:touch;
+}
+#msgs-area::-webkit-scrollbar{width:5px}
+#msgs-area::-webkit-scrollbar-thumb{background:#333;border-radius:3px}
+
+.mrow{
+  max-width:min(780px,100%);
+  margin:0 auto 24px;
+  padding:0 clamp(12px,3vw,24px);
+  animation:fin .22s ease;
+}
+@keyframes fin{from{opacity:0;transform:translateY(5px)}to{opacity:1;transform:none}}
+
+.urow{display:flex;justify-content:flex-end}
+.ubub{
+  background:#1e1d2e;border:1px solid #3a3460;
+  border-radius:18px 18px 4px 18px;
+  padding:11px 16px;max-width:min(82%,520px);
+  color:var(--txt);font-size:13.5px;word-break:break-word;
+}
+.brow{display:flex;gap:12px;align-items:flex-start}
+.bav{
+  width:30px;height:30px;border-radius:50%;flex-shrink:0;
+  background:linear-gradient(135deg,var(--acc),var(--acc2));
+  display:flex;align-items:center;justify-content:center;
+  font-size:15px;margin-top:2px;
+  box-shadow:0 0 10px var(--acc-glow);
+}
+.bcon{flex:1;min-width:0}
+.bname{font-size:12px;font-weight:600;color:var(--txt2);margin-bottom:6px}
+.btxt{color:var(--txt);font-size:clamp(13px,2.2vw,14.5px);line-height:1.75}
+
+.btxt h1,.btxt h2,.btxt h3{color:#fff;margin:16px 0 7px;font-family:var(--fd)}
+.btxt h1{font-size:17px;border-bottom:1px solid var(--bdr2);padding-bottom:5px}
+.btxt h2{font-size:15px}
+.btxt h3{font-size:13.5px;color:var(--acc-hi)}
+.btxt p{margin-bottom:9px}
+.btxt ul,.btxt ol{padding-left:20px;margin-bottom:9px}
+.btxt li{margin-bottom:4px}
+.btxt strong{color:#c8c0ff;font-weight:600}
+.btxt code{background:#222233;border:1px solid var(--bdr2);border-radius:4px;padding:1px 6px;font-family:'Courier New',monospace;font-size:12px;color:var(--acc-hi)}
+.btxt pre{background:#1a1a2a;border:1px solid var(--bdr2);border-radius:8px;padding:13px;overflow-x:auto;margin:9px 0}
+.btxt pre code{background:none;border:none;padding:0}
+.btxt table{width:100%;border-collapse:collapse;margin:9px 0;font-size:13px;display:block;overflow-x:auto}
+.btxt th{background:#1e1a3a;color:var(--acc-hi);font-weight:600;padding:8px 11px;border:1px solid var(--bdr2);white-space:nowrap}
+.btxt td{padding:7px 11px;border:1px solid var(--bdr2);vertical-align:top}
+.btxt tr:nth-child(even) td{background:rgba(255,255,255,.025)}
+.btxt blockquote{border-left:3px solid var(--acc-hi);padding-left:13px;color:#aaa;margin:9px 0}
+
+.tdots{display:flex;gap:5px;align-items:center;padding:4px 0}
+.tdots span{width:8px;height:8px;border-radius:50%;background:var(--txt3);animation:tb 1.3s infinite ease-in-out}
+.tdots span:nth-child(2){animation-delay:.2s}
+.tdots span:nth-child(3){animation-delay:.4s}
+@keyframes tb{0%,80%,100%{transform:translateY(0);background:var(--txt3)}40%{transform:translateY(-6px);background:var(--acc-hi)}}
+
+#spin{
+  display:none;flex-shrink:0;
+  justify-content:center;align-items:center;gap:8px;
+  padding:7px;font-size:12px;color:var(--txt2);
+}
+.sring{
+  width:15px;height:15px;
+  border:2px solid var(--bdr2);border-top-color:var(--acc-hi);
+  border-radius:50%;animation:sr .7s linear infinite;flex-shrink:0;
+}
+@keyframes sr{to{transform:rotate(360deg)}}
+
+#sbar{
+  display:none;flex-shrink:0;
+  padding:5px clamp(12px,3vw,20px);
+  background:var(--surf);border-top:1px solid var(--bdr);
+  font-size:11px;color:var(--txt2);
+}
+
+.macts{display:flex;gap:4px;margin-top:8px}
+.abtn,.pbtn{
+  display:inline-flex;align-items:center;justify-content:center;
+  width:30px;height:30px;border-radius:6px;
+  border:1px solid #2e2e3d;background:transparent;
+  color:#555;cursor:pointer;
+  transition:border-color .15s,color .15s,background .15s;
+  padding:0;touch-action:manipulation;
+}
+.abtn:hover{border-color:var(--acc-hi);color:var(--acc-hi);background:var(--acc-glow)}
+.abtn.copied{border-color:var(--green);color:var(--green)}
+.pbtn{border-color:#1e2e24;color:#3a6a4a}
+.pbtn:hover{border-color:var(--green);color:var(--green);background:rgba(34,216,122,.08)}
+
+#welcome{
+  max-width:min(540px,100%);
+  margin:clamp(18px,5vw,52px) auto;
+  padding:0 clamp(14px,4vw,24px);
+  text-align:center;
+}
+#welcome .wi{font-size:clamp(32px,7vw,48px);margin-bottom:14px}
+#welcome h2{font-family:var(--fd);font-size:clamp(15px,3.5vw,21px);font-weight:700;color:#fff;margin-bottom:10px}
+#welcome p{font-size:clamp(12px,2.2vw,14px);color:var(--txt2);line-height:1.75}
+
+#disc{
+  flex-shrink:0;text-align:center;
+  font-size:clamp(9px,1.6vw,11px);color:var(--txt3);
+  padding:4px clamp(8px,3vw,16px) clamp(5px,1.5vw,8px);
+}
+
+/* ─── RESPONSIVE ──────────────────────────────────────── */
+
+/* MOBILE ≤ 820px */
+@media(max-width:820px){
+  /* Show toggle bar and drawer */
+  #mob-toggle{display:flex}
+  #mob-drawer{display:block}
+
+  /* Hide desktop sidebar */
+  #form-panel{display:none!important}
+
+  /* Main only contains chat */
+  #main{flex-direction:column}
+  #chat-panel{flex:1;min-height:0}
+
+  .mrow{padding:0 13px}
+
+  /* Bigger tap targets & no iOS zoom */
+  .fld input,.fld select,.fld textarea{font-size:16px;padding:10px}
+  .sub-btn{padding:13px}
+  .abtn,.pbtn{width:36px;height:36px}
+}
+
+/* Very small phones */
+@media(max-width:380px){
+  .hs{display:none}
+  #qpill{padding:3px 8px;font-size:10px}
+}
+
+/* Landscape small */
+@media(max-height:480px) and (max-width:820px){
+  #mob-drawer.open{max-height:96dvh}
+  #welcome .wi{display:none}
+}
+
+/* Large desktops */
+@media(min-width:1360px){
+  :root{--fw:350px}
+  .mrow{max-width:860px}
+}
+</style>
+</head>
+<body>
+
+<!-- ── SVG sprite ─��� -->
+<svg style="display:none">
+  <symbol id="ic-copy" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2">
+    <rect x="9" y="9" width="13" height="13" rx="2"/>
+    <path d="M5 15H4a2 2 0 01-2-2V4a2 2 0 012-2h9a2 2 0 012 2v1"/>
+  </symbol>
+  <symbol id="ic-check" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2.5">
+    <polyline points="20 6 9 17 4 12"/>
+  </symbol>
+  <symbol id="ic-dl" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2">
+    <path d="M21 15v4a2 2 0 01-2 2H5a2 2 0 01-2-2v-4"/>
+    <polyline points="7 10 12 15 17 10"/>
+    <line x1="12" y1="15" x2="12" y2="3"/>
+  </symbol>
+</svg>
+
+<div id="app">
+
+  <!-- ── HEADER ── -->
+  <div id="hdr">
+    <div class="hl">
+      <div class="hi">🎓</div>
+      <div style="min-width:0">
+        <div class="ht">SmartGrad AI Advisor</div>
+        <div class="hs">Multi-agent university guidance</div>
+      </div>
+    </div>
+    <div class="hr">
+      <div id="qpill">2 / 2 today</div>
+      <div class="spill"><div class="sdot"></div><span>Connected</span></div>
+    </div>
+  </div>
+
+  <!-- ── MOBILE TOGGLE BAR (tap to open/close drawer) ── -->
+  <div id="mob-toggle" onclick="toggleDrawer()" role="button" aria-expanded="false" aria-controls="mob-drawer">
+    <div class="mt-left">
+      <div class="mt-icon">✏️</div>
+      <div>
+        <div class="mt-label">Student Profile</div>
+        <div class="mt-hint" id="mt-hint">Tap to fill in your details</div>
+      </div>
+    </div>
+    <span class="mt-arrow" id="mt-arrow">▼</span>
+  </div>
+
+  <!-- ── MOBILE DRAWER (slide-down) ── -->
+  <div id="mob-drawer" role="region" aria-label="Student profile form">
+    <div id="mob-drawer-inner">
+      <div class="form-ttl">🎓 Your Details</div>
+      <!-- Fields injected here by JS -->
+    </div>
+  </div>
+
+  <!-- ── PROGRESS BAR ── -->
+  <div id="pbar"><div id="pfill"></div></div>
+
+  <!-- ── MAIN ── -->
+  <div id="main">
+
+    <!-- Desktop sidebar form (always visible ≥821px) -->
+    <div id="form-panel">
+      <div class="form-ttl">🎓 Student Profile</div>
+      <!-- Fields injected here by JS -->
+    </div>
+
+    <!-- Chat -->
+    <div id="chat-panel">
+      <div id="msgs-area">
+        <div id="welcome">
+          <div class="wi">🎓</div>
+          <h2>Welcome to SmartGrad</h2>
+          <p>
+            Fill in your student profile and click <strong>"Get Recommendations"</strong>.<br/><br/>
+            Our AI agents will research programmes, scholarships, visa requirements, and financial planning — then write a personalised advisory letter just for you.<br/><br/>
+            <span style="color:var(--yellow);font-size:12px">⚠ You have <strong id="q-remain">2</strong> free queries today.</span>
+          </p>
+        </div>
+        <div id="msgs"></div>
+      </div>
+      <div id="spin"><div class="sring"></div><span id="spin-lbl">Agents are working…</span></div>
+      <div id="sbar"><span id="stxt">⏳ Processing…</span></div>
+      <div id="disc">AI can make mistakes — verify with official university sources &nbsp;|&nbsp; 2 queries/day &nbsp;|&nbsp; Developed by Gacirane Patrick © 2026</div>
+    </div>
+
+  </div><!-- /#main -->
+</div><!-- /#app -->
+
+<script>
+(function(){
+'use strict';
+
+/* ═══════════════════════════════════════════════════
+   FIELD DEFINITIONS  — single source of truth
+═══════════════════════════════════════════════════ */
+var FIELDS = [
+  {id:'student_name',        label:'Student Name *',           type:'text',     ph:'e.g. Jane Uwase',                     ac:'name'},
+  {id:'lower_level',         label:'Current Education Level',  type:'select',   opts:[['high school','High School'],['college','College / Diploma'],['undergraduate','Undergraduate']]},
+  {id:'higher_level',        label:'Desired Level *',          type:'select',   opts:[['undergraduate','Undergraduate'],['masters','Masters'],['phd','PhD'],['diploma','Diploma / Certificate']]},
+  {id:'grade',               label:'Grade / Score *',          type:'text',     ph:'e.g. A (distinction, 87%)'},
+  {id:'major',               label:'Major / Field of Study *', type:'text',     ph:'e.g. Sciences (Math, Physics)'},
+  {id:'subjects',            label:'Subjects Studied *',       type:'textarea', ph:'e.g. Mathematics, Physics, Chemistry'},
+  {id:'program',             label:'Desired Program *',        type:'text',     ph:'e.g. Computer Science / AI'},
+  {id:'country',             label:'Home Country *',           type:'text',     ph:'e.g. Rwanda',                         ac:'country-name'},
+  {id:'destination_country', label:'Destination Country *',    type:'text',     ph:'e.g. Canada'},
+  {id:'state',               label:'Province / State *',       type:'text',     ph:'e.g. Ontario'}
+];
+var REQUIRED = ['student_name','grade','major','subjects','program','country','destination_country','state'];
+
+/* Build fields HTML for a container, using an id prefix */
+function buildFields(prefix){
+  return FIELDS.map(function(f){
+    var id = prefix+f.id;
+    var ctrl = '';
+    if(f.type==='select'){
+      ctrl = '<select id="'+id+'">'
+        + f.opts.map(function(o){return '<option value="'+o[0]+'">'+o[1]+'</option>';}).join('')
+        + '</select>';
+    } else if(f.type==='textarea'){
+      ctrl = '<textarea id="'+id+'" rows="2" placeholder="'+f.ph+'"></textarea>';
+    } else {
+      ctrl = '<input type="text" id="'+id+'" placeholder="'+f.ph+'"'+(f.ac?' autocomplete="'+f.ac+'"':'')+'/>';
+    }
+    return '<div class="fld"><label for="'+id+'">'+f.label+'</label>'+ctrl+'</div>';
+  }).join('');
+}
+
+/* Inject fields into containers */
+var desktopPanel  = document.getElementById('form-panel');
+var drawerInner   = document.getElementById('mob-drawer-inner');
+
+/* Desktop: append fields + submit btn + quota warn */
+desktopPanel.insertAdjacentHTML('beforeend',
+  buildFields('d-')
+  +'<button class="sub-btn" id="d-sub" onclick="doSubmit()">🚀 Get Recommendations</button>'
+  +'<div class="qwarn" id="d-qwarn"></div>'
+);
+
+/* Mobile drawer: append fields + submit btn + quota warn */
+drawerInner.insertAdjacentHTML('beforeend',
+  buildFields('m-')
+  +'<button class="sub-btn" id="m-sub" onclick="doSubmit()">🚀 Get Recommendations</button>'
+  +'<div class="qwarn" id="m-qwarn"></div>'
+);
+
+/* ═══════════════════════════════════════════════════
+   QUOTA  (localStorage, resets daily)
+═══════════════════════════════════════════════════ */
+var QKEY  = 'sg_q';
+var QLIM  = 2;
+
+function today(){ var d=new Date(); return d.getFullYear()+'-'+(d.getMonth()+1)+'-'+d.getDate(); }
+function getQ(){
+  try{ var r=localStorage.getItem(QKEY); if(r){var o=JSON.parse(r);if(o.d===today())return o.c;} }catch(e){}
+  return 0;
+}
+function incQ(){ try{ localStorage.setItem(QKEY,JSON.stringify({d:today(),c:getQ()+1})); }catch(e){} }
+function rem(){ return Math.max(0,QLIM-getQ()); }
+
+function refreshQuotaUI(){
+  var r  = rem();
+  var pill = document.getElementById('qpill');
+  var qr   = document.getElementById('q-remain');
+  if(pill){ pill.textContent=r+' / '+QLIM+' today'; pill.className=r===0?'full':r===1?'warn':''; }
+  if(qr) qr.textContent=r;
+
+  ['d','m'].forEach(function(p){
+    var w  = document.getElementById(p+'-qwarn');
+    var b  = document.getElementById(p+'-sub');
+    if(!w||!b) return;
+    if(r===0){
+      w.className='qwarn lim'; w.style.display='block';
+      w.innerHTML='🚫 Daily limit reached.<br>Come back tomorrow.';
+      b.disabled=true;
+    } else if(r===1){
+      w.className='qwarn one'; w.style.display='block';
+      w.innerHTML='⚠ Last query remaining today.';
+      b.disabled=false;
+    } else {
+      w.style.display='none'; b.disabled=false;
+    }
+  });
+}
+
+/* ═══════════════════════════════════════════════════
+   MOBILE DRAWER LOGIC
+═══════════════════════════════════════════════════ */
+var drawer    = document.getElementById('mob-drawer');
+var toggle    = document.getElementById('mob-toggle');
+var mtArrow   = document.getElementById('mt-arrow');
+var mtHint    = document.getElementById('mt-hint');
+var isOpen    = false;
+
+function openDrawer(){
+  isOpen = true;
+  drawer.classList.add('open');
+  mtArrow.classList.add('open');
+  toggle.setAttribute('aria-expanded','true');
+  mtHint.textContent = 'Tap to collapse';
+  /* Sync desktop → mobile values so user doesn't lose data */
+  syncFields('d-','m-');
+}
+
+function closeDrawer(){
+  isOpen = false;
+  drawer.classList.remove('open');
+  mtArrow.classList.remove('open');
+  toggle.setAttribute('aria-expanded','false');
+  /* Update hint: show summary if fields are filled */
+  var name = fieldVal('student_name');
+  var prog = fieldVal('program');
+  mtHint.textContent = (name && prog)
+    ? '✓ '+name+' · '+prog+' — tap to edit'
+    : 'Tap to fill in your details';
+}
+
+window.toggleDrawer = function(){
+  if(isOpen) closeDrawer(); else openDrawer();
+};
+
+/* Touch: swipe up on drawer header collapses it */
+var ty0 = 0;
+toggle.addEventListener('touchstart',function(e){ty0=e.touches[0].clientY;},{passive:true});
+toggle.addEventListener('touchend',function(e){
+  if(isOpen && (ty0 - e.changedTouches[0].clientY) > 40){ closeDrawer(); e.preventDefault(); }
+},{passive:false});
+
+/* ═══════════════════════════════════════════════════
+   FIELD VALUE HELPERS
+════════════��══════════════════════════════════════ */
+function isMob(){ return window.matchMedia('(max-width:820px)').matches; }
+
+/* Get value from whichever context is active */
+function fieldVal(name){
+  var p = isMob() ? 'm-' : 'd-';
+  var el = document.getElementById(p+name);
+  return el ? el.value.trim() : '';
+}
+
+/* Copy all field values from one prefix to another */
+function syncFields(from, to){
+  FIELDS.forEach(function(f){
+    var s=document.getElementById(from+f.id);
+    var d=document.getElementById(to+f.id);
+    if(s&&d) d.value=s.value;
+  });
+}
+
+/* ═══════════════════════════════════════════════════
+   VALIDATION
+═══════════════════════════════════════════════════ */
+function validate(){
+  var p = isMob() ? 'm-' : 'd-';
+  var ok=true;
+  REQUIRED.forEach(function(name){
+    var el=document.getElementById(p+name);
+    if(!el||!el.value.trim()){
+      el.classList.add('invalid');
+      if(ok){ el.focus(); ok=false; }
+      el.addEventListener('input',function h(){ el.classList.remove('invalid'); el.removeEventListener('input',h); });
+    } else {
+      el.classList.remove('invalid');
+    }
+  });
+  /* On mobile, open drawer so errors are visible */
+  if(!ok && isMob() && !isOpen) openDrawer();
+  return ok;
+}
+
+/* ═══════════════════════════════════════════════════
+   SUBMIT
+═══════════════════════════════════════════════════ */
+var CTX   = '<%= ctxPath %>';
+var msgs  = document.getElementById('msgs');
+var spin  = document.getElementById('spin');
+var slbl  = document.getElementById('spin-lbl');
+var sbar  = document.getElementById('sbar');
+var stxt  = document.getElementById('stxt');
+var pbar  = document.getElementById('pbar');
+var pfill = document.getElementById('pfill');
+var evSrc = null;
+
+window.doSubmit = function(){
+  if(rem()<=0){
+    alert('You have reached your daily limit of '+QLIM+' queries. Please come back tomorrow.');
+    return;
+  }
+  if(!validate()) return;
+
+  /* Sync fields between panels before reading values */
+  if(isMob()) syncFields('m-','d-'); else syncFields('d-','m-');
+
+  /* ── Auto-collapse drawer after submit ── */
+  if(isMob()) closeDrawer();
+
+  /* Hide welcome screen */
+  var wel=document.getElementById('welcome');
+  if(wel) wel.style.display='none';
+
+  /* User bubble summary */
+  var name = fieldVal('student_name');
+  var prog = fieldVal('program');
+  var dest = fieldVal('destination_country');
+  addUserBubble('🎓 '+name+' — '+prog+' in '+dest);
+  var botTxt = addBotBubble();
+
+  /* Record quota use BEFORE request (prevents refresh bypass) */
+  incQ();
+  refreshQuotaUI();
+
+  /* Disable both submit buttons while processing */
+  setSubmitBtns(true);
+
+  /* Show progress indicators */
+  spin.style.display  = 'flex';
+  slbl.textContent    = 'Connecting to advisory system…';
+  pbar.style.display  = 'block';
+  pfill.style.width   = '5%';
+  sbar.style.display  = 'block';
+  stxt.textContent    = '⏳ Submitting your profile…';
+  scrollDown();
+
+  if(evSrc) evSrc.close();
+
+  var p = new URLSearchParams({
+    student_name:        fieldVal('student_name'),
+    lower_level:         fieldVal('lower_level'),
+    higher_level:        fieldVal('higher_level'),
+    grade:               fieldVal('grade'),
+    major:               fieldVal('major'),
+    subjects:            fieldVal('subjects'),
+    program:             fieldVal('program'),
+    country:             fieldVal('country'),
+    destination_country: fieldVal('destination_country'),
+    state:               fieldVal('state'),
+    agent_name:          'SmartGrad AI Advisor',
+    institution:         'SmartGrad Education Services'
+  });
+
+  evSrc = new EventSource(CTX+'/CrewResponseStream?'+p.toString());
+  var first=true, buf='', pct=10;
+
+  evSrc.onmessage = function(e){
+    var data = e.data;
+    if(data.trim()==='[END]'){
+      evSrc.close();
+      spin.style.display='none'; pbar.style.display='none'; sbar.style.display='none';
+      pfill.style.width='100%';
+      if(rem()>0) setSubmitBtns(false);
+      if(buf){ botTxt.innerHTML=marked.parse(buf); addActions(botTxt.parentElement,buf); }
+      scrollDown(); return;
+    }
+    if(data.startsWith('STATUS:')){
+      var m=data.substring(7).trim();
+      stxt.textContent='⏳ '+m; slbl.textContent=m;
+      pct=Math.min(pct+10,90); pfill.style.width=pct+'%'; return;
+    }
+    var tr=data.trim();
+    if(tr.startsWith('⏳')||tr.startsWith('🔄')||(tr.startsWith('✅')&&data.length<60)) return;
+    if(first){botTxt.innerHTML='';first=false;}
+    buf+='\n'+data;
+    botTxt.innerHTML=data.length>200?marked.parse(buf):botTxt.innerHTML+marked.parse(data);
+    scrollDown();
+  };
+
+  evSrc.onerror=function(){
+    spin.style.display='none'; pbar.style.display='none'; sbar.style.display='none';
+    if(rem()>0) setSubmitBtns(false);
+    botTxt.innerHTML='<span style="color:var(--red)">⚠ Connection error. Please try again.</span>';
+    evSrc.close(); scrollDown();
+  };
+};
+
+function setSubmitBtns(disabled){
+  var ds=document.getElementById('d-sub');
+  var ms=document.getElementById('m-sub');
+  if(ds) ds.disabled=disabled;
+  if(ms) ms.disabled=disabled;
+}
+
+/* ═══════════════════════════════════════════════════
+   DOM / CHAT HELPERS
+═══════════════════════════════════════════════════ */
+function addUserBubble(text){
+  var row=document.createElement('div'); row.className='mrow';
+  row.innerHTML='<div class="urow"><div class="ubub"></div></div>';
+  row.querySelector('.ubub').textContent=text;
+  msgs.appendChild(row);
+}
+
+function addBotBubble(){
+  var row=document.createElement('div'); row.className='mrow';
+  row.innerHTML=
+    '<div class="brow">'
+    +'<div class="bav">🎓</div>'
+    +'<div class="bcon">'
+    +'<div class="bname">SmartGrad Advisor &nbsp;<span style="font-size:11px;color:var(--txt3)">'+fmtT()+'</span></div>'
+    +'<div class="btxt"><div class="tdots"><span></span><span></span><span></span></div></div>'
+    +'</div></div>';
+  msgs.appendChild(row);
+  return row.querySelector('.btxt');
+}
+
+function addActions(container, md){
+  var bar=document.createElement('div'); bar.className='macts';
+  var cp=document.createElement('button');
+  cp.className='abtn'; cp.setAttribute('aria-label','Copy');
+  cp.innerHTML=svg('ic-copy',14);
+  cp.onclick=function(){
+    navigator.clipboard.writeText(md).then(function(){
+      cp.innerHTML=svg('ic-check',14); cp.classList.add('copied');
+      setTimeout(function(){cp.innerHTML=svg('ic-copy',14);cp.classList.remove('copied');},2000);
+    });
+  };
+  bar.appendChild(cp);
+  if(md.length>300){
+    var pd=document.createElement('button');
+    pd.className='pbtn'; pd.setAttribute('aria-label','Download PDF');
+    pd.innerHTML=svg('ic-dl',14);
+    pd.onclick=function(){makePdf(md);};
+    bar.appendChild(pd);
+  }
+  var bc=container.querySelector('.bcon')||container;
+  bc.appendChild(bar);
+}
+
+function scrollDown(){
+  requestAnimationFrame(function(){
+    var a=document.getElementById('msgs-area');
+    a.scrollTop=a.scrollHeight;
+  });
+}
+function fmtT(){ return new Date().toLocaleTimeString([],{hour:'2-digit',minute:'2-digit'}); }
+function svg(id,sz){ return '<svg width="'+sz+'" height="'+sz+'" aria-hidden="true"><use href="#'+id+'"/></svg>'; }
+
+/* ═══════════════════════════════════════════════════
+   PDF EXPORT
+═══════════════════════════════════════════════════ */
+function makePdf(md){
+  var J=window.jspdf?window.jspdf.jsPDF:null;
+  if(!J){alert('jsPDF not loaded');return;}
+  var doc=new J(), lines=md.split('\n');
+  var mX=15,mT=28,mB=22,pH=doc.internal.pageSize.height,y=mT,pg=1;
+  var now=new Date().toLocaleString();
+  function hdr(){
+    doc.setFont('Helvetica','bold');doc.setFontSize(13);doc.setTextColor(80,20,160);
+    doc.text('SmartGrad — University Advisory Report',mX,12);
+    doc.setDrawColor(80,20,160);doc.line(mX,15,195,15);
+    doc.setFont('Helvetica','normal');doc.setFontSize(9);doc.setTextColor(120);
+    doc.text('Confidential · Generated by SmartGrad AI Advisor · '+now,mX,21);
+  }
+  function ftr(){
+    doc.setFont('Helvetica','normal');doc.setFontSize(9);doc.setTextColor(130);
+    doc.line(mX,pH-14,195,pH-14);
+    doc.text('Page '+pg+' | SmartGrad Education Services | '+now,mX,pH-8);
+  }
+  function wln(t){
+    doc.splitTextToSize(t,180).forEach(function(ln){
+      if(y>pH-mB-10){ftr();doc.addPage();pg++;hdr();y=mT;}
+      doc.setFont('Helvetica','normal');doc.setFontSize(10.5);doc.setTextColor(30);
+      doc.text(ln,mX,y);y+=6.5;
+    });y+=2;
+  }
+  hdr();lines.forEach(wln);ftr();
+  doc.save('SmartGrad_Advisory_'+Date.now()+'.pdf');
+}
+
+/* ── Init ── */
+refreshQuotaUI();
+
+})();
+</script>
+</body>
+</html>

src/main/webapp/WEB-INF/web.xml

@@ -0,0 +1,11 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<web-app xmlns="http://xmlns.jcp.org/xml/ns/javaee"
+   xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+   xsi:schemaLocation="http://xmlns.jcp.org/xml/ns/javaee http://xmlns.jcp.org/xml/ns/javaee/web-app_4_0.xsd"
+   version="4.0">
+    <session-config>
+        <session-timeout>
+            30
+        </session-timeout>
+    </session-config>
+</web-app>

src/main/webapp/index.html

@@ -0,0 +1,10 @@
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Start Page</title>
+        <meta http-equiv="refresh" content="0; URL='chat'" />
+    </head>
+    <body>
+        <h1>Welcome to Smart Grad!</h1>
+    </body>
+</html>