fix: Azure deployment fixes and dark mode playground

- Revert databricks-sdk to >=0.40.0 (>=0.55.0 caused SDK to use SP
  credentials instead of user OBO token for embeddings)
- Document required OAuth scopes in README deploy steps and CLAUDE.md
  (dashboards.genie + serving.serving-endpoints, set via CLI post-deploy)
- Fix dark mode in playground: textarea bg and error state colors
- Remove hardcoded app URL defaults from demo notebooks
- Remove obsolete TECHNICAL_GUIDE.pdf

Co-authored-by: Isaac

Author: Rampim

README.md

@@ -43,8 +43,15 @@ databricks sync . /Workspace/Users/<your-email>/genie-cache-queue
 # Deploy
 databricks apps deploy genie-cache-queue \
   --source-code-path /Workspace/Users/<your-email>/genie-cache-queue
+
+# Configure OAuth scopes (required once after first deploy)
+databricks apps update genie-cache-queue --json '{
+  "user_api_scopes": ["sql", "serving.serving-endpoints", "dashboards.genie"]
+}'
 ```
 
+> **Note:** The `dashboards.genie` scope allows the app to call the Genie API on behalf of the logged-in user. Without it, gateway creation cannot list Genie Spaces and queries will fail with `403 Invalid scope`. This only needs to be set once per app installation — it is not configurable via `app.yaml`.
+
 ### 2. Create a Gateway
 
 Open the app URL. On the **Gateways** home page, click **+** to create a new gateway:

TECHNICAL_GUIDE.pdf

@@ -5,7 +5,7 @@ pydantic-settings==2.1.0
 httpx==0.26.0
 python-dotenv==1.0.0
 numpy==1.26.3
-databricks-sdk>=0.55.0
+databricks-sdk>=0.40.0
 
 # PostgreSQL with PGVector for vector similarity search
 pgvector==0.2.4

backend/requirements.txt

@@ -185,8 +185,8 @@ function ChatMessage({ item }) {
         )}
 
         {isFailed && (
-          <div className="bg-red-50 border border-red-200 rounded p-3">
-            <p className="text-[13px] text-red-700">{item.error || 'An unknown error occurred'}</p>
+          <div className="bg-dbx-status-red-bg border border-dbx-danger-border rounded p-3">
+            <p className="text-[13px] text-dbx-text-danger">{item.error || 'An unknown error occurred'}</p>
           </div>
         )}
       </div>
@@ -575,7 +575,7 @@ export default function PlaygroundPage() {
             onKeyDown={handleKeyDown}
             placeholder={!selectedGateway && !loadingGateways ? 'Select a gateway above to start querying...' : 'Ask a question about your data...'}
             rows={2}
-            className="flex-1 border border-dbx-border-input rounded p-3 text-[13px] text-dbx-text placeholder-dbx-border-input resize-none focus:outline-none focus:border-dbx-blue focus:ring-1 focus:ring-[rgba(34,114,180,0.2)] disabled:bg-dbx-sidebar disabled:cursor-not-allowed"
+            className="flex-1 border border-dbx-border-input rounded p-3 text-[13px] text-dbx-text bg-dbx-bg placeholder-dbx-border-input resize-none focus:outline-none focus:border-dbx-blue focus:ring-1 focus:ring-[rgba(34,114,180,0.2)] disabled:bg-dbx-sidebar disabled:cursor-not-allowed"
             disabled={running || (!selectedGateway && !loadingGateways)}
           />
           <div className="flex flex-col gap-1.5 items-stretch">

frontend/src/components/playground/PlaygroundPage.jsx

@@ -11,11 +11,7 @@
    "metadata": {},
    "outputs": [],
    "execution_count": null,
-   "source": [
-    "dbutils.widgets.text(\"app_url\", \"https://genie-cache-queue-7474650836156271.aws.databricksapps.com\", \"App URL\")\n",
-    "dbutils.widgets.text(\"gateway_id\", \"\", \"Gateway ID\")\n",
-    "dbutils.widgets.text(\"space_id\", \"\", \"Genie Space ID\")"
-   ]
+   "source": "dbutils.widgets.text(\"app_url\", \"\", \"App URL\")\ndbutils.widgets.text(\"gateway_id\", \"\", \"Gateway ID\")\ndbutils.widgets.text(\"space_id\", \"\", \"Genie Space ID\")"
   },
   {
    "cell_type": "code",

notebooks/api_gateway_demo.ipynb

@@ -11,9 +11,7 @@
    "metadata": {},
    "outputs": [],
    "execution_count": null,
-   "source": [
-    "%pip install 'openai-agents[mcp]' -q"
-   ]
+   "source": "%pip install 'openai-agents[mcp]' -q"
   },
   {
    "cell_type": "code",
@@ -29,7 +27,7 @@
    "metadata": {},
    "outputs": [],
    "execution_count": null,
-   "source": "dbutils.widgets.text(\"app_url\", \"https://genie-cache-queue-7474650836156271.aws.databricksapps.com\", \"App URL\")\ndbutils.widgets.text(\"space_id\", \"\", \"Genie Space ID\")\ndbutils.widgets.text(\"gateway_id\", \"\", \"Gateway ID\")\ndbutils.widgets.text(\"model\", \"databricks-claude-sonnet-4\", \"Model Serving Endpoint\")"
+   "source": "dbutils.widgets.text(\"app_url\", \"\", \"App URL\")\ndbutils.widgets.text(\"space_id\", \"\", \"Genie Space ID\")\ndbutils.widgets.text(\"gateway_id\", \"\", \"Gateway ID\")\ndbutils.widgets.text(\"model\", \"databricks-claude-sonnet-4\", \"Model Serving Endpoint\")"
   },
   {
    "cell_type": "code",

notebooks/mcp_gateway_agent_demo.ipynb

@@ -5,7 +5,7 @@ pydantic-settings==2.1.0
 httpx==0.26.0
 python-dotenv==1.0.0
 numpy==1.26.3
-databricks-sdk>=0.55.0
+databricks-sdk>=0.40.0
 
 # PostgreSQL with PGVector for vector similarity search
 pgvector==0.2.4