@xbrowser/cli 1.9.8 → 1.10.0

package/dist/chunk-Q2DFJQGS.js

@@ -0,0 +1,128 @@
+// src/daemon/daemon.ts
+import { spawn } from "child_process";
+import { join, dirname } from "path";
+import { homedir } from "os";
+import { fileURLToPath } from "url";
+import { writeFileSync, unlinkSync, mkdirSync } from "fs";
+import { stopDaemon as xcliStopDaemon, isDaemonRunning, getDaemonStatus, killAllDaemon } from "@dyyz1993/xcli-core";
+var CONFIG_DIR = join(homedir(), ".xbrowser");
+var __dirname = dirname(fileURLToPath(import.meta.url));
+var WORKER_PATH = join(__dirname, "daemon-main.js");
+function getDaemonConfig() {
+  return {
+    configDir: CONFIG_DIR,
+    workerEntryPath: WORKER_PATH,
+    basePort: 9224
+  };
+}
+async function startDaemonProcess(port = 9224) {
+  const config = getDaemonConfig();
+  if (isDaemonRunning(config)) {
+    const status = getDaemonStatus(config);
+    if (status.port === port && status.pid) {
+      return { pid: status.pid, port: status.port, startedAt: (/* @__PURE__ */ new Date()).toISOString() };
+    }
+    await xcliStopDaemon(config);
+  }
+  const lockFile = join(CONFIG_DIR, "daemon.lock");
+  try {
+    mkdirSync(CONFIG_DIR, { recursive: true });
+    writeFileSync(lockFile, String(process.pid), { flag: "wx" });
+  } catch {
+    console.error("Another process is starting the daemon, waiting...");
+    for (let i = 0; i < 50; i++) {
+      await new Promise((r) => setTimeout(r, 200));
+      if (isDaemonRunning(config)) {
+        const s = getDaemonStatus(config);
+        if (s.port === port && s.pid) {
+          return { pid: s.pid, port: s.port, startedAt: (/* @__PURE__ */ new Date()).toISOString() };
+        }
+      }
+    }
+    try {
+      unlinkSync(lockFile);
+    } catch {
+    }
+    try {
+      writeFileSync(lockFile, String(process.pid), { flag: "wx" });
+    } catch {
+    }
+  }
+  const child = spawn("node", [WORKER_PATH], {
+    detached: true,
+    stdio: "ignore",
+    env: {
+      ...process.env,
+      XBROWSER_DAEMON_PORT: String(port)
+    }
+  });
+  child.unref();
+  return new Promise((resolve, reject) => {
+    let resolved = false;
+    const timeout = setTimeout(() => {
+      if (!resolved) {
+        resolved = true;
+        try {
+          unlinkSync(lockFile);
+        } catch {
+        }
+        reject(new Error("Daemon start timeout after 15s"));
+      }
+    }, 15e3);
+    const checkInterval = setInterval(() => {
+      if (isDaemonRunning(config)) {
+        const s = getDaemonStatus(config);
+        if (s.port === port && s.pid) {
+          resolved = true;
+          clearTimeout(timeout);
+          clearInterval(checkInterval);
+          try {
+            unlinkSync(lockFile);
+          } catch {
+          }
+          resolve({ pid: s.pid, port: s.port, startedAt: (/* @__PURE__ */ new Date()).toISOString() });
+        }
+      }
+    }, 200);
+    child.on("error", (err) => {
+      if (!resolved) {
+        resolved = true;
+        clearTimeout(timeout);
+        clearInterval(checkInterval);
+        try {
+          unlinkSync(lockFile);
+        } catch {
+        }
+        reject(err);
+      }
+    });
+  });
+}
+async function stopDaemonProcess() {
+  await xcliStopDaemon(getDaemonConfig());
+}
+async function killAllDaemonProcesses() {
+  await killAllDaemon(getDaemonConfig());
+}
+function getDaemonProcessStatus() {
+  const config = getDaemonConfig();
+  const running = isDaemonRunning(config);
+  if (!running) {
+    return { running: false, pid: 0, port: 0, info: null };
+  }
+  const status = getDaemonStatus(config);
+  return {
+    running: true,
+    pid: status.pid,
+    port: status.port,
+    info: { pid: status.pid, port: status.port, startedAt: (/* @__PURE__ */ new Date()).toISOString() }
+  };
+}
+
+export {
+  getDaemonConfig,
+  startDaemonProcess,
+  stopDaemonProcess,
+  killAllDaemonProcesses,
+  getDaemonProcessStatus
+};

package/dist/{chunk-GM3HWQ5U.js → chunk-RRBXV7KE.js}

@@ -288,6 +288,36 @@ function queryJS(selector) {
     const xpath = JSON.stringify(selector.slice(6));
     return `document.evaluate(${xpath}, document, null, XPathResult.FIRST_ORDERED_NODE_TYPE, null).singleNodeValue`;
   }
+  if (selector.startsWith("text=")) {
+    const raw = selector.slice(5);
+    const exact = raw.startsWith('"') && raw.endsWith('"');
+    const text = exact ? raw.slice(1, -1) : raw;
+    return `(() => {
+      const target = ${JSON.stringify(text)};
+      const exact = ${exact};
+      const els = [...document.querySelectorAll('*')].filter(e => {
+        if (e.children.length > 0) return false;
+        if (e.offsetParent === null) return false;
+        const t = (e.textContent || '').trim();
+        if (!t) return false;
+        return exact ? t === target : t.toLowerCase().includes(target.toLowerCase());
+      });
+      return els[0] || null;
+    })()`;
+  }
+  if (selector.startsWith("popup-text=")) {
+    const text = selector.slice("popup-text=".length);
+    return `(() => {
+      const target = ${JSON.stringify(text)};
+      const els = [...document.querySelectorAll('*')].filter(e => {
+        if (e.children.length > 0) return false;
+        if (e.offsetParent === null) return false;
+        if ((e.textContent || '').trim() !== target) return false;
+        return true;
+      });
+      return els[0] || null;
+    })()`;
+  }
   return `document.querySelector(${JSON.stringify(selector)})`;
 }
 function queryAllJS(selector) {
@@ -295,6 +325,9 @@ function queryAllJS(selector) {
     const xpath = JSON.stringify(selector.slice(6));
     return `(() => { const it = document.evaluate(${xpath}, document, null, XPathResult.ORDERED_NODE_SNAPSHOT_TYPE, null); const r=[]; for(let i=0;i<it.snapshotLength;i++) r.push(it.snapshotItem(i)); return r; })()`;
   }
+  if (selector.startsWith("text=") || selector.startsWith("popup-text=")) {
+    return `(() => { const el = ${queryJS(selector)}; return el ? [el] : []; })()`;
+  }
   return `document.querySelectorAll(${JSON.stringify(selector)})`;
 }
 
@@ -2757,11 +2790,52 @@ var CDPConnection = class extends EventEmitter4 {
     this.setMaxListeners(0);
     this.defaultSessionId = sessionId;
     if (typeof wsOrUrl === "string") {
-      this.ws = new WebSocket(wsOrUrl);
+      const wsOptions = /^wss:\/\/\d+\.\d+\.\d+\.\d+/.test(wsOrUrl) ? { rejectUnauthorized: false } : void 0;
+      this.ws = new WebSocket(wsOrUrl, wsOptions);
     } else {
       this.ws = wsOrUrl;
     }
     this.bindWebSocket();
+    this.startKeepalive();
+  }
+  /** Send periodic WS pings to prevent idle-timeout disconnects (e.g. CF's 100s).
+   *  Also detects dead connections: if a pong isn't received within 10s of a
+   *  ping, the connection is considered dead and forcibly closed. */
+  keepaliveTimer = null;
+  pongTimer = null;
+  startKeepalive() {
+    this.ws.on("pong", () => {
+      if (this.pongTimer) {
+        clearTimeout(this.pongTimer);
+        this.pongTimer = null;
+      }
+    });
+    this.keepaliveTimer = setInterval(() => {
+      if (this.ws.readyState === WebSocket.OPEN) {
+        if (!this.pongTimer) {
+          this.pongTimer = setTimeout(() => {
+            if (!this.closed) {
+              this.closed = true;
+              this.closeReason = "keepalive timeout (no pong in 10s)";
+              try {
+                this.ws.terminate();
+              } catch {
+              }
+              for (const [, pending] of this.pending) {
+                clearTimeout(pending.timeout);
+                pending.reject(new Error("Connection dead: keepalive timeout"));
+              }
+              this.pending.clear();
+              this.emit("disconnect");
+            }
+          }, 1e4);
+        }
+        this.ws.ping?.();
+      } else if (this.closed) {
+        if (this.keepaliveTimer) clearInterval(this.keepaliveTimer);
+        this.keepaliveTimer = null;
+      }
+    }, 3e4);
   }
   /** Wait for the connection to be fully open */
   async ready() {
@@ -2870,6 +2944,14 @@ var CDPConnection = class extends EventEmitter4 {
     if (this.closed) return;
     this.closed = true;
     this.closeReason = "closed by caller";
+    if (this.keepaliveTimer) {
+      clearInterval(this.keepaliveTimer);
+      this.keepaliveTimer = null;
+    }
+    if (this.pongTimer) {
+      clearTimeout(this.pongTimer);
+      this.pongTimer = null;
+    }
     for (const [id, pending] of this.pending) {
       clearTimeout(pending.timeout);
       pending.reject(new Error(`Connection closed: ${pending.method}`));
@@ -2911,6 +2993,10 @@ var CDPConnection = class extends EventEmitter4 {
       if (this.closed) return;
       this.closed = true;
       this.closeReason = `WebSocket closed: ${code} ${reason?.toString() ?? ""}`.trim();
+      if (this.keepaliveTimer) {
+        clearInterval(this.keepaliveTimer);
+        this.keepaliveTimer = null;
+      }
       for (const [id, pending] of this.pending) {
         clearTimeout(pending.timeout);
         pending.reject(new Error(`Connection closed: ${pending.method}`));

package/dist/{human-interaction-HJTXFVQS.js → chunk-SQHSZENE.js}

@@ -1,7 +1,6 @@
 import {
   ScreencastCapturer
-} from "./chunk-7ZDWM6T2.js";
-import "./chunk-KFQGP6VL.js";
+} from "./chunk-BNO7OKO4.js";
 
 // src/human-interaction.ts
 import { execSync } from "child_process";
@@ -307,6 +306,7 @@ var HumanInteractionManager = class {
     });
   }
 };
+
 export {
   HumanInteractionManager
 };

package/dist/chunk-TZPKFUBT.js

@@ -0,0 +1,20 @@
+import {
+  getDaemonConfig,
+  getDaemonProcessStatus
+} from "./chunk-CG3D3CHY.js";
+
+// src/utils/viewer-url.ts
+function buildViewerUrl(sessionName = "default") {
+  try {
+    const status = getDaemonProcessStatus();
+    if (!status.running) return void 0;
+    const port = status.port || getDaemonConfig().basePort;
+    return `http://localhost:${port}/preview/${encodeURIComponent(sessionName)}`;
+  } catch {
+    return void 0;
+  }
+}
+
+export {
+  buildViewerUrl
+};

package/dist/{chunk-PBDID7SE.js → chunk-WSCP7QCJ.js}

@@ -1,6 +1,6 @@
 import {
   launch
-} from "./chunk-GM3HWQ5U.js";
+} from "./chunk-RRBXV7KE.js";
 import {
   errMsg
 } from "./chunk-GDKLH7ZY.js";
@@ -134,7 +134,7 @@ process.on("exit", () => {
     if (session.isCDP) {
       logSessionEvent("process_exit", `Session "${session.name}": CDP connection (not closing external browser).`);
     } else {
-      logSessionEvent("process_exit", `Session "${session.name}": Closing browser.`);
+      logSessionEvent("process_exit", `Session "${session.name}": Closing self-launched browser.`);
       try {
         session.browser?.close();
       } catch {
@@ -142,7 +142,7 @@ process.on("exit", () => {
     }
   }
   if (_sharedBrowser) {
-    logSessionEvent("process_exit", "Closing shared browser.");
+    logSessionEvent("process_exit", "Closing shared browser (self-launched only, external CDP is safe).");
     try {
       _sharedBrowser.close();
     } catch {
@@ -272,9 +272,29 @@ function deleteSessionDiskMeta(name) {
   } catch {
   }
 }
+async function isSessionPageAlive(session) {
+  const page = session.page;
+  if (!page || typeof page.evaluate !== "function") return false;
+  try {
+    await Promise.race([
+      page.evaluate("1"),
+      new Promise((_, reject) => setTimeout(() => reject(new Error("liveness probe timeout")), 1500))
+    ]);
+    return true;
+  } catch {
+    return false;
+  }
+}
 async function findOrRestoreSession(name, cdpEndpoint) {
   const inMem = findSession(name);
-  if (inMem) return inMem;
+  if (inMem) {
+    if (await isSessionPageAlive(inMem)) return inMem;
+    logSessionEvent("stale_session", `name="${name}" \u2014 page \u63A2\u9488\u5931\u8D25\uFF08\u6D4F\u89C8\u5668\u53EF\u80FD\u5DF2\u91CD\u542F\uFF09\uFF0C\u5C31\u5730\u91CD\u5EFA`);
+    try {
+      await closeSessionByName(name);
+    } catch {
+    }
+  }
   const meta = readSessionDiskMeta(name);
   if (!meta) return void 0;
   const ep = cdpEndpoint || meta.cdpEndpoint;
@@ -537,14 +557,6 @@ async function createSession(name, url, options) {
   let context;
   let page;
   if (isCDP) {
-    await new Promise((r) => setTimeout(r, 500));
-    let contexts = b.contexts();
-    if (contexts.length === 0) {
-      await new Promise((r) => setTimeout(r, 500));
-      contexts = b.contexts();
-    }
-    context = contexts[0] || await b.newContext();
-    let targetPage = null;
     const targetHostname = url ? (() => {
       try {
         return new URL(url).hostname;
@@ -552,12 +564,54 @@ async function createSession(name, url, options) {
         return "";
       }
     })() : "";
+    const isRealPageUrl = (u) => !!u && u !== "about:blank" && !u.startsWith("chrome://") && !u.startsWith("chrome-untrusted://") && !u.startsWith("chrome-error://");
+    const resolvePageUrl = async (p) => {
+      const u = p.url();
+      if (u && u !== "about:blank") return u;
+      try {
+        return await p.evaluate("location.href");
+      } catch {
+        return u ?? "";
+      }
+    };
+    const pollStart = Date.now();
+    for (; ; ) {
+      const ctxs = b.contexts();
+      let hostHit = false;
+      let anyHit = false;
+      for (const ctx of ctxs) {
+        for (const p of ctx.pages()) {
+          const u = await resolvePageUrl(p);
+          if (!isRealPageUrl(u)) continue;
+          anyHit = true;
+          if (targetHostname && u.includes(targetHostname)) {
+            hostHit = true;
+            break;
+          }
+        }
+        if (hostHit) break;
+      }
+      if (process.env.XB_DEBUG_SESSION_POLL) {
+        console.error(`[poll] t=${Date.now() - pollStart}ms ctxs=${ctxs.length} hostHit=${hostHit} anyHit=${anyHit}`);
+      }
+      if (hostHit) break;
+      if (anyHit && Date.now() - pollStart >= 2e3) break;
+      if (Date.now() - pollStart >= 5e3) break;
+      await new Promise((r) => setTimeout(r, 200));
+    }
+    let contexts = b.contexts();
+    if (contexts.length === 0) {
+      await new Promise((r) => setTimeout(r, 500));
+      contexts = b.contexts();
+    }
+    context = contexts[0] || await b.newContext();
+    let targetPage = null;
     if (targetHostname) {
       for (const ctx of contexts) {
         const pages = ctx.pages();
         for (const p of pages) {
-          const pUrl = p.url();
-          if (pUrl && pUrl !== "about:blank" && !pUrl.startsWith("chrome://") && !pUrl.startsWith("chrome-untrusted://") && !pUrl.startsWith("chrome-error://") && pUrl.includes(targetHostname)) {
+          const pUrl = await resolvePageUrl(p);
+          if (isRealPageUrl(pUrl) && pUrl.includes(targetHostname)) {
             targetPage = p;
             break;
           }
@@ -569,8 +623,8 @@ async function createSession(name, url, options) {
       for (const ctx of contexts) {
         const pages = ctx.pages();
         for (const p of pages) {
-          const pUrl = p.url();
-          if (pUrl && pUrl !== "about:blank" && !pUrl.startsWith("chrome://") && !pUrl.startsWith("chrome-untrusted://") && !pUrl.startsWith("chrome-error://")) {
+          const pUrl = await resolvePageUrl(p);
+          if (isRealPageUrl(pUrl)) {
             targetPage = p;
             break;
           }
@@ -628,10 +682,6 @@ async function closeSessionByName(name) {
     if (session.name === name || session.id === name) {
       logSessionEvent("close_session", `name="${session.name}" id="${session.id}" url="${session.page.url()}"`);
       if (session.isCDP) {
-        try {
-          await session.page.close();
-        } catch {
-        }
         if (session.browser) {
           await session.browser.close().catch(() => {
           });
@@ -656,7 +706,7 @@ async function closeSessionByName(name) {
       } catch {
       }
       try {
-        const { SessionRecorder } = await import("./session-recorder-AG6CH6EI.js");
+        const { SessionRecorder } = await import("./session-recorder-QRZMKFVL.js");
         SessionRecorder.cleanup(session.name);
       } catch {
       }
@@ -675,12 +725,17 @@ async function closeAllSessions() {
   if (names) logSessionEvent("close_all_sessions", `Closing ${sessions.size} sessions: ${names}`);
   for (const session of sessions.list()) {
     try {
-      if (!session.isCDP) {
+      if (session.isCDP) {
+        if (session.browser) {
+          await session.browser.close().catch(() => {
+          });
+        }
+      } else {
         await session.context.close();
-      }
-      if (session.browser) {
-        await session.browser.close().catch(() => {
-        });
+        if (session.browser) {
+          await session.browser.close().catch(() => {
+          });
+        }
       }
       sessions.removeById(session.id);
     } catch {
@@ -689,7 +744,7 @@ async function closeAllSessions() {
   }
 }
 async function destroyBrowser() {
-  logSessionEvent("destroy_browser", `Sessions count: ${sessions.size}. Clearing idle timer and closing all browsers.`);
+  logSessionEvent("destroy_browser", `Sessions count: ${sessions.size}. Clearing idle timer and closing all sessions.`);
   if (idleTimer) {
     clearTimeout(idleTimer);
     idleTimer = null;
@@ -725,8 +780,6 @@ async function ensureProcessCanExit() {
   for (const session of sessions.list()) {
     if (session.browser) {
       if (session.isCDP) {
-        await session.browser.close().catch(() => {
-        });
       } else {
         await session.browser.close().catch(() => {
         });

package/dist/{chunk-YAUG3NSI.js → chunk-YMUSHPU4.js}

@@ -1,128 +1,11 @@
+import {
+  startDaemonProcess,
+  stopDaemonProcess
+} from "./chunk-Q2DFJQGS.js";
 import {
   errMsg
 } from "./chunk-GDKLH7ZY.js";
 
-// src/daemon/daemon.ts
-import { spawn } from "child_process";
-import { join, dirname } from "path";
-import { homedir } from "os";
-import { fileURLToPath } from "url";
-import { writeFileSync, unlinkSync, mkdirSync } from "fs";
-import { stopDaemon as xcliStopDaemon, isDaemonRunning, getDaemonStatus, killAllDaemon } from "@dyyz1993/xcli-core";
-var CONFIG_DIR = join(homedir(), ".xbrowser");
-var __dirname = dirname(fileURLToPath(import.meta.url));
-var WORKER_PATH = join(__dirname, "daemon-main.js");
-function getDaemonConfig() {
-  return {
-    configDir: CONFIG_DIR,
-    workerEntryPath: WORKER_PATH,
-    basePort: 9224
-  };
-}
-async function startDaemonProcess(port = 9224) {
-  const config = getDaemonConfig();
-  if (isDaemonRunning(config)) {
-    const status = getDaemonStatus(config);
-    if (status.port === port && status.pid) {
-      return { pid: status.pid, port: status.port, startedAt: (/* @__PURE__ */ new Date()).toISOString() };
-    }
-    await xcliStopDaemon(config);
-  }
-  const lockFile = join(CONFIG_DIR, "daemon.lock");
-  try {
-    mkdirSync(CONFIG_DIR, { recursive: true });
-    writeFileSync(lockFile, String(process.pid), { flag: "wx" });
-  } catch {
-    console.error("Another process is starting the daemon, waiting...");
-    for (let i = 0; i < 50; i++) {
-      await new Promise((r) => setTimeout(r, 200));
-      if (isDaemonRunning(config)) {
-        const s = getDaemonStatus(config);
-        if (s.port === port && s.pid) {
-          return { pid: s.pid, port: s.port, startedAt: (/* @__PURE__ */ new Date()).toISOString() };
-        }
-      }
-    }
-    try {
-      unlinkSync(lockFile);
-    } catch {
-    }
-    try {
-      writeFileSync(lockFile, String(process.pid), { flag: "wx" });
-    } catch {
-    }
-  }
-  const child = spawn("node", [WORKER_PATH], {
-    detached: true,
-    stdio: "ignore",
-    env: {
-      ...process.env,
-      XBROWSER_DAEMON_PORT: String(port)
-    }
-  });
-  child.unref();
-  return new Promise((resolve, reject) => {
-    let resolved = false;
-    const timeout = setTimeout(() => {
-      if (!resolved) {
-        resolved = true;
-        try {
-          unlinkSync(lockFile);
-        } catch {
-        }
-        reject(new Error("Daemon start timeout after 15s"));
-      }
-    }, 15e3);
-    const checkInterval = setInterval(() => {
-      if (isDaemonRunning(config)) {
-        const s = getDaemonStatus(config);
-        if (s.port === port && s.pid) {
-          resolved = true;
-          clearTimeout(timeout);
-          clearInterval(checkInterval);
-          try {
-            unlinkSync(lockFile);
-          } catch {
-          }
-          resolve({ pid: s.pid, port: s.port, startedAt: (/* @__PURE__ */ new Date()).toISOString() });
-        }
-      }
-    }, 200);
-    child.on("error", (err) => {
-      if (!resolved) {
-        resolved = true;
-        clearTimeout(timeout);
-        clearInterval(checkInterval);
-        try {
-          unlinkSync(lockFile);
-        } catch {
-        }
-        reject(err);
-      }
-    });
-  });
-}
-async function stopDaemonProcess() {
-  await xcliStopDaemon(getDaemonConfig());
-}
-async function killAllDaemonProcesses() {
-  await killAllDaemon(getDaemonConfig());
-}
-function getDaemonProcessStatus() {
-  const config = getDaemonConfig();
-  const running = isDaemonRunning(config);
-  if (!running) {
-    return { running: false, pid: 0, port: 0, info: null };
-  }
-  const status = getDaemonStatus(config);
-  return {
-    running: true,
-    pid: status.pid,
-    port: status.port,
-    info: { pid: status.pid, port: status.port, startedAt: (/* @__PURE__ */ new Date()).toISOString() }
-  };
-}
-
 // src/version.ts
 import { createRequire } from "module";
 var require2 = createRequire(import.meta.url);
@@ -201,7 +84,7 @@ async function rpcCall(method, params = {}, timeoutMs = 1e4) {
   }
   return resp.json();
 }
-async function isDaemonRunning2() {
+async function isDaemonRunning() {
   try {
     const resp = await fetch(`${DAEMON_BASE}/health`, { signal: AbortSignal.timeout(2e3) });
     if (!resp.ok) return false;
@@ -238,6 +121,15 @@ async function forwardExec(command, params, session = "default", cdpEndpoint, ti
     return { success: false, data: null, message: errMsg(e), duration: 0 };
   }
 }
+async function forwardPluginExec(command, params, session = "default", cdpEndpoint, timeoutMs = 12e4) {
+  const rpcParams = { command, params, session };
+  if (cdpEndpoint) rpcParams.cdpEndpoint = cdpEndpoint;
+  try {
+    return await rpcCall("plugin:exec", rpcParams, timeoutMs);
+  } catch (e) {
+    return { success: false, data: null, message: errMsg(e), duration: 0 };
+  }
+}
 async function forwardChain(input, session = "default", cdpEndpoint) {
   const params = { chain: input, session };
   if (cdpEndpoint) params.cdpEndpoint = cdpEndpoint;
@@ -329,17 +221,13 @@ async function forwardViewerCheckSelector(name, selector) {
 
 export {
   version,
-  getDaemonConfig,
-  startDaemonProcess,
-  stopDaemonProcess,
-  killAllDaemonProcesses,
-  getDaemonProcessStatus,
-  isDaemonRunning2 as isDaemonRunning,
+  isDaemonRunning,
   daemonPing,
   forwardSessionCreate,
   forwardSessionClose,
   forwardSessionList,
   forwardExec,
+  forwardPluginExec,
   forwardChain,
   forwardAgentObserve,
   forwardAgentAct,