# Quietbox website

Live demo: https://quietbox-2x6.pages.dev/

Cloudflare Pages is the preferred host. See `docs/CLOUDFLARE-PAGES.md` in the
project for free deployment and update instructions. The build creates
`artifacts/website/Quietbox-Cloudflare-Pages.zip` with deployment files at its root.
The included `_headers` file applies the security policy on Cloudflare Pages.
No credit card, hosted backend, or deployment secret is required for direct upload.

GitHub Pages: the included `.github/workflows/website-pages.yml` publishes only `website/`. The repository owner must enable **Settings → Pages → Source: GitHub Actions**, then run **Actions → Deploy Quietbox website → Run workflow**. Run the workflow again after future website updates. The deployment summary supplies the verified URL; until this is enabled, the conventional target `https://mattwallace-hub.github.io/support-resolution-agent/` is not a confirmed live link. Private-repository Pages requires a supporting GitHub plan. No OpenRouter key belongs in GitHub Secrets or source code for this browser-only design.

Extract the ZIP. In this folder, run `python -m http.server 8000`, then open http://localhost:8000 in a current desktop browser. Or deploy this entire folder to an HTTPS static host. No build step or backend is needed. Opening `index.html` as a file does not work because browsers restrict workers and fetch on file URLs.

Start in **Offline** mode, choose a Routine case, and click **Run Quietbox**. Stress-test and Custom cases are also available. Offline uses the notebook's FakeLLM and makes no model calls. For a paid run, select Live, enter an OpenRouter key, and choose a model. Review the result and execution trace. Download run evidence or mark it reviewed. The customer directory links the same synthetic orders to their customer, and authorized session runs appear in that customer's support history.

The agent is the **unchanged Python implementation** from `src/`, packaged into `runtime.json` by `python scripts/package_website.py`. Python executes through pinned Pyodide 0.27.7 in a dedicated Web Worker; `requests==2.32.3` is loaded through micropip. First load requires internet for the interpreter, dependencies, and optional Google Fonts. The website is not a fully disconnected demo. Model calls use a browser-specific XMLHttpRequest transport directly to OpenRouter. Browsers control redirects; the notebook's Python HTTP transport remains the stricter transport. The fixed HTTPS endpoint and browser same-origin/credential protections apply. No application server receives the key.

Keys stay in tab/worker memory and are never intentionally saved to local storage, URLs, logs, or evidence exports. Clear removes the key field; reload closes the worker. Only the theme preference is stored locally. Customer records are explicitly fictional and publicly visible in the demo operator directory. Simulated authorization is part of the demonstration, not a real customer login. Do not enter real customer data or treat this demonstration as a production authentication system.

Live runs refresh the selected model's availability and prices from OpenRouter's public catalog. A pricing refresh failure prevents a paid request. Catalog prices are rate ceilings, not guaranteed charges or quality benchmarks. Per run: 3 calls, 8192 input tokens and 512 output tokens per call, $0.05 local budget, no automatic retries. Provider usage is the source for reported cost. Unknown charges remain unknown, including interrupted live attempts. Check OpenRouter Activity for billed totals. A new run resets the local budget. Session totals cover this tab only and reset on reload; they are not an account spending limit.

The notebook preset lists and dates are preserved. The customer directory is a separate operator view; the agent retrieves only records needed for the specific inquiry after its authorization checks. Reviewer history is session memory and is not silently included in future model prompts. There is no cross-device history database. No customer messages, refunds, or order updates exist.

Sources: [OpenRouter model catalog](https://openrouter.ai/api/v1/models), [usage accounting](https://openrouter.ai/docs/guides/guides/usage-accounting), [Pyodide worker documentation](https://pyodide.org/en/0.27.7/usage/webworker.html).

To update: edit `website/`, run `python scripts/package_website.py` from the repository root, then deploy `website/` and distribute `artifacts/website/Quietbox-Website.zip`. The bundle intentionally excludes evaluator gold labels and held-out inquiries. Keep the notebook project ZIP available alongside the website download.
