Recipes & Copy-Paste Flows

// 1) Go to /login (don’t steal focus) on a named tab
const url='https://app.example.com/login';
try{
  await askBackoff('navigate', { url, focus:false, tabKey:'auth' });
}catch(e){
  if ((e.code||'')==='DOMAIN_NOT_ALLOWED'){ showAllowFor(url); throw e; }
  throw e;
}

// 2) Wait for either the login form or a "ready" badge (already signed in)
const seen = await Promise.race([
  ask('waitFor', { selector:'#email',       timeoutMs:15000, tabKey:'auth' }).then(_=>'form'),
  ask('waitFor', { selector:'.badge.ready', timeoutMs:15000, tabKey:'auth' }).then(_=>'ready')
]).catch(_=>null);

// 3) If we saw the form, fill it and submit
if (seen==='form'){
  await ask('domSetValue', { selector:'#email', value:'user@example.com', tabKey:'auth' });
  await ask('domSetValue', { selector:'#note',  value:'hello world',     tabKey:'auth' });
  await ask('domClick',    { selector:'button[type=submit]',             tabKey:'auth' });
  // Wait for a post-login marker
  await ask('waitFor',     { selector:'.badge.ready', timeoutMs:30000,   tabKey:'auth' });
}

// 4) Optionally bring the remote tab to front when needed
await ask('focus', { tabKey:'auth' });

const u = await ask('getUrl', { tabKey:'auth' }).catch(_=>null);
if (!u?.ok || !u.data?.url?.startsWith('https://app.example.com/dashboard')) {
  try{
    await askBackoff('navigate', { url:'https://app.example.com/dashboard', focus:false, tabKey:'auth' });
  }catch(e){
    if ((e.code||'')==='DOMAIN_NOT_ALLOWED'){ showAllowFor('https://app.example.com/dashboard'); throw e; }
    else throw e;
  }
}
const t = await ask('runJs', { code:'document.title', tabKey:'auth' });
if (!t?.ok || !/Dashboard/i.test(String(t.data||''))) throw new Error('Unexpected page title');

// Wait until the table has ≥ 1 row
async function waitTableRows(selector='table.data', timeout=30000, step=600){
  const t0 = Date.now();
  while(Date.now()-t0 < timeout){
    const has = await ask('runJs', { code:`(function(){
      const t=document.querySelector('${selector}');
      return !!(t && t.tBodies[0] && t.tBodies[0].rows.length);
    })()`, tabKey:'sales' });
    if (has?.ok && has.data===true) return true;
    await new Promise(r=>setTimeout(r, step));
  }
  throw Object.assign(new Error('TIMEOUT'), { code:'TIMEOUT' });
}
await waitTableRows();

// Paginate politely (max 5 pages here)
for (let i=0;i<5;i++){
  // Simple extraction
  const count = await ask('runJs', { code:`(function(){
    const t=document.querySelector('table.data'); return t ? (t.tBodies[0]?.rows.length||0) : 0;
  })()`, tabKey:'sales' });
  console.log('Rows on page', i+1, ':', count?.ok ? count.data : 0);

  // If a non-disabled Next button exists, click it
  const hasNext = await ask('runJs', { code:`(function(){
    const n=document.querySelector('button.next:not([disabled])'); return !!n;
  })()`, tabKey:'sales' });
  if (!hasNext?.ok || !hasNext.data) break;
  await ask('domClick', { selector:'button.next', tabKey:'sales' });
  await new Promise(r => setTimeout(r, 500)); // small pause
}

// If you need to select by visible label:
await ask('runJs', { code:`(function(){
  const s=document.querySelector('select#status'); if(!s) return false;
  const opt=[...s.options].find(o=>o.textContent.trim()==='Active'); if(!opt) return false;
  s.value=opt.value; s.dispatchEvent(new Event('input',{bubbles:true}));
  s.dispatchEvent(new Event('change',{bubbles:true}));
  return true;
})()`, tabKey:'sales' });

await ask('runJs', { code:`(function(){
  const el=document.querySelector('#tos'); if(!el) return false;
  if (!el.checked){ el.checked=true; el.dispatchEvent(new Event('change',{bubbles:true})); }
  return true;
})()`, tabKey:'sales' });

await ask('runJs', { code:`(function(){
  const host=document.querySelector('my-input'); if(!host||!host.shadowRoot) return false;
  const input=host.shadowRoot.querySelector('input'); if(!input) return false;
  input.value='hello'; input.dispatchEvent(new Event('input',{bubbles:true}));
  return true;
})()`, tabKey:'sales' });

const pages=['/a','/b','/c'].map(x=>'https://example.com'+x);
for (const url of pages){
  try{
    await askBackoff('navigate', { url, tabKey:'sales' });
    await ask('waitFor', { selector:'body', timeoutMs:15000, tabKey:'sales' });
    const h1 = await ask('runJs', { code:'(document.querySelector("h1")||{}).textContent||""', tabKey:'sales' });
    console.log('Visited:', url, 'Title:', h1?.ok ? h1.data : '');
  }catch(e){
    if ((e.code||'')==='DOMAIN_NOT_ALLOWED'){ showAllowFor(url); break; }
    else { console.warn('Step failed', e); }
  }
  await new Promise(r => setTimeout(r, 600)); // be polite with the target app
}