agent-tank 0.9.6 → 0.9.8

package/src/cli-background.js

@@ -0,0 +1,198 @@
+const fs = require('node:fs');
+const os = require('node:os');
+const path = require('node:path');
+const { spawn } = require('node:child_process');
+const {
+  filterBackgroundArgs,
+  findAgentTankProcessesAsync,
+} = require('./process-utils.js');
+const { ANSI } = require('./logger.js');
+
+const BACKGROUND_STARTUP_GRACE_MS = 750;
+
+function createBackgroundLogPath({
+  env = process.env,
+  tmpdir = os.tmpdir,
+  pid = process.pid,
+  now = Date.now,
+} = {}) {
+  return env.AGENT_TANK_BACKGROUND_LOG ||
+    path.join(tmpdir(), `agent-tank-${pid}-${now()}.log`);
+}
+
+function writeBackgroundStartMessage({ pid, logPath, stdout = process.stdout }) {
+  stdout.write(`Agent Tank started in the background with PID ${pid}\n`);
+  stdout.write(`Background log: ${logPath}\n`);
+}
+
+function writeBackgroundStartFailure({ message, logPath, stderr = process.stderr }) {
+  stderr.write(`Failed to start Agent Tank in the background: ${message}\n`);
+  stderr.write(`Background log: ${logPath}\n`);
+}
+
+function ignoreLateChildError() {}
+
+function openBackgroundLog(logPath, openSync = fs.openSync) {
+  return openSync(logPath, 'a');
+}
+
+function closeBackgroundLog(logFd, closeSync = fs.closeSync) {
+  try {
+    closeSync(logFd);
+  } catch (_err) {
+    // The child owns the duplicated descriptor after spawn; parent close failures are non-fatal.
+  }
+}
+
+function getBackgroundStartupGraceMs(env = process.env) {
+  const parsed = Number.parseInt(env.AGENT_TANK_BACKGROUND_GRACE_MS, 10);
+  return Number.isFinite(parsed) && parsed >= 0 ? parsed : BACKGROUND_STARTUP_GRACE_MS;
+}
+
+function waitForBackgroundStartup(child, graceMs, setTimer = setTimeout, clearTimer = clearTimeout) {
+  return new Promise((resolve, reject) => {
+    let settled = false;
+
+    const finish = (callback, value) => {
+      if (settled) {
+        return;
+      }
+      settled = true;
+      clearTimer(timer);
+      child.off('error', onError);
+      child.off('exit', onExit);
+      callback(value);
+    };
+
+    const onError = (err) => finish(reject, err);
+    const onExit = (code, signal) => {
+      const detail = signal ? `signal ${signal}` : `exit code ${code}`;
+      finish(reject, new Error(`child exited during startup (${detail})`));
+    };
+    const timer = setTimer(() => finish(resolve), graceMs);
+
+    child.once('error', onError);
+    child.once('exit', onExit);
+  });
+}
+
+async function spawnBackgroundProcess({
+  argv = process.argv,
+  env = process.env,
+  execPath = process.execPath,
+  spawnFn = spawn,
+  stdout = process.stdout,
+  stderr = process.stderr,
+  openSync = fs.openSync,
+  closeSync = fs.closeSync,
+  startupGraceMs,
+} = {}) {
+  const resolvedStartupGraceMs = startupGraceMs ?? getBackgroundStartupGraceMs(env);
+  const logPath = createBackgroundLogPath({ env });
+  let logFd;
+
+  try {
+    logFd = openBackgroundLog(logPath, openSync);
+  } catch (err) {
+    writeBackgroundStartFailure({ message: err.message, logPath, stderr });
+    return false;
+  }
+
+  const childArgs = [
+    argv[1],
+    ...filterBackgroundArgs(argv.slice(2)),
+  ];
+  const childEnv = {
+    ...env,
+    AGENT_TANK_BACKGROUND_CHILD: '1',
+  };
+  delete childEnv.AGENT_TANK_BACKGROUND;
+  delete childEnv.AGENT_TANK_BACKGROUND_LOG;
+  delete childEnv.AGENT_TANK_BACKGROUND_GRACE_MS;
+
+  let child;
+  try {
+    child = spawnFn(execPath, childArgs, {
+      detached: true,
+      stdio: ['ignore', logFd, logFd],
+      env: childEnv,
+      windowsHide: true,
+    });
+  } catch (err) {
+    closeBackgroundLog(logFd, closeSync);
+    writeBackgroundStartFailure({ message: err.message, logPath, stderr });
+    return false;
+  }
+
+  closeBackgroundLog(logFd, closeSync);
+  child.on('error', ignoreLateChildError);
+
+  try {
+    await waitForBackgroundStartup(child, resolvedStartupGraceMs);
+  } catch (err) {
+    writeBackgroundStartFailure({ message: err.message, logPath, stderr });
+    return false;
+  }
+
+  if (!child.pid) {
+    // Extremely defensive: normal spawn failures are reported via the error event above.
+    writeBackgroundStartFailure({ message: 'child process PID was not assigned', logPath, stderr });
+    return false;
+  }
+
+  child.unref();
+  writeBackgroundStartMessage({ pid: child.pid, logPath, stdout });
+  return true;
+}
+
+function redactProcessCommand(command) {
+  return command
+    .replace(/(--auth-pass(?:=|\s+))(?:"[^"]*"|'[^']*'|\S+)/g, '$1[redacted]')
+    .replace(/(--auth-token(?:=|\s+))(?:"[^"]*"|'[^']*'|\S+)/g, '$1[redacted]');
+}
+
+async function warnAboutRunningProcesses({
+  findProcesses = findAgentTankProcessesAsync,
+  stderr = process.stderr,
+} = {}) {
+  let running;
+  try {
+    running = await findProcesses();
+  } catch (_err) {
+    return;
+  }
+
+  if (running.length === 0) {
+    return;
+  }
+
+  const lines = running
+    .map(entry => `  PID ${entry.pid}: ${redactProcessCommand(entry.command)}`)
+    .join('\n');
+
+  // Only emit color when writing to an interactive terminal, so redirected
+  // logs stay free of ANSI escape sequences.
+  const header = 'Warning: other Agent Tank process(es) already running:';
+  const coloredHeader = stderr.isTTY
+    ? `${ANSI.bold}${ANSI.red}${header}${ANSI.reset}`
+    : header;
+
+  const pids = running.map(entry => entry.pid).join(' ');
+
+  stderr.write(`${coloredHeader}\n`);
+  stderr.write(`${lines}\n`);
+  stderr.write('If this instance uses the same port, startup will fail; choose a different --port or stop the other process.\n');
+  stderr.write(`To stop the process(es) above, run: kill ${pids}\n`);
+  stderr.write(`If a process does not exit, force it with: kill -9 ${pids}\n`);
+  stderr.write('Tip: start Agent Tank in the background with agent-tank --background\n');
+}
+
+module.exports = {
+  BACKGROUND_STARTUP_GRACE_MS,
+  createBackgroundLogPath,
+  getBackgroundStartupGraceMs,
+  redactProcessCommand,
+  spawnBackgroundProcess,
+  waitForBackgroundStartup,
+  warnAboutRunningProcesses,
+};

package/src/client-auto-refresh-helpers.js

@@ -41,7 +41,7 @@ const timeHelpers = `
     // Cycle duration constants (mirrored from server-side)
     const CYCLE_DURATIONS = {
       session: 5 * 60 * 60,
-      sessionGemini: 24 * 60 * 60,
+      sessionAgy: 24 * 60 * 60,
       weekly: 7 * 24 * 60 * 60,
       fiveHour: 5 * 60 * 60
     };
@@ -74,21 +74,21 @@ const metricExtractors = `
       return metrics;
     }
 
-    // Extract metrics from Gemini usage data
-    function extractGeminiMetrics(usage) {
+    // Extract metrics from Antigravity usage data
+    function extractAgyMetrics(usage) {
       const metrics = [];
       if (usage.models && usage.models.length > 0) {
         for (const model of usage.models) {
-          const modelName = model.model.toLowerCase();
-          const metricId = \`gemini-\${modelName.replace(/[^a-z0-9]/g, '-')}\`;
+          const modelName = model.model;
+          const metricId = \`agy-\${modelName.toLowerCase().replace(/[^a-z0-9]/g, '-')}\`;
           metrics.push({
             metricId,
-            agent: 'gemini',
+            agent: 'agy',
             label: modelName,
             percent: model.percentUsed ?? 0,
             resetsIn: model.resetsIn || '',
             resetsAt: model.resetsAt || '',
-            cycle: 'sessionGemini'
+            cycle: 'sessionAgy'
           });
         }
       }

package/src/client-auto-refresh.js

@@ -142,8 +142,8 @@ ${metricExtractors}
           let metrics = [];
           if (agentName === 'claude') {
             metrics = extractClaudeMetrics(agentData.usage);
-          } else if (agentName === 'gemini') {
-            metrics = extractGeminiMetrics(agentData.usage);
+          } else if (agentName === 'agy') {
+            metrics = extractAgyMetrics(agentData.usage);
           } else if (agentName === 'codex') {
             metrics = extractCodexMetrics(agentData.usage);
           }

package/src/client-monitor.js

@@ -183,7 +183,7 @@ const monitorScript = `
       const { percent, color, agent, label } = trackedMetric;
 
       // Update page title: XX% Agent | Agent Tank (clean format for squeezed tabs)
-      const agentName = agent.charAt(0).toUpperCase() + agent.slice(1);
+      const agentName = agent === 'agy' ? 'Antigravity' : agent.charAt(0).toUpperCase() + agent.slice(1);
       document.title = \`\${percent}% \${agentName} | Agent Tank\`;
 
       // Generate favicon using Canvas API
@@ -204,7 +204,7 @@ const monitorScript = `
 
         // Send browser notification
         if ('Notification' in window && Notification.permission === 'granted') {
-          const agentName = agent.charAt(0).toUpperCase() + agent.slice(1);
+          const agentName = agent === 'agy' ? 'Antigravity' : agent.charAt(0).toUpperCase() + agent.slice(1);
           new Notification('Agent Tank Warning', {
             body: \`\${agentName} \${label} is at \${percent}% usage!\`,
             icon: '/favicon.ico',

package/src/discovery.js

@@ -22,22 +22,15 @@ async function discoverAgents() {
     }
   }
 
-  // Check for Gemini with version requirement
-  if (commandExists('gemini')) {
-    const version = getGeminiVersion();
+  // Check for Antigravity CLI
+  if (commandExists('agy')) {
+    const version = getAgyVersion();
     if (version) {
-      if (!compareVersion(version, 0, 24, 5)) {
-        logger.warn(`Gemini CLI version ${version.full} detected. Version 0.24.5+ required for /stats command.`);
-        logger.warn('Please update: npm update -g gemini');
-      } else {
-        logger.success(`✅ Gemini CLI version ${version.full} detected`);
-        found.push('gemini');
-      }
+      logger.success(`✅ Antigravity CLI version ${version.full} detected`);
     } else {
-      // If we can't determine version, add with warning
-      logger.warn('Gemini found but version unknown. Version 0.24.5+ required for /stats command.');
-      found.push('gemini');
+      logger.success('✅ Antigravity CLI detected (version unknown)');
     }
+    found.push('agy');
   }
 
   // Check for Codex with version info
@@ -81,9 +74,9 @@ function getClaudeVersion() {
   return null;
 }
 
-function getGeminiVersion() {
+function getAgyVersion() {
   try {
-    const output = execSync('gemini --version 2>&1', { encoding: 'utf-8' });
+    const output = execSync('agy --version 2>&1', { encoding: 'utf-8' });
     const match = output.match(/(\d+)\.(\d+)\.(\d+)/);
     if (match) {
       return {
@@ -117,12 +110,4 @@ function getCodexVersion() {
   return null;
 }
 
-function compareVersion(version, minMajor, minMinor, minPatch) {
-  if (version.major > minMajor) return true;
-  if (version.major < minMajor) return false;
-  if (version.minor > minMinor) return true;
-  if (version.minor < minMinor) return false;
-  return version.patch >= minPatch;
-}
-
-module.exports = { discoverAgents };
+module.exports = { discoverAgents };

package/src/history-store.js

@@ -130,7 +130,7 @@ class HistoryStore {
   /**
    * Add a usage snapshot to history.
    *
-   * @param {string} agentName - Name of the agent (e.g., 'claude', 'gemini', 'codex')
+   * @param {string} agentName - Name of the agent (e.g., 'claude', 'agy', 'codex')
    * @param {Object} usageData - The usage data to store
    * @param {string} [timestamp] - ISO timestamp (defaults to current time)
    * @returns {Object} The stored record

package/src/icons.js

@@ -12,8 +12,8 @@ const agentIcons = {
   claude: `<svg class="agent-icon" viewBox="0 0 24 24" fill="currentColor" xmlns="http://www.w3.org/2000/svg">
     <path d="M4.709 15.955l4.72-2.647.08-.23-.08-.128H9.2l-.79-.048-2.698-.073-2.339-.097-2.266-.122-.571-.121L0 11.784l.055-.352.48-.321.686.06 1.52.103 2.278.158 1.652.097 2.449.255h.389l.055-.157-.134-.098-.103-.097-2.358-1.596-2.552-1.688-1.336-.972-.724-.491-.364-.462-.158-1.008.656-.722.881.06.225.061.893.686 1.908 1.476 2.491 1.833.365.304.145-.103.019-.073-.164-.274-1.355-2.446-1.446-2.49-.644-1.032-.17-.619a2.97 2.97 0 01-.104-.729L6.283.134 6.696 0l.996.134.42.364.62 1.414 1.002 2.229 1.555 3.03.456.898.243.832.091.255h.158V9.01l.128-1.706.237-2.095.23-2.695.08-.76.376-.91.747-.492.584.28.48.685-.067.444-.286 1.851-.559 2.903-.364 1.942h.212l.243-.242.985-1.306 1.652-2.064.73-.82.85-.904.547-.431h1.033l.76 1.129-.34 1.166-1.064 1.347-.881 1.142-1.264 1.7-.79 1.36.073.11.188-.02 2.856-.606 1.543-.28 1.841-.315.833.388.091.395-.328.807-1.969.486-2.309.462-3.439.813-.042.03.049.061 1.549.146.662.036h1.622l3.02.225.79.522.474.638-.079.485-1.215.62-1.64-.389-3.829-.91-1.312-.329h-.182v.11l1.093 1.068 2.006 1.81 2.509 2.33.127.578-.322.455-.34-.049-2.205-1.657-.851-.747-1.926-1.62h-.128v.17l.444.649 2.345 3.521.122 1.08-.17.353-.608.213-.668-.122-1.374-1.925-1.415-2.167-1.143-1.943-.14.08-.674 7.254-.316.37-.729.28-.607-.461-.322-.747.322-1.476.389-1.924.315-1.53.286-1.9.17-.632-.012-.042-.14.018-1.434 1.967-2.18 2.945-1.726 1.845-.414.164-.717-.37.067-.662.401-.589 2.388-3.036 1.44-1.882.93-1.086-.006-.158h-.055L4.132 18.56l-1.13.146-.487-.456.061-.746.231-.243 1.908-1.312-.006.006z" />
   </svg>`,
-  gemini: `<svg class="agent-icon" viewBox="0 0 24 24" fill="currentColor" xmlns="http://www.w3.org/2000/svg">
-    <path d="M20.616 10.835a14.147 14.147 0 01-4.45-3.001 14.111 14.111 0 01-3.678-6.452.503.503 0 00-.975 0 14.134 14.134 0 01-3.679 6.452 14.155 14.155 0 01-4.45 3.001c-.65.28-1.318.505-2.002.678a.502.502 0 000 .975c.684.172 1.35.397 2.002.677a14.147 14.147 0 014.45 3.001 14.112 14.112 0 013.679 6.453.502.502 0 00.975 0c.172-.685.397-1.351.677-2.003a14.145 14.145 0 013.001-4.45 14.113 14.113 0 016.453-3.678.503.503 0 000-.975 13.245 13.245 0 01-2.003-.678z" />
+  agy: `<svg class="agent-icon" viewBox="0 0 24 24" fill="currentColor" xmlns="http://www.w3.org/2000/svg" aria-label="Antigravity">
+    <path d="M21.751 22.607c1.34 1.005 3.35.335 1.508-1.508C17.73 15.74 18.904 1 12.037 1 5.17 1 6.342 15.74.815 21.1c-2.01 2.009.167 2.511 1.507 1.506 5.192-3.517 4.857-9.714 9.715-9.714 4.857 0 4.522 6.197 9.714 9.715z" />
   </svg>`,
   codex: `<svg class="agent-icon" viewBox="0 0 24 24" fill="currentColor" xmlns="http://www.w3.org/2000/svg">
     <path d="M22.2819 9.8211a5.9847 5.9847 0 0 0-.5157-4.9108 6.0462 6.0462 0 0 0-6.5098-2.9A6.0651 6.0651 0 0 0 4.9807 4.1818a5.9847 5.9847 0 0 0-3.9977 2.9 6.0462 6.0462 0 0 0 .7427 7.0966 5.98 5.98 0 0 0 .511 4.9107 6.051 6.051 0 0 0 6.5146 2.9001A5.9847 5.9847 0 0 0 13.2599 24a6.0557 6.0557 0 0 0 5.7718-4.2058 5.9894 5.9894 0 0 0 3.9977-2.9001 6.0557 6.0557 0 0 0-.7475-7.0729zm-9.022 12.6081a4.4755 4.4755 0 0 1-2.8764-1.0408l.1419-.0804 4.7783-2.7582a.7948.7948 0 0 0 .3927-.6813v-6.7369l2.02 1.1686a.071.071 0 0 1 .038.052v5.5826a4.504 4.504 0 0 1-4.4945 4.4944zm-9.6607-4.1254a4.4708 4.4708 0 0 1-.5346-3.0137l.142.0852 4.783 2.7582a.7712.7712 0 0 0 .7806 0l5.8428-3.3685v2.3324a.0804.0804 0 0 1-.0332.0615L9.74 19.9502a4.4992 4.4992 0 0 1-6.1408-1.6464zM2.3408 7.8956a4.485 4.485 0 0 1 2.3655-1.9728V11.6a.7664.7664 0 0 0 .3879.6765l5.8144 3.3543-2.0201 1.1685a.0757.0757 0 0 1-.071 0l-4.8303-2.7865A4.504 4.504 0 0 1 2.3408 7.872zm16.5963 3.8558L13.1038 8.364 15.1192 7.2a.0757.0757 0 0 1 .071 0l4.8303 2.7913a4.4944 4.4944 0 0 1-.6765 8.1042v-5.6772a.79.79 0 0 0-.407-.667zm2.0107-3.0231l-.142-.0852-4.7735-2.7818a.7759.7759 0 0 0-.7854 0L9.409 9.2297V6.8974a.0662.0662 0 0 1 .0284-.0615l4.8303-2.7866a4.4992 4.4992 0 0 1 6.6802 4.66zM8.3065 12.863l-2.02-1.1638a.0804.0804 0 0 1-.038-.0567V6.0742a4.4992 4.4992 0 0 1 7.3757-3.4537l-.142.0805L8.704 5.459a.7948.7948 0 0 0-.3927.6813zm1.0976-2.3654l2.602-1.4998 2.6069 1.4998v2.9994l-2.5974 1.4997-2.6067-1.4997Z" />

package/src/index.js

@@ -1,8 +1,10 @@
+/* eslint-disable max-lines -- Tracked in issue #90; keep this PR scoped to background startup behavior. */
+
 const path = require('node:path');
 const os = require('node:os');
 const { execFileSync } = require('node:child_process');
 const { ClaudeAgent } = require('./agents/claude.js');
-const { GeminiAgent } = require('./agents/gemini.js');
+const { AgyAgent } = require('./agents/agy.js');
 const { CodexAgent } = require('./agents/codex.js');
 const { discoverAgents } = require('./discovery.js');
 const { fetchPublicStatus } = require('./public-status.js');
@@ -121,7 +123,6 @@ class AgentTank {
     this.requestedAgents = options.agents || null;
     this.freshProcess = options.freshProcess || false;
     this.claudeApi = options.claudeApi || false; // Use direct Anthropic API for Claude
-    this.geminiMode = options.geminiMode || 'fallback';
     this.auth = options.auth || {};
     this.agents = new Map();
     this.server = null;
@@ -236,11 +237,11 @@ class AgentTank {
           logger.warn('No compatible LLM agents found.');
           logger.info('Requirements:');
           logger.info('  - Claude Code 2.0+ (for /usage command support)');
-          logger.info('  - Gemini CLI 0.24.5+ (for /stats command support)');
+          logger.info('  - Antigravity CLI as agy (for /usage command support)');
           logger.info('  - Codex CLI');
           logger.info('\nInstall/update with:');
           logger.info('  npm install -g @anthropic-ai/claude-code@latest');
-          logger.info('  npm install -g gemini@latest');
+          logger.info('  Install Antigravity CLI from https://antigravity.google/docs/cli-getting-started');
           throw new Error('No agents found');
         }
         logger.success(`✅ Found agents: ${agentNames.join(', ')}`);
@@ -327,8 +328,8 @@ class AgentTank {
     switch (name) {
       case 'claude':
         return new ClaudeAgent({ useApi: this.claudeApi });
-      case 'gemini':
-        return new GeminiAgent({ mode: this.geminiMode });
+      case 'agy':
+        return new AgyAgent();
       case 'codex':
         return new CodexAgent();
       default:

package/src/logger.js

@@ -39,7 +39,7 @@ const ANSI = {
 // Agent color mapping
 const AGENT_COLORS = {
   claude: ANSI.magenta,
-  gemini: ANSI.cyan,
+  agy: ANSI.cyan,
   codex: ANSI.green,
 };
 
@@ -139,7 +139,7 @@ const logger = {
 
   /**
    * Log an agent-specific message with mapped color
-   * @param {string} agentName - Name of the agent (claude, gemini, codex)
+   * @param {string} agentName - Name of the agent (claude, agy, codex)
    * @param {...any} args - Message arguments
    */
   agent(agentName, ...args) {

package/src/pace-attachment.js

@@ -47,14 +47,14 @@ function attachClaudePace(usage) {
 }
 
 /**
- * Attach pace evaluation to Gemini usage metrics.
- * @param {Object} usage - Gemini usage data
+ * Attach pace evaluation to Antigravity usage metrics.
+ * @param {Object} usage - Antigravity usage data
  */
-function attachGeminiPace(usage) {
+function attachAgyPace(usage) {
   if (!usage.models || !Array.isArray(usage.models)) return;
 
   for (const model of usage.models) {
-    attachPaceToData(model, 'percentUsed', 'sessionGemini');
+    attachPaceToData(model, 'percentUsed', 'sessionAgy');
   }
 }
 
@@ -86,8 +86,8 @@ function attachPaceEvaluation(agentName, usage) {
     case 'claude':
       attachClaudePace(usage);
       break;
-    case 'gemini':
-      attachGeminiPace(usage);
+    case 'agy':
+      attachAgyPace(usage);
       break;
     case 'codex':
       attachCodexPace(usage);
@@ -98,7 +98,7 @@ function attachPaceEvaluation(agentName, usage) {
 module.exports = {
   attachPaceEvaluation,
   attachClaudePace,
-  attachGeminiPace,
+  attachAgyPace,
   attachCodexPace,
   attachPaceToData
 };

package/src/process-utils.js

@@ -0,0 +1,215 @@
+const { execFile } = require('node:child_process');
+const path = require('node:path');
+
+const BACKGROUND_ARG_RE = /^--(?:no-)?background$/;
+const AGENT_TANK_BIN_RE = /(^|[\\/])bin[\\/]agent-tank\.js$/;
+const PROCESS_SCAN_TIMEOUT_MS = 2000;
+const WINDOWS_PROCESS_SCAN_TIMEOUT_MS = 8000;
+const PROCESS_SCAN_MAX_BUFFER = 8 * 1024 * 1024;
+const WINDOWS_PROCESS_SCAN_MAX_BUFFER = 32 * 1024 * 1024;
+// This covers common Node flags that take a separate value; unknown flags may
+// still be heuristic misses, but process warnings are best-effort only.
+const NODE_OPTIONS_WITH_VALUE = new Set([
+  '-C',
+  '--conditions',
+  '-e',
+  '--eval',
+  '--experimental-loader',
+  '--import',
+  '--loader',
+  '-r',
+  '--require',
+]);
+
+function isTruthyEnv(value) {
+  return value === '1' || value === 'true';
+}
+
+function filterBackgroundArgs(args) {
+  return args.filter(arg => !BACKGROUND_ARG_RE.test(arg));
+}
+
+function parseProcessList(output) {
+  return output
+    .split('\n')
+    .map(line => line.trim())
+    .filter(Boolean)
+    .map(line => {
+      const match = line.match(/^(\d+)\s+(.+)$/);
+      if (!match) {
+        return null;
+      }
+      return {
+        pid: Number(match[1]),
+        command: match[2],
+      };
+    })
+    .filter(Boolean);
+}
+
+function parseWindowsProcessList(output) {
+  const parsed = JSON.parse(output || '[]');
+  const entries = Array.isArray(parsed) ? parsed : [parsed];
+
+  return entries
+    .map(entry => ({
+      pid: Number(entry.ProcessId),
+      command: entry.CommandLine || '',
+    }))
+    .filter(entry => Number.isFinite(entry.pid) && entry.command);
+}
+
+function commandTokens(command) {
+  const tokens = [];
+  const tokenRe = /"([^"]*)"|'([^']*)'|[^\s]+/g;
+  let match;
+
+  while ((match = tokenRe.exec(command)) !== null) {
+    tokens.push(match[1] ?? match[2] ?? match[0]);
+  }
+
+  return tokens;
+}
+
+function commandBasename(token) {
+  return path.basename(token.replace(/^"|"$/g, '').replace(/\\/g, '/')).toLowerCase();
+}
+
+function isAgentTankExecutable(token) {
+  const executable = commandBasename(token);
+  return executable === 'agent-tank' ||
+    executable === 'agent-tank.cmd' ||
+    executable === 'agent-tank.ps1';
+}
+
+function isAgentTankNodeScript(token) {
+  const scriptPath = token.replace(/^"|"$/g, '');
+  return AGENT_TANK_BIN_RE.test(scriptPath) || isAgentTankExecutable(scriptPath);
+}
+
+function isNodeInterpreter(token) {
+  return /^(?:node|nodejs|node\d*)(?:\.exe)?$/.test(commandBasename(token));
+}
+
+function findNodeScriptToken(tokens) {
+  for (let index = 1; index < tokens.length; index += 1) {
+    const token = tokens[index];
+
+    if (NODE_OPTIONS_WITH_VALUE.has(token)) {
+      index += 1;
+      continue;
+    }
+
+    if (token.startsWith('--') && NODE_OPTIONS_WITH_VALUE.has(token.split('=')[0])) {
+      continue;
+    }
+
+    if (token.startsWith('-')) {
+      continue;
+    }
+
+    return token;
+  }
+
+  return null;
+}
+
+function isAgentTankCommand(command) {
+  const tokens = commandTokens(command);
+  if (tokens.length === 0) {
+    return false;
+  }
+
+  if (isAgentTankExecutable(tokens[0])) {
+    return true;
+  }
+
+  if (!isNodeInterpreter(tokens[0])) {
+    return false;
+  }
+
+  const scriptToken = findNodeScriptToken(tokens);
+  return Boolean(scriptToken && isAgentTankNodeScript(scriptToken));
+}
+
+function getProcessScanCommand(platform, scanTimeoutMs) {
+  const timeout = scanTimeoutMs ?? (
+    platform === 'win32' ? WINDOWS_PROCESS_SCAN_TIMEOUT_MS : PROCESS_SCAN_TIMEOUT_MS
+  );
+
+  if (platform === 'win32') {
+    return {
+      file: 'powershell.exe',
+      args: [
+        '-NoProfile',
+        '-Command',
+        'Get-CimInstance Win32_Process | Select-Object ProcessId,CommandLine | ConvertTo-Json -Compress',
+      ],
+      options: {
+        encoding: 'utf8',
+        maxBuffer: WINDOWS_PROCESS_SCAN_MAX_BUFFER,
+        timeout,
+      },
+      parse: parseWindowsProcessList,
+    };
+  }
+
+  return {
+    file: 'ps',
+    args: ['-eo', 'pid=,args='],
+    options: {
+      encoding: 'utf8',
+      maxBuffer: PROCESS_SCAN_MAX_BUFFER,
+      timeout,
+    },
+    parse: parseProcessList,
+  };
+}
+
+function filterAgentTankProcesses(processes, currentPid) {
+  return processes
+    .filter(entry => entry.pid !== currentPid)
+    .filter(entry => isAgentTankCommand(entry.command));
+}
+
+function execFilePromise(execFileFn, file, args, options) {
+  return new Promise((resolve, reject) => {
+    execFileFn(file, args, options, (err, stdout) => {
+      if (err) {
+        reject(err);
+        return;
+      }
+
+      resolve(stdout);
+    });
+  });
+}
+
+async function findAgentTankProcessesAsync({
+  currentPid = process.pid,
+  execFileFn = execFile,
+  platform = process.platform,
+  scanTimeoutMs,
+} = {}) {
+  const command = getProcessScanCommand(platform, scanTimeoutMs);
+
+  try {
+    const output = await execFilePromise(execFileFn, command.file, command.args, command.options);
+    return filterAgentTankProcesses(command.parse(output), currentPid);
+  } catch (_err) {
+    return [];
+  }
+}
+
+module.exports = {
+  filterBackgroundArgs,
+  findAgentTankProcessesAsync,
+  isAgentTankCommand,
+  isTruthyEnv,
+  parseProcessList,
+  parseWindowsProcessList,
+  PROCESS_SCAN_MAX_BUFFER,
+  PROCESS_SCAN_TIMEOUT_MS,
+  WINDOWS_PROCESS_SCAN_MAX_BUFFER,
+  WINDOWS_PROCESS_SCAN_TIMEOUT_MS,
+};