web-agent-bridge 3.3.0 → 3.8.1

package/examples/next-app-router/README.md

@@ -1,44 +1,44 @@
-# Next.js App Router + WAB
-
-1. Install the React helpers (from repo root after publish, or `file:` link):
-
-```bash
-npm install @web-agent-bridge/react
-```
-
-2. Add a client component `components/WabShop.tsx`:
-
-```tsx
-'use client';
-
-import { WABProvider, useWAB } from '@web-agent-bridge/react';
-import { useEffect } from 'react';
-
-function WabInner() {
-  const { ready, discover, execute } = useWAB({
-    name: 'My App',
-    actions: {
-      ping: { description: 'Health check', run: () => ({ ok: true }) },
-    },
-  });
-
-  useEffect(() => {
-    if (!ready) return;
-    discover().then(console.log);
-  }, [ready, discover]);
-
-  return <p>WAB {ready ? 'ready' : 'loading…'}</p>;
-}
-
-export default function WabShop() {
-  return (
-    <WABProvider scriptSrc="https://webagentbridge.com/script/wab.min.js">
-      <WabInner />
-    </WABProvider>
-  );
-}
-```
-
-3. Import `WabShop` from any `app/.../page.tsx` (server component can import client components).
-
-Use `next/script` with `strategy="beforeInteractive"` if you prefer loading `wab.min.js` in `layout.tsx` instead of `WABProvider`.
+# Next.js App Router + WAB
+
+1. Install the React helpers (from repo root after publish, or `file:` link):
+
+```bash
+npm install @web-agent-bridge/react
+```
+
+2. Add a client component `components/WabShop.tsx`:
+
+```tsx
+'use client';
+
+import { WABProvider, useWAB } from '@web-agent-bridge/react';
+import { useEffect } from 'react';
+
+function WabInner() {
+  const { ready, discover, execute } = useWAB({
+    name: 'My App',
+    actions: {
+      ping: { description: 'Health check', run: () => ({ ok: true }) },
+    },
+  });
+
+  useEffect(() => {
+    if (!ready) return;
+    discover().then(console.log);
+  }, [ready, discover]);
+
+  return <p>WAB {ready ? 'ready' : 'loading…'}</p>;
+}
+
+export default function WabShop() {
+  return (
+    <WABProvider scriptSrc="https://webagentbridge.com/script/wab.min.js">
+      <WabInner />
+    </WABProvider>
+  );
+}
+```
+
+3. Import `WabShop` from any `app/.../page.tsx` (server component can import client components).
+
+Use `next/script` with `strategy="beforeInteractive"` if you prefer loading `wab.min.js` in `layout.tsx` instead of `WABProvider`.

package/examples/plesk-wab-dns.js

@@ -0,0 +1,103 @@
+#!/usr/bin/env node
+/**
+ * plesk-wab-dns.js — enable/disable WAB DNS Discovery TXT record via Plesk REST API.
+ *
+ * Usage:
+ *   PLESK_API_KEY=… node plesk-wab-dns.js enable  example.com plesk.host.com
+ *   PLESK_API_KEY=… node plesk-wab-dns.js disable example.com plesk.host.com
+ *   node plesk-wab-dns.js status example.com
+ *
+ * Optional env vars:
+ *   PLESK_PORT=8443
+ *   PLESK_USER + PLESK_PASS (basic auth instead of API key)
+ *   WAB_BASE_URL (default: https://www.webagentbridge.com)
+ *   NODE_TLS_REJECT_UNAUTHORIZED=0 (for self-signed cert)
+ */
+
+'use strict';
+
+const fetch = (() => { try { return require('node-fetch'); } catch { return globalThis.fetch; } })();
+
+const [,, action, domain, host] = process.argv;
+const PORT     = process.env.PLESK_PORT    || '8443';
+const APIKEY   = process.env.PLESK_API_KEY;
+const USER     = process.env.PLESK_USER;
+const PASS     = process.env.PLESK_PASS;
+const WAB_BASE = process.env.WAB_BASE_URL  || 'https://www.webagentbridge.com';
+const ENDPOINT = process.env.WAB_ENDPOINT  || `https://${domain}/.well-known/wab.json`;
+
+if (!action || !domain) { console.error('Usage: node plesk-wab-dns.js <enable|disable|status> <domain> [plesk-host]'); process.exit(1); }
+if (!['enable','disable','status'].includes(action)) { console.error('Action must be: enable | disable | status'); process.exit(1); }
+if (action !== 'status' && !host) { console.error('plesk-host required for enable/disable'); process.exit(1); }
+if (action !== 'status' && !APIKEY && !(USER && PASS)) { console.error('Set PLESK_API_KEY or PLESK_USER + PLESK_PASS'); process.exit(1); }
+
+function headers() {
+  const h = { 'Content-Type': 'application/json' };
+  if (APIKEY) h['X-API-Key'] = APIKEY;
+  else h['Authorization'] = 'Basic ' + Buffer.from(`${USER}:${PASS}`).toString('base64');
+  return h;
+}
+
+const base = () => `https://${host}:${PORT}/api/v2`;
+
+async function pkReq(method, path, body) {
+  const opts = { method, headers: headers() };
+  if (body) opts.body = JSON.stringify(body);
+  const r = await fetch(`${base()}${path}`, opts);
+  const t = await r.text();
+  if (!r.ok) throw new Error(`Plesk ${r.status}: ${t.slice(0, 300)}`);
+  try { return JSON.parse(t); } catch { return t; }
+}
+
+async function getRecordTemplate() {
+  const j = await (await fetch(`${WAB_BASE}/api/discovery/provider/record-template?domain=${encodeURIComponent(domain)}&endpoint=${encodeURIComponent(ENDPOINT)}`)).json();
+  if (!j.record || !j.record.value) throw new Error('Could not fetch WAB record template');
+  return j.record.value;
+}
+
+async function listWab() {
+  const all = await pkReq('GET', `/dns/records?domain=${encodeURIComponent(domain)}&type=TXT`);
+  return (all || []).filter(r => {
+    const h = (r.host || '').replace(/\.$/, '');
+    return h === `_wab.${domain}` || h === '_wab';
+  });
+}
+
+async function main() {
+  console.log(`[WAB] Action: ${action} | Domain: ${domain}`);
+
+  if (action === 'status') {
+    const j = await (await fetch(`${WAB_BASE}/api/discovery/provider/status?domain=${encodeURIComponent(domain)}`)).json();
+    console.log(`[WAB] Status: ${j.status}`);
+    console.log(JSON.stringify(j, null, 2));
+    return;
+  }
+
+  if (action === 'enable') {
+    const txtVal = await getRecordTemplate();
+    console.log(`[WAB] TXT value: ${txtVal}`);
+    const existing = await listWab();
+    for (const rec of existing) {
+      console.log(`[Plesk] Deleting old record id=${rec.id}`);
+      await pkReq('DELETE', `/dns/records/${rec.id}`);
+    }
+    const out = await pkReq('POST', '/dns/records', {
+      domain, type: 'TXT', host: `_wab.${domain}`, value: txtVal,
+    });
+    console.log('[Plesk] Created TXT record');
+    console.log(JSON.stringify(out, null, 2));
+    console.log('[WAB] WAB Discovery ENABLED.');
+  }
+
+  if (action === 'disable') {
+    const existing = await listWab();
+    if (!existing.length) { console.log('[Plesk] No _wab record found — already disabled.'); return; }
+    for (const rec of existing) {
+      console.log(`[Plesk] Deleting record id=${rec.id}`);
+      await pkReq('DELETE', `/dns/records/${rec.id}`);
+    }
+    console.log('[WAB] WAB Discovery DISABLED.');
+  }
+}
+
+main().catch(err => { console.error('[ERROR]', err.message); process.exit(1); });

package/examples/puppeteer-agent.js

@@ -1,108 +1,108 @@
-/**
- * Example: Basic AI Agent using Puppeteer + WAB
- *
- * This agent connects to a website that has the Web Agent Bridge script installed,
- * discovers available actions, and executes them.
- *
- * Prerequisites:
- *   npm install puppeteer
- *
- * Usage:
- *   node examples/puppeteer-agent.js <url>
- */
-
-const puppeteer = require('puppeteer');
-
-const TARGET_URL = process.argv[2] || 'http://localhost:3000';
-
-async function main() {
-  console.log(`\n🤖 WAB Puppeteer Agent`);
-  console.log(`   Target: ${TARGET_URL}\n`);
-
-  const browser = await puppeteer.launch({ headless: true });
-  const page = await browser.newPage();
-
-  // Navigate to the target site
-  await page.goto(TARGET_URL, { waitUntil: 'networkidle2' });
-  console.log(`✓ Page loaded: ${await page.title()}`);
-
-  // Wait for WAB bridge to be ready
-  const hasBridge = await page.evaluate(() => {
-    return new Promise((resolve) => {
-      if (window.AICommands && window.AICommands._ready) {
-        resolve(true);
-      } else {
-        // Wait up to 5 seconds for bridge
-        const timeout = setTimeout(() => resolve(false), 5000);
-        document.addEventListener('wab:ready', () => {
-          clearTimeout(timeout);
-          resolve(true);
-        });
-      }
-    });
-  });
-
-  if (!hasBridge) {
-    console.log('✗ Web Agent Bridge not found on this page.');
-    await browser.close();
-    return;
-  }
-
-  console.log('✓ Web Agent Bridge detected\n');
-
-  // Step 1: Get page info
-  const pageInfo = await page.evaluate(() => window.AICommands.getPageInfo());
-  console.log('📄 Page Info:');
-  console.log(`   Title: ${pageInfo.title}`);
-  console.log(`   URL: ${pageInfo.url}`);
-  console.log(`   Bridge Version: ${pageInfo.bridgeVersion}`);
-  console.log(`   Tier: ${pageInfo.tier}`);
-  console.log(`   Actions Available: ${pageInfo.actionsCount}`);
-  console.log(`   Rate Limit Remaining: ${pageInfo.rateLimitRemaining}\n`);
-
-  // Step 2: Discover all available actions
-  const actions = await page.evaluate(() => window.AICommands.getActions());
-  console.log(`🔍 Discovered ${actions.length} actions:`);
-  actions.forEach((action) => {
-    console.log(`   • ${action.name} (${action.trigger}) — ${action.description}`);
-    if (action.fields) {
-      action.fields.forEach((f) => {
-        console.log(`     └─ ${f.name}: ${f.type}${f.required ? ' (required)' : ''}`);
-      });
-    }
-  });
-
-  // Step 3: Read content from the page
-  const content = await page.evaluate(() => {
-    return window.AICommands.readContent('h1') || window.AICommands.readContent('title');
-  });
-  if (content && content.success) {
-    console.log(`\n📖 Page heading: "${content.text}"`);
-  }
-
-  // Step 4: Execute a click action (first available)
-  const clickAction = actions.find((a) => a.trigger === 'click');
-  if (clickAction) {
-    console.log(`\n▶ Executing action: "${clickAction.name}"`);
-    const result = await page.evaluate(
-      (name) => window.AICommands.execute(name),
-      clickAction.name
-    );
-    console.log(`   Result: ${result.success ? '✓ Success' : '✗ ' + result.error}`);
-  }
-
-  // Step 5: List permissions
-  const permissions = pageInfo.permissions;
-  console.log('\n🔐 Permissions:');
-  Object.entries(permissions).forEach(([key, value]) => {
-    console.log(`   ${value ? '✓' : '✗'} ${key}`);
-  });
-
-  console.log('\n✓ Agent session complete.');
-  await browser.close();
-}
-
-main().catch((err) => {
-  console.error('Agent error:', err.message);
-  process.exit(1);
-});
+/**
+ * Example: Basic AI Agent using Puppeteer + WAB
+ *
+ * This agent connects to a website that has the Web Agent Bridge script installed,
+ * discovers available actions, and executes them.
+ *
+ * Prerequisites:
+ *   npm install puppeteer
+ *
+ * Usage:
+ *   node examples/puppeteer-agent.js <url>
+ */
+
+const puppeteer = require('puppeteer');
+
+const TARGET_URL = process.argv[2] || 'http://localhost:3000';
+
+async function main() {
+  console.log(`\n🤖 WAB Puppeteer Agent`);
+  console.log(`   Target: ${TARGET_URL}\n`);
+
+  const browser = await puppeteer.launch({ headless: true });
+  const page = await browser.newPage();
+
+  // Navigate to the target site
+  await page.goto(TARGET_URL, { waitUntil: 'networkidle2' });
+  console.log(`✓ Page loaded: ${await page.title()}`);
+
+  // Wait for WAB bridge to be ready
+  const hasBridge = await page.evaluate(() => {
+    return new Promise((resolve) => {
+      if (window.AICommands && window.AICommands._ready) {
+        resolve(true);
+      } else {
+        // Wait up to 5 seconds for bridge
+        const timeout = setTimeout(() => resolve(false), 5000);
+        document.addEventListener('wab:ready', () => {
+          clearTimeout(timeout);
+          resolve(true);
+        });
+      }
+    });
+  });
+
+  if (!hasBridge) {
+    console.log('✗ Web Agent Bridge not found on this page.');
+    await browser.close();
+    return;
+  }
+
+  console.log('✓ Web Agent Bridge detected\n');
+
+  // Step 1: Get page info
+  const pageInfo = await page.evaluate(() => window.AICommands.getPageInfo());
+  console.log('📄 Page Info:');
+  console.log(`   Title: ${pageInfo.title}`);
+  console.log(`   URL: ${pageInfo.url}`);
+  console.log(`   Bridge Version: ${pageInfo.bridgeVersion}`);
+  console.log(`   Tier: ${pageInfo.tier}`);
+  console.log(`   Actions Available: ${pageInfo.actionsCount}`);
+  console.log(`   Rate Limit Remaining: ${pageInfo.rateLimitRemaining}\n`);
+
+  // Step 2: Discover all available actions
+  const actions = await page.evaluate(() => window.AICommands.getActions());
+  console.log(`🔍 Discovered ${actions.length} actions:`);
+  actions.forEach((action) => {
+    console.log(`   • ${action.name} (${action.trigger}) — ${action.description}`);
+    if (action.fields) {
+      action.fields.forEach((f) => {
+        console.log(`     └─ ${f.name}: ${f.type}${f.required ? ' (required)' : ''}`);
+      });
+    }
+  });
+
+  // Step 3: Read content from the page
+  const content = await page.evaluate(() => {
+    return window.AICommands.readContent('h1') || window.AICommands.readContent('title');
+  });
+  if (content && content.success) {
+    console.log(`\n📖 Page heading: "${content.text}"`);
+  }
+
+  // Step 4: Execute a click action (first available)
+  const clickAction = actions.find((a) => a.trigger === 'click');
+  if (clickAction) {
+    console.log(`\n▶ Executing action: "${clickAction.name}"`);
+    const result = await page.evaluate(
+      (name) => window.AICommands.execute(name),
+      clickAction.name
+    );
+    console.log(`   Result: ${result.success ? '✓ Success' : '✗ ' + result.error}`);
+  }
+
+  // Step 5: List permissions
+  const permissions = pageInfo.permissions;
+  console.log('\n🔐 Permissions:');
+  Object.entries(permissions).forEach(([key, value]) => {
+    console.log(`   ${value ? '✓' : '✗'} ${key}`);
+  });
+
+  console.log('\n✓ Agent session complete.');
+  await browser.close();
+}
+
+main().catch((err) => {
+  console.error('Agent error:', err.message);
+  process.exit(1);
+});

package/examples/route53-wab-dns.js

@@ -0,0 +1,144 @@
+#!/usr/bin/env node
+/**
+ * route53-wab-dns.js
+ * -------------------
+ * CLI tool: enable or disable WAB DNS Discovery TXT record on AWS Route 53.
+ *
+ * Usage:
+ *   AWS_ACCESS_KEY_ID=… AWS_SECRET_ACCESS_KEY=… \
+ *     node route53-wab-dns.js enable  example.com [HOSTED_ZONE_ID]
+ *
+ *   AWS_ACCESS_KEY_ID=… AWS_SECRET_ACCESS_KEY=… \
+ *     node route53-wab-dns.js disable example.com [HOSTED_ZONE_ID]
+ *
+ *   node route53-wab-dns.js status example.com
+ *
+ * Optional env vars:
+ *   AWS_REGION          (default: us-east-1)
+ *   WAB_BASE_URL        (default: https://www.webagentbridge.com)
+ *   WAB_ENDPOINT        (override the wab.json URL in the TXT record)
+ *
+ * Required: @aws-sdk/client-route-53
+ *   npm install @aws-sdk/client-route-53
+ */
+
+'use strict';
+
+const {
+  Route53Client,
+  ChangeResourceRecordSetsCommand,
+  ListHostedZonesByNameCommand,
+  ListResourceRecordSetsCommand,
+} = require('@aws-sdk/client-route-53');
+
+const fetch = (() => {
+  try { return require('node-fetch'); }
+  catch { return globalThis.fetch; }
+})();
+
+const [,, action, domain, zoneIdArg] = process.argv;
+
+const REGION   = process.env.AWS_REGION    || 'us-east-1';
+const WAB_BASE = process.env.WAB_BASE_URL  || 'https://www.webagentbridge.com';
+const ENDPOINT = process.env.WAB_ENDPOINT  || `https://${domain}/.well-known/wab.json`;
+
+if (!action || !domain) {
+  console.error('Usage: node route53-wab-dns.js <enable|disable|status> <domain> [zone-id]');
+  process.exit(1);
+}
+if (!['enable','disable','status'].includes(action)) {
+  console.error('Action must be: enable | disable | status');
+  process.exit(1);
+}
+if (action !== 'status' && (!process.env.AWS_ACCESS_KEY_ID || !process.env.AWS_SECRET_ACCESS_KEY)) {
+  console.error('Set AWS_ACCESS_KEY_ID and AWS_SECRET_ACCESS_KEY env variables');
+  process.exit(1);
+}
+
+const client = new Route53Client({ region: REGION });
+
+async function getRecordTemplate() {
+  const url = `${WAB_BASE}/api/discovery/provider/record-template?domain=${encodeURIComponent(domain)}&endpoint=${encodeURIComponent(ENDPOINT)}`;
+  const j   = await (await fetch(url)).json();
+  if (!j.record || !j.record.value) throw new Error('Could not fetch WAB record template');
+  // Route 53 requires double-quoted TXT value
+  const v = j.record.value;
+  return v.startsWith('"') ? v : `"${v}"`;
+}
+
+async function resolveZoneId() {
+  if (zoneIdArg) return zoneIdArg;
+  console.log(`[R53] Resolving hosted zone for ${domain}…`);
+  const r = await client.send(new ListHostedZonesByNameCommand({ DNSName: domain, MaxItems: '1' }));
+  const zone = (r.HostedZones || []).find(z => z.Name === `${domain}.`);
+  if (!zone) throw new Error(`No hosted zone found for "${domain}"`);
+  return zone.Id.replace('/hostedzone/', '');
+}
+
+async function getCurrentRecord(zoneId) {
+  const r = await client.send(new ListResourceRecordSetsCommand({
+    HostedZoneId: zoneId,
+    StartRecordName: `_wab.${domain}`,
+    StartRecordType: 'TXT',
+    MaxItems: '1',
+  }));
+  return (r.ResourceRecordSets || []).find(
+    rr => rr.Name === `_wab.${domain}.` && rr.Type === 'TXT'
+  ) || null;
+}
+
+async function main() {
+  console.log(`[WAB] Action: ${action} | Domain: ${domain}`);
+
+  if (action === 'status') {
+    const j = await (await fetch(`${WAB_BASE}/api/discovery/provider/status?domain=${encodeURIComponent(domain)}`)).json();
+    console.log(`[WAB] Status: ${j.status}`);
+    console.log(JSON.stringify(j, null, 2));
+    return;
+  }
+
+  const zoneId  = await resolveZoneId();
+  console.log(`[R53] Zone ID: ${zoneId}`);
+
+  if (action === 'enable') {
+    const txtVal = await getRecordTemplate();
+    console.log(`[WAB] TXT value: ${txtVal}`);
+
+    await client.send(new ChangeResourceRecordSetsCommand({
+      HostedZoneId: zoneId,
+      ChangeBatch: {
+        Comment: 'WAB DNS Discovery enable',
+        Changes: [{
+          Action: 'UPSERT',
+          ResourceRecordSet: {
+            Name: `_wab.${domain}`,
+            Type: 'TXT',
+            TTL:  3600,
+            ResourceRecords: [{ Value: txtVal }],
+          },
+        }],
+      },
+    }));
+    console.log('[R53] UPSERT applied');
+    console.log('[WAB] WAB Discovery ENABLED. Propagation may take up to 60 s.');
+  }
+
+  if (action === 'disable') {
+    const existing = await getCurrentRecord(zoneId);
+    if (!existing) {
+      console.log('[R53] No _wab TXT record found — already disabled.');
+      return;
+    }
+    await client.send(new ChangeResourceRecordSetsCommand({
+      HostedZoneId: zoneId,
+      ChangeBatch: {
+        Comment: 'WAB DNS Discovery disable',
+        Changes: [{ Action: 'DELETE', ResourceRecordSet: existing }],
+      },
+    }));
+    console.log('[R53] Record deleted');
+    console.log('[WAB] WAB Discovery DISABLED.');
+  }
+}
+
+main().catch(err => { console.error('[ERROR]', err.message); process.exit(1); });

package/examples/saas-dashboard/README.md

@@ -1,55 +1,55 @@
-# SaaS Dashboard Example (Notion-style)
-
-A practical setup for internal dashboards where agents read KPIs and trigger safe workflows.
-
-## Embed
-
-```html
-<script src="https://webagentbridge.com/script/wab.min.js"></script>
-<script>
-window.WAB.init({
-  name: 'Acme SaaS Dashboard',
-  actions: {
-    getKpiCards: {
-      description: 'Return KPI card values from dashboard widgets',
-      run: function () {
-        var cards = Array.from(document.querySelectorAll('[data-kpi-card]')).map(function (card) {
-          return {
-            key: card.getAttribute('data-kpi-card'),
-            label: (card.querySelector('[data-kpi-label]') || {}).textContent || null,
-            value: (card.querySelector('[data-kpi-value]') || {}).textContent || null
-          };
-        });
-        return { success: true, cards: cards };
-      }
-    },
-    openCustomerById: {
-      description: 'Open customer panel using data-customer-id selector',
-      params: [{ name: 'customerId', type: 'string', required: true }],
-      run: function (params) {
-        var id = String(params.customerId || '').trim();
-        if (!id) return { success: false, error: 'customerId is required' };
-        var row = document.querySelector('[data-customer-id="' + CSS.escape(id) + '"]');
-        if (!row) return { success: false, error: 'Customer not found' };
-        row.click();
-        return { success: true, customerId: id };
-      }
-    },
-    triggerInvoiceReminder: {
-      description: 'Trigger existing invoice reminder button from dashboard row',
-      params: [{ name: 'invoiceId', type: 'string', required: true }],
-      run: function (params) {
-        var id = String(params.invoiceId || '').trim();
-        if (!id) return { success: false, error: 'invoiceId is required' };
-        var btn = document.querySelector('[data-invoice-id="' + CSS.escape(id) + '"] [data-action="send-reminder"]');
-        if (!btn) return { success: false, error: 'Reminder action not found for invoice' };
-        btn.click();
-        return { success: true, invoiceId: id };
-      }
-    }
-  }
-});
-</script>
-```
-
-The selectors use data attributes so actions stay stable across UI redesigns.
+# SaaS Dashboard Example (Notion-style)
+
+A practical setup for internal dashboards where agents read KPIs and trigger safe workflows.
+
+## Embed
+
+```html
+<script src="https://webagentbridge.com/script/wab.min.js"></script>
+<script>
+window.WAB.init({
+  name: 'Acme SaaS Dashboard',
+  actions: {
+    getKpiCards: {
+      description: 'Return KPI card values from dashboard widgets',
+      run: function () {
+        var cards = Array.from(document.querySelectorAll('[data-kpi-card]')).map(function (card) {
+          return {
+            key: card.getAttribute('data-kpi-card'),
+            label: (card.querySelector('[data-kpi-label]') || {}).textContent || null,
+            value: (card.querySelector('[data-kpi-value]') || {}).textContent || null
+          };
+        });
+        return { success: true, cards: cards };
+      }
+    },
+    openCustomerById: {
+      description: 'Open customer panel using data-customer-id selector',
+      params: [{ name: 'customerId', type: 'string', required: true }],
+      run: function (params) {
+        var id = String(params.customerId || '').trim();
+        if (!id) return { success: false, error: 'customerId is required' };
+        var row = document.querySelector('[data-customer-id="' + CSS.escape(id) + '"]');
+        if (!row) return { success: false, error: 'Customer not found' };
+        row.click();
+        return { success: true, customerId: id };
+      }
+    },
+    triggerInvoiceReminder: {
+      description: 'Trigger existing invoice reminder button from dashboard row',
+      params: [{ name: 'invoiceId', type: 'string', required: true }],
+      run: function (params) {
+        var id = String(params.invoiceId || '').trim();
+        if (!id) return { success: false, error: 'invoiceId is required' };
+        var btn = document.querySelector('[data-invoice-id="' + CSS.escape(id) + '"] [data-action="send-reminder"]');
+        if (!btn) return { success: false, error: 'Reminder action not found for invoice' };
+        btn.click();
+        return { success: true, invoiceId: id };
+      }
+    }
+  }
+});
+</script>
+```
+
+The selectors use data attributes so actions stay stable across UI redesigns.