browser-workspace 0.4.5 → 0.4.9

package/session_client.py

@@ -6,6 +6,7 @@ from pathlib import Path
 ROOT=Path(__file__).resolve().parent
 RUNTIME_DIR=Path.home()/'.config/browser-workspace/runtime'
 SOCKET_PATH=(Path(os.environ['BROWSER_WORKSPACE_SESSION_SOCKET']) if os.environ.get('BROWSER_WORKSPACE_TEST_MODE')=='1' and os.environ.get('BROWSER_WORKSPACE_SESSION_SOCKET') else RUNTIME_DIR/'session.sock')
+HARNESS_RUNTIME_SPEC='browser-harness @ git+https://github.com/lalalic/browser-harness.git@80b74e116b9126f5159c84e5e05a750573e5f192'
 
 def package_version():
     try:
@@ -30,6 +31,13 @@ def runtime_source():
         destination=tmp/name
         if source.is_dir(): shutil.copytree(source,destination)
         else: shutil.copy2(source,destination)
+    # A published wheel installs directly under browser_workspace_app/ without
+    # a nested src/ tree. Reconstruct the build layout only in the runtime
+    # cache, never in the repository or published source tree.
+    if not (tmp/'src').exists():
+        package_root = tmp/'src'/'browser_workspace_app'
+        package_root.parent.mkdir(parents=True, exist_ok=True)
+        shutil.copytree(ROOT, package_root, ignore=shutil.ignore_patterns('__pycache__', '*.pyc', '.DS_Store'))
     (tmp/'.ready').write_text(package_version())
     shutil.rmtree(target,ignore_errors=True)
     tmp.rename(target)
@@ -53,6 +61,7 @@ def ensure_runtime_python():
         if uv:
             subprocess.run([uv,'venv','--python','3.11',str(PYTHON.parent.parent)],check=True)
             subprocess.run([uv,'pip','install','--python',str(PYTHON),'-e',str(SOURCE)],check=True)
+            subprocess.run([uv,'pip','install','--python',str(PYTHON),'--reinstall',HARNESS_RUNTIME_SPEC],check=True)
             return PYTHON
         if sys.version_info < (3,11):
             raise RuntimeError(
@@ -61,6 +70,7 @@ def ensure_runtime_python():
             )
         subprocess.run([sys.executable,'-m','venv',str(PYTHON.parent.parent)],check=True)
         subprocess.run([str(PYTHON),'-m','pip','install','-e',str(SOURCE)],check=True)
+        subprocess.run([str(PYTHON),'-m','pip','install','--force-reinstall',HARNESS_RUNTIME_SPEC],check=True)
         return PYTHON
 
 def request(payload, ensure=True):

package/src/browser_workspace.egg-info/PKG-INFO

@@ -1,9 +1,9 @@
 Metadata-Version: 2.4
 Name: browser-workspace
-Version: 0.4.5
+Version: 0.4.9
 Summary: Agent browser workspace with persistent Python sessions, tab leasing, snapshots, and platform workflows.
 Requires-Python: >=3.11
-Requires-Dist: browser-harness @ git+https://github.com/lalalic/browser-harness.git@80b74e116b9126f5159c84e5e05a750573e5f192
+Requires-Dist: browser-harness==0.1.13
 Requires-Dist: cdp-use==1.4.5
 Requires-Dist: fetch-use==0.4.0
 Requires-Dist: pillow==12.3.0

package/src/browser_workspace.egg-info/SOURCES.txt

@@ -1,5 +1,58 @@
+MANIFEST.in
 README.md
+platform_runner.py
 pyproject.toml
+setup.py
+platforms/chatgpt/README.md
+platforms/chatgpt/manifest.yaml
+platforms/chatgpt/actions/_bootstrap_start.py
+platforms/chatgpt/actions/_lifecycle_common.py
+platforms/chatgpt/actions/_mcp_app.py
+platforms/chatgpt/actions/_new_thread.py
+platforms/chatgpt/actions/_new_turn.py
+platforms/chatgpt/actions/_project_setup.py
+platforms/chatgpt/actions/_readiness.py
+platforms/chatgpt/actions/_submit_thread.py
+platforms/chatgpt/actions/_temporary_submit.py
+platforms/chatgpt/actions/_thread_turn.py
+platforms/chatgpt/tests/test_contract.py
+platforms/chrome-web-store/README.md
+platforms/chrome-web-store/manifest.yaml
+platforms/chrome-web-store/actions/_chrome_web_store.py
+platforms/chrome-web-store/flows/check-status.md
+platforms/chrome-web-store/flows/open-item.md
+platforms/chrome-web-store/flows/submit-review.md
+platforms/chrome-web-store/flows/update-listing.md
+platforms/chrome-web-store/flows/upload-package.md
+platforms/chrome-web-store/flows/verify-published.md
+platforms/chrome-web-store/tests/test_contract.py
+platforms/iyf/AIRPLAY.md
+platforms/iyf/manifest.yaml
+platforms/iyf/safari-airplay
+platforms/iyf/actions/_find.py
+platforms/iyf/actions/_open.py
+platforms/microsoft-teams/README.md
+platforms/microsoft-teams/manifest.yaml
+platforms/microsoft-teams/actions/_meeting.py
+platforms/microsoft-teams/flows/instant-meeting.md
+platforms/microsoft-teams/tests/test_contract.py
+platforms/tiktok/README.md
+platforms/tiktok/manifest.yaml
+platforms/tiktok/actions/_post.py
+platforms/wechat-channels/README.md
+platforms/wechat-channels/manifest.yaml
+platforms/wechat-channels/actions/_common.py
+platforms/wechat-channels/actions/_manage.py
+platforms/wechat-channels/actions/_post.py
+platforms/wechat-channels/tests/test_contract.py
+platforms/xhs/README.md
+platforms/xhs/manifest.yaml
+platforms/xhs/actions/_manage.py
+platforms/xhs/actions/_post.py
+platforms/xhs/tests/test_contract.py
+platforms/youtube/README.md
+platforms/youtube/manifest.yaml
+platforms/youtube/actions/_post.py
 src/browser_workspace.egg-info/PKG-INFO
 src/browser_workspace.egg-info/SOURCES.txt
 src/browser_workspace.egg-info/dependency_links.txt
@@ -10,7 +63,6 @@ src/browser_workspace_app/__init__.py
 src/browser_workspace_app/cli.py
 src/browser_workspace_app/managed_chrome.py
 src/browser_workspace_app/package.json
-src/browser_workspace_app/platform_runner.py
 src/browser_workspace_app/pyproject.toml
 src/browser_workspace_app/session_client.py
 src/browser_workspace_app/session_daemon.py
@@ -39,51 +91,6 @@ src/browser_workspace_app/interaction-skills/uploads.md
 src/browser_workspace_app/interaction-skills/viewport.md
 src/browser_workspace_app/licenses/browser-harness-MIT.txt
 src/browser_workspace_app/node/admin.mjs
-src/browser_workspace_app/platforms/chatgpt/README.md
-src/browser_workspace_app/platforms/chatgpt/manifest.yaml
-src/browser_workspace_app/platforms/chatgpt/actions/_bootstrap_start.py
-src/browser_workspace_app/platforms/chatgpt/actions/_lifecycle_common.py
-src/browser_workspace_app/platforms/chatgpt/actions/_mcp_app.py
-src/browser_workspace_app/platforms/chatgpt/actions/_new_thread.py
-src/browser_workspace_app/platforms/chatgpt/actions/_new_turn.py
-src/browser_workspace_app/platforms/chatgpt/actions/_project_setup.py
-src/browser_workspace_app/platforms/chatgpt/actions/_readiness.py
-src/browser_workspace_app/platforms/chatgpt/actions/_submit_thread.py
-src/browser_workspace_app/platforms/chatgpt/actions/_temporary_submit.py
-src/browser_workspace_app/platforms/chatgpt/actions/_thread_turn.py
-src/browser_workspace_app/platforms/chatgpt/tests/test_contract.py
-src/browser_workspace_app/platforms/chrome-web-store/README.md
-src/browser_workspace_app/platforms/chrome-web-store/manifest.yaml
-src/browser_workspace_app/platforms/chrome-web-store/actions/_chrome_web_store.py
-src/browser_workspace_app/platforms/chrome-web-store/flows/check-status.md
-src/browser_workspace_app/platforms/chrome-web-store/flows/open-item.md
-src/browser_workspace_app/platforms/chrome-web-store/flows/submit-review.md
-src/browser_workspace_app/platforms/chrome-web-store/flows/update-listing.md
-src/browser_workspace_app/platforms/chrome-web-store/flows/upload-package.md
-src/browser_workspace_app/platforms/chrome-web-store/flows/verify-published.md
-src/browser_workspace_app/platforms/chrome-web-store/tests/test_contract.py
-src/browser_workspace_app/platforms/microsoft-teams/README.md
-src/browser_workspace_app/platforms/microsoft-teams/manifest.yaml
-src/browser_workspace_app/platforms/microsoft-teams/actions/_meeting.py
-src/browser_workspace_app/platforms/microsoft-teams/flows/instant-meeting.md
-src/browser_workspace_app/platforms/microsoft-teams/tests/test_contract.py
-src/browser_workspace_app/platforms/tiktok/README.md
-src/browser_workspace_app/platforms/tiktok/manifest.yaml
-src/browser_workspace_app/platforms/tiktok/actions/_post.py
-src/browser_workspace_app/platforms/wechat-channels/README.md
-src/browser_workspace_app/platforms/wechat-channels/manifest.yaml
-src/browser_workspace_app/platforms/wechat-channels/actions/_common.py
-src/browser_workspace_app/platforms/wechat-channels/actions/_manage.py
-src/browser_workspace_app/platforms/wechat-channels/actions/_post.py
-src/browser_workspace_app/platforms/wechat-channels/tests/test_contract.py
-src/browser_workspace_app/platforms/xhs/README.md
-src/browser_workspace_app/platforms/xhs/manifest.yaml
-src/browser_workspace_app/platforms/xhs/actions/_manage.py
-src/browser_workspace_app/platforms/xhs/actions/_post.py
-src/browser_workspace_app/platforms/xhs/tests/test_contract.py
-src/browser_workspace_app/platforms/youtube/README.md
-src/browser_workspace_app/platforms/youtube/manifest.yaml
-src/browser_workspace_app/platforms/youtube/actions/_post.py
 test/test_auth_cookie_audit.py
 test/test_auth_keepalive_visit.py
 test/test_harness_ownership.py

package/src/browser_workspace.egg-info/requires.txt

@@ -1,4 +1,4 @@
-browser-harness @ git+https://github.com/lalalic/browser-harness.git@80b74e116b9126f5159c84e5e05a750573e5f192
+browser-harness==0.1.13
 cdp-use==1.4.5
 fetch-use==0.4.0
 pillow==12.3.0

package/src/browser_workspace_app/package.json

@@ -1,6 +1,6 @@
 {
   "name": "browser-workspace",
-  "version": "0.4.5",
+  "version": "0.4.8",
   "description": "Agent browser workspace with persistent sessions, tab leasing, snapshots, and platform workflows.",
   "bin": {
     "browser-workspace": "bin/browser-workspace"

package/src/browser_workspace_app/pyproject.toml

@@ -4,11 +4,11 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "browser-workspace"
-version = "0.4.5"
+version = "0.4.8"
 description = "Agent browser workspace with persistent Python sessions, tab leasing, snapshots, and platform workflows."
 requires-python = ">=3.11"
 dependencies = [
-  "browser-harness @ git+https://github.com/lalalic/browser-harness.git@80b74e116b9126f5159c84e5e05a750573e5f192",
+  "browser-harness==0.1.13",
   "cdp-use==1.4.5",
   "fetch-use==0.4.0",
   "pillow==12.3.0",

package/src/browser_workspace_app/session_client.py

@@ -6,6 +6,7 @@ from pathlib import Path
 ROOT=Path(__file__).resolve().parent
 RUNTIME_DIR=Path.home()/'.config/browser-workspace/runtime'
 SOCKET_PATH=(Path(os.environ['BROWSER_WORKSPACE_SESSION_SOCKET']) if os.environ.get('BROWSER_WORKSPACE_TEST_MODE')=='1' and os.environ.get('BROWSER_WORKSPACE_SESSION_SOCKET') else RUNTIME_DIR/'session.sock')
+HARNESS_RUNTIME_SPEC='browser-harness @ git+https://github.com/lalalic/browser-harness.git@80b74e116b9126f5159c84e5e05a750573e5f192'
 
 def package_version():
     try:
@@ -30,6 +31,13 @@ def runtime_source():
         destination=tmp/name
         if source.is_dir(): shutil.copytree(source,destination)
         else: shutil.copy2(source,destination)
+    # A published wheel installs directly under browser_workspace_app/ without
+    # a nested src/ tree. Reconstruct the build layout only in the runtime
+    # cache, never in the repository or published source tree.
+    if not (tmp/'src').exists():
+        package_root = tmp/'src'/'browser_workspace_app'
+        package_root.parent.mkdir(parents=True, exist_ok=True)
+        shutil.copytree(ROOT, package_root, ignore=shutil.ignore_patterns('__pycache__', '*.pyc', '.DS_Store'))
     (tmp/'.ready').write_text(package_version())
     shutil.rmtree(target,ignore_errors=True)
     tmp.rename(target)
@@ -53,6 +61,7 @@ def ensure_runtime_python():
         if uv:
             subprocess.run([uv,'venv','--python','3.11',str(PYTHON.parent.parent)],check=True)
             subprocess.run([uv,'pip','install','--python',str(PYTHON),'-e',str(SOURCE)],check=True)
+            subprocess.run([uv,'pip','install','--python',str(PYTHON),'--reinstall',HARNESS_RUNTIME_SPEC],check=True)
             return PYTHON
         if sys.version_info < (3,11):
             raise RuntimeError(
@@ -61,6 +70,7 @@ def ensure_runtime_python():
             )
         subprocess.run([sys.executable,'-m','venv',str(PYTHON.parent.parent)],check=True)
         subprocess.run([str(PYTHON),'-m','pip','install','-e',str(SOURCE)],check=True)
+        subprocess.run([str(PYTHON),'-m','pip','install','--force-reinstall',HARNESS_RUNTIME_SPEC],check=True)
         return PYTHON
 
 def request(payload, ensure=True):

package/src/browser_workspace_app/platform_runner.py

@@ -1,204 +0,0 @@
-#!/usr/bin/env python3
-from __future__ import annotations
-
-import json
-import re
-from pathlib import Path
-
-import yaml
-
-from session_client import request
-
-ROOT = Path(__file__).resolve().parent
-PLATFORMS = ROOT / "platforms"
-
-
-def platform_manifest(platform: str) -> dict:
-    platform = platform.strip()
-    manifest = PLATFORMS / platform / "manifest.yaml"
-    if not manifest.is_file():
-        raise FileNotFoundError(f"unknown platform: {platform}")
-    data = yaml.safe_load(manifest.read_text())
-    if not isinstance(data, dict):
-        raise ValueError(f"invalid platform manifest: {platform}")
-    return data
-
-
-def platform_profile(platform: str) -> dict:
-    data = platform_manifest(platform)
-    keys = (
-        "platform", "display_name", "aliases", "implementation_status",
-        "media", "fields", "capabilities", "content_mapping", "notes",
-    )
-    return {key: data[key] for key in keys if key in data}
-
-
-def _validate_string(name: str, value, spec: dict) -> None:
-    if value is None:
-        return
-    text = str(value)
-    minimum = spec.get("min_chars")
-    maximum = spec.get("max_chars") or spec.get("max_chars_including_tags")
-    if minimum is not None and text and len(text) < int(minimum):
-        raise ValueError(f"{name} too short: {len(text)} chars (min {minimum})")
-    if maximum is not None and len(text) > int(maximum):
-        raise ValueError(f"{name} too long: {len(text)} chars (max {maximum})")
-
-
-def validate_platform_config(platform: str, action: str, config: dict) -> None:
-    if action != "post":
-        return
-    profile = platform_profile(platform)
-    fields = profile.get("fields") or {}
-    for name, spec in fields.items():
-        if not isinstance(spec, dict) or spec.get("type") == "operation":
-            continue
-        value = config.get(name)
-        if spec.get("required") and (value is None or value == "" or value == []):
-            raise ValueError(f"{platform}: missing required field {name}")
-        if value is None:
-            continue
-        kind = spec.get("type")
-        if kind == "string":
-            _validate_string(name, value, spec)
-        elif kind == "string_list":
-            values = value if isinstance(value, list) else [x.strip() for x in str(value).split(",") if x.strip()]
-            maximum = spec.get("max_count")
-            if maximum is not None and len(values) > int(maximum):
-                raise ValueError(f"{name} has {len(values)} items (max {maximum})")
-            each = spec.get("max_chars_each")
-            if each is not None:
-                for item in values:
-                    if len(str(item)) > int(each):
-                        raise ValueError(f"{name} item too long: {item!r} (max {each})")
-            total = spec.get("max_total_chars")
-            if total is not None and sum(len(str(x)) for x in values) > int(total):
-                raise ValueError(f"{name} total length exceeds {total}")
-        elif kind == "enum":
-            values = spec.get("values") or []
-            if value not in values:
-                raise ValueError(f"{name} must be one of: {', '.join(map(str, values))}")
-
-    images_spec = (profile.get("media") or {}).get("images") or {}
-    images = config.get("images") or []
-    maximum = images_spec.get("max_count")
-    if maximum is not None and len(images) > int(maximum):
-        raise ValueError(f"images has {len(images)} items (max {maximum})")
-
-
-def declared_actions(platform: str) -> dict[str, Path]:
-    platform = platform.strip()
-    manifest = PLATFORMS / platform / "manifest.yaml"
-    if not manifest.is_file():
-        raise FileNotFoundError(f"unknown platform: {platform}")
-
-    text = manifest.read_text()
-    match = re.search(
-        r"^actions:\s*\n(?P<body>(?:^[ \t]+.*\n?)*)",
-        text,
-        flags=re.MULTILINE,
-    )
-    if not match:
-        raise ValueError(f"{platform}/manifest.yaml has no actions block")
-
-    actions: dict[str, Path] = {}
-    for line in match.group("body").splitlines():
-        entry = re.match(r'^\s{2}([\w-]+):\s*(.+?)\s*$', line)
-        if not entry:
-            continue
-        name, relative = entry.groups()
-        if len(relative) >= 2 and relative[0] == relative[-1] and relative[0] in {"\"", "'"}:
-            relative = relative[1:-1]
-        # Actions are simple relative file paths; comments and nested mappings are not runnable actions.
-        if not relative or relative.startswith(("#", "{", "[")) or " #" in relative:
-            continue
-        path = PLATFORMS / platform / relative
-        if not path.is_file():
-            raise FileNotFoundError(f"declared platform action missing: {platform}/{name} -> {relative}")
-        actions[name] = path
-    if not actions:
-        raise ValueError(f"{platform}/manifest.yaml declares no runnable actions")
-    return actions
-
-
-def action_path(platform: str, action: str) -> Path:
-    platform = platform.strip()
-    action = action.strip().replace("_", "-")
-    actions = declared_actions(platform)
-    if action not in actions:
-        raise FileNotFoundError(
-            f"unknown platform action {platform}/{action}; "
-            f"available: {', '.join(sorted(actions)) or 'none'}"
-        )
-    return actions[action]
-
-
-def prepare_action(path: Path, config_path: Path | None = None) -> str:
-    source = path.read_text()
-    source = "import sys\nsys.path.insert(0, " + repr(str(path.parent.resolve())) + ")\n" + source
-    if "__CFG_PATH__" in source:
-        if config_path is None:
-            raise ValueError(f"{path.parent.parent.name}/{path.stem}: --config is required")
-        escaped = str(config_path.resolve()).replace("\\", "\\\\").replace('"', '\\"')
-        source = source.replace("__CFG_PATH__", escaped)
-    return source
-
-
-def run_platform_action(
-    platform: str,
-    action: str,
-    *,
-    config_path: str | None = None,
-    url: str | None = None,
-    session_id: str | None = None,
-    auto_session: bool = False,
-) -> dict:
-    path = action_path(platform, action)
-    config_file = Path(config_path) if config_path else None
-    if config_file is not None:
-        config = json.loads(config_file.read_text())
-        if not isinstance(config, dict):
-            raise ValueError("platform config must be a JSON object")
-        validate_platform_config(platform, action, config)
-    code = prepare_action(path, config_file)
-
-    if not session_id and not auto_session:
-        raise ValueError(
-            "platform run requires session_id; orchestrators should use: "
-            "session start -> platform run --session-id SESSION_ID -> self-heal in the same session -> session stop. "
-            "Use auto_session=True only for a one-shot run without orchestrator self-heal."
-        )
-    if session_id and auto_session:
-        raise ValueError("session_id and auto_session are mutually exclusive")
-
-    owned_session = bool(auto_session)
-    started = request({"op": "start", "workspace": None, "url": url}) if owned_session else {"session_id": session_id, "workspace_supported": None}
-    sid = started["session_id"]
-    result = None
-    cleanup = None
-    try:
-        raw_result = request({"op": "exec", "session_id": sid, "code": code})
-        result = {k: v for k, v in raw_result.items() if k not in {"session_id", "workspace", "target_id"}}
-        output = {
-            "platform": platform,
-            "action": action,
-            "workspace_supported": started.get("workspace_supported"),
-            "session_mode": "auto_session_no_self_heal" if owned_session else "caller_owned_self_heal_capable",
-            "self_heal_capable": not owned_session,
-            "result": result,
-        }
-        if started.get("warning"):
-            output["warning"] = started["warning"]
-            output["extension_url"] = started.get("extension_url")
-        return output
-    finally:
-        if owned_session:
-            try:
-                raw_cleanup = request({"op": "stop", "session_id": sid})
-                cleanup = {k: v for k, v in raw_cleanup.items() if k not in {"session_id", "workspace", "target_id"}}
-            except Exception as exc:
-                cleanup = {"release_error": f"{type(exc).__name__}: {exc}"}
-        else:
-            cleanup = {"caller_owned_session": True}
-        if result is not None:
-            result["cleanup"] = cleanup

package/src/browser_workspace_app/platforms/chatgpt/README.md

@@ -1,60 +0,0 @@
-# ChatGPT browser platform
-
-Canonical reusable browser mechanics for ChatGPT.
-
-This platform owns ChatGPT-specific page behavior. Callers own lifecycle:
-
-- Agents Relay: disposable worker lifecycle and event/barrier ownership.
-- NeoY Tutor Workspace: persistent learner/thread lifecycle.
-
-Use Browser Workspace as the only browser-control engine. Do not duplicate ChatGPT
-selectors or submit/result-completion logic in callers.
-
-`temporary-submit` owns the reusable Temporary Chat page mechanics and verified submit receipt. Callers that need delayed cleanup should render the action source into a caller-owned Browser Workspace session and stop that session at their lifecycle barrier.
-
-## Web ChatGPT MCP apps
-
-Use the `mcp-app` action for repeatable inspection of an installed custom MCP app and for a safe tool refresh. It deliberately uses semantic text/role discovery rather than transient snapshot refs such as `e31`.
-
-```bash
-cat > /tmp/chatgpt-mcp-app.json <<'JSON'
-{"app_name":"neo","operation":"status"}
-JSON
-browser-workspace platform run chatgpt mcp-app --config /tmp/chatgpt-mcp-app.json
-```
-
-A connected app is verified by its detail page exposing `Permissions`, `Disconnect`, and `Refresh tools`. The action returns these as structured booleans.
-
-### Configure a custom MCP app
-
-The proven Web ChatGPT flow is:
-
-1. Start/reuse a Browser Workspace session on `https://chatgpt.com` and take a fresh `snapshot()` before interacting. Never reuse `eNN` refs from an earlier snapshot.
-2. Open the visible profile menu by semantic label `Open profile menu`, choose `Settings`, then choose `Plugins`. The durable settings route observed in October 2026 is `/settings/plugins-settings`, but prefer semantic navigation because routes can drift.
-3. From Plugins, use the create/add-custom-app control. Enter the app display name and its public HTTPS MCP endpoint. Keep endpoint/client/OAuth values in caller configuration; never commit credentials to this platform.
-4. Ask ChatGPT to scan/discover the MCP tools. If OAuth is advertised by the MCP server, continue the OAuth authorization flow and return to ChatGPT.
-5. Finish creating/installing the app, then reopen Settings -> Plugins and select the app by exact display name.
-6. Verify the detail page exposes `Permissions`, `Disconnect`, and `Refresh tools`. `Disconnect` is the positive signal that the account/OAuth connection is established. Run `mcp-app` with `operation=status` to capture this verification programmatically.
-7. After an MCP server descriptor/tool change, use `operation=refresh-tools`, then inspect status again before testing tool calls.
-
-### Snapshot-first fallback for UI drift
-
-If a semantic selector no longer resolves, do not guess coordinates or hard-code old refs. In the same Browser Workspace session:
-
-```python
-print(snapshot(interactive_only=False))
-```
-
-Use the fresh accessibility/DOM output to rediscover the visible control by role, accessible label, or stable text. When a menu is lazy-loaded, trigger the visible semantic control, wait for hydration, then snapshot again. This is how the profile menu -> Settings -> Plugins path was recovered during the live MCP setup.
-
-Destructive controls (`Disconnect`, `Uninstall`, `Delete app`) are intentionally not exposed as `mcp-app` operations.
-
-
-## XChat lifecycle control transfer
-
-Browser Workspace owns the ChatGPT UI mechanics for orchestrator lifecycle handoff.
-
-- `new-turn`: given stable `project_id`, `thread_id`, and `message`, wait until the current assistant turn is no longer generating, submit the continuation as the next user turn in the same thread, verify acceptance, and return without waiting for the new assistant answer.
-- `new-thread`: given stable `project_id` and `message` (plus optional `source_thread_id` provenance), open the same Project, submit the continuation to create a fresh thread, and return the durable new `thread_id` once ChatGPT replaces any temporary local id.
-
-These actions are control-transfer primitives. The generic Browser Workspace runner owns session start/stop and cleanup. Product code should pass stable Project/Thread IDs rather than persist ChatGPT URLs or DOM identities.

package/src/browser_workspace_app/platforms/chatgpt/actions/_bootstrap_start.py

@@ -1,58 +0,0 @@
-import json
-import time
-from urllib.parse import urlsplit
-
-CFG=json.load(open("__CFG_PATH__",encoding="utf-8"))
-
-def wait(pred,label,timeout=30):
-    deadline=time.time()+timeout
-    while time.time()<deadline:
-        value=pred()
-        if value:return value
-        time.sleep(.2)
-    raise RuntimeError(f"{label} not observed")
-
-def composer():
-    return js("""(() => {
-      const sels=['#prompt-textarea','[contenteditable="true"][data-composer-markdown]','[contenteditable="true"][data-lexical-editor="true"]','textarea'];
-      for(const s of sels){const e=document.querySelector(s);if(!e)continue;const r=e.getBoundingClientRect();if(r.width&&r.height)return s;}
-      return null;
-    })()""")
-
-def set_value(selector,text):
-    ok=js(f"""(() => {{
-      const e=document.querySelector({json.dumps(selector)});
-      if(!e)return false;e.focus();
-      if(e instanceof HTMLTextAreaElement || e instanceof HTMLInputElement){{
-        const p=e instanceof HTMLTextAreaElement?HTMLTextAreaElement.prototype:HTMLInputElement.prototype;
-        Object.getOwnPropertyDescriptor(p,'value')?.set?.call(e,{json.dumps(text)});
-      }}else{{
-        const sel=window.getSelection(),r=document.createRange();r.selectNodeContents(e);sel.removeAllRanges();sel.addRange(r);
-        document.execCommand('delete',false,null);document.execCommand('insertText',false,{json.dumps(text)});sel.removeAllRanges();
-      }}
-      e.dispatchEvent(new InputEvent('input',{{bubbles:true,inputType:'insertText',data:{json.dumps(text)}}}));
-      return true;
-    }})()""")
-    if not ok: raise RuntimeError("bootstrap composer could not be filled")
-
-target_id=new_tab("https://chatgpt.com/")
-wait_for_load()
-selector=wait(composer,"ChatGPT bootstrap composer",45)
-set_value(selector,CFG["instructions"])
-button=wait(lambda: js("""(() => {
-  const b=document.querySelector('button[data-testid="send-button"],button[aria-label="Send prompt"],button[aria-label="Send"],form button[type="submit"]');
-  if(!b||b.disabled||b.getAttribute('aria-disabled')==='true')return null;
-  b.setAttribute('data-neoy-bootstrap-send','1');return '[data-neoy-bootstrap-send="1"]';
-})()"""),"ChatGPT bootstrap send button",20)
-if not js("""(() => {const b=document.querySelector('[data-neoy-bootstrap-send="1"]');if(!b)return false;b.click();return true;})()"""):
-    raise RuntimeError("bootstrap send failed")
-deadline=time.time()+90
-thread_url=None
-while time.time()<deadline:
-    current=page_info().get("url","")
-    if "/c/" in urlsplit(current).path and "local-chatgpt" not in current:
-        thread_url=current.split("?",1)[0]
-        break
-    time.sleep(.25)
-if not thread_url: raise RuntimeError("bootstrap thread durable URL not observed")
-print(json.dumps({"status":"started","thread_url":thread_url,"target_id":target_id},ensure_ascii=False),flush=True)