browser-workspace 0.4.1 → 0.4.5

package/src/browser_workspace_app/platforms/microsoft-teams/actions/_meeting.py

@@ -0,0 +1,210 @@
+"""Microsoft Teams meeting browser mechanics.
+
+Keep the instant-meeting navigation in one browser action so target identity remains stable.
+"""
+
+import json
+import time
+
+CFG = json.load(open("__CFG_PATH__", encoding="utf-8"))
+ACTION = CFG.get("action", "status")
+TEAMS_URL = "https://teams.cloud.microsoft/"
+ALLOWED_ACTIONS = {"start-instant-meeting", "status", "leave"}
+
+
+def fail(message, **extra):
+    print(json.dumps({"action": ACTION, "ok": False, "error": message, **extra}, ensure_ascii=False))
+    raise SystemExit(2)
+
+
+def evidence(**extra):
+    record = {"action": ACTION, "ok": True, "url": page_info().get("url"), **extra}
+    print(json.dumps(record, ensure_ascii=False))
+    return record
+
+
+def wait_until(predicate, timeout=30.0, interval=0.25, message="condition not reached"):
+    deadline = time.monotonic() + timeout
+    while time.monotonic() < deadline:
+        value = predicate()
+        if value:
+            return value
+        time.sleep(interval)
+    fail(message, title=page_info().get("title"), url=page_info().get("url"))
+
+
+def teams_status():
+    return js("""(() => ({
+      title: document.title,
+      prejoin: !!document.querySelector('#prejoin-join-button'),
+      duration: document.querySelector('#call-duration-custom,[data-tid="call-duration"]')?.textContent || null,
+      hangup: !!document.querySelector('#hangup-button'),
+      profile: document.querySelector('#idna-me-control-avatar-trigger')?.getAttribute('aria-label') || ''
+    }))()""")
+
+
+def wait_app_bar():
+    return wait_until(
+        lambda: js("""!![...document.querySelectorAll('button')].find(
+          b => (b.getAttribute('aria-label') || '').startsWith('Calendar'))"""),
+        timeout=40,
+        message="Teams app bar did not expose Calendar",
+    )
+
+
+def click_calendar():
+    ok = js("""(() => {
+      const button = [...document.querySelectorAll('button')].find(
+        b => (b.getAttribute('aria-label') || '').startsWith('Calendar'));
+      if (!button) return false;
+      button.click();
+      return true;
+    })()""")
+    if not ok:
+        fail("Calendar button was not clickable")
+
+
+def calendar_target(parent_target):
+    def resolve():
+        targets = cdp("Target.getTargets").get("targetInfos", [])
+        matches = [
+            t for t in targets
+            if t.get("type") == "iframe"
+            and "outlook.office.com/hosted/calendar" in t.get("url", "")
+            and t.get("parentId") == parent_target
+        ]
+        return matches[0].get("targetId") if matches else None
+
+    return wait_until(resolve, timeout=30, message="Teams Calendar iframe did not become ready")
+
+
+def click_meet_now(target_id):
+    wait_until(
+        lambda: js("""!![...document.querySelectorAll('button')].find(
+          b => (b.getAttribute('aria-label') || '') === 'Start an instant Teams meeting.')""", target_id=target_id),
+        timeout=30,
+        message="Meet now button did not appear",
+    )
+    ok = js("""(() => {
+      const button = [...document.querySelectorAll('button')].find(
+        b => (b.getAttribute('aria-label') || '') === 'Start an instant Teams meeting.');
+      if (!button) return false;
+      button.click();
+      return true;
+    })()""", target_id=target_id)
+    if not ok:
+        fail("Meet now button was not clickable")
+
+
+
+
+def start_meeting_dialog(target_id):
+    """Handle Teams' intermediate 'Start a meeting now' dialog when present."""
+    def find_button():
+        return js("""(() => {
+          const buttons = [...document.querySelectorAll('button')];
+          const b = buttons.find(x => (x.innerText || '').includes('Start meeting'));
+          return !!b;
+        })()""", target_id=target_id)
+
+    try:
+        wait_until(find_button, timeout=8, message="Start meeting dialog did not appear")
+    except SystemExit:
+        return False
+
+    ok = js("""(() => {
+      const b = [...document.querySelectorAll('button')].find(
+        x => (x.innerText || '').includes('Start meeting'));
+      if (!b) return false;
+      b.click();
+      return true;
+    })()""", target_id=target_id)
+    if not ok:
+        fail("Start meeting button was not clickable")
+    return True
+
+def wait_prejoin():
+    wait_until(
+        lambda: js("!!document.querySelector('#prejoin-join-button')"),
+        timeout=40,
+        message="Meet now did not reach Teams pre-join",
+    )
+    return teams_status()
+
+
+def join_now():
+    ok = js("""(() => {
+      const button = document.querySelector('#prejoin-join-button');
+      if (!button) return false;
+      button.click();
+      return true;
+    })()""")
+    if not ok:
+        fail("Join now button was not clickable")
+
+
+def wait_in_call():
+    wait_until(
+        lambda: (lambda s: s.get("duration") or s.get("hangup"))(teams_status()),
+        timeout=40,
+        message="Teams did not reach in-call state after Join now",
+    )
+    return teams_status()
+
+
+def start_instant_meeting():
+    target = new_tab(TEAMS_URL)
+    wait_app_bar()
+    initial = teams_status()
+    click_calendar()
+    cal = calendar_target(target)
+    click_meet_now(cal)
+    start_meeting_dialog(cal)
+    try:
+        prejoin = wait_prejoin()
+    except SystemExit:
+        current = teams_status()
+        if "in a call" in (current.get("profile") or "").lower():
+            fail(
+                "account is already in a call; instant Meet now could not reach pre-join",
+                profile=current.get("profile"),
+            )
+        raise
+    join_now()
+    incall = wait_in_call()
+    return evidence(target_id=target, initial=initial, prejoin=prejoin, in_call=incall)
+
+
+def leave():
+    state = teams_status()
+    if not state.get("duration") and not state.get("hangup"):
+        return evidence(left=False, state=state)
+
+    ok = js("""(() => {
+      const button = document.querySelector('#hangup-button') ||
+        [...document.querySelectorAll('button')].find(
+          b => /leave|hang up/i.test(b.getAttribute('aria-label') || b.innerText || ''));
+      if (!button) return false;
+      button.click();
+      return true;
+    })()""")
+    if not ok:
+        fail("in-call state observed but leave/hangup control was not clickable", state=state)
+
+    wait_until(
+        lambda: not (teams_status().get("duration") or teams_status().get("hangup")),
+        timeout=20,
+        message="meeting did not exit after leave",
+    )
+    return evidence(left=True, before=state, after=teams_status())
+
+
+if ACTION not in ALLOWED_ACTIONS:
+    fail(f"unsupported action: {ACTION}")
+
+if ACTION == "start-instant-meeting":
+    start_instant_meeting()
+elif ACTION == "leave":
+    leave()
+else:
+    evidence(state=teams_status())

package/src/browser_workspace_app/platforms/microsoft-teams/flows/instant-meeting.md

@@ -0,0 +1,21 @@
+# Instant meeting
+
+Status: `verified` on 2026-10-01.
+
+Preconditions:
+- Microsoft Teams is already authenticated in the browser context.
+- The action may create and join a real meeting.
+
+Canonical flow:
+1. Open `https://teams.cloud.microsoft/`.
+2. Wait for the left application rail.
+3. Click **Calendar**.
+4. Resolve the hosted calendar target/iframe when required.
+5. Click **Meet now**.
+6. If the intermediate dialog appears, click **Start meeting**.
+7. Wait for pre-join.
+8. Click **Join now**.
+9. Verify in-call state using call duration or hangup controls.
+10. When cleanup is requested, click leave/hangup and verify the call controls disappear.
+
+Do not identify browser ownership by URL. Do not touch unrelated tabs when the account is already in another call.

package/src/browser_workspace_app/platforms/microsoft-teams/manifest.yaml

@@ -0,0 +1,25 @@
+platform: microsoft-teams
+status: verified
+last_verified: 2026-10-01
+actions:
+  meeting: "actions/_meeting.py"
+verification:
+  status: verified
+  last_verified: 2026-10-01
+  evidence: "Live E2E verified Calendar -> Meet now -> Start meeting -> pre-join -> Join now -> in-call and meeting exit on teams.cloud.microsoft. Generic platform-runner status execution and automatic tab cleanup were also live-verified on 2026-10-01."
+url_patterns:
+  - "https://teams.cloud.microsoft/*"
+  - "https://outlook.office.com/hosted/calendar/*"
+authentication:
+  required: true
+  notes: "Use an already authenticated Microsoft Teams browser context; never store credentials or session state."
+side_effects:
+  - "start-instant-meeting can create and join a real Teams meeting"
+  - "leave exits the current meeting"
+provenance:
+  source: "Live Browser Workspace exploration for MeetMate E2E"
+  migrated_code: false
+flows:
+  instant-meeting: {status: verified, evidence: "Live verified through in-call state on 2026-10-01."}
+  meeting-status: {status: verified, evidence: "Live call state observed via call duration and hangup controls."}
+  leave: {status: verified, evidence: "Live E2E exited the test meeting cleanly."}

package/src/browser_workspace_app/platforms/microsoft-teams/tests/test_contract.py

@@ -0,0 +1,24 @@
+from pathlib import Path
+
+ROOT = Path(__file__).resolve().parents[1]
+ACTION = (ROOT / "actions" / "_meeting.py").read_text()
+README = (ROOT / "README.md").read_text()
+MANIFEST = (ROOT / "manifest.yaml").read_text()
+
+
+def test_canonical_instant_meeting_path():
+    assert "Calendar -> Meet now -> Start meeting (when shown) -> pre-join -> Join now" in README
+    assert "Start an instant Teams meeting." in ACTION
+    assert "#prejoin-join-button" in ACTION
+    assert "Start meeting" in ACTION
+    assert "#call-duration-custom" in ACTION
+
+
+def test_action_uses_browser_helper_path():
+    assert "new_tab(TEAMS_URL)" in ACTION
+    assert "websocket" not in ACTION.lower()
+
+
+def test_manifest_declares_side_effects():
+    assert "instant-meeting" in MANIFEST
+    assert "real Teams meeting" in MANIFEST

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

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

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

@@ -0,0 +1,180 @@
+import time, json
+
+CFG = json.load(open("__CFG_PATH__"))
+
+total_steps = 7
+step = [0]
+def next_step(label):
+    step[0] += 1
+    print(f"[{step[0]}/{total_steps}] {label}")
+
+next_step("Opening TikTok upload page...")
+new_tab("https://www.tiktok.com/creator#/upload?scene=creator_center")
+wait_for_load()
+time.sleep(5)
+
+url = page_info()["url"]
+if "login" in url.lower() or "accounts" in url.lower():
+    print("ERROR: Not logged in. Log in at tiktok.com first.")
+    capture_screenshot()
+    raise SystemExit(1)
+
+# Check for uid null error (not logged in)
+# The page loads but shows login modal if not authenticated
+login_check = js('document.querySelector("[class*=login-modal],[class*=LoginModal]") ? "login" : "ok"')
+if login_check == "login":
+    print("ERROR: Login modal detected. Log in at tiktok.com first.")
+    capture_screenshot()
+    raise SystemExit(1)
+
+# Wait for upload area to appear
+for i in range(15):
+    found = js('document.querySelector("input[type=file],input[accept*=video],[class*=upload-btn],[class*=upload-card]") ? "found" : "wait"')
+    if found == "found":
+        break
+    time.sleep(2)
+else:
+    print("ERROR: Upload area not found. May not be logged in.")
+    capture_screenshot()
+    raise SystemExit(1)
+
+print("  -> Logged in, page loaded.")
+
+next_step("Uploading video: " + CFG["video"])
+# TikTok has a file input, may be hidden — try multiple selectors
+try:
+    upload_file("input[type=file]", CFG["video"])
+except Exception:
+    # Fallback: find input via DOM search
+    doc = cdp("DOM.getDocument", depth=-1, pierce=True)
+    sr = cdp("DOM.performSearch", query='input[type="file"]')
+    if sr.get("resultCount", 0) > 0:
+        nodes = cdp("DOM.getSearchResults", searchId=sr["searchId"], fromIndex=0, toIndex=1)
+        nid = nodes["nodeIds"][0]
+        cdp("DOM.setFileInputFiles", files=[CFG["video"]], nodeId=nid)
+        cdp("DOM.discardSearchResults", searchId=sr["searchId"])
+    else:
+        print("ERROR: Cannot find file input.")
+        capture_screenshot()
+        raise SystemExit(1)
+
+next_step("Waiting for video upload + processing...")
+for attempt in range(120):
+    time.sleep(5)
+    # Check for upload completion indicators
+    done = js('''
+        (function() {
+            var indicators = document.querySelectorAll("[class*=progress],[class*=percent],[class*=upload-progress]");
+            for (var i = 0; i < indicators.length; i++) {
+                var t = indicators[i].textContent;
+                if (t && (t.indexOf("100") >= 0 || t.indexOf("Complete") >= 0 || t.indexOf("Done") >= 0)) return "done";
+            }
+            // Check if caption editor appeared (means upload accepted)
+            if (document.querySelector("[class*=caption],[class*=editor] [contenteditable],[data-text=true]")) return "done";
+            return "uploading";
+        })()
+    ''')
+    if done == "done":
+        print("  -> Upload done!")
+        break
+    if attempt % 6 == 5:
+        pct = js('var el=document.querySelector("[class*=progress-text],[class*=percent]"); el ? el.textContent.trim() : "..."')
+        print(f"  -> Uploading... {pct} ({(attempt+1)*5}s)")
+else:
+    print("WARNING: Upload may still be processing.")
+    capture_screenshot()
+time.sleep(3)
+
+next_step("Setting caption...")
+caption_escaped = json.dumps(CFG["caption"])
+# TikTok uses a contenteditable div or DraftJS editor for caption
+js('''
+    (function() {
+        var ed = document.querySelector("[class*=caption-editor] [contenteditable],[class*=notranslate][contenteditable],[data-text=true],.DraftEditor-root [contenteditable],[class*=editor-container] [contenteditable]");
+        if (!ed) ed = document.querySelector("[contenteditable=true]");
+        if (ed) {
+            ed.focus();
+            ed.textContent = ''' + caption_escaped + ''';
+            ed.dispatchEvent(new Event("input", {bubbles: true}));
+        }
+    })()
+''')
+time.sleep(1)
+
+# Set visibility if not public
+if CFG["visibility"] != "public":
+    next_step("Setting visibility to " + CFG["visibility"] + "...")
+    # Click "Who can watch this video" dropdown
+    js('''
+        (function() {
+            var selects = document.querySelectorAll("[class*=select],[class*=dropdown],[class*=visibility]");
+            for (var i = 0; i < selects.length; i++) {
+                var t = selects[i].textContent;
+                if (t && (t.indexOf("Everyone") >= 0 || t.indexOf("Public") >= 0 || t.indexOf("Friends") >= 0)) {
+                    selects[i].click();
+                    break;
+                }
+            }
+        })()
+    ''')
+    time.sleep(1)
+    # Map visibility to TikTok's menu options
+    vis_map = {"friends": "Friends", "private": "Only me"}
+    vis_text = vis_map.get(CFG["visibility"], "Everyone")
+    js('var opts=document.querySelectorAll("[class*=option],[class*=menu-item],[role=option]");for(var i=0;i<opts.length;i++){if(opts[i].textContent.indexOf("' + vis_text + '")>=0){opts[i].click();break}};""')
+    time.sleep(1)
+else:
+    next_step("Visibility: public (default)")
+
+# Toggle social features if needed
+toggles_changed = []
+if not CFG.get("allow_comments", True):
+    toggles_changed.append("comments off")
+if not CFG.get("allow_duets", True):
+    toggles_changed.append("duets off")
+if not CFG.get("allow_stitch", True):
+    toggles_changed.append("stitch off")
+
+if toggles_changed:
+    next_step("Adjusting toggles: " + ", ".join(toggles_changed))
+    # TikTok has toggle switches for comments, duets, stitch
+    js('''
+        (function() {
+            var toggles = document.querySelectorAll("[class*=toggle],[class*=switch]");
+            var labels = ["comment", "duet", "stitch"];
+            var states = [''' + json.dumps(CFG.get("allow_comments", True)) + ''', ''' + json.dumps(CFG.get("allow_duets", True)) + ''', ''' + json.dumps(CFG.get("allow_stitch", True)) + '''];
+            toggles.forEach(function(t) {
+                var text = (t.closest("[class*=form-item],[class*=setting]") || t.parentElement).textContent.toLowerCase();
+                for (var i = 0; i < labels.length; i++) {
+                    if (text.indexOf(labels[i]) >= 0) {
+                        var isOn = t.classList.contains("on") || t.getAttribute("aria-checked") === "true" || t.querySelector("[class*=active]");
+                        if (isOn !== states[i]) t.click();
+                    }
+                }
+            });
+        })()
+    ''')
+    time.sleep(1)
+else:
+    next_step("Social features: defaults (all enabled)")
+
+capture_screenshot()
+
+next_step("Posting video...")
+# Click the Post button
+js('''
+    (function() {
+        var btns = document.querySelectorAll("button,[class*=btn-post],[class*=post-button]");
+        for (var i = 0; i < btns.length; i++) {
+            var t = btns[i].textContent.trim();
+            if (t === "Post" || t === "发布") {
+                btns[i].click();
+                return;
+            }
+        }
+    })()
+''')
+time.sleep(5)
+
+capture_screenshot()
+print("Done! Video posted to TikTok.")

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

@@ -0,0 +1,99 @@
+platform: tiktok
+status: migrated_unverified
+last_verified: null
+actions:
+  post: actions/_post.py
+verification:
+  status: migrated_unverified
+  last_verified: null
+  evidence: Existing upload mechanics migrated from the working post adapter. Current
+    Browser Workspace live verification pending.
+url_patterns:
+- https://www.tiktok.com/creator*
+authentication:
+  required: true
+  notes: Use the caller's authenticated browser context; never store credentials.
+provenance:
+  source: skills/post/scripts/platforms/tiktok
+  migrated_code: true
+flows:
+  post:
+    status: migrated_unverified
+    evidence: Migrated action; current Browser Workspace live verification pending.
+display_name: TikTok
+aliases: []
+media:
+  modes:
+  - video
+  video:
+    required: true
+    formats:
+    - mp4
+    max_size_gb: 10
+    max_duration_minutes: 10
+fields:
+  caption:
+    cli: --caption
+    required: true
+    type: string
+    max_chars_including_tags: 4000
+    implemented: true
+  tags:
+    cli: --tags
+    required: false
+    type: string_list
+    max_count: 10
+    implemented: true
+    render: 'append as #tag'
+  cover:
+    cli: --cover
+    required: false
+    type: file
+    implemented: false
+    status: cli_only
+    note: The migrated CLI validates the file but the browser body does not currently
+      apply it.
+  visibility:
+    cli: --visibility
+    required: false
+    type: enum
+    values:
+    - public
+    - friends
+    - private
+    default: public
+    implemented: true
+  allow_comments:
+    cli: --no-comments
+    required: false
+    type: boolean
+    default: true
+    implemented: true
+  allow_duets:
+    cli: --no-duets
+    required: false
+    type: boolean
+    default: true
+    implemented: true
+  allow_stitch:
+    cli: --no-stitch
+    required: false
+    type: boolean
+    default: true
+    implemented: true
+capabilities:
+  draft: false
+  publish: true
+  visibility: true
+  custom_thumbnail: false
+  social_interaction_controls: true
+  post_status: false
+  read_comments: false
+  write_comment: false
+  reply_comments: false
+content_mapping:
+  headline: null
+  main_text: caption
+  discovery_terms: tags
+notes:
+- The current adapter performs the final Post action; it has no draft mode.

package/src/browser_workspace_app/platforms/wechat-channels/README.md

@@ -0,0 +1,10 @@
+---
+name: wechat-channels-platform
+description: "WeChat Channels Browser Workspace posting and manager assets."
+---
+
+# WeChat Channels
+
+Use the parent Browser Workspace skill contract first. The
+`actions/` directory is the canonical home for the migrated posting,
+manager, and shadow-DOM helper mechanics used by `skills/post`.