Studio: clarify tool permission controls (#7181)

.github/scripts/run-studio-permission-browser.sh

@@ -0,0 +1,69 @@
+#!/usr/bin/env bash
+# SPDX-License-Identifier: AGPL-3.0-only
+# Copyright 2026-present the Unsloth AI Inc. team. All rights reserved.
+
+set -euo pipefail
+
+port="${1:?usage: $0 PORT BROWSER [CHANNEL]}"
+browser="${2:?usage: $0 PORT BROWSER [CHANNEL]}"
+channel="${3:-}"
+slug="$browser${channel:+-$channel}"
+artifact_dir="logs/playwright-permissions-$slug"
+server_log="logs/studio-permissions-$slug.log"
+studio_home="${UNSLOTH_STUDIO_HOME:-$HOME/.unsloth/studio}"
+set --
+if [ -n "${STUDIO_PERMISSION_FRONTEND:-}" ]; then
+  set -- -f "$STUDIO_PERMISSION_FRONTEND"
+fi
+
+mkdir -p "$artifact_dir"
+unsloth studio reset-password
+UNSLOTH_API_ONLY=1 unsloth studio -H 127.0.0.1 -p "$port" "$@" \
+  >"$server_log" 2>&1 &
+studio_pid=$!
+
+cleanup() {
+  kill "$studio_pid" 2>/dev/null || true
+  wait "$studio_pid" 2>/dev/null || true
+}
+trap cleanup EXIT
+
+healthy=0
+for _ in $(seq 1 180); do
+  if curl -fs "http://127.0.0.1:$port/api/health" >/dev/null; then
+    healthy=1
+    break
+  fi
+  if ! kill -0 "$studio_pid" 2>/dev/null; then
+    tail -100 "$server_log" || true
+    exit 1
+  fi
+  sleep 1
+done
+if [ "$healthy" -ne 1 ]; then
+  tail -100 "$server_log" || true
+  exit 1
+fi
+
+old_password=$(cat "$studio_home/auth/.bootstrap_password")
+new_password="CIPerm-$(python -c 'import secrets; print(secrets.token_urlsafe(16))')"
+if [ "${GITHUB_ACTIONS:-}" = "true" ]; then
+  echo "::add-mask::$old_password"
+  echo "::add-mask::$new_password"
+fi
+
+export BASE_URL="http://127.0.0.1:$port"
+export STUDIO_OLD_PW="$old_password"
+export STUDIO_NEW_PW="$new_password"
+export STUDIO_UI_STRICT=1
+export STUDIO_UI_PERMISSION_ONLY=1
+export STUDIO_UI_WALL_TIMEOUT_S=240
+export STUDIO_PLAYWRIGHT_BROWSER="$browser"
+export PW_ART_DIR="$artifact_dir"
+if [ -n "$channel" ]; then
+  export STUDIO_PLAYWRIGHT_CHANNEL="$channel"
+else
+  unset STUDIO_PLAYWRIGHT_CHANNEL || true
+fi
+
+python tests/studio/playwright_chat_ui.py

.github/workflows/studio-mac-ui-smoke.yml

@@ -19,6 +19,7 @@ on:
       - 'install.sh'
       - 'pyproject.toml'
       - 'tests/studio/**'
+      - '.github/scripts/run-studio-permission-browser.sh'
       - '.github/workflows/studio-mac-ui-smoke.yml'
   push:
     branches: [main, pip]
@@ -96,7 +97,7 @@ jobs:
       - name: Assert llama.cpp loads on this macOS
         run: bash .github/scripts/assert-llama-loads.sh
 
-      - name: Install Playwright + Chromium
+      - name: Install Playwright browsers
         # No --with-deps on Mac: that flag installs Linux apt packages.
         # GitHub-hosted macos-14 ships the system frameworks Chromium
         # needs already.
@@ -112,7 +113,7 @@ jobs:
         # in-script retry recover from any residual flakes.
         run: |
           pip install 'playwright>=1.55,<1.58'
-          python -m playwright install chromium
+          python -m playwright install chromium webkit
 
       - name: Patch Playwright pipeTransport.js to tolerate malformed JSON
         # In Playwright 1.55-1.58, pipeTransport.js does
@@ -244,6 +245,10 @@ jobs:
           kill "${STUDIO_PID}" 2>/dev/null || true
           sleep 2
 
+      - name: Cross-browser permission controls
+        run: |
+          bash .github/scripts/run-studio-permission-browser.sh 18895 webkit
+
       - name: Reset auth + boot Unsloth for extra UI tests (port 18897)
         run: |
           unsloth studio reset-password
@@ -343,5 +348,7 @@ jobs:
             logs/studio_extra.log
             logs/install.log
             logs/playwright
+            logs/playwright-permissions-*
             logs/playwright_extra
+            logs/studio-permissions-*.log
           retention-days: 7

.github/workflows/studio-ui-smoke.yml

@@ -27,6 +27,7 @@ on:
       # The Playwright test files themselves -- a PR that ONLY edits
       # the test must still trigger UI CI.
       - 'tests/studio/**'
+      - '.github/scripts/run-studio-permission-browser.sh'
       - '.github/workflows/studio-ui-smoke.yml'
   push:
     branches: [main, pip]
@@ -107,13 +108,10 @@ jobs:
           set -o pipefail
           bash install.sh --local --no-torch 2>&1 | tee logs/install.log
 
-      - name: Install Playwright + Chromium
+      - name: Install Playwright browsers
         run: |
           pip install 'playwright>=1.45'
-          # --with-deps installs the OS-level runtime libs Chromium
-          # needs (libnss3, libxkbcommon, etc.). About 30 s on a
-          # warm runner.
-          python -m playwright install --with-deps chromium
+          python -m playwright install --with-deps chromium firefox webkit
 
       - name: Reset auth + boot Unsloth
         run: |
@@ -182,6 +180,12 @@ jobs:
           kill "${STUDIO_PID}" 2>/dev/null || true
           sleep 2
 
+      - name: Cross-browser permission controls
+        run: |
+          bash .github/scripts/run-studio-permission-browser.sh 18893 firefox
+          bash .github/scripts/run-studio-permission-browser.sh 18893 webkit
+          bash .github/scripts/run-studio-permission-browser.sh 18893 chromium chrome
+
       # The chat UI test ends by clicking the Shutdown menuitem, which
       # leaves the server dead. The extra UI test (Compare / Recipes /
       # Export / Unsloth / Settings) needs a fresh Unsloth, so we boot a
@@ -297,6 +301,8 @@ jobs:
             logs/install.log
             logs/server-logs/
             logs/playwright
+            logs/playwright-permissions-*
             logs/playwright_extra
             logs/playwright_ime
+            logs/studio-permissions-*.log
           retention-days: 7

.github/workflows/studio-windows-ui-smoke.yml

@@ -19,6 +19,7 @@ on:
       - 'install.ps1'
       - 'pyproject.toml'
       - 'tests/studio/**'
+      - '.github/scripts/run-studio-permission-browser.sh'
       - '.github/workflows/studio-windows-ui-smoke.yml'
   push:
     branches: [main, pip]
@@ -345,6 +346,10 @@ jobs:
           kill "${STUDIO_PID}" 2>/dev/null || true
           sleep 2
 
+      - name: Edge permission controls
+        run: |
+          bash .github/scripts/run-studio-permission-browser.sh 18895 chromium msedge
+
       - name: Reset auth + boot Unsloth for extra UI tests (port 18897)
         run: |
           unsloth studio reset-password
@@ -402,5 +407,7 @@ jobs:
             logs/studio_extra.log
             logs/install.log
             logs/playwright
+            logs/playwright-permissions-*
             logs/playwright_extra
+            logs/studio-permissions-*.log
           retention-days: 7