browser-workspace 0.4.0

package/platforms/chatgpt/actions/_new_turn.py

@@ -0,0 +1,33 @@
+import json
+from urllib.parse import quote, urlsplit
+import _lifecycle_common as lifecycle_common
+
+lifecycle_common.js = js
+lifecycle_common.fill_input = fill_input
+wait_for_idle = lifecycle_common.wait_for_idle
+submit = lifecycle_common.submit
+
+CFG=json.load(open("__CFG_PATH__",encoding="utf-8"))
+project_id=str(CFG.get("project_id") or "").strip() or None
+thread_id=str(CFG.get("thread_id") or "").strip()
+message=str(CFG.get("message") or "").strip()
+if not thread_id: raise RuntimeError("thread_id is required")
+if not message: raise RuntimeError("message is required")
+if project_id:
+    thread_url=f"https://chatgpt.com/g/{quote(project_id,safe='')}/c/{quote(thread_id,safe='')}"
+else:
+    thread_url=f"https://chatgpt.com/c/{quote(thread_id,safe='')}"
+goto_url(thread_url)
+wait_for_load()
+if urlsplit(page_info().get("url","")).path.rstrip("/") != urlsplit(thread_url).path.rstrip("/"):
+    raise RuntimeError("ChatGPT thread redirect mismatch")
+wait_for_idle(timeout=int(CFG.get("wait_timeout",300)))
+receipt=submit(message)
+print(json.dumps({
+  "status":"submitted",
+  "mode":"new-turn",
+  "project_id":project_id,
+  "thread_id":thread_id,
+  "verified_by":receipt["verified_by"],
+  "user_message_id":receipt["turn"].get("id") or None,
+},ensure_ascii=False),flush=True)

package/platforms/chatgpt/actions/_project_setup.py

@@ -0,0 +1,353 @@
+import json
+import re
+import time
+from urllib.parse import urlsplit
+
+
+CFG = json.load(open("__CFG_PATH__", encoding="utf-8"))
+
+def _norm(value):
+    return re.sub(r"\s+", " ", str(value or "")).strip()
+
+def _candidate(selector, patterns, root_expr="document"):
+    wanted=[p.lower() for p in patterns]
+    return js(f"""(() => {{
+      const root={root_expr};
+      const wanted={json.dumps(wanted)};
+      const nodes=[...root.querySelectorAll({json.dumps(selector)})];
+      const e=nodes.find(el=>{{
+        const text=((el.innerText||el.textContent||el.getAttribute('aria-label')||'')+'').replace(/\\s+/g,' ').trim().toLowerCase();
+        return wanted.some(p=>text===p||text.includes(p));
+      }});
+      if(!e) return false; e.click(); return true;
+    }})()""")
+
+def _wait(predicate, label, timeout=15):
+    deadline=time.time()+timeout
+    last=None
+    while time.time()<deadline:
+        try:
+            last=predicate()
+            if last:
+                return last
+        except Exception:
+            pass
+        time.sleep(.15)
+    raise RuntimeError(f"{label} not found")
+
+def _project_from_url(url):
+    m=re.search(r"/g/(g-p-[A-Za-z0-9]{32})(?:-[^/]+)?(?:/|$)", url or "")
+    return m.group(1) if m else None
+
+def _project_links():
+    return js("""(() => [...document.querySelectorAll('a[href]')].map(a=>({
+      text:(a.innerText||a.textContent||'').replace(/\s+/g,' ').trim(),
+      href:new URL(a.getAttribute('href'),location.origin).href
+    })).filter(x=>/\/g\/g-p-[A-Za-z0-9]{32}/.test(x.href)))()""") or []
+
+def _ensure_project(name):
+    wanted=_norm(name).lower()
+
+    # ChatGPT hydrates the sidebar asynchronously after the main page reports loaded.
+    # Open it when needed, then give the requested existing Project time to appear
+    # before treating the always-earlier "Add new project" control as proof of absence.
+    def project_surface():
+        return js("""(() => {
+          const rows=[...document.querySelectorAll('[data-app-action-sidebar-project-row]')];
+          if(rows.length) return 'rows';
+          const add=[...document.querySelectorAll('button,[role="button"]')].find(e=>(e.getAttribute('aria-label')||'').toLowerCase().includes('add new project'));
+          if(add) return 'add';
+          const show=[...document.querySelectorAll('button,[role="button"]')].find(e=>(e.getAttribute('aria-label')||'').toLowerCase()==='show sidebar');
+          if(show){ show.click(); return 'opening'; }
+          return '';
+        })()""")
+    _wait(project_surface, "ChatGPT Projects sidebar", 20)
+
+    def existing_project():
+        return js(f"""(() => {{
+          const wanted={json.dumps(wanted)};
+          const rows=[...document.querySelectorAll('[data-app-action-sidebar-project-row]')];
+          const row=rows.find(e=>(e.getAttribute('data-app-action-sidebar-project-label')||'').replace(/\\s+/g,' ').trim().toLowerCase()===wanted);
+          return row ? {{
+            projectId:row.getAttribute('data-app-action-sidebar-project-id')||'',
+            label:row.getAttribute('data-app-action-sidebar-project-label')||''
+          }} : null;
+        }})()""")
+
+    existing=None
+    deadline=time.time()+10
+    while time.time()<deadline:
+        existing=existing_project()
+        if existing and existing.get("projectId"):
+            break
+        time.sleep(.2)
+    if existing and existing.get("projectId"):
+        project_url=f"https://chatgpt.com/g/{existing['projectId']}/project"
+        goto_url(project_url)
+        wait_for_load()
+        return {"project_id":existing["projectId"],"project_url":page_info().get("url",project_url),"reused":True}
+
+    # Legacy fallback for older ChatGPT Project sidebar surfaces.
+    for item in _project_links():
+        if _norm(item.get("text")).lower()==wanted:
+            pid=_project_from_url(item["href"])
+            project_url=f"https://chatgpt.com/g/{pid}/project" if pid else item["href"]
+            goto_url(project_url)
+            wait_for_load()
+            return {"project_id":pid,"project_url":page_info().get("url",project_url),"reused":True}
+
+    clicked=bool(js("""(() => {
+      const b=[...document.querySelectorAll('button')].find(b=>(b.getAttribute('aria-label')||'').toLowerCase().includes('add new project'));
+      if(!b)return false;b.click();return true;
+    })()"""))
+    if not clicked:
+        clicked=_candidate('button,a,[role="button"]',['new project','create project'])
+    if not clicked:
+        raise RuntimeError(f"ChatGPT New Project control was not found for {name}")
+
+    selector=_wait(lambda: js("""(() => {
+      const visible=e=>{const r=e.getBoundingClientRect();return !!(r.width&&r.height)};
+      const e=[...document.querySelectorAll('input[type="text"],input:not([type]),textarea')]
+        .find(e=>visible(e)&&/project name|copenhagen trip/i.test((e.getAttribute('aria-label')||'')+' '+(e.getAttribute('placeholder')||''))) ||
+        [...document.querySelectorAll('input[type="text"],input:not([type]),textarea')].find(visible);
+      if(!e)return null;
+      e.setAttribute('data-neoy-project-name','1');
+      return '[data-neoy-project-name="1"]';
+    })()"""), "ChatGPT project name field")
+    fill_input(selector,name,clear_first=True)
+
+    # New Project dialog defaults to account memory. Choose Project-only when offered.
+    js("""(() => {
+      const visible=e=>{const r=e.getBoundingClientRect();return !!(r.width&&r.height)};
+      const fire=e=>{for(const type of ['pointerdown','mousedown','pointerup','mouseup','click']) e.dispatchEvent(new MouseEvent(type,{bubbles:true,cancelable:true,view:window,button:0,buttons:type.includes('down')?1:0}));};
+      const b=[...document.querySelectorAll('button,[role="button"]')].filter(visible).find(e=>/default memory/i.test((e.innerText||e.textContent||e.getAttribute('aria-label')||'')));
+      if(b){fire(b);return true;} return false;
+    })()""")
+    time.sleep(.15)
+    js("""(() => {
+      const fire=e=>{for(const type of ['pointerdown','mousedown','pointerup','mouseup','click']) e.dispatchEvent(new MouseEvent(type,{bubbles:true,cancelable:true,view:window,button:0,buttons:type.includes('down')?1:0}));};
+      const nodes=[...document.querySelectorAll('[role="menuitem"],button,[role="button"],label')];
+      const e=nodes.find(e=>/project[- ]only/i.test((e.innerText||e.textContent||e.getAttribute('aria-label')||'').replace(/\s+/g,' ').trim()));
+      if(!e)return false;fire(e);return true;
+    })()""")
+
+    ok=js("""(() => {
+      const visible=e=>{const r=e.getBoundingClientRect();return !!(r.width&&r.height)};
+      const buttons=[...document.querySelectorAll('button,[role="button"]')].filter(visible);
+      const b=buttons.find(e=>{
+        const t=(e.innerText||e.textContent||e.getAttribute('aria-label')||'').replace(/\s+/g,' ').trim().toLowerCase();
+        return t==='create project'||t==='create'||t==='continue'||t==='done';
+      });
+      if(!b||b.disabled||b.getAttribute('aria-disabled')==='true')return false;b.click();return true;
+    })()""")
+    if not ok:
+        raise RuntimeError("ChatGPT Create Project button not found")
+
+    deadline=time.time()+30
+    while time.time()<deadline:
+        info=page_info()
+        pid=_project_from_url(info.get("url",""))
+        if pid:
+            project_url=f"https://chatgpt.com/g/{pid}/project"
+            if "/project" not in urlsplit(info.get("url","")).path:
+                goto_url(project_url); wait_for_load()
+            return {"project_id":pid,"project_url":page_info().get("url",project_url),"reused":False}
+        created=js(f"""(() => {{
+          const wanted={json.dumps(wanted)};
+          const rows=[...document.querySelectorAll('[data-app-action-sidebar-project-row]')];
+          const row=rows.find(e=>(e.getAttribute('data-app-action-sidebar-project-label')||'').replace(/\\s+/g,' ').trim().toLowerCase()===wanted);
+          return row ? row.getAttribute('data-app-action-sidebar-project-id')||'' : '';
+        }})()""")
+        if created:
+            project_url=f"https://chatgpt.com/g/{created}/project"
+            goto_url(project_url); wait_for_load()
+            return {"project_id":created,"project_url":page_info().get("url",project_url),"reused":False}
+        time.sleep(.25)
+    raise RuntimeError(f"ChatGPT Project {name} was not created")
+
+def _settings_panel():
+    already=js("""(() => {
+      const d=document.querySelector('[role="dialog"]');
+      return !!d && /project settings/i.test((d.innerText||d.textContent||''));
+    })()""")
+    if already:
+        return True
+
+    opened=_wait(lambda: js("""(() => {
+      const fire=e=>{for(const type of ['pointerdown','mousedown','pointerup','mouseup','click']) e.dispatchEvent(new MouseEvent(type,{bubbles:true,cancelable:true,view:window,button:0,buttons:type.includes('down')?1:0}));};
+      const b=[...document.querySelectorAll('button')].find(b=>(b.getAttribute('aria-label')||'')==='Project actions');
+      if(!b)return false;fire(b);return true;
+    })()"""), "ChatGPT Project actions control",15)
+
+    def open_settings_menu_item():
+        return js("""(() => {
+          const fire=e=>{for(const type of ['pointerdown','mousedown','pointerup','mouseup','click']) e.dispatchEvent(new MouseEvent(type,{bubbles:true,cancelable:true,view:window,button:0,buttons:type.includes('down')?1:0}));};
+          const nodes=[...document.querySelectorAll('[role="menuitem"],button,[role="button"],a')];
+          const e=nodes.find(e=>{
+            const text=(e.innerText||e.textContent||e.getAttribute('aria-label')||'').replace(/\\s+/g,' ').trim().toLowerCase();
+            return text.includes('project settings') || text.includes('edit project') || text.includes('project instructions');
+          });
+          if(e){fire(e);return true;}
+          const b=[...document.querySelectorAll('button')].find(b=>(b.getAttribute('aria-label')||'')==='Project actions');
+          if(b) fire(b);
+          return false;
+        })()""")
+    _wait(open_settings_menu_item, "ChatGPT Project settings menu item",8)
+
+    _wait(lambda: js("""(() => {
+      const d=document.querySelector('[role="dialog"]');
+      return !!d && /project settings/i.test((d.innerText||d.textContent||''));
+    })()"""), "ChatGPT Project settings dialog",5)
+    return True
+
+def _close_settings_panel():
+    js("""(() => {
+      const d=document.querySelector('[role="dialog"]');
+      if(!d)return true;
+      const b=[...d.querySelectorAll('button,[role="button"]')].find(e=>(e.getAttribute('aria-label')||'')==='Close dialog'||/close dialog/i.test((e.innerText||e.textContent||'')));
+      if(!b)return false;
+      const fire=e=>{for(const type of ['pointerdown','mousedown','pointerup','mouseup','click']) e.dispatchEvent(new MouseEvent(type,{bubbles:true,cancelable:true,view:window,button:0,buttons:type.includes('down')?1:0}));};
+      fire(b);return true;
+    })()""")
+    time.sleep(.2)
+
+def _set_field_value(field_selector,value):
+    ok=js(f"""(() => {{
+      const e=document.querySelector({json.dumps(field_selector)});
+      if(!e)return false;
+      e.focus();
+      if(e instanceof HTMLTextAreaElement || e instanceof HTMLInputElement){{
+        const p=e instanceof HTMLTextAreaElement?HTMLTextAreaElement.prototype:HTMLInputElement.prototype;
+        const setter=Object.getOwnPropertyDescriptor(p,'value')?.set;
+        setter?.call(e,{json.dumps(value)});
+      }}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(value)});
+        sel.removeAllRanges();
+      }}
+      e.dispatchEvent(new InputEvent('input',{{bubbles:true,inputType:'insertText',data:{json.dumps(value)}}}));
+      e.dispatchEvent(new Event('change',{{bubbles:true}}));
+      return true;
+    }})()""")
+    if not ok: raise RuntimeError("Could not update Project Instructions field")
+
+def _apply_instructions(value):
+    value=str(value or "").strip()
+    if not value: raise RuntimeError("Project Instructions are empty")
+    _settings_panel()
+    selector=_wait(lambda: js("""(() => {
+      const root=document.querySelector('[role="dialog"]');
+      if(!root||!/project settings/i.test((root.innerText||root.textContent||'')))return null;
+      const field=root.querySelector('textarea');
+      if(!field)return null;
+      field.setAttribute('data-neoy-project-instructions','1');
+      return '[data-neoy-project-instructions="1"]';
+    })()"""), "ChatGPT Project Instructions field")
+    _set_field_value(selector,value)
+    # Current ChatGPT Project settings auto-save Instructions.
+    time.sleep(1.0)
+
+def _set_project_only_memory():
+    _settings_panel()
+    current=js("""(() => {
+      const d=document.querySelector('[role="dialog"]');
+      if(!d)return 'missing';
+      const text=(d.innerText||d.textContent||'').replace(/\s+/g,' ').trim().toLowerCase();
+      if(text.includes('project-only')) return 'project-only';
+      const controls=[...d.querySelectorAll('button,[role="button"]')];
+      const memory=controls.find(e=>/default memory|memory/i.test((e.innerText||e.textContent||e.getAttribute('aria-label')||'').replace(/\s+/g,' ').trim().toLowerCase()));
+      if(!memory)return 'unavailable';
+      const fire=e=>{for(const type of ['pointerdown','mousedown','pointerup','mouseup','click']) e.dispatchEvent(new MouseEvent(type,{bubbles:true,cancelable:true,view:window,button:0,buttons:type.includes('down')?1:0}));};
+      fire(memory);return 'opened';
+    })()""")
+    if current=="project-only":
+        _close_settings_panel()
+        return {"memory":"project-only"}
+    if current=="opened":
+        _wait(lambda: js("""(() => {
+          const nodes=[...document.querySelectorAll('[role="menuitem"],button,[role="button"],label')];
+          const e=nodes.find(e=>/project[- ]only/i.test((e.innerText||e.textContent||e.getAttribute('aria-label')||'').replace(/\s+/g,' ').trim()));
+          if(!e)return false;
+          const fire=e=>{for(const type of ['pointerdown','mousedown','pointerup','mouseup','click']) e.dispatchEvent(new MouseEvent(type,{bubbles:true,cancelable:true,view:window,button:0,buttons:type.includes('down')?1:0}));};
+          fire(e);return true;
+        })()"""), "Project-only memory option",3)
+        time.sleep(.7)
+        _close_settings_panel()
+        return {"memory":"project-only"}
+    _close_settings_panel()
+    return {"memory":"unavailable"}
+
+def _composer_selector():
+    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;}
+      const visible=[...document.querySelectorAll('[contenteditable="true"]')].filter(e=>{const r=e.getBoundingClientRect();return r.width&&r.height;});
+      if(visible.length===1){visible[0].setAttribute('data-neoy-composer','1');return '[data-neoy-composer="1"]';}
+      return null;
+    })()""")
+
+def _fill_composer(text):
+    sel=_wait(_composer_selector,"ChatGPT Project composer",30)
+    editable=bool(js(f"""(() => document.querySelector({json.dumps(sel)})?.getAttribute('contenteditable')==='true')()"""))
+    if editable:
+        _set_field_value(sel,text)
+    else:
+        fill_input(sel,text,clear_first=True)
+    return sel
+
+def _send_initial(text):
+    before=page_info().get("url","")
+    _fill_composer(text)
+    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-send','1');return '[data-neoy-send="1"]';
+    })()"""), "enabled ChatGPT Send button",20)
+    clicked=js("""(() => {const b=document.querySelector('[data-neoy-send="1"]');if(!b)return false;b.click();return true;})()""")
+    if not clicked: raise RuntimeError("Initial Project thread Send failed")
+    deadline=time.time()+90
+    observed_thread=False
+    while time.time()<deadline:
+        current=page_info().get("url","")
+        path=urlsplit(current).path
+        if "/c/" in path:
+            observed_thread=True
+            # ChatGPT first exposes a client-local local-chatgpt id, then replaces
+            # it with the durable server thread id. Never persist the temporary URL.
+            if "local-chatgpt" not in current:
+                assistant_visible=bool(js("""(() => [...document.querySelectorAll('h4')].some(e => (e.innerText || '').trim() === 'ChatGPT said:') || document.querySelector('[data-message-author-role="assistant"]'))()"""))
+                if assistant_visible:
+                    return current
+        time.sleep(.25)
+    if observed_thread:
+        raise RuntimeError("ChatGPT Project thread stayed on a temporary local-chatgpt URL")
+    raise RuntimeError(f"ChatGPT did not create a Project thread from {before}")
+
+target_id=new_tab("https://chatgpt.com/")
+wait_for_load()
+project=_ensure_project(CFG["project_name"])
+if project.get("project_url") and page_info().get("url","")!=project["project_url"]:
+    goto_url(project["project_url"]); wait_for_load()
+_apply_instructions(CFG["instructions"])
+memory_state=_set_project_only_memory()
+
+# Return to the Project root after settings operations if the UI changed location.
+project_url=project["project_url"]
+if "/project" not in urlsplit(page_info().get("url","")).path:
+    goto_url(project_url); wait_for_load()
+
+initial=str(CFG.get("initial_prompt") or "").strip()
+if not initial:
+    initial="Initialize this learner's Family Tutor thread from the Project Instructions and reply only with READY."
+thread_url=_send_initial(initial)
+print(json.dumps({
+  "status":"completed",
+  "project_id":project["project_id"],
+  "project_url":project_url,
+  "project_reused":project["reused"],
+  "memory":memory_state["memory"],
+  "thread_url":thread_url.split("?",1)[0],
+  "thread_id":urlsplit(thread_url).path.rstrip("/").rsplit("/",1)[-1],
+  "target_id":target_id,
+},ensure_ascii=False),flush=True)

package/platforms/chatgpt/actions/_readiness.py

@@ -0,0 +1,52 @@
+"""Bounded polling helpers for ChatGPT submit readiness."""
+from __future__ import annotations
+
+import re
+import time
+
+def wait_until_stable(read_state, ready, *, timeout, interval=0.25, stable_samples=2, phase):
+    deadline = time.monotonic() + timeout
+    stable = 0
+    last_state = {}
+    while time.monotonic() < deadline:
+        try:
+            last_state = read_state()
+        except Exception:
+            stable = 0
+            time.sleep(interval)
+            continue
+        if ready(last_state):
+            stable += 1
+            if stable >= stable_samples:
+                return last_state
+        else:
+            stable = 0
+        time.sleep(interval)
+    raise RuntimeError(f"ChatGPT {phase} was not observed ready")
+
+def prompt_text_matches(observed, expected):
+    def normalize(value):
+        text=re.sub(r"\s+", " ", value or "").strip()
+        text=re.sub(r">\s+", ">", text)
+        text=re.sub(r"\s+<", "<", text)
+        return text
+    observed_n = normalize(observed)
+    expected_n = normalize(expected)
+    if expected_n in observed_n:
+        return True
+    if not expected_n:
+        return not observed_n
+    span = min(256, max(48, len(expected_n) // 8))
+    return (
+        len(observed_n) >= int(len(expected_n) * 0.9)
+        and expected_n[:span] in observed_n
+        and expected_n[-span:] in observed_n
+    )
+
+def submission_receipt(turns, before_count, prompt, composer_text):
+    for turn in turns[before_count:]:
+        if prompt_text_matches(turn.get("text"), prompt):
+            return {"verified_by": "user-turn", "turn": turn}
+    if not (composer_text or "").strip():
+        return {"verified_by": "composer-cleared", "turn": {"id": None, "text": prompt}}
+    return None

package/platforms/chatgpt/actions/_submit_thread.py

@@ -0,0 +1,129 @@
+import json
+import os
+import time
+from urllib.parse import quote
+from _readiness import wait_until_stable, submission_receipt, prompt_text_matches
+
+CFG=json.load(open("__CFG_PATH__",encoding="utf-8"))
+project_id=str(CFG.get("project_id") or "").strip()
+thread_id=str(CFG.get("thread_id") or "").strip()
+prompt=str(CFG.get("prompt") or "")
+files=list(CFG.get("file") or [])
+app_name=str(CFG.get("app") or "").strip()
+if not project_id or not thread_id: raise RuntimeError("project_id and thread_id are required")
+if not prompt and not files: raise RuntimeError("prompt or file is required")
+thread_url=f"https://chatgpt.com/g/{quote(project_id,safe='')}/c/{quote(thread_id,safe='')}"
+goto_url(thread_url+"?prompt="+quote(prompt,safe=''))
+wait_for_load()
+
+def composer_state():
+    return js("""(() => {
+      const selectors=['#prompt-textarea','[contenteditable="true"][data-composer-markdown]','[contenteditable="true"][data-lexical-editor="true"]','textarea'];
+      const elements=[...new Set(selectors.flatMap(s=>[...document.querySelectorAll(s)]))];
+      const e=elements.find(node=>{const r=node.getBoundingClientRect();return !node.disabled&&r.width>0&&r.height>0});
+      if(!e) return {present:false,text:'',sendEnabled:false};
+      const form=e.closest('form');
+      const b=form?.querySelector('button[data-testid="send-button"],button[aria-label="Send prompt"],button[aria-label="Send"]');
+      return {present:true,text:(e.innerText||e.value||e.textContent||'').trim(),sendEnabled:!!b&&!b.disabled&&b.getAttribute('aria-disabled')!=='true'};
+    })()""") or {"present":False,"text":"","sendEnabled":False}
+
+def visible_composer_text():
+    return composer_state().get("text","")
+
+def click_visible_send():
+    return bool(js("""(() => {
+      const selectors=['#prompt-textarea','[contenteditable="true"][data-composer-markdown]','[contenteditable="true"][data-lexical-editor="true"]','textarea'];
+      const elements=[...new Set(selectors.flatMap(s=>[...document.querySelectorAll(s)]))];
+      const e=elements.find(node=>{const r=node.getBoundingClientRect();return !node.disabled&&r.width>0&&r.height>0});
+      if(!e) return false;
+      const form=e.closest('form');
+      const b=form?.querySelector('button[data-testid="send-button"],button[aria-label="Send prompt"],button[aria-label="Send"]');
+      if(!b||b.disabled||b.getAttribute('aria-disabled')==='true') return false;
+      b.click(); return true;
+    })()"""))
+
+def visible_composer_element_js():
+    return """(() => { const selectors=['#prompt-textarea','[contenteditable=\"true\"][data-composer-markdown]','[contenteditable=\"true\"][data-lexical-editor=\"true\"]','textarea']; const elements=[...new Set(selectors.flatMap(s=>[...document.querySelectorAll(s)]))]; return elements.find(node=>{const r=node.getBoundingClientRect();return !node.disabled&&r.width>0&&r.height>0})||null; })()"""
+
+def attach_app_and_restore_prompt(name, prompt, timeout=12):
+    if not name: return False
+    ok=js("""(() => { const selectors=['#prompt-textarea','[contenteditable=\"true\"][data-composer-markdown]','[contenteditable=\"true\"][data-lexical-editor=\"true\"]','textarea']; const els=[...new Set(selectors.flatMap(s=>[...document.querySelectorAll(s)]))]; const e=els.find(node=>{const r=node.getBoundingClientRect();return !node.disabled&&r.width>0&&r.height>0}); if(!e||e.getAttribute('contenteditable')!=='true') return false; e.focus(); const sel=window.getSelection(); const range=document.createRange(); range.selectNodeContents(e); sel.removeAllRanges(); sel.addRange(range); document.execCommand('delete',false,null); sel.removeAllRanges(); return true; })()""")
+    if not ok: raise RuntimeError("ChatGPT app mention requires a visible contenteditable composer")
+    session=cdp("Target.attachToTarget",targetId=target_id,flatten=True)["sessionId"]
+    cdp("Input.insertText",session_id=session,text="@")
+    wanted=name.lower()
+    deadline=time.time()+timeout
+    while time.time()<deadline:
+        clicked=js(f"""(() => {{ const wanted={json.dumps(wanted)}; const candidates=[...document.querySelectorAll('button,[role=\"option\"],[role=\"menuitem\"]')]; const e=candidates.find(node=>{{const text=(node.innerText||node.textContent||'').replace(/\\s+/g,'').trim().toLowerCase(); return text===wanted.replace(/\\s+/g,'') || text===(wanted+wanted).replace(/\\s+/g,'');}}); if(!e)return false;e.click();return true; }})()""")
+        if clicked: break
+        time.sleep(.1)
+    else: raise RuntimeError(f"ChatGPT app '{name}' was not offered by the composer")
+    deadline=time.time()+timeout
+    while time.time()<deadline:
+        attached=js(f"""(() => {{ const selectors=['#prompt-textarea','[contenteditable=\"true\"][data-composer-markdown]','[contenteditable=\"true\"][data-lexical-editor=\"true\"]']; const els=[...new Set(selectors.flatMap(s=>[...document.querySelectorAll(s)]))]; const e=els.find(node=>{{const r=node.getBoundingClientRect();return r.width>0&&r.height>0}}); return !!e && !![...e.querySelectorAll('[app-mention-name]')].find(n=>(n.getAttribute('app-mention-name')||'').toLowerCase()==={json.dumps(wanted)}); }})()""")
+        if attached: break
+        time.sleep(.1)
+    else: raise RuntimeError(f"ChatGPT app '{name}' mention did not attach")
+    for offset in range(0,len(prompt),256):
+        chunk=prompt[offset:offset+256]
+        inserted=js(f"""(() => {{ const selectors=['#prompt-textarea','[contenteditable=\"true\"][data-composer-markdown]','[contenteditable=\"true\"][data-lexical-editor=\"true\"]']; const els=[...new Set(selectors.flatMap(s=>[...document.querySelectorAll(s)]))]; const e=els.find(node=>{{const r=node.getBoundingClientRect();return r.width>0&&r.height>0}}); if(!e)return false;e.focus();const sel=window.getSelection();const range=document.createRange();range.selectNodeContents(e);range.collapse(false);sel.removeAllRanges();sel.addRange(range);const ok=document.execCommand('insertText',false,{json.dumps(chunk)});e.dispatchEvent(new InputEvent('input',{{bubbles:true,inputType:'insertText',data:{json.dumps(chunk)}}}));return ok; }})()""")
+        if not inserted: raise RuntimeError("ChatGPT composer rejected prompt after app mention")
+    return True
+
+def attachment_state():
+    return js(r"""(() => { const names=[...document.querySelectorAll('button[aria-label^="Remove "]')].map(b => (b.getAttribute('aria-label')||'').replace(/^Remove file\s+\d+:\s*/,'').replace(/^Remove\s+/,'')).filter(Boolean); const visible=e=>{const r=e.getBoundingClientRect();return r.width>0&&r.height>0}; const pending=[...document.querySelectorAll('[role="progressbar"],[aria-busy="true"],[data-state="loading"]')].some(visible); return {names,pending}; })()""") or {"names":[],"pending":False}
+
+
+def user_turns():
+    return js("""(() => { const legacy=[...document.querySelectorAll('[data-message-author-role="user"]')].map(e=>({text:(e.innerText||'').trim(),id:e.getAttribute('data-message-id')||''})).filter(x=>x.text); if(legacy.length) return legacy; return [...document.querySelectorAll('h4')].filter(e=>(e.innerText||'').trim()==='You said:').map((e,index)=>({text:(e.parentElement?.innerText||'').replace(/^You said:\\s*/,'').trim(),id:`dom-user-${index}`})).filter(x=>x.text); })()""") or []
+
+def upload_files(paths):
+    if not paths: return []
+    selector=js("""(() => { for(const s of ['#upload-files','#upload-media','input[name="upload-media"]','input[type="file"]']) if(document.querySelector(s)) return s; return null; })()""")
+    if not selector:
+        js("""(() => { const b=[...document.querySelectorAll('button')].find(b=>(b.getAttribute('aria-label')||'').trim()==='Add files and more'); if(!b)return false;b.click();return true; })()""")
+        deadline=time.time()+5
+        while time.time()<deadline and not selector:
+            selector=js("""(() => { for(const s of ['#upload-files','#upload-media','input[name="upload-media"]','input[type="file"]']) if(document.querySelector(s)) return s; return null; })()""")
+            if not selector: time.sleep(.1)
+    if not selector: raise RuntimeError("ChatGPT file input was not observed")
+    expected=[]
+    for item in paths:
+        if not os.path.isfile(item): raise RuntimeError(f"attachment does not exist: {item}")
+        upload_file(selector,item); expected.append(os.path.basename(item))
+    wait_until_stable(attachment_state,lambda state:set(expected).issubset(state["names"]) and not state["pending"],timeout=120,phase="attachment readiness")
+    return expected
+
+wait_until_stable(
+    composer_state,
+    lambda state: state["present"],
+    timeout=20,
+    phase="composer readiness",
+)
+wait_until_stable(
+    composer_state,
+    lambda state: prompt_text_matches(state["text"],prompt),
+    timeout=20,
+    phase="prefilled thread readiness",
+)
+app_attached=attach_app_and_restore_prompt(app_name,prompt) if app_name else False
+if app_attached:
+    wait_until_stable(composer_state,lambda state: prompt_text_matches(state["text"],prompt),timeout=15,phase="app prompt readiness")
+attachments=upload_files(files)
+before_users=len(user_turns())
+wait_until_stable(
+    lambda:{"composer":composer_state(),"attachments":attachment_state()},
+    lambda state: prompt_text_matches(state["composer"]["text"],prompt) and set(attachments).issubset(state["attachments"]["names"]) and not state["attachments"]["pending"] and state["composer"]["sendEnabled"],
+    timeout=45 if attachments else 20,
+    phase="send readiness",
+)
+if not click_visible_send(): raise RuntimeError("ChatGPT send button changed before click")
+deadline=time.time()+15
+receipt=None
+while time.time()<deadline:
+    receipt=submission_receipt(user_turns(),before_users,prompt,visible_composer_text())
+    if receipt: break
+    time.sleep(.1)
+if not receipt: raise RuntimeError("ChatGPT submission verification did not observe an accepted submission")
+
+print(json.dumps({"status":"submitted","project_id":project_id,"thread_id":thread_id,"verified_by":receipt["verified_by"],"user_message_id":receipt["turn"].get("id") or None,"app":app_name or None},ensure_ascii=False),flush=True)