Production rollout: Azure GPT-5.1 proxy, KV KB fallback, and config assistant demo

- Route backend proxy to Azure GPT-5.1 defaults
- Add KV fallback for /api/kb when R2 is unavailable
- Add Cloudflare-hostable config assistant demo page
- Update deploy docs for Azure vars/secrets and demo deploy flow
- Add backend chat + KB fallback tests

Author: OpenCodeEngineer

README.md

@@ -13,7 +13,7 @@ Embeddable GenAI-powered web chat widget with client-side agent loop, tool calli
 - 💾 Session persistence (IndexedDB / localStorage)
 - 🌐 WebMCP support (Chrome 146+) — provider + consumer
 - 🎨 Shadow DOM isolation — works on any website
-- ☁️ Cloudflare Workers backend (D1, KV, R2, Queues)
+- ☁️ Cloudflare Workers backend (D1, KV, Queues; R2 optional)
 - 🔑 Hybrid API keys: BYOK + managed
 
 ## Quick Start
@@ -115,9 +115,9 @@ See the [Skill Authoring Guide](docs/skills.md) for full documentation on creati
 │  │ Queue   │ │ Tickets   │  │
 │  └─────────┘ └───────────┘  │
 │  ┌─────────┐ ┌───────────┐  │
-│  │ KB (R2) │ │ Admin     │  │
+│  │ KB (KV/R2)│ │ Admin    │  │
 │  └─────────┘ └───────────┘  │
-│  D1 · KV · R2 · Queues      │
+│  D1 · KV · Queues (R2 opt.) │
 └──────────────────────────────┘
 ```
 
@@ -146,6 +146,13 @@ The widget can discover and use tools registered by the host page or other exten
 | `@vibetechnologies/webagent` | Client-side chat widget |
 | `@vibetechnologies/webagent-backend` | Cloudflare Workers backend |
 
+## Examples
+
+- `examples/basic/index.html` — minimal static embed example
+- `examples/ecommerce/index.html` — e-commerce flavored static demo
+- `examples/docs-site/index.html` — docs-focused static demo
+- `examples/config-assistant/index.html` — Cloudflare-hostable widget configuration assistant with live preview and copy-paste embed generation
+
 ## Development
 
 ```bash
@@ -154,6 +161,7 @@ pnpm typecheck    # Type-check all packages
 pnpm build        # Build all packages
 pnpm test         # Run tests
 pnpm dev          # Dev mode (all packages)
+pnpm --filter @vibetechnologies/webagent-backend dev:azure  # Backend with ~/.env.d/azure-dev.env
 ```
 
 ## License

docs/deploy.md

@@ -21,11 +21,11 @@ npx wrangler d1 create webagent-db
 # Create KV namespace
 npx wrangler kv namespace create KV
 
-# Create R2 bucket
-npx wrangler r2 bucket create webagent-kb
-
 # Create Queue
 npx wrangler queues create webagent-emails
+
+# Optional (only if you want KB on R2 instead of KV fallback)
+npx wrangler r2 bucket create webagent-kb
 ```
 
 ### 2. Update wrangler.toml
@@ -41,6 +41,10 @@ database_id = "YOUR_D1_DATABASE_ID"
 [[kv_namespaces]]
 binding = "KV"
 id = "YOUR_KV_NAMESPACE_ID"
+
+[vars]
+AZURE_DEV_AI_BASE_URL = "https://vibe-dev-ai.cognitiveservices.azure.com/openai/v1"
+AZURE_DEV_AI_MODEL = "gpt-5.1"
 ```
 
 ### 3. Set Secrets
@@ -53,6 +57,9 @@ npx wrangler secret put ADMIN_SECRET
 
 # Resend API key for email delivery
 npx wrangler secret put RESEND_API_KEY
+
+# Azure dev account key for GPT-5.1 proxying
+npx wrangler secret put AZURE_DEV_AI_API_KEY
 ```
 
 ### 4. Run Migrations
@@ -83,6 +90,47 @@ After publishing to npm, the widget is available via:
 - unpkg: `https://unpkg.com/@vibetechnologies/webagent/dist/webagent.min.js`
 - jsDelivr: `https://cdn.jsdelivr.net/npm/@vibetechnologies/webagent/dist/webagent.min.js`
 
+## Static Demo Deployment (Cloudflare Pages / Workers Assets)
+
+The repository includes a static configuration assistant at `examples/config-assistant/index.html`. It uses a progressive bundle loader:
+
+- **Development / local file usage**: tries `../../packages/widget/dist/webagent.min.js` first so the demo works directly from the repo or a local static server.
+- **Production hosting**: falls back to versioned CDN URLs for `@vibetechnologies/webagent`, which makes the page safe to deploy as plain static assets on Cloudflare without copying the widget build output.
+
+### Cloudflare Pages
+
+Deploy the example directory directly:
+
+```bash
+pnpm --filter @vibetechnologies/webagent build
+npx wrangler pages deploy examples/config-assistant --project-name webagent-config-assistant
+```
+
+If you want the demo to call a real backend by default, edit the form defaults in `examples/config-assistant/index.html` before deployment or configure the values in the browser after publishing.
+
+### Cloudflare Workers static assets
+
+Point a Worker at the example directory with Wrangler assets:
+
+```toml
+name = "webagent-config-assistant"
+compatibility_date = "2025-01-01"
+
+[assets]
+directory = "examples/config-assistant"
+```
+
+Then deploy:
+
+```bash
+pnpm --filter @vibetechnologies/webagent build
+npx wrangler deploy
+```
+
+### Optional: self-host the widget bundle
+
+If you want Cloudflare to serve the widget bundle instead of the CDN, copy `packages/widget/dist/webagent.min.js` into your static asset directory and update the loader candidates in `examples/config-assistant/index.html` to prefer that hosted path in production.
+
 ## Customer API Key Setup
 
 ### Create a managed key
@@ -131,6 +179,9 @@ curl -X PUT https://your-worker.workers.dev/api/kb/my-docs \
   ]'
 ```
 
+By default this backend can store KB docs in **KV** (free-tier friendly) when no R2 bucket binding is configured.
+If you enable and bind R2 later, `/api/kb` automatically uses R2.
+
 ### Configure widget to use KB
 
 ```html
@@ -149,6 +200,9 @@ curl -X PUT https://your-worker.workers.dev/api/kb/my-docs \
 |---|---|---|
 | `ADMIN_SECRET` | Yes | Secret for admin API endpoints |
 | `RESEND_API_KEY` | Yes | [Resend](https://resend.com) API key for email |
+| `AZURE_DEV_AI_API_KEY` | Yes (for Azure GPT-5.1 proxy mode) | Azure OpenAI key used by backend proxy when provider is `azure-openai` |
+| `AZURE_DEV_AI_BASE_URL` | Yes (wrangler var) | Azure OpenAI base URL (`.../openai/v1`) |
+| `AZURE_DEV_AI_MODEL` | No | Default Azure model/deployment (`gpt-5.1`) |
 
 ## Cloudflare Free Tier Limits