Upload 5 files

.gitattributes

@@ -1,35 +1,35 @@
-*.7z filter=lfs diff=lfs merge=lfs -text
-*.arrow filter=lfs diff=lfs merge=lfs -text
-*.bin filter=lfs diff=lfs merge=lfs -text
-*.bz2 filter=lfs diff=lfs merge=lfs -text
-*.ckpt filter=lfs diff=lfs merge=lfs -text
-*.ftz filter=lfs diff=lfs merge=lfs -text
-*.gz filter=lfs diff=lfs merge=lfs -text
-*.h5 filter=lfs diff=lfs merge=lfs -text
-*.joblib filter=lfs diff=lfs merge=lfs -text
-*.lfs.* filter=lfs diff=lfs merge=lfs -text
-*.mlmodel filter=lfs diff=lfs merge=lfs -text
-*.model filter=lfs diff=lfs merge=lfs -text
-*.msgpack filter=lfs diff=lfs merge=lfs -text
-*.npy filter=lfs diff=lfs merge=lfs -text
-*.npz filter=lfs diff=lfs merge=lfs -text
-*.onnx filter=lfs diff=lfs merge=lfs -text
-*.ot filter=lfs diff=lfs merge=lfs -text
-*.parquet filter=lfs diff=lfs merge=lfs -text
-*.pb filter=lfs diff=lfs merge=lfs -text
-*.pickle filter=lfs diff=lfs merge=lfs -text
-*.pkl filter=lfs diff=lfs merge=lfs -text
-*.pt filter=lfs diff=lfs merge=lfs -text
-*.pth filter=lfs diff=lfs merge=lfs -text
-*.rar filter=lfs diff=lfs merge=lfs -text
-*.safetensors filter=lfs diff=lfs merge=lfs -text
-saved_model/**/* filter=lfs diff=lfs merge=lfs -text
-*.tar.* filter=lfs diff=lfs merge=lfs -text
-*.tar filter=lfs diff=lfs merge=lfs -text
-*.tflite filter=lfs diff=lfs merge=lfs -text
-*.tgz filter=lfs diff=lfs merge=lfs -text
-*.wasm filter=lfs diff=lfs merge=lfs -text
-*.xz filter=lfs diff=lfs merge=lfs -text
-*.zip filter=lfs diff=lfs merge=lfs -text
-*.zst filter=lfs diff=lfs merge=lfs -text
-*tfevents* filter=lfs diff=lfs merge=lfs -text
+*.7z filter=lfs diff=lfs merge=lfs -text
+*.arrow filter=lfs diff=lfs merge=lfs -text
+*.bin filter=lfs diff=lfs merge=lfs -text
+*.bz2 filter=lfs diff=lfs merge=lfs -text
+*.ckpt filter=lfs diff=lfs merge=lfs -text
+*.ftz filter=lfs diff=lfs merge=lfs -text
+*.gz filter=lfs diff=lfs merge=lfs -text
+*.h5 filter=lfs diff=lfs merge=lfs -text
+*.joblib filter=lfs diff=lfs merge=lfs -text
+*.lfs.* filter=lfs diff=lfs merge=lfs -text
+*.mlmodel filter=lfs diff=lfs merge=lfs -text
+*.model filter=lfs diff=lfs merge=lfs -text
+*.msgpack filter=lfs diff=lfs merge=lfs -text
+*.npy filter=lfs diff=lfs merge=lfs -text
+*.npz filter=lfs diff=lfs merge=lfs -text
+*.onnx filter=lfs diff=lfs merge=lfs -text
+*.ot filter=lfs diff=lfs merge=lfs -text
+*.parquet filter=lfs diff=lfs merge=lfs -text
+*.pb filter=lfs diff=lfs merge=lfs -text
+*.pickle filter=lfs diff=lfs merge=lfs -text
+*.pkl filter=lfs diff=lfs merge=lfs -text
+*.pt filter=lfs diff=lfs merge=lfs -text
+*.pth filter=lfs diff=lfs merge=lfs -text
+*.rar filter=lfs diff=lfs merge=lfs -text
+*.safetensors filter=lfs diff=lfs merge=lfs -text
+saved_model/**/* filter=lfs diff=lfs merge=lfs -text
+*.tar.* filter=lfs diff=lfs merge=lfs -text
+*.tar filter=lfs diff=lfs merge=lfs -text
+*.tflite filter=lfs diff=lfs merge=lfs -text
+*.tgz filter=lfs diff=lfs merge=lfs -text
+*.wasm filter=lfs diff=lfs merge=lfs -text
+*.xz filter=lfs diff=lfs merge=lfs -text
+*.zip filter=lfs diff=lfs merge=lfs -text
+*.zst filter=lfs diff=lfs merge=lfs -text
+*tfevents* filter=lfs diff=lfs merge=lfs -text

Dockerfile

@@ -1,11 +1,11 @@
-FROM python:3.9-slim
-
-WORKDIR /app
-
-COPY requirements.txt .
-RUN pip install --no-cache-dir -r requirements.txt
-
-COPY . .
-
-# HF Spaces requires port 7860
-CMD ["uvicorn", "app:app", "--host", "0.0.0.0", "--port", "7860"]
+FROM python:3.9-slim
+
+WORKDIR /app
+
+COPY requirements.txt .
+RUN pip install --no-cache-dir -r requirements.txt
+
+COPY . .
+
+# HF Spaces requires port 7860
+CMD ["uvicorn", "app:app", "--host", "0.0.0.0", "--port", "7860"]

README.md

@@ -43,3 +43,40 @@ Set these in the Space **Settings → Variables and Secrets**:
 ## Version
 
 **v3.7** — Navigation-first agentic AI. See GitHub for changelog.
+
+## Architecture (v3.8)
+
+The pipeline is split by stage under `src/agentcore/` - each module's docstring
+explains its role:
+
+| Module | Role |
+|---|---|
+| `models.py` | Pydantic I/O contracts |
+| `constants.py` | Regexes, URLs, prompts (no logic) |
+| `utils.py` | Shared helpers, LLM factory, query/URL builders |
+| `classify.py` | Rule pre-classifier + LLM intent classifier |
+| `libcal.py` | Live hours/events via Cloudflare Worker proxy |
+| `scholarly.py` | OpenAlex, Semantic Scholar, Crossref, Unpaywall clients |
+| `rendering.py` | HTML fragments (badges, trace blocks, AI-tools footer) |
+| `intents_library.py` | library_info handlers |
+| `intents_search.py` | search_academic / search_medical machinery |
+| `intents_general.py` | general / social handlers |
+| `orchestrator.py` | Injection gate, routing pipeline, analytics logging |
+
+`src/api/agent.py` is a thin router. Tests: `pytest tests/ -q` (20 tests, no
+API keys required).
+
+## Environment variables (new in v3.8)
+
+| Variable | Purpose |
+|---|---|
+| `CLOUDFLARE_WORKER_TOKEN` | Bearer token for the Worker analytics surface; must equal the Worker's `ANALYTICS_TOKEN` secret |
+| `CONTACT_EMAIL` | Polite-pool contact sent to OpenAlex / Unpaywall / Crossref (default `library@ku.ac.ae`) |
+
+## Privacy
+
+Before any query reaches metrics or the D1 analytics store it passes
+`_redact_for_analytics`: e-mail addresses and digit runs of 6+ are masked and
+text is truncated to 200 characters. Answer excerpts logged for the daily
+relevance agent get the same treatment. The Worker applies the identical
+redaction server-side as defence in depth.

app.py

@@ -26,7 +26,7 @@ try:
 except ImportError:
     _ttl_cache_available = False
 
-from src.config import get_settings
+from src.config import get_settings, LIBBEE_VERSION
 from src.services.cache_service import CacheService
 from src.services.metrics_service import MetricsService
 from src.services.rag_service import RAGService
@@ -124,7 +124,7 @@ async def lifespan(app: FastAPI):
 app = FastAPI(
     title="LibBee - KU Library AI",
     description="Khalifa University Library AI Assistant",
-    version="3.5.0",
+    version=LIBBEE_VERSION,
     lifespan=lifespan,
 )
 
@@ -261,7 +261,7 @@ def health_check():
     settings = get_settings()
     return {
         "status": "ok",
-        "version": "3.5.0",
+        "version": LIBBEE_VERSION,
         "service": "LibBee KU Library AI",
         "rag_ready": rag_service.is_ready(),
         "maintenance_mode": settings.maintenance_mode,

requirements.txt

@@ -11,10 +11,6 @@ anthropic>=0.34.0
 faiss-cpu>=1.7.4
 rank-bm25>=0.2.2
 httpx>=0.25.0
-slowapi>=0.1.9
-bcrypt>=4.1.2
-passlib>=1.7.4
-python-jose[cryptography]>=3.3.0
 numpy>=1.26.0
 openai>=1.40.0
 cachetools>=5.3.0