browser-workspace 0.4.2 → 0.4.5

package/src/browser_workspace_app/platforms/xhs/manifest.yaml

@@ -0,0 +1,107 @@
+platform: xhs
+status: migrated_unverified
+last_verified: null
+actions:
+  post: "actions/_post.py"
+  manage: "actions/_manage.py"
+verification:
+  status: migrated_unverified
+  last_verified: null
+  evidence: Existing post and creator-manager mechanics migrated from the working
+    post adapter. Current Browser Workspace live verification pending.
+url_patterns:
+- https://creator.xiaohongshu.com/*
+authentication:
+  required: true
+  notes: Use the caller's authenticated browser context; never store credentials.
+provenance:
+  source: skills/post/scripts/platforms/xhs
+  migrated_code: true
+flows:
+  post:
+    status: migrated_unverified
+    evidence: Migrated action; current Browser Workspace live verification pending.
+  manage:
+    status: migrated_unverified
+    evidence: Migrated manager action; current Browser Workspace live verification
+      pending.
+display_name: Xiaohongshu
+aliases:
+- xiaohongshu
+media:
+  modes:
+  - video
+  - images
+  video:
+    required_when_mode: video
+    formats:
+    - mp4
+  images:
+    required_when_mode: images
+    formats:
+    - jpg
+    - png
+    - webp
+    max_count: 18
+  mutually_exclusive:
+  - video
+  - images
+fields:
+  title:
+    cli: --title
+    required: true
+    type: string
+    max_chars: 20
+    implemented: true
+  body:
+    cli: --body
+    required: true
+    type: string
+    max_chars: 1000
+    implemented: true
+  tags:
+    cli: --tags
+    required: false
+    type: string_list
+    max_count: 5
+    implemented: true
+    render: 'append as #tag'
+  publish:
+    cli: --publish
+    required: false
+    type: boolean
+    default: false
+    implemented: true
+  collection:
+    required: false
+    type: string
+    max_chars: 20
+    implemented: true
+  collection_description:
+    required: false
+    type: string
+    max_chars: 50
+    implemented: true
+capabilities:
+  draft: true
+  publish: true
+  visibility: false
+  custom_thumbnail: false
+  series_or_collection: true
+  post_status: true
+  read_comments: true
+  write_comment: true
+  reply_comments: true
+content_mapping:
+  headline: title
+  main_text: body
+  discovery_terms: tags
+notes:
+- Without --publish, the adapter saves a draft.
+- After --publish, the XHS adapter automatically verifies the created note in creator
+  note manager and reports published/reviewing/rejected state.
+- comments/comment/reply resolve the post from the signed-in My Posts profile list
+  and use that card's live xsec detail route.
+- The opened post detail view is the canonical place to read comments, write a top-level
+  comment, and reply to comments.
+- Optional `collection` selects an existing exact-name collection or creates and joins it when absent.

package/src/browser_workspace_app/platforms/xhs/tests/test_contract.py

@@ -0,0 +1,34 @@
+from pathlib import Path
+
+
+HERE = Path(__file__).resolve().parents[1]
+
+
+def test_actions_do_not_use_page_info_as_tab_url_authority():
+    for name in ("_post.py", "_manage.py"):
+        source = (HERE / "actions" / name).read_text()
+        assert 'page_info()["url"]' not in source
+
+
+def test_actions_use_current_tab_url_for_navigation_identity():
+    post = (HERE / "actions" / "_post.py").read_text()
+    manage = (HERE / "actions" / "_manage.py").read_text()
+    assert '(current_tab().get("url") or "") != url' in post
+    assert '(current_tab().get("url") or "") != url' in manage
+
+
+def test_video_readiness_uses_editor_state_not_preview():
+    source=(HERE/'actions'/'_post.py').read_text()
+    assert '上传中' in source
+    assert '重新上传' in source
+    assert 'Upload processed and editor-ready!' in source
+
+def test_collection_and_receipt_contracts_are_present():
+    source=(HERE/'actions'/'_post.py').read_text()
+    manifest=(HERE/'manifest.yaml').read_text()
+    assert 'choose_collection' in source
+    assert 'creator_manager_receipt' in source
+    assert 'XHS_RECEIPT' in source
+    assert 'duplicate_count' in source
+    assert 'series_or_collection: true' in manifest
+    assert 'collection:' in manifest

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

@@ -0,0 +1,10 @@
+---
+name: youtube-platform
+description: "YouTube Studio Browser Workspace upload mechanics."
+---
+
+# YouTube
+
+Use the parent Browser Workspace skill contract first. The
+`actions/` directory contains the canonical migrated Studio upload
+mechanics; `skills/post` retains payload and publishing orchestration.

package/src/browser_workspace_app/platforms/youtube/actions/_post.py

@@ -0,0 +1,103 @@
+import time, json
+
+CFG = json.load(open("__CFG_PATH__"))
+
+tags = CFG.get("tags", [])
+thumbnail = CFG.get("thumbnail", "")
+has_extras = bool(tags or thumbnail)
+total_steps = 7 + (1 if tags else 0) + (1 if thumbnail else 0)
+step = [0]
+def next_step(label):
+    step[0] += 1
+    print(f"[{step[0]}/{total_steps}] {label}")
+
+def click_btn(text):
+    text_s = json.dumps(text)
+    for _ in range(5):
+        clicked = js(
+            '(function(){ var btns=document.querySelectorAll("ytcp-button"); '
+            'var b=Array.from(btns).find(function(el){return el.textContent.trim()===' + text_s + ' && !el.disabled;}); '
+            'if(!b)return false; b.click(); return true; })()'
+        )
+        if clicked:
+            return True
+        time.sleep(1)
+    return False
+
+next_step("Opening YouTube Studio upload...")
+new_tab("https://www.youtube.com/upload")
+wait_for_load()
+time.sleep(3)
+
+url = page_info()["url"]
+if "accounts.google.com" in url:
+    print("ERROR: Not logged in")
+    capture_screenshot()
+    raise SystemExit(1)
+
+next_step("Uploading video...")
+upload_file("input[type=file]", CFG["video"])
+time.sleep(5)
+
+next_step("Waiting for processing...")
+time.sleep(3)
+
+next_step("Setting title: " + CFG["title"])
+title_escaped = json.dumps(CFG["title"])
+js('var b=document.querySelectorAll("#textbox")[0];b.textContent=' + title_escaped + ';b.dispatchEvent(new Event("input",{bubbles:true}));""')
+time.sleep(0.5)
+
+next_step("Setting description...")
+desc_escaped = json.dumps(CFG["desc"])
+js('var b=document.querySelectorAll("#textbox")[1];b.textContent=' + desc_escaped + ';b.dispatchEvent(new Event("input",{bubbles:true}));""')
+time.sleep(0.5)
+
+# Upload thumbnail if provided
+if thumbnail:
+    next_step("Uploading thumbnail...")
+    # Click "Upload thumbnail" button to reveal file input
+    js('var btn=document.querySelector("#still-picker ytcp-button,#upload-prompt");if(btn)btn.click();""')
+    time.sleep(1)
+    upload_file("#file-loader input[type=file],input[accept*=image]", thumbnail)
+    time.sleep(3)
+
+# Add tags via "Show more" → tags input
+if tags:
+    next_step("Adding tags: " + ", ".join(tags))
+    # Expand "Show more" section
+    js('var btn=document.querySelector("#toggle-button ytcp-button,ytcp-button#toggle-button");if(btn)btn.click();""')
+    time.sleep(1)
+    # Find tags input and type comma-separated tags
+    tag_str = ",".join(tags)
+    tag_escaped = json.dumps(tag_str)
+    js('var inp=document.querySelector("input.tags-input,input[aria-label*=Tag],input[placeholder*=Tag]");if(inp){var ns=Object.getOwnPropertyDescriptor(HTMLInputElement.prototype,"value").set;ns.call(inp,' + tag_escaped + ');inp.dispatchEvent(new Event("input",{bubbles:true}));inp.dispatchEvent(new Event("change",{bubbles:true}))};"done"')
+    time.sleep(0.5)
+
+next_step("Setting audience" + (" (MADE FOR KIDS)" if CFG.get("made_for_kids") else "") + " + advancing wizard...")
+if CFG.get("made_for_kids"):
+    # COPPA: select explicitly by name — never rely on radio order
+    js('var r=document.querySelector("tp-yt-paper-radio-button[name=VIDEO_MADE_FOR_KIDS_MFK]");if(r){r.click()}')
+else:
+    js('var g=document.querySelector(".made-for-kids-group");if(g){g.querySelectorAll("tp-yt-paper-radio-button")[1].click()}')
+time.sleep(1)
+
+for w_step in ["Video elements", "Initial check", "Visibility"]:
+    print("  -> " + w_step)
+    click_btn("Next")
+    time.sleep(2)
+
+vis = CFG["vis"]
+next_step("Setting visibility to " + vis + " and saving...")
+for _ in range(5):
+    found = js('document.querySelector("[name=' + vis + ']") ? "found" : "notfound"')
+    if found == "found":
+        js('document.querySelector("[name=' + vis + ']").click()')
+        time.sleep(1)
+        break
+    time.sleep(1)
+
+click_btn("Save")
+time.sleep(5)
+
+capture_screenshot()
+print("Done! Video saved as " + vis + ".")

package/src/browser_workspace_app/platforms/youtube/manifest.yaml

@@ -0,0 +1,94 @@
+platform: youtube
+status: migrated_unverified
+last_verified: null
+actions:
+  post: actions/_post.py
+verification:
+  status: migrated_unverified
+  last_verified: null
+  evidence: Existing Studio upload mechanics migrated from the working post adapter.
+    Current Browser Workspace live verification pending.
+url_patterns:
+- https://www.youtube.com/upload
+- https://studio.youtube.com/*
+authentication:
+  required: true
+  notes: Use the caller's authenticated browser context; never store credentials.
+provenance:
+  source: skills/post/scripts/platforms/youtube
+  migrated_code: true
+flows:
+  post:
+    status: migrated_unverified
+    evidence: Migrated action; current Browser Workspace live verification pending.
+display_name: YouTube
+aliases:
+- yt
+media:
+  modes:
+  - video
+  video:
+    required: true
+fields:
+  title:
+    cli: --title
+    required: true
+    type: string
+    max_chars: 100
+    implemented: true
+  desc:
+    cli: --desc
+    required: false
+    type: string
+    max_chars: 5000
+    implemented: true
+  tags:
+    cli: --tags
+    required: false
+    type: string_list
+    max_total_chars: 500
+    max_chars_each: 30
+    implemented: true
+  thumbnail:
+    cli: --thumbnail
+    required: false
+    type: file
+    formats:
+    - jpg
+    - png
+    max_size_mb: 2
+    implemented: true
+  visibility:
+    cli_group:
+    - --private
+    - --unlisted
+    - --public
+    required: false
+    type: enum
+    values:
+    - PRIVATE
+    - UNLISTED
+    - PUBLIC
+    default: PRIVATE
+    implemented: true
+  made_for_kids:
+    cli: --made-for-kids
+    required: false
+    type: boolean
+    default: false
+    implemented: true
+capabilities:
+  draft: false
+  publish: true
+  visibility: true
+  custom_thumbnail: true
+  audience_made_for_kids: true
+  post_status: false
+  read_comments: false
+  write_comment: false
+  reply_comments: false
+content_mapping:
+  headline: title
+  main_text: desc
+  discovery_terms: tags
+  visual_packaging: thumbnail

package/src/browser_workspace_app/pyproject.toml

@@ -0,0 +1,33 @@
+[build-system]
+requires = ["setuptools==84.0.0"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "browser-workspace"
+version = "0.4.5"
+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",
+  "cdp-use==1.4.5",
+  "fetch-use==0.4.0",
+  "pillow==12.3.0",
+  "PyYAML==6.0.2",
+  "websockets==15.0.1",
+]
+
+[project.scripts]
+browser-workspace = "browser_workspace_app.cli:main"
+
+[tool.setuptools]
+package-dir = {"" = "src"}
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.setuptools.package-data]
+browser_workspace_app = ["**/*"]
+
+[tool.pytest.ini_options]
+pythonpath = ["src"]
+addopts = "--import-mode=importlib"

package/src/browser_workspace_app/session_client.py

@@ -0,0 +1,107 @@
+#!/usr/bin/env python3
+from __future__ import annotations
+import fcntl, json, os, shutil, socket, subprocess, sys, time
+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')
+
+def package_version():
+    try:
+        return json.loads((ROOT/'package.json').read_text()).get('version','dev')
+    except Exception:
+        return 'dev'
+
+def runtime_source():
+    configured=os.environ.get('BROWSER_WORKSPACE_RUNTIME_SOURCE')
+    if configured: return Path(configured)
+    if not (ROOT/'package.json').exists(): return ROOT
+    target=RUNTIME_DIR/'packages'/package_version()
+    marker=target/'.ready'
+    if marker.exists(): return target
+    target.parent.mkdir(parents=True,exist_ok=True)
+    tmp=target.with_name(target.name+'.tmp')
+    shutil.rmtree(tmp,ignore_errors=True)
+    tmp.mkdir(parents=True)
+    for name in ['pyproject.toml','session_daemon.py','session_client.py','platform_runner.py','managed_chrome.py','src','agent-workspace','interaction-skills','platforms','extension','licenses']:
+        source=ROOT/name
+        if not source.exists(): continue
+        destination=tmp/name
+        if source.is_dir(): shutil.copytree(source,destination)
+        else: shutil.copy2(source,destination)
+    (tmp/'.ready').write_text(package_version())
+    shutil.rmtree(target,ignore_errors=True)
+    tmp.rename(target)
+    return target
+
+SOURCE=runtime_source()
+PYTHON=Path(os.environ.get('BROWSER_WORKSPACE_SESSION_PYTHON',RUNTIME_DIR/'venv'/package_version()/'bin/python'))
+
+
+
+def ensure_runtime_python():
+    if PYTHON.exists():
+        return PYTHON
+    RUNTIME_DIR.mkdir(parents=True, exist_ok=True)
+    lock_path=RUNTIME_DIR/'runtime-bootstrap.lock'
+    with open(lock_path,'a+b') as lock:
+        fcntl.flock(lock,fcntl.LOCK_EX)
+        if PYTHON.exists():
+            return PYTHON
+        uv=shutil.which('uv')
+        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)
+            return PYTHON
+        if sys.version_info < (3,11):
+            raise RuntimeError(
+                'Browser Workspace needs Python 3.11+ for first-use bootstrap. '
+                'Install uv or Python 3.11+, then retry.'
+            )
+        subprocess.run([sys.executable,'-m','venv',str(PYTHON.parent.parent)],check=True)
+        subprocess.run([str(PYTHON),'-m','pip','install','-e',str(SOURCE)],check=True)
+        return PYTHON
+
+def request(payload, ensure=True):
+    if ensure: ensure_daemon()
+    s=socket.socket(socket.AF_UNIX,socket.SOCK_STREAM)
+    try: s.connect(str(SOCKET_PATH))
+    except Exception:
+        s.close(); raise
+    with s:
+        f=s.makefile('rwb'); f.write((json.dumps(payload,ensure_ascii=False)+'\n').encode()); f.flush(); line=f.readline()
+    if not line: raise RuntimeError('browser-workspace session daemon closed without a response')
+    return json.loads(line)
+
+def ping():
+    try: return request({'op':'ping'},ensure=False)
+    except Exception: return None
+
+def owner_is_running():
+    """An exclusive owner lock means a live daemon already exists."""
+    owner_path=RUNTIME_DIR/'session.lock'
+    with open(owner_path,'a+b') as owner:
+        try:
+            fcntl.flock(owner,fcntl.LOCK_EX|fcntl.LOCK_NB)
+        except BlockingIOError:
+            return True
+        finally:
+            try: fcntl.flock(owner,fcntl.LOCK_UN)
+            except OSError: pass
+    return False
+
+def ensure_daemon():
+    p=ping()
+    if p and p.get('ok'): return p
+    RUNTIME_DIR.mkdir(parents=True,exist_ok=True)
+    if owner_is_running():
+        raise RuntimeError('browser-workspace daemon is alive but its socket is unreachable; refusing duplicate startup')
+    runtime_python=ensure_runtime_python()
+    log=open(RUNTIME_DIR/'session-daemon.log','ab',buffering=0)
+    subprocess.Popen([str(runtime_python),str(SOURCE/'session_daemon.py')],stdin=subprocess.DEVNULL,stdout=log,stderr=log,start_new_session=True,close_fds=True)
+    deadline=time.time()+15
+    while time.time()<deadline:
+        time.sleep(.1); p=ping()
+        if p and p.get('ok'): return p
+    raise RuntimeError(f'browser-workspace session daemon did not start; see {RUNTIME_DIR / "session-daemon.log"}')