jupyterlab-codex-sidebar 0.1.4 → 0.1.6

package/lib/protocol.js

@@ -0,0 +1,278 @@
+export const PROTOCOL_VERSION = '1.0.0';
+export function parseServerMessage(raw) {
+    if (typeof raw !== 'string' && (raw === null || typeof raw !== 'object')) {
+        return null;
+    }
+    const parsed = typeof raw === 'string' ? parseJson(raw) : raw;
+    if (parsed === null || typeof parsed !== 'object') {
+        return null;
+    }
+    const message = parsed;
+    const type = typeof message.type === 'string' ? message.type : '';
+    if (!type) {
+        return null;
+    }
+    switch (type) {
+        case 'cli_defaults':
+            const cliDefaultsMessage = {
+                type,
+                protocolVersion: typeof message.protocolVersion === 'string' ? message.protocolVersion : undefined
+            };
+            if (Object.prototype.hasOwnProperty.call(message, 'model')) {
+                cliDefaultsMessage.model =
+                    typeof message.model === 'string' || message.model === null ? message.model : null;
+            }
+            if (Object.prototype.hasOwnProperty.call(message, 'reasoningEffort')) {
+                cliDefaultsMessage.reasoningEffort =
+                    typeof message.reasoningEffort === 'string' || message.reasoningEffort === null
+                        ? message.reasoningEffort
+                        : null;
+            }
+            if (Object.prototype.hasOwnProperty.call(message, 'availableModels')) {
+                cliDefaultsMessage.availableModels = parseModelCatalog(Array.isArray(message.availableModels) ? message.availableModels : []);
+            }
+            return cliDefaultsMessage;
+        case 'rate_limits':
+            return {
+                type,
+                protocolVersion: typeof message.protocolVersion === 'string' ? message.protocolVersion : undefined,
+                snapshot: message.snapshot ?? null
+            };
+        case 'delete_all_sessions':
+            if (typeof message.ok !== 'boolean' ||
+                !Number.isFinite(Number(message.deletedCount)) ||
+                !Number.isFinite(Number(message.failedCount)) ||
+                typeof message.message !== 'string') {
+                return null;
+            }
+            return {
+                type,
+                protocolVersion: typeof message.protocolVersion === 'string' ? message.protocolVersion : undefined,
+                ok: message.ok,
+                deletedCount: Number(message.deletedCount),
+                failedCount: Number(message.failedCount),
+                message: message.message
+            };
+        case 'status':
+            return {
+                type,
+                protocolVersion: typeof message.protocolVersion === 'string' ? message.protocolVersion : undefined,
+                state: message.state === 'running' ? 'running' : 'ready',
+                runId: typeof message.runId === 'string' ? message.runId : undefined,
+                sessionId: typeof message.sessionId === 'string' ? message.sessionId : undefined,
+                sessionContextKey: typeof message.sessionContextKey === 'string' ? message.sessionContextKey : undefined,
+                notebookPath: typeof message.notebookPath === 'string' ? message.notebookPath : undefined,
+                runMode: message.runMode === 'fallback' ? 'fallback' : message.runMode === 'resume' ? 'resume' : undefined,
+                pairedOk: typeof message.pairedOk === 'boolean' ? message.pairedOk : undefined,
+                pairedPath: typeof message.pairedPath === 'string' ? message.pairedPath : undefined,
+                pairedOsPath: typeof message.pairedOsPath === 'string' ? message.pairedOsPath : undefined,
+                pairedMessage: typeof message.pairedMessage === 'string' ? message.pairedMessage : undefined,
+                notebookMode: typeof message.notebookMode === 'string' ? message.notebookMode : undefined,
+                sessionResolution: typeof message.sessionResolution === 'string' ? message.sessionResolution : undefined,
+                sessionResolutionNotice: typeof message.sessionResolutionNotice === 'string' ? message.sessionResolutionNotice : undefined,
+                history: Array.isArray(message.history) ? message.history : undefined,
+                effectiveSandbox: typeof message.effectiveSandbox === 'string' ? message.effectiveSandbox : undefined
+            };
+        case 'output':
+            if (typeof message.runId !== 'string' ||
+                typeof message.sessionId !== 'string' ||
+                typeof message.notebookPath !== 'string' ||
+                typeof message.text !== 'string') {
+                return null;
+            }
+            return {
+                type,
+                protocolVersion: typeof message.protocolVersion === 'string' ? message.protocolVersion : undefined,
+                runId: message.runId,
+                sessionId: message.sessionId,
+                sessionContextKey: typeof message.sessionContextKey === 'string' ? message.sessionContextKey : undefined,
+                notebookPath: message.notebookPath,
+                role: typeof message.role === 'string' ? message.role : 'assistant',
+                text: message.text
+            };
+        case 'event':
+            if (typeof message.runId !== 'string' ||
+                typeof message.sessionId !== 'string' ||
+                typeof message.notebookPath !== 'string') {
+                return null;
+            }
+            return {
+                type,
+                protocolVersion: typeof message.protocolVersion === 'string' ? message.protocolVersion : undefined,
+                runId: message.runId,
+                sessionId: message.sessionId,
+                sessionContextKey: typeof message.sessionContextKey === 'string' ? message.sessionContextKey : undefined,
+                notebookPath: message.notebookPath,
+                payload: message.payload
+            };
+        case 'done':
+            if (typeof message.runId !== 'string' ||
+                typeof message.sessionId !== 'string' ||
+                typeof message.notebookPath !== 'string') {
+                return null;
+            }
+            let exitCode = null;
+            if (message.exitCode === null) {
+                exitCode = null;
+            }
+            else if (typeof message.exitCode === 'number' && Number.isFinite(message.exitCode)) {
+                exitCode = message.exitCode;
+            }
+            else if (typeof message.exitCode === 'string') {
+                const parsedExitCode = Number(message.exitCode.trim());
+                exitCode = Number.isFinite(parsedExitCode) ? parsedExitCode : null;
+            }
+            return {
+                type,
+                protocolVersion: typeof message.protocolVersion === 'string' ? message.protocolVersion : undefined,
+                runId: message.runId,
+                sessionId: message.sessionId,
+                sessionContextKey: typeof message.sessionContextKey === 'string' ? message.sessionContextKey : undefined,
+                notebookPath: message.notebookPath,
+                exitCode,
+                cancelled: typeof message.cancelled === 'boolean' ? message.cancelled : false,
+                fileChanged: typeof message.fileChanged === 'boolean' ? message.fileChanged : false,
+                runMode: message.runMode === 'fallback' ? 'fallback' : message.runMode === 'resume' ? 'resume' : undefined,
+                pairedOk: typeof message.pairedOk === 'boolean' ? message.pairedOk : undefined,
+                pairedPath: typeof message.pairedPath === 'string' ? message.pairedPath : undefined,
+                pairedOsPath: typeof message.pairedOsPath === 'string' ? message.pairedOsPath : undefined,
+                pairedMessage: typeof message.pairedMessage === 'string' ? message.pairedMessage : undefined,
+                notebookMode: typeof message.notebookMode === 'string' ? message.notebookMode : undefined
+            };
+        case 'error':
+            if (typeof message.message !== 'string') {
+                return null;
+            }
+            return {
+                type,
+                protocolVersion: typeof message.protocolVersion === 'string' ? message.protocolVersion : undefined,
+                runId: typeof message.runId === 'string' ? message.runId : undefined,
+                sessionId: typeof message.sessionId === 'string' ? message.sessionId : undefined,
+                sessionContextKey: typeof message.sessionContextKey === 'string' ? message.sessionContextKey : undefined,
+                notebookPath: typeof message.notebookPath === 'string' ? message.notebookPath : undefined,
+                message: message.message,
+                runMode: message.runMode === 'fallback' ? 'fallback' : message.runMode === 'resume' ? 'resume' : undefined,
+                suggestedCommandPath: typeof message.suggestedCommandPath === 'string' ? message.suggestedCommandPath : undefined,
+                pairedOk: typeof message.pairedOk === 'boolean' ? message.pairedOk : undefined,
+                pairedPath: typeof message.pairedPath === 'string' ? message.pairedPath : undefined,
+                pairedOsPath: typeof message.pairedOsPath === 'string' ? message.pairedOsPath : undefined,
+                pairedMessage: typeof message.pairedMessage === 'string' ? message.pairedMessage : undefined,
+                notebookMode: typeof message.notebookMode === 'string' ? message.notebookMode : undefined
+            };
+    }
+    return null;
+}
+export function parseModelCatalog(rawModels) {
+    if (!Array.isArray(rawModels)) {
+        return [];
+    }
+    const seen = new Set();
+    const catalog = [];
+    for (const item of rawModels) {
+        if (!item || typeof item !== 'object') {
+            continue;
+        }
+        const rawModel = item.model;
+        const rawDisplayName = item.displayName;
+        const rawReasoningEfforts = item.reasoningEfforts ??
+            item.supportedReasoningEfforts;
+        const rawDefaultReasoningEffort = item.defaultReasoningEffort;
+        if (typeof rawModel !== 'string') {
+            continue;
+        }
+        const model = rawModel.trim();
+        if (!model || seen.has(model)) {
+            continue;
+        }
+        seen.add(model);
+        const displayName = typeof rawDisplayName === 'string' && rawDisplayName.trim() ? rawDisplayName.trim() : model;
+        const defaultReasoningEffort = typeof rawDefaultReasoningEffort === 'string' && rawDefaultReasoningEffort.trim()
+            ? rawDefaultReasoningEffort.trim()
+            : '';
+        const reasoningEfforts = Array.isArray(rawReasoningEfforts)
+            ? rawReasoningEfforts.reduce((acc, effortCandidate) => {
+                const effort = coerceReasoningEffortEntry(effortCandidate);
+                if (!effort || acc.includes(effort)) {
+                    return acc;
+                }
+                acc.push(effort);
+                return acc;
+            }, [])
+            : [];
+        catalog.push({
+            model,
+            displayName,
+            ...(reasoningEfforts.length > 0 ? { reasoningEfforts } : {}),
+            ...(defaultReasoningEffort ? { defaultReasoningEffort } : {})
+        });
+    }
+    return catalog;
+}
+export function buildStartSessionMessage(input) {
+    return {
+        type: 'start_session',
+        sessionId: input.sessionId,
+        sessionContextKey: input.sessionContextKey,
+        notebookPath: input.notebookPath,
+        forceNewThread: input.forceNewThread === true,
+        commandPath: input.commandPath ? input.commandPath.trim() : undefined
+    };
+}
+export function buildSendMessage(input) {
+    return {
+        type: 'send',
+        sessionId: input.sessionId,
+        sessionContextKey: input.sessionContextKey,
+        notebookPath: input.notebookPath,
+        ...(input.commandPath ? { commandPath: input.commandPath } : {}),
+        content: input.content,
+        model: input.model,
+        reasoningEffort: input.reasoningEffort,
+        sandbox: input.sandbox,
+        ...(input.selection ? { selection: input.selection } : {}),
+        ...(input.cellOutput ? { cellOutput: input.cellOutput } : {}),
+        ...(input.images ? { images: input.images } : {}),
+        ...(input.uiSelectionPreview ? { uiSelectionPreview: input.uiSelectionPreview } : {}),
+        ...(input.uiCellOutputPreview ? { uiCellOutputPreview: input.uiCellOutputPreview } : {}),
+        ...(input.selectionTruncated ? { selectionTruncated: true } : {}),
+        ...(input.cellOutputTruncated ? { cellOutputTruncated: true } : {})
+    };
+}
+export function buildCancelMessage(runId) {
+    return {
+        type: 'cancel',
+        runId
+    };
+}
+export function buildDeleteSessionMessage(sessionId) {
+    return {
+        type: 'delete_session',
+        sessionId
+    };
+}
+export function buildDeleteAllSessionsMessage() {
+    return {
+        type: 'delete_all_sessions'
+    };
+}
+function parseJson(raw) {
+    try {
+        return JSON.parse(raw);
+    }
+    catch {
+        return null;
+    }
+}
+function coerceReasoningEffortEntry(value) {
+    if (typeof value === 'string') {
+        return value.trim();
+    }
+    if (value &&
+        typeof value === 'object' &&
+        'reasoningEffort' in value) {
+        const candidate = value.reasoningEffort;
+        return typeof candidate === 'string' ? candidate.trim() : '';
+    }
+    return '';
+}
+//# sourceMappingURL=protocol.js.map

package/lib/protocol.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.js","sourceRoot":"","sources":["../src/protocol.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "jupyterlab-codex-sidebar",
-  "version": "0.1.4",
+  "version": "0.1.6",
   "author": "ILHO AHN",
   "description": "Codex sidebar for JupyterLab",
   "license": "BSD-3-Clause",
@@ -26,8 +26,16 @@
     "watch": "jlpm run watch:lib & jlpm run watch:labextension",
     "watch:lib": "tsc -w -p tsconfig.json",
     "watch:labextension": "jupyter labextension watch . --development --source-map",
-    "clean": "rimraf lib tsconfig.tsbuildinfo"
+    "clean": "rimraf lib tsconfig.tsbuildinfo",
+    "test:unit": "playwright test --config playwright.unit.config.cjs",
+    "test:e2e": "bash scripts/run_playwright_e2e.sh",
+    "test:e2e:queue-repro": "bash scripts/run_playwright_queue_repro.sh",
+    "test:e2e:queue-repro:local": "bash scripts/run_playwright_repro.sh",
+    "test:e2e:headed": "bash scripts/run_playwright_e2e.sh --headed",
+    "test:e2e:install": "playwright install chromium",
+    "test:e2e:repro-local": "bash scripts/run_playwright_repro.sh"
   },
+  "packageManager": "yarn@3.5.0",
   "dependencies": {
     "@jupyterlab/application": "^4.0.0",
     "@jupyterlab/apputils": "^4.0.0",
@@ -45,6 +53,7 @@
   },
   "devDependencies": {
     "@jupyterlab/builder": "^4.0.0",
+    "@playwright/test": "^1.56.1",
     "@types/react": "^18.2.0",
     "@types/react-dom": "^18.2.0",
     "rimraf": "^5.0.0",
@@ -52,6 +61,7 @@
   },
   "jupyterlab": {
     "extension": true,
-    "outputDir": "jupyterlab_codex/labextension"
+    "outputDir": "jupyterlab_codex/labextension",
+    "webpackConfig": "webpack.config.js"
   }
 }

package/playwright.config.cjs

@@ -0,0 +1,27 @@
+const { defineConfig } = require('@playwright/test');
+
+const baseURL =
+  process.env.JUPYTERLAB_URL ||
+  process.env.PLAYWRIGHT_BASE_URL ||
+  'http://127.0.0.1:8888/lab';
+const channel = process.env.PLAYWRIGHT_BROWSER_CHANNEL || undefined;
+const video = process.env.PLAYWRIGHT_VIDEO || 'retain-on-failure';
+
+module.exports = defineConfig({
+  testDir: './tests/e2e',
+  timeout: 120000,
+  expect: {
+    timeout: 15000
+  },
+  fullyParallel: false,
+  retries: 0,
+  reporter: [['list']],
+  use: {
+    baseURL,
+    ...(channel ? { channel } : {}),
+    headless: process.env.PW_HEADLESS !== '0',
+    trace: 'retain-on-failure',
+    screenshot: 'only-on-failure',
+    video
+  }
+});

package/playwright.unit.config.cjs

@@ -0,0 +1,19 @@
+const { defineConfig } = require('@playwright/test');
+
+module.exports = defineConfig({
+  testDir: './tests/unit',
+  testMatch: /.*\.spec\.(js|ts)$/,
+  timeout: 120000,
+  expect: {
+    timeout: 15000
+  },
+  fullyParallel: false,
+  retries: 0,
+  reporter: [['list']],
+  use: {
+    headless: process.env.PW_HEADLESS !== '0',
+    trace: 'off',
+    screenshot: 'off',
+    video: 'off'
+  }
+});

package/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "jupyterlab-codex-sidebar"
-version = "0.1.4"
+version = "0.1.6"
 description = "JupyterLab Codex sidebar with server extension"
 readme = "README.md"
 requires-python = ">=3.9"

package/release.sh

@@ -15,9 +15,9 @@ Examples:
   ./release.sh --skip-npm
 
 Description:
-  - Uses current versions in package.json and pyproject.toml (no version bump)
-  - Optionally validates that [version] matches current version
-  - Runs jlpm install and jlpm build
+  - If [version] is provided, updates package.json and pyproject.toml to that version
+  - If [version] is omitted, uses the current synced version from manifests
+  - Runs jlpm install --immutable and jlpm build
   - Builds Python distribution (dist/*)
   - Uploads to PyPI using twine (unless --skip-pypi)
   - Publishes to npm (unless --skip-npm)
@@ -118,18 +118,48 @@ print(match.group(1))
 PY
 )"
 
-if [[ "$CURRENT_PACKAGE_VERSION" != "$CURRENT_PYTHON_VERSION" ]]; then
-  echo "ERROR: Version mismatch between package.json ($CURRENT_PACKAGE_VERSION) and pyproject.toml ($CURRENT_PYTHON_VERSION)." >&2
-  echo "       Sync versions first, then run release.sh again." >&2
-  exit 1
-fi
+if [[ -n "$EXPECTED_VERSION" ]]; then
+  RELEASE_VERSION="$EXPECTED_VERSION"
+
+  if [[ "$CURRENT_PACKAGE_VERSION" != "$RELEASE_VERSION" ]]; then
+    node - <<'JS' "$RELEASE_VERSION"
+const fs = require('fs');
+const version = process.argv[2];
+const pkgPath = 'package.json';
+const pkg = JSON.parse(fs.readFileSync(pkgPath, 'utf8'));
+pkg.version = version;
+fs.writeFileSync(pkgPath, `${JSON.stringify(pkg, null, 2)}\n`);
+JS
+  fi
 
-RELEASE_VERSION="$CURRENT_PACKAGE_VERSION"
+  if [[ "$CURRENT_PYTHON_VERSION" != "$RELEASE_VERSION" ]]; then
+    "$PYTHON_BIN" - <<'PY' "$RELEASE_VERSION"
+import pathlib
+import re
+import sys
 
-if [[ -n "$EXPECTED_VERSION" && "$EXPECTED_VERSION" != "$RELEASE_VERSION" ]]; then
-  echo "ERROR: Requested version '$EXPECTED_VERSION' does not match current version '$RELEASE_VERSION'." >&2
-  echo "       This script does not change versions; update files first if needed." >&2
-  exit 1
+version = sys.argv[1]
+pyproject = pathlib.Path("pyproject.toml")
+text = pyproject.read_text()
+updated = re.sub(
+    r'(^version\s*=\s*")([^"]+)(")',
+    rf'\g<1>{version}\g<3>',
+    text,
+    count=1,
+    flags=re.M,
+)
+if updated == text:
+    raise SystemExit("ERROR: version not found in pyproject.toml")
+pyproject.write_text(updated)
+PY
+  fi
+else
+  if [[ "$CURRENT_PACKAGE_VERSION" != "$CURRENT_PYTHON_VERSION" ]]; then
+    echo "ERROR: Version mismatch between package.json ($CURRENT_PACKAGE_VERSION) and pyproject.toml ($CURRENT_PYTHON_VERSION)." >&2
+    echo "       Sync versions first, then run release.sh again." >&2
+    exit 1
+  fi
+  RELEASE_VERSION="$CURRENT_PACKAGE_VERSION"
 fi
 
 if [[ "$RELEASE_VERSION" =~ -dev(\.[0-9A-Za-z-]+)*$ ]]; then
@@ -172,7 +202,7 @@ echo "[2/5] Cleaning previous artifacts"
 rm -rf dist
 
 echo "[3/5] Installing JS dependencies and building frontend"
-jlpm install
+jlpm install --immutable
 jlpm run build
 
 echo "[4/5] Building Python distributions"
@@ -194,6 +224,14 @@ else
 fi
 
 if [[ "$SKIP_NPM" -eq 0 ]]; then
+  echo "[extra] Ensuring npm authentication"
+  if ! npm whoami >/dev/null 2>&1; then
+    echo "  - npm login required. Starting interactive login..."
+    npm login
+  else
+    echo "  - npm login already active."
+  fi
+
   echo "[extra] Publishing to npm"
   npm publish --access public
 else

package/scripts/run_playwright_e2e.sh

@@ -0,0 +1,96 @@
+#!/usr/bin/env bash
+
+if [ -z "${BASH_VERSION:-}" ]; then
+  exec bash "$0" "$@"
+fi
+
+set -euo pipefail
+
+ROOT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
+cd "$ROOT_DIR"
+
+HOST="${JUPYTERLAB_HOST:-127.0.0.1}"
+DEFAULT_PORT="${JUPYTERLAB_PORT:-8888}"
+FALLBACK_PORTS_RAW="${JUPYTERLAB_FALLBACK_PORTS:-$DEFAULT_PORT 8889 8890 8891 8892 8893}"
+if [[ "${PLAYWRIGHT_BASE_URL:-}" != "" ]]; then
+  BASE_URL_CANDIDATES=("$PLAYWRIGHT_BASE_URL")
+else
+  # shellcheck disable=SC2206
+  FALLBACK_PORTS=(${FALLBACK_PORTS_RAW})
+  BASE_URL_CANDIDATES=()
+  for port in "${FALLBACK_PORTS[@]}"; do
+    BASE_URL_CANDIDATES+=("http://${HOST}:${port}/lab")
+  done
+fi
+
+BASE_URL=""
+JUPYTER_PID=""
+LOG_FILE="${PLAYWRIGHT_JUPYTER_LOG:-$ROOT_DIR/.jupyterlab-playwright.log}"
+
+cleanup() {
+  if [ -n "${JUPYTER_PID}" ] && kill -0 "$JUPYTER_PID" >/dev/null 2>&1; then
+    kill "$JUPYTER_PID" >/dev/null 2>&1 || true
+    wait "$JUPYTER_PID" >/dev/null 2>&1 || true
+  fi
+}
+trap cleanup EXIT
+
+for candidate in "${BASE_URL_CANDIDATES[@]}"; do
+  if curl -fsS "$candidate" >/dev/null 2>&1; then
+    BASE_URL="$candidate"
+    break
+  fi
+done
+
+if [[ -z "$BASE_URL" ]]; then
+  if [[ "${PLAYWRIGHT_BASE_URL:-}" != "" ]]; then
+    echo "[playwright] JupyterLab is not reachable."
+    echo "[playwright] Tried: $PLAYWRIGHT_BASE_URL"
+    echo "[playwright] Start JupyterLab first and retry."
+    exit 1
+  fi
+
+  echo "[playwright] JupyterLab is not reachable. launching automatically..."
+  for port in ${FALLBACK_PORTS_RAW}; do
+    BASE_URL_CANDIDATE="http://${HOST}:${port}/lab"
+    echo "[playwright] launching JupyterLab on ${BASE_URL_CANDIDATE}"
+
+    jupyter lab \
+      --no-browser \
+      --ServerApp.open_browser=False \
+      --ServerApp.port="$port" \
+      --ServerApp.ip="$HOST" \
+      --IdentityProvider.token='' \
+      --ServerApp.token='' \
+      --ServerApp.password='' \
+      >"$LOG_FILE" 2>&1 &
+    JUPYTER_PID=$!
+
+    for _ in $(seq 1 60); do
+      if curl -fsS "$BASE_URL_CANDIDATE" >/dev/null 2>&1; then
+        BASE_URL="$BASE_URL_CANDIDATE"
+        break 2
+      fi
+      sleep 1
+    done
+
+    if [ -n "$JUPYTER_PID" ] && kill -0 "$JUPYTER_PID" >/dev/null 2>&1; then
+      kill "$JUPYTER_PID" >/dev/null 2>&1 || true
+      wait "$JUPYTER_PID" >/dev/null 2>&1 || true
+    fi
+    JUPYTER_PID=""
+  done
+
+  if [[ -z "$BASE_URL" ]]; then
+    echo "[playwright] JupyterLab failed to start. Log: $LOG_FILE"
+    exit 1
+  fi
+fi
+
+if [ -x "$ROOT_DIR/node_modules/.bin/playwright" ]; then
+  env PLAYWRIGHT_BASE_URL="$BASE_URL" \
+    "$ROOT_DIR/node_modules/.bin/playwright" test "$@"
+else
+  env PLAYWRIGHT_BASE_URL="$BASE_URL" \
+    npx playwright test "$@"
+fi

package/scripts/run_playwright_freeze_repro.sh

@@ -0,0 +1,58 @@
+#!/usr/bin/env bash
+
+if [ -z "${BASH_VERSION:-}" ]; then
+  exec bash "$0" "$@"
+fi
+
+set -euo pipefail
+
+ROOT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
+cd "$ROOT_DIR"
+
+PORT="${JUPYTERLAB_PORT:-8888}"
+HOST="${JUPYTERLAB_HOST:-127.0.0.1}"
+BASE_URL="${PLAYWRIGHT_BASE_URL:-http://${HOST}:${PORT}/lab}"
+MOCK_CODEX="${PLAYWRIGHT_CODEX_COMMAND:-$ROOT_DIR/tests/e2e/mock-codex-cli-flood.py}"
+LOG_FILE="${PLAYWRIGHT_JUPYTER_LOG:-$ROOT_DIR/.jupyterlab-playwright-freeze.log}"
+MOCK_CODEX_EVENT_DELAY_MS_DEFAULT="${MOCK_CODEX_EVENT_DELAY_MS:-120}"
+
+cleanup() {
+  if [ -n "${JUPYTER_PID:-}" ] && kill -0 "$JUPYTER_PID" >/dev/null 2>&1; then
+    kill "$JUPYTER_PID" >/dev/null 2>&1 || true
+    wait "$JUPYTER_PID" >/dev/null 2>&1 || true
+  fi
+}
+trap cleanup EXIT
+
+echo "[playwright] launching JupyterLab on ${BASE_URL}"
+jupyter lab \
+  --no-browser \
+  --ServerApp.open_browser=False \
+  --ServerApp.port="$PORT" \
+  --ServerApp.ip="$HOST" \
+  --IdentityProvider.token='' \
+  --ServerApp.token='' \
+  --ServerApp.password='' \
+  >"$LOG_FILE" 2>&1 &
+JUPYTER_PID=$!
+
+echo "[playwright] waiting for JupyterLab to be ready..."
+for _ in $(seq 1 60); do
+  if curl -fsS "$BASE_URL" >/dev/null 2>&1; then
+    break
+  fi
+  sleep 1
+done
+
+if ! curl -fsS "$BASE_URL" >/dev/null 2>&1; then
+  echo "[playwright] JupyterLab failed to start. Log: $LOG_FILE"
+  exit 1
+fi
+
+echo "[playwright] running notebook-tab freeze reproduction e2e"
+PLAYWRIGHT_BASE_URL="$BASE_URL" \
+PLAYWRIGHT_CODEX_COMMAND="$MOCK_CODEX" \
+MOCK_CODEX_EVENT_COUNT="${MOCK_CODEX_EVENT_COUNT:-360}" \
+MOCK_CODEX_EVENT_DELAY_MS="${MOCK_CODEX_EVENT_DELAY_MS_DEFAULT}" \
+MOCK_CODEX_CHUNK_WORDS="${MOCK_CODEX_CHUNK_WORDS:-14}" \
+npx playwright test tests/e2e/freeze-notebook-tabs-repro.spec.js "$@"