Add settings dialog with theme switcher, timezone, language, and startup scripts

New settings modal (gear icon in topbar) with timezone selector, language
picker, and 7 themes (4 dark + 3 light) applied via CSS custom properties.
Settings persist to localStorage. Added cross-platform startup scripts
(start.sh, start.command, start.bat) that handle venv creation and
dependency installation. Updated README with full Account API coverage
and all new features.

Co-authored-by: Isaac

Author: guidooswaldDB

README.md

@@ -1,6 +1,6 @@
 # Databricks API Explorer
 
-An ultra-modern, interactive REST API explorer for Databricks workspaces. Built as a Databricks App with dual-mode authentication — runs locally via Databricks CLI SSO and in production as a Databricks App using On-Behalf-Of (OBO) authentication.
+An ultra-modern, interactive REST API explorer for Databricks — covering both **Workspace** and **Account-level** APIs. Built as a Databricks App with dual-mode authentication: runs locally via Databricks CLI SSO and in production as a Databricks App using On-Behalf-Of (OBO) authentication.
 
 ---
 
@@ -14,7 +14,10 @@ An ultra-modern, interactive REST API explorer for Databricks workspaces. Built
 
 ### API Coverage
 
-- **15 API categories** with **45+ endpoints** across the full Databricks REST API surface:
+- **32 API categories** with **76 endpoints** across both Workspace and Account REST API surfaces
+- **Scope switcher** in the sidebar toggles between Workspace and Account API views
+
+#### Workspace APIs (16 categories, 45 endpoints)
 
 | Category | Endpoints |
 |---|---|
@@ -23,7 +26,7 @@ An ultra-modern, interactive REST API explorer for Databricks workspaces. Built
 | Workspace | List Objects, Get Status, Search |
 | DBFS | List Files, Get File Status |
 | SQL Warehouses | List, Get, List Saved Queries |
-| Unity Catalog | List Catalogs, Schemas, Tables, Volumes, Get Metastore |
+| Unity Catalog | List Catalogs, Schemas, Tables, Volumes, Get Table, Get Metastore |
 | MLflow | Search Experiments, Get Experiment, Search Runs, Registered Models |
 | Model Serving | List Endpoints, Get Endpoint |
 | Pipelines (DLT) | List, Get, List Events |
@@ -35,18 +38,40 @@ An ultra-modern, interactive REST API explorer for Databricks workspaces. Built
 | Repos | List Repos |
 | Permissions | Get Cluster, Job, and Warehouse Permissions |
 
+#### Account APIs (16 categories, 31 endpoints)
+
+| Category | Endpoints |
+|---|---|
+| Account Users | List Users, Get User |
+| Account Groups | List Groups, Get Group |
+| Service Principals | List Service Principals, Get Service Principal |
+| Workspaces | List Workspaces, Get Workspace |
+| Credentials | List Credential Configs, Get Credential Config |
+| Storage | List Storage Configs, Get Storage Config |
+| Networks | List Network Configs, Get Network Config |
+| Private Access | List Private Access Settings, Get Private Access Settings |
+| VPC Endpoints | List VPC Endpoints, Get VPC Endpoint |
+| Encryption Keys | List Encryption Key Configs, Get Encryption Key Config |
+| Log Delivery | List Log Delivery Configs, Get Log Delivery Config |
+| Budgets | List Budgets, Get Budget |
+| Usage Download | Download Usage (CSV) |
+| Account Metastores | List Metastores, Get Metastore, List Metastore Assignments |
+| Account Access Control | Get Rule Set |
+| Account Settings | Get Personal Compute Setting, List IP Access Lists |
+
 ### Authentication
 
 - **Local mode** — authenticates via the Databricks CLI (`~/.databrickscfg`). Supports all CLI auth flows: OAuth/SSO (browser-based), PAT, Azure Service Principal, Azure Managed Identity, OAuth M2M.
 - **Databricks App mode** — auto-detected at runtime. Uses On-Behalf-Of (OBO) authentication: the user's access token is forwarded via the `x-forwarded-access-token` HTTP header, so every API call runs as the logged-in user. No token configuration required.
 - **Custom URL / PAT** — optionally specify any workspace URL and Personal Access Token directly in the UI, bypassing the CLI entirely.
+- **Account API auth** — account-scope endpoints automatically derive the accounts console URL from the workspace host and obtain an account-level token.
 
 ### Connection Management
 
 - **User identity panel** — click the username chip in the top bar to open a slide-down panel showing:
   - Display name, username, active status
   - Auth type (OBO, OAuth/SSO, PAT, Azure SP, etc.)
-  - Workspace host
+  - Workspace host and account ID
   - User ID and primary email
   - Group memberships (up to 20, with overflow count)
 - **CLI profile switcher** — all profiles from `~/.databrickscfg` are listed and refreshed on every panel open. Switch profiles without restarting the app.
@@ -59,23 +84,41 @@ An ultra-modern, interactive REST API explorer for Databricks workspaces. Built
 - **Path parameter interpolation** — path parameters (e.g. `{cluster_id}`) are extracted from the URL and shown as dedicated fields
 - **JSON body editor** — POST endpoints show a pre-populated JSON textarea with the correct request schema
 - **Real-time search** — filter endpoints across all categories by name, path, method, or category
+- **Configurable timeout** — per-request timeout control with a spinner input next to the Execute button (defaults vary by endpoint, e.g. 120 s for Usage Download)
+- **Auto-fill account ID** — account-scope endpoints automatically populate the `account_id` field from the current CLI profile
 
 ### Response Viewer
 
-- **Syntax-highlighted JSON** — token-level syntax coloring using Dash `html.Span` components (no `dangerousHTML` injection)
+- **Collapsible JSON tree** — interactive tree viewer rendered in an iframe with expand/collapse toggles, inline syntax highlighting, and compact previews for collapsed nodes
+- **Inline ID links** — list API responses render clickable ID chips on matching fields; clicking one fires the corresponding Get API and pre-fills the parameter form
+- **Side panel with chip list** — list responses show a scrollable side panel of result chips with labels, allowing quick drill-down into individual items
+- **Action buttons on chips** — some list endpoints expose secondary actions (e.g. "List workspace assignments" on metastores) directly on each chip
 - **Response metadata bar** — HTTP status code (color-coded), latency in ms, item count for list responses, full request URL
-- **Large response handling** — responses over 50 000 characters are truncated with a clear notice
-- **Side-by-side layout** — fixed 360 px parameter panel on the left, full-height response panel on the right
+- **CSV viewer** — endpoints that return CSV data (e.g. Usage Download) are rendered as a scrollable HTML table
+- **curl command** — every executed request generates a ready-to-copy `curl` command displayed below the Execute button, with a one-click copy button
+
+### Pagination
+
+- **Automatic pagination** — when a response contains a `next_page_token`, the app automatically fetches subsequent pages and merges them into a single result
+- **"Load All" button** — for APIs with `has_more`-style pagination, a "Load All" button in the side panel fetches all remaining pages in a background thread with live progress updates
+- **Abort controls** — both automatic pagination and Load All can be cancelled mid-flight; Load All auto-cancels when switching to a different endpoint
+
+### Resizable Side Panel
+
+- **Drag-to-resize** — the side panel has a left-edge resize handle; drag to adjust width between 20% and 80% of the viewport
+- **Persistent width** — panel width is saved to `localStorage` and restored across page reloads
 
 ### UI & UX
 
 - **Glassmorphism dark theme** — custom CSS with CSS variables, neon accent colors, backdrop-filter blur effects
 - **CYBORG Bootstrap theme** via `dash-bootstrap-components`
+- **Scope switcher** — toggle between Workspace and Account API catalogs in the sidebar
 - **Mode badge** in the top bar shows whether running as `Local Mode` or `Databricks App`
-- **Workspace host display** in the top bar
+- **Workspace host display** in the top bar with a clickable link to the workspace
 - **Auto-incrementing build version** — `version.py` bumps a counter on every app start, displayed as `v<N>` in the topbar
 - **Accordion sidebar** with category icons, per-category endpoint counts, and method color badges (GET/POST/PUT/DELETE/PATCH)
 - **Active endpoint highlighting** — selected endpoint button is highlighted in the sidebar
+- **Debug bar patches** — MutationObserver removes the Plotly Cloud button and injects workspace URL links into the Dash debug bar
 
 ---
 
@@ -93,24 +136,24 @@ An ultra-modern, interactive REST API explorer for Databricks workspaces. Built
 │                                                         │
 │  ┌─────────────┐  ┌──────────────┐  ┌───────────────┐  │
 │  │   TOPBAR    │  │   SIDEBAR    │  │  MAIN CONTENT │  │
-│  │  user chip  │  │  accordion   │  │               │  │
-│  │  host label │  │  search      │  │  ┌──────────┐ │  │
-│  │  mode badge │  │  endpoints   │  │  │  form    │ │  │
-│  └──────┬──────┘  └──────┬───────┘  │  │  panel   │ │  │
-│         │                │          │  └──────────┘ │  │
+│  │  user chip  │  │  scope switch│  │               │  │
+│  │  host label │  │  accordion   │  │  ┌──────────┐ │  │
+│  │  mode badge │  │  search      │  │  │  form    │ │  │
+│  └──────┬──────┘  │  endpoints   │  │  │  panel   │ │  │
+│         │         └──────┬───────┘  │  └──────────┘ │  │
 │  ┌──────▼──────┐         │          │  ┌──────────┐ │  │
 │  │ USER        │         │          │  │ response │ │  │
-│  │ DROPDOWN    │         │          │  │ panel    │ │  │
-│  │ (fixed pos) │         │          │  └──────────┘ │  │
-│  └─────────────┘         │          └───────────────┘  │
-│                           │                             │
-│  ┌────────────────────────▼────────────────────────┐   │
-│  │              dcc.Store (conn-config)             │   │
-│  │   {"mode": "profile"|"custom",                  │   │
-│  │    "profile": "<name>" | "host": "...",          │   │
-│  │    "token": "..."}                               │   │
-│  └────────────────────────┬────────────────────────┘   │
-└───────────────────────────│─────────────────────────────┘
+│  │ DROPDOWN    │         │          │  │ tree +   │ │  │
+│  │ (fixed pos) │         │          │  │ side     │ │  │
+│  └─────────────┘         │          │  │ panel    │ │  │
+│                           │          │  └──────────┘ │  │
+│  ┌────────────────────────▼──────────┴───────────┐   │
+│  │              dcc.Store (conn-config)            │   │
+│  │   {"mode": "profile"|"custom",                 │   │
+│  │    "profile": "<name>" | "host": "...",         │   │
+│  │    "token": "..."}                              │   │
+│  └────────────────────────┬──────────────────────┘   │
+└───────────────────────────│───────────────────────────┘
                             │
          ┌──────────────────▼──────────────────┐
          │             auth.py                 │
@@ -126,23 +169,24 @@ An ultra-modern, interactive REST API explorer for Databricks workspaces. Built
          │                                     │
          │  make_api_call()                    │
          │    └─ requests.request()            │
-         └──────────────────┬──────────────────┘
-                            │
-         ┌──────────────────▼──────────────────┐
-         │        Databricks REST API          │
-         │        (workspace host)             │
-         └─────────────────────────────────────┘
+         └──────┬───────────────────┬──────────┘
+                │                   │
+ ┌──────────────▼───────┐ ┌────────▼──────────────────┐
+ │  Databricks REST API │ │  Databricks Accounts API  │
+ │  (workspace host)    │ │  (accounts console host)  │
+ └──────────────────────┘ └───────────────────────────┘
 ```
 
 ### Key Components
 
 | File | Responsibility |
 |---|---|
-| `app.py` | Dash app, layout, all callbacks |
-| `auth.py` | Auth resolution, profile discovery, `make_api_call()` |
-| `api_catalog.py` | All endpoint definitions (15 categories, 45+ endpoints) |
+| `app.py` | Dash app, layout, all callbacks (19+ callbacks) |
+| `auth.py` | Auth resolution, profile discovery, account token exchange, `make_api_call()` |
+| `api_catalog.py` | Endpoint catalog (32 categories, 76 endpoints), chip extraction, list-to-get linking |
 | `version.py` | Auto-incrementing build version counter |
 | `assets/style.css` | Full dark glassmorphism CSS theme |
+| `assets/devtools_patch.js` | Debug bar patches + resizable side panel |
 | `app.yaml` | Databricks Apps runtime config (command + env) |
 | `databricks.yml` | Asset Bundle config for DABs deployment |
 | `resources/api_explorer.app.yml` | DABs app resource definition |
@@ -170,6 +214,12 @@ An ultra-modern, interactive REST API explorer for Databricks workspaces. Built
                            ▼
                   make_api_call(method, path,
                                 token, host)
+                           │
+              ┌────────────┴────────────┐
+              │ scope == "workspace"    │ scope == "account"
+              ▼                         ▼
+     workspace host            _accounts_host() derives
+                               accounts console URL
 ```
 
 ### Callback Graph
@@ -183,10 +233,16 @@ conn-mode-radio ───► toggle_conn_mode ──► profile-section / custom
 profile-select ────► show_profile_hint ──► profile-auth-type hint
 apply-conn-btn ────► apply_connection ──► conn-config store
 reauth-btn ────────► reauth ──► reauth-status
+scope-switch ──────► switch_scope ──► sidebar categories (workspace/account)
 endpoint-btn[ALL] ─► select_endpoint ──► selected-endpoint store
+selected-endpoint ─► sync_active_button ──► endpoint-btn[ALL] className
 selected-endpoint ─► render_endpoint_detail ──► endpoint-detail, param form
-execute-btn ───────► execute_api_call ──► response-container
+execute-btn ───────► execute_api_call ──► response-container, curl command
+                   ► start_pagination ──► auto-fetch next pages
 search-input ──────► filter_endpoints ──► endpoint-btn[ALL] styles
+id-link-btn ───────► handle_id_link_click ──► selected-endpoint, response
+load-all-btn ──────► start_load_all ──► background thread + ticker
+last-req ──────────► update_curl_display ──► curl-text, curl-display
 ```
 
 ---
@@ -195,7 +251,7 @@ search-input ──────► filter_endpoints ──► endpoint-btn[ALL]
 
 | Layer | Technology |
 |---|---|
-| **Framework** | [Dash 2.x](https://dash.plotly.com/) (Plotly) |
+| **Framework** | [Dash 4.x](https://dash.plotly.com/) (Plotly) |
 | **UI Components** | [dash-bootstrap-components](https://dash-bootstrap-components.opensource.faculty.ai/) — CYBORG theme |
 | **Icons** | Bootstrap Icons (via CDN) |
 | **HTTP Client** | [requests](https://requests.readthedocs.io/) |
@@ -263,7 +319,7 @@ databricks apps logs databricks-api-explorer --profile guido-demo-azure
 DatabricksAPIexplorer/
 ├── app.py                        # Main Dash app + all callbacks
 ├── auth.py                       # Auth resolution + API call helper
-├── api_catalog.py                # Endpoint catalog (15 categories)
+├── api_catalog.py                # Endpoint catalog (32 categories, 76 endpoints)
 ├── version.py                    # Auto-incrementing build version
 ├── version.txt                   # Current build number (auto-updated)
 ├── requirements.txt              # Python dependencies
@@ -273,5 +329,6 @@ DatabricksAPIexplorer/
 │   └── api_explorer.app.yml      # DABs app resource definition
 └── assets/
     ├── style.css                 # Dark glassmorphism CSS theme
+    ├── devtools_patch.js         # Debug bar patches + resizable side panel
     └── screenshot.png            # App screenshot
 ```