screenhand 0.1.1 → 0.3.0

package/dist-playbooks/davinci-color-grade.json

@@ -0,0 +1,153 @@
+{
+  "id": "davinci-color-grade",
+  "name": "DaVinci Resolve - Basic Color Grade",
+  "description": "Keyboard-first color-correction flow that switches to the Color page, adds correction nodes, applies Auto Color, enables printer-light hotkeys, adds a windowed node, and grabs a still. Designed for ScreenHand environments where DaVinci UI elements are not accessibility-visible.",
+  "platform": "davinci-resolve",
+  "version": "1.0.0",
+  "tags": [
+    "davinci-resolve",
+    "color",
+    "grading",
+    "keyboard",
+    "menu"
+  ],
+  "successCount": 0,
+  "failCount": 0,
+  "urls": {
+    "manual_pdf": "https://documents.blackmagicdesign.com/UserManuals/DaVinci_Resolve_20.3_Reference_Manual.pdf",
+    "training": "https://www.blackmagicdesign.com/products/davinciresolve/training"
+  },
+  "selectors": {
+    "menus": {
+      "color_page": "Workspace/Switch to Page/Color",
+      "printer_light_hotkeys": "Color/Printer Light Hotkeys",
+      "add_circle_window_node": "Color/Nodes/Add Serial Node + CPW",
+      "add_outside_node": "Color/Nodes/Add Outside Node",
+      "grab_still": "Color/Stills/Grab Still"
+    }
+  },
+  "flows": {
+    "basic_color_correction": {
+      "why": "Provides a reproducible baseline grade without relying on inaccessible UI widgets.",
+      "steps": [
+        "Switch to Color, add a serial node, apply Auto Color, enable printer-light hotkeys, add a power-window node, then grab a still."
+      ]
+    }
+  },
+  "policyNotes": {
+    "preconditions": [
+      "Open a project and select the clip you want to grade before running this playbook.",
+      "If printer-light hotkeys are already enabled, the menu step is idempotent."
+    ],
+    "limitations": [
+      "Default Resolve shortcuts do not expose direct palette toggles for Curves or Qualifier, so this workflow focuses on node creation, primaries, windows, and still capture."
+    ]
+  },
+  "steps": [
+    {
+      "action": "key",
+      "keys": [
+        "shift",
+        "6"
+      ],
+      "description": "Switch to the Color page"
+    },
+    {
+      "action": "wait",
+      "ms": 1000,
+      "description": "Wait for the Color page to settle"
+    },
+    {
+      "action": "key",
+      "keys": [
+        "alt",
+        "s"
+      ],
+      "description": "Add a serial correction node"
+    },
+    {
+      "action": "wait",
+      "ms": 400,
+      "description": "Let the node graph update"
+    },
+    {
+      "action": "key",
+      "keys": [
+        "shift",
+        "alt",
+        "c"
+      ],
+      "description": "Apply Auto Color for a primary-balance starting point"
+    },
+    {
+      "action": "wait",
+      "ms": 600,
+      "description": "Wait for Auto Color to finish"
+    },
+    {
+      "action": "menu_click",
+      "menuPath": [
+        "Color",
+        "Printer Light Hotkeys"
+      ],
+      "description": "Enable printer-light hotkeys for keyboard primary trims"
+    },
+    {
+      "action": "key",
+      "keys": [
+        "7"
+      ],
+      "description": "Nudge red printer light up one step"
+    },
+    {
+      "action": "key",
+      "keys": [
+        "8"
+      ],
+      "description": "Nudge green printer light up one step"
+    },
+    {
+      "action": "key",
+      "keys": [
+        "9"
+      ],
+      "description": "Nudge blue printer light up one step"
+    },
+    {
+      "action": "menu_click",
+      "menuPath": [
+        "Color",
+        "Nodes",
+        "Add Serial Node + CPW"
+      ],
+      "description": "Add a serial node with a circular power window"
+    },
+    {
+      "action": "wait",
+      "ms": 400,
+      "description": "Wait for the windowed node to appear"
+    },
+    {
+      "action": "menu_click",
+      "menuPath": [
+        "Color",
+        "Nodes",
+        "Add Outside Node"
+      ],
+      "description": "Create an outside node for the isolated correction"
+    },
+    {
+      "action": "menu_click",
+      "menuPath": [
+        "Color",
+        "Stills",
+        "Grab Still"
+      ],
+      "description": "Grab a still for before/after comparison"
+    },
+    {
+      "action": "screenshot",
+      "description": "Capture the Color page after grading"
+    }
+  ]
+}

package/dist-playbooks/davinci-edit-timeline.json

@@ -0,0 +1,162 @@
+{
+  "id": "davinci-edit-timeline",
+  "name": "DaVinci Resolve - Import And Arrange Timeline",
+  "description": "Keyboard-only edit workflow that imports media, focuses the media pool and timeline, appends clips, adds a transition, and drops a marker. Intended for projects where the current file picker selection is already correct.",
+  "platform": "davinci-resolve",
+  "version": "1.0.0",
+  "tags": [
+    "davinci-resolve",
+    "edit",
+    "timeline",
+    "import",
+    "keyboard",
+    "menu"
+  ],
+  "successCount": 0,
+  "failCount": 0,
+  "urls": {
+    "manual_pdf": "https://documents.blackmagicdesign.com/UserManuals/DaVinci_Resolve_20.3_Reference_Manual.pdf",
+    "training": "https://www.blackmagicdesign.com/products/davinciresolve/training"
+  },
+  "selectors": {
+    "menus": {
+      "edit_page": "Workspace/Switch to Page/Edit",
+      "import_media": "File/Import/Media…",
+      "add_transition": "Timeline/Add Transition"
+    }
+  },
+  "flows": {
+    "import_arrange_clips": {
+      "why": "Stages a simple timeline without pointer clicks by leaning on panel-focus shortcuts and edit commands.",
+      "steps": [
+        "Switch to Edit, import media, focus Media Clips, append the selected clip(s), then focus the timeline to add a transition and marker."
+      ]
+    }
+  },
+  "policyNotes": {
+    "preconditions": [
+      "Open a project before running the playbook.",
+      "The native import dialog must already be pointed at the desired folder and current selection, because the playbook uses keyboard confirmation only."
+    ],
+    "limitations": [
+      "This workflow assumes at least one imported clip can be reached with arrow-key selection from the Media Clips panel."
+    ]
+  },
+  "steps": [
+    {
+      "action": "key",
+      "keys": [
+        "shift",
+        "4"
+      ],
+      "description": "Switch to the Edit page"
+    },
+    {
+      "action": "wait",
+      "ms": 1000,
+      "description": "Wait for the Edit page to settle"
+    },
+    {
+      "action": "menu_click",
+      "menuPath": [
+        "File",
+        "Import",
+        "Media…"
+      ],
+      "description": "Open the native media import dialog"
+    },
+    {
+      "action": "wait",
+      "ms": 600,
+      "description": "Wait for the file picker to appear"
+    },
+    {
+      "action": "key",
+      "keys": [
+        "enter"
+      ],
+      "description": "Confirm the current file picker selection"
+    },
+    {
+      "action": "wait",
+      "ms": 1200,
+      "description": "Wait for media import to complete"
+    },
+    {
+      "action": "key",
+      "keys": [
+        "cmd",
+        "2"
+      ],
+      "description": "Focus the Media Clips panel"
+    },
+    {
+      "action": "key",
+      "keys": [
+        "down"
+      ],
+      "description": "Select the next clip in Media Clips"
+    },
+    {
+      "action": "key",
+      "keys": [
+        "shift",
+        "f12"
+      ],
+      "description": "Append the selected clip to the end of the timeline"
+    },
+    {
+      "action": "wait",
+      "ms": 400,
+      "description": "Wait for the append edit to complete"
+    },
+    {
+      "action": "key",
+      "keys": [
+        "cmd",
+        "4"
+      ],
+      "description": "Focus the timeline"
+    },
+    {
+      "action": "key",
+      "keys": [
+        "n"
+      ],
+      "description": "Toggle snapping on for predictable edits"
+    },
+    {
+      "action": "key",
+      "keys": [
+        "b"
+      ],
+      "description": "Switch to Blade Edit mode"
+    },
+    {
+      "action": "key",
+      "keys": [
+        "a"
+      ],
+      "description": "Return to Normal Edit mode"
+    },
+    {
+      "action": "key",
+      "keys": [
+        "cmd",
+        "t"
+      ],
+      "description": "Add the default transition at the selected cut"
+    },
+    {
+      "action": "key",
+      "keys": [
+        "m"
+      ],
+      "description": "Drop a marker on the current edit"
+    },
+    {
+      "action": "screenshot",
+      "description": "Capture the Edit page after timeline assembly"
+    }
+  ]
+}

package/dist-playbooks/davinci-render.json

@@ -0,0 +1,114 @@
+{
+  "id": "davinci-render",
+  "name": "DaVinci Resolve - Render Export",
+  "description": "Keyboard-first export workflow that switches to Deliver, marks the range, then uses Quick Export as the stable no-pointer fallback when Deliver queue buttons are not accessibility-exposed.",
+  "platform": "davinci-resolve",
+  "version": "1.0.0",
+  "tags": [
+    "davinci-resolve",
+    "deliver",
+    "render",
+    "export",
+    "keyboard",
+    "menu"
+  ],
+  "successCount": 0,
+  "failCount": 0,
+  "urls": {
+    "manual_pdf": "https://documents.blackmagicdesign.com/UserManuals/DaVinci_Resolve_20.3_Reference_Manual.pdf",
+    "training": "https://www.blackmagicdesign.com/products/davinciresolve/training"
+  },
+  "selectors": {
+    "menus": {
+      "deliver_page": "Workspace/Switch to Page/Deliver",
+      "quick_export": "File/Quick Export…"
+    }
+  },
+  "flows": {
+    "quick_export_fallback": {
+      "why": "Deliver queue buttons are not reliably exposed via accessibility, so Quick Export is the deterministic export path for keyboard-only automation.",
+      "steps": [
+        "Switch to Deliver, define the In/Out range, open Quick Export, and confirm the last-used preset and destination from the keyboard."
+      ]
+    }
+  },
+  "policyNotes": {
+    "preconditions": [
+      "Open the target project and timeline before running this playbook.",
+      "Quick Export should already remember the desired preset and destination, because the dialog is confirmed from the keyboard using the last-used state."
+    ],
+    "limitations": [
+      "The default Resolve UI does not expose Add to Render Queue and Start Render as stable menu targets, so this playbook uses Quick Export instead of the Deliver queue buttons."
+    ]
+  },
+  "steps": [
+    {
+      "action": "key",
+      "keys": [
+        "shift",
+        "8"
+      ],
+      "description": "Switch to the Deliver page"
+    },
+    {
+      "action": "wait",
+      "ms": 1000,
+      "description": "Wait for the Deliver page to settle"
+    },
+    {
+      "action": "key",
+      "keys": [
+        "i"
+      ],
+      "description": "Mark the current frame as the render In point"
+    },
+    {
+      "action": "key",
+      "keys": [
+        "o"
+      ],
+      "description": "Mark the current frame as the render Out point"
+    },
+    {
+      "action": "menu_click",
+      "menuPath": [
+        "File",
+        "Quick Export…"
+      ],
+      "description": "Open Quick Export as the stable render fallback"
+    },
+    {
+      "action": "wait",
+      "ms": 800,
+      "description": "Wait for the Quick Export dialog to appear"
+    },
+    {
+      "action": "key",
+      "keys": [
+        "enter"
+      ],
+      "description": "Accept the currently highlighted Quick Export preset"
+    },
+    {
+      "action": "wait",
+      "ms": 800,
+      "description": "Wait for the export confirmation state"
+    },
+    {
+      "action": "key",
+      "keys": [
+        "enter"
+      ],
+      "description": "Confirm export using the last-used destination"
+    },
+    {
+      "action": "wait",
+      "ms": 2000,
+      "description": "Give Resolve time to start the export"
+    },
+    {
+      "action": "screenshot",
+      "description": "Capture the Deliver or export dialog state after submission"
+    }
+  ]
+}

package/dist-playbooks/devto.json

@@ -0,0 +1,52 @@
+{
+  "id": "devto",
+  "name": "Dev.to Automation",
+  "description": "Battle-tested playbook for Dev.to browser automation via CDP. Covers creating posts, liking, commenting, bookmarking, searching, and profile management. Dev.to uses standard HTML elements (textarea, button) with React — native value setter needed for controlled inputs.",
+  "platform": "devto",
+  "version": "1.0.0",
+  "urlPatterns": [
+    "*dev.to*"
+  ],
+  "tags": [
+    "devto",
+    "blog",
+    "developer",
+    "browser",
+    "cdp"
+  ],
+  "successCount": 0,
+  "failCount": 0,
+  "steps": [
+    {
+      "action": "navigate",
+      "url": "https://dev.to/",
+      "description": "Open Dev.to home feed"
+    },
+    {
+      "action": "wait",
+      "ms": 2000,
+      "description": "Wait for feed to load"
+    },
+    {
+      "action": "extract",
+      "target": "[class*='crayons-story']",
+      "format": "text",
+      "description": "Extract article cards from feed"
+    },
+    {
+      "action": "scroll",
+      "direction": "down",
+      "amount": 5,
+      "description": "Scroll for more articles"
+    },
+    {
+      "action": "wait",
+      "ms": 1000,
+      "description": "Wait for lazy-loaded articles"
+    },
+    {
+      "action": "screenshot",
+      "description": "Capture feed state"
+    }
+  ]
+}

package/dist-playbooks/discord.json

@@ -0,0 +1,41 @@
+{
+  "id": "discord",
+  "name": "Discord Automation",
+  "description": "Battle-tested playbook for Discord browser automation via CDP. Covers server navigation, channel browsing, messaging, DMs, reactions, server joining, friend requests, and search. Discord uses React with aria-labels and data-list-item-id attributes for reliable selectors.",
+  "platform": "discord",
+  "version": "1.0.0",
+  "urlPatterns": [
+    "*discord.com*"
+  ],
+  "tags": [
+    "discord",
+    "chat",
+    "community",
+    "browser",
+    "cdp"
+  ],
+  "successCount": 0,
+  "failCount": 0,
+  "steps": [
+    {
+      "action": "navigate",
+      "url": "https://discord.com/channels/@me",
+      "description": "Open Discord home (DMs)"
+    },
+    {
+      "action": "wait",
+      "ms": 2000,
+      "description": "Wait for Discord to load"
+    },
+    {
+      "action": "extract",
+      "target": "[data-list-item-id*='guildsnav']",
+      "format": "text",
+      "description": "Extract server list from sidebar"
+    },
+    {
+      "action": "screenshot",
+      "description": "Capture Discord state"
+    }
+  ]
+}

package/dist-playbooks/google-flow-create-project.json

@@ -0,0 +1,59 @@
+{
+  "id": "google-flow-create-project",
+  "name": "Google Flow — Create Project",
+  "description": "Open the Google Flow dashboard, create a new project, and optionally rename it with {PROJECT_TITLE}. If {PROJECT_TITLE} is omitted, the auto-generated Flow title is kept.",
+  "platform": "google-flow",
+  "version": "1.0.0",
+  "urlPatterns": [
+    "*labs.google/fx/tools/flow*"
+  ],
+  "tags": [
+    "google-flow",
+    "browser",
+    "cdp",
+    "project",
+    "create"
+  ],
+  "successCount": 0,
+  "failCount": 0,
+  "steps": [
+    {
+      "action": "navigate",
+      "url": "https://labs.google/fx/tools/flow",
+      "description": "Open the Flow dashboard"
+    },
+    {
+      "action": "wait",
+      "ms": 1500,
+      "description": "Wait for the dashboard to load"
+    },
+    {
+      "action": "browser_js",
+      "code": "(() => { const close = [...document.querySelectorAll('button,[role=\"button\"]')].find(el => /close/i.test((el.textContent || '').trim())); if (close instanceof HTMLElement) { close.click(); return 'dismissed banner'; } return 'no banner'; })()",
+      "description": "Dismiss the launch banner if it is visible",
+      "optional": true
+    },
+    {
+      "action": "browser_js",
+      "code": "(() => { const visible = el => { const r = el.getBoundingClientRect(); const s = getComputedStyle(el); return r.width > 0 && r.height > 0 && s.visibility !== 'hidden' && s.display !== 'none'; }; const button = [...document.querySelectorAll('button,[role=\"button\"]')].filter(visible).find(el => (el.textContent || '').replace(/\\s+/g, ' ').includes('New project')); if (!(button instanceof HTMLElement)) throw new Error('New project button not found'); button.click(); return 'clicked New project'; })()",
+      "description": "Create a new Flow project",
+      "verify": "input[aria-label='Editable text']",
+      "verifyTimeoutMs": 15000
+    },
+    {
+      "action": "wait",
+      "ms": 1000,
+      "description": "Allow the project editor to settle"
+    },
+    {
+      "action": "browser_js",
+      "code": "(() => { const raw = `{PROJECT_TITLE}`.trim(); if (!raw || raw === '{PROJECT_TITLE}') return 'kept generated title'; const input = document.querySelector(\"input[aria-label='Editable text']\"); if (!(input instanceof HTMLInputElement)) throw new Error('Project title input not found'); input.focus(); input.value = ''; input.value = raw; input.dispatchEvent(new Event('input', { bubbles: true })); input.dispatchEvent(new Event('change', { bubbles: true })); input.blur(); return input.value; })()",
+      "description": "Rename the project if PROJECT_TITLE was provided"
+    },
+    {
+      "action": "screenshot",
+      "description": "Capture the new project editor",
+      "optional": true
+    }
+  ]
+}

package/dist-playbooks/google-flow-edit-image.json

@@ -0,0 +1,90 @@
+{
+  "id": "google-flow-edit-image",
+  "name": "Google Flow — Edit Image",
+  "description": "Open a Flow project, switch to image assets, open a matching image edit URL, and apply a prompt-based image edit through Flow's internal Slate editor and onSubmit handler. PROMPT mode is fully automated. CROP, SELECT, and DRAW can also be staged, but they usually still need drag or region input unless {AUTO_SUBMIT} is set to 1.",
+  "platform": "google-flow",
+  "version": "1.0.0",
+  "urlPatterns": [
+    "*labs.google/fx/tools/flow*"
+  ],
+  "tags": [
+    "google-flow",
+    "browser",
+    "cdp",
+    "image",
+    "edit"
+  ],
+  "successCount": 0,
+  "failCount": 0,
+  "steps": [
+    {
+      "action": "navigate",
+      "url": "https://labs.google/fx/tools/flow",
+      "description": "Open the Flow dashboard"
+    },
+    {
+      "action": "wait",
+      "ms": 1500,
+      "description": "Wait for dashboard project cards"
+    },
+    {
+      "action": "browser_js",
+      "code": "(() => { const visible = el => { const r = el.getBoundingClientRect(); const s = getComputedStyle(el); return r.width > 0 && r.height > 0 && s.visibility !== 'hidden' && s.display !== 'none'; }; const rawWanted = `{PROJECT_NAME}`.trim(); const wanted = rawWanted.toLowerCase(); const hasWanted = !!rawWanted && rawWanted !== '{PROJECT_NAME}'; const links = [...document.querySelectorAll(\"a[href*='/fx/tools/flow/project/']\")].filter(visible); if (!links.length) throw new Error('No Flow project cards found'); const pick = hasWanted ? links.find(link => ((link.closest('div')?.textContent || link.parentElement?.textContent || '')).toLowerCase().includes(wanted)) : links[0]; if (!(pick instanceof HTMLAnchorElement)) throw new Error(hasWanted ? `Flow project not found: ${rawWanted}` : 'No clickable Flow project found'); const url = pick.href || pick.getAttribute('href'); if (!url) throw new Error('Project card is missing href'); window.location.assign(url); return url; })()",
+      "description": "Open the matching project card",
+      "verify": "[role='textbox'][contenteditable='true'][data-slate-editor='true']",
+      "verifyTimeoutMs": 15000
+    },
+    {
+      "action": "wait",
+      "ms": 800,
+      "description": "Allow the project editor to settle"
+    },
+    {
+      "action": "browser_js",
+      "code": "(() => { const button = [...document.querySelectorAll('button')].find(el => (el.textContent || '').includes('View images')); if (button instanceof HTMLElement) button.click(); return !!button; })()",
+      "description": "Switch the asset rail to images when the filter is present"
+    },
+    {
+      "action": "wait",
+      "ms": 400,
+      "description": "Wait for the image grid filter to apply"
+    },
+    {
+      "action": "browser_js",
+      "code": "(() => { const visible = el => { const r = el.getBoundingClientRect(); const s = getComputedStyle(el); return r.width > 0 && r.height > 0 && s.visibility !== 'hidden' && s.display !== 'none'; }; const rawUrl = `{ASSET_URL}`.trim(); const rawId = `{ASSET_ID}`.trim(); const rawIndex = `{ASSET_INDEX}`.trim(); const wantedIndex = rawIndex && rawIndex !== '{ASSET_INDEX}' ? Number(rawIndex) : 0; const anchors = [...document.querySelectorAll(\"a[href*='/edit/']\")].filter(visible).filter(anchor => { const tile = anchor.closest(\"[id^='fe_id_']\") || anchor.parentElement; return !tile?.querySelector('video'); }); let pick = null; if (rawUrl && rawUrl !== '{ASSET_URL}') pick = anchors.find(anchor => anchor.href === rawUrl); else if (rawId && rawId !== '{ASSET_ID}') pick = anchors.find(anchor => anchor.href.includes(`/edit/${rawId}`) || anchor.closest(`[id='fe_id_${rawId}']`)); else pick = anchors[Math.max(0, wantedIndex)] || anchors[0]; if (!(pick instanceof HTMLAnchorElement)) throw new Error('No Flow image edit link found'); window.location.assign(pick.href); return pick.href; })()",
+      "description": "Open the requested image asset in edit view",
+      "verify": "[role='textbox'][contenteditable='true'][data-slate-editor='true']",
+      "verifyTimeoutMs": 15000
+    },
+    {
+      "action": "wait",
+      "ms": 600,
+      "description": "Allow the image editor to settle"
+    },
+    {
+      "action": "browser_js",
+      "code": "(() => { const modeRaw = `{EDIT_MODE}`.trim().toUpperCase(); const mode = !modeRaw || modeRaw === '{EDIT_MODE}' ? 'PROMPT' : modeRaw; const autoSubmit = `{AUTO_SUBMIT}`.trim() === '1'; const buttonText = { CROP: 'Crop', SELECT: 'Select', DRAW: 'Draw' }; const clickButton = text => { const button = [...document.querySelectorAll('button')].find(el => (el.textContent || '').includes(text)); if (!(button instanceof HTMLElement)) throw new Error(`Flow image tool not found: ${text}`); button.click(); return text; }; let selectedTool = 'PROMPT'; if (buttonText[mode]) selectedTool = clickButton(buttonText[mode]); if (mode === 'CROP') { const aspectRaw = `{CROP_ASPECT}`.trim(); const aspect = !aspectRaw || aspectRaw === '{CROP_ASPECT}' ? '' : aspectRaw; if (aspect) { const aspectButton = [...document.querySelectorAll('button')].find(el => (el.textContent || '').includes(aspect)); if (aspectButton instanceof HTMLElement) aspectButton.click(); } } window.__flowImageEditMode = mode; window.__flowImageEditShouldSubmit = mode === 'PROMPT' || autoSubmit; return JSON.stringify({ mode, selectedTool, shouldSubmit: window.__flowImageEditShouldSubmit }); })()",
+      "description": "Choose the image edit mode and stage any tool-specific UI"
+    },
+    {
+      "action": "browser_js",
+      "code": "(() => { if (!window.__flowImageEditShouldSubmit) return JSON.stringify({ skipped: true, reason: 'staged_only' }); const prompt = `{PROMPT_TEXT}`.trim(); if (!prompt || prompt === '{PROMPT_TEXT}') throw new Error('PROMPT_TEXT variable is required for image edit submission'); const editorEl = document.querySelector(\"[role='textbox'][contenteditable='true'][data-slate-editor='true']\"); if (!(editorEl instanceof HTMLElement)) throw new Error('Flow image edit prompt box not found'); const fiberKey = Object.keys(editorEl).find(k => k.startsWith('__reactFiber')); let cur = fiberKey ? editorEl[fiberKey] : null; let store = null; for (let i = 0; cur && i < 9; i++, cur = cur.return) { if (i === 7) { store = cur.memoizedProps?.promptBoxStore; break; } } const state = store?.getState?.(); const actions = state?.actions; const textEditor = state?.inputs?.textEditor; if (!actions || !textEditor) throw new Error('Flow image edit store not found'); if (typeof actions.setMode === 'function') actions.setMode('IMAGE'); const currentText = textEditor.children?.[0]?.children?.[0]?.text ?? ''; try { textEditor.select({ anchor: { path: [0, 0], offset: 0 }, focus: { path: [0, 0], offset: currentText.length } }); } catch {} try { textEditor.deleteFragment(); } catch {} textEditor.insertText(prompt); try { textEditor.onChange(); } catch {} const text = (textEditor.children || []).map(node => (node.children || []).map(child => child.text || '').join('')).join('\\n'); window.__flowImageEditPrompt = text; return JSON.stringify({ prompt: text, mode: store.getState().mode, editMode: window.__flowImageEditMode || 'PROMPT' }); })()",
+      "description": "Insert the image edit prompt through Flow's internal Slate editor"
+    },
+    {
+      "action": "browser_js",
+      "code": "(() => { if (!window.__flowImageEditShouldSubmit) return JSON.stringify({ submitted: false, reason: 'staged_only' }); const submitButton = [...document.querySelectorAll('button')].find(el => (el.textContent || '').includes('arrow_forward') && (el.textContent || '').includes('Create')); if (!(submitButton instanceof HTMLElement)) throw new Error('Flow image edit submit button not found'); const fiberKey = Object.keys(submitButton).find(k => k.startsWith('__reactFiber')); let cur = fiberKey ? submitButton[fiberKey] : null; let onSubmit = null; for (let i = 0; cur && i < 6; i++, cur = cur.return) { if (i === 5) { onSubmit = cur.memoizedProps?.onSubmit; break; } } if (typeof onSubmit !== 'function') throw new Error('Flow image edit onSubmit handler not found'); window.__flowImageEditBaseline = { resourceCount: performance.getEntriesByType('resource').length }; onSubmit(); return JSON.stringify({ submitted: true, baseline: window.__flowImageEditBaseline }); })()",
+      "description": "Submit the image edit through Flow's internal handler"
+    },
+    {
+      "action": "browser_js",
+      "code": "(() => { if (!window.__flowImageEditShouldSubmit) return JSON.stringify({ staged: true }); const baseline = window.__flowImageEditBaseline || { resourceCount: 0 }; const seenRequest = () => performance.getEntriesByType('resource').slice(baseline.resourceCount).some(entry => /flowMedia:batchGenerateImages|flowWorkflows\\//.test(entry.name)); const start = Date.now(); return new Promise(resolve => { const check = () => { if (seenRequest()) { resolve(JSON.stringify({ submitted: true, generationRequestSeen: true })); return; } if (Date.now() - start > 30000) { resolve(JSON.stringify({ submitted: false, generationRequestSeen: false })); return; } setTimeout(check, 1000); }; check(); }); })()",
+      "description": "Wait for Flow to issue the image edit request"
+    },
+    {
+      "action": "screenshot",
+      "description": "Capture the image editor after staging or submission",
+      "optional": true
+    }
+  ]
+}