halo-agent 2.2.2 → 2.2.4

package/browser.js

@@ -135,7 +135,7 @@ async function connectToChrome(retries = 10, opts = {}) {
               ctx = fresh.contexts()[0] || await fresh.newContext();
               conn.context = ctx;
             }
-            const page = await ctx.newPage();
+            let page = await ctx.newPage();
             if (url) {
               try {
                 await page.goto(url, { waitUntil: 'domcontentloaded', timeout: 60000 });
@@ -153,6 +153,39 @@ async function connectToChrome(retries = 10, opts = {}) {
                   await page.waitForTimeout(8000);
                 }
               }
+
+              // VERIFY-AFTER-GOTO. connectOverCDP against the user's REAL Chrome
+              // has a tab-handle race: ctx.newPage() may hand back a different
+              // tab than the one that actually navigated (e.g. Chrome already
+              // had a restored New Tab open). Symptom: the agent then scans
+              // about:blank / chrome://newtab forever while the target URL is
+              // loaded in a sibling tab. Self-correct: if our handle isn't on
+              // the target host, find the tab that IS and adopt it.
+              try {
+                const here = page.url();
+                const targetHost = new URL(url).hostname;
+                const onTarget = (u) => { try { return new URL(u).hostname === targetHost; } catch { return false; } };
+                if (!onTarget(here)) {
+                  // Look across all pages in this context for the one that navigated.
+                  const pages = ctx.pages();
+                  const match = pages.find((p) => onTarget(p.url()));
+                  if (match && match !== page) {
+                    console.warn(`[halo-agent] newPage handle was on "${here.slice(0, 40)}" but target loaded in another tab — adopting it.`);
+                    // Close the stray blank tab we opened so it doesn't litter.
+                    if (/^about:blank$|^chrome:\/\/newtab/i.test(here)) {
+                      try { await page.close(); } catch {}
+                    }
+                    page = match;
+                    await page.bringToFront().catch(() => {});
+                  } else if (/^about:blank$|^chrome:\/\/newtab/i.test(here)) {
+                    // Our tab is genuinely blank and nothing else navigated —
+                    // the goto silently no-op'd. Retry the navigation on THIS tab.
+                    console.warn('[halo-agent] Tab still blank after goto — retrying navigation on this handle...');
+                    await page.goto(url, { waitUntil: 'commit', timeout: 30000 }).catch(() => {});
+                    await page.waitForTimeout(4000);
+                  }
+                }
+              } catch { /* best-effort self-correction; fall through */ }
             }
             return page;
           },

package/index.js

@@ -38,14 +38,18 @@ async function main() {
     let v = '';
     try { v = require('./package.json').version; } catch {}
     ui.banner(v);
+    console.log(`  ${ui.bold('Usage')}  ${ui.gray('halo-agent <command>')}`);
     console.log('');
-    console.log(`  ${ui.bold('Usage')}`);
-    console.log(`    ${ui.cyan('halo-agent pair')} ${ui.gray('<code>')}            One-click pair with the dashboard`);
-    console.log(`    ${ui.cyan('halo-agent start')}                   Start the agent`);
-    console.log(`    ${ui.cyan('halo-agent install-autostart')}       Auto-start at login`);
-    console.log(`    ${ui.cyan('halo-agent uninstall-autostart')}     Remove login auto-start`);
-    console.log(`    ${ui.cyan('halo-agent init')}                    First-time setup (legacy: token paste)`);
-    console.log(`    ${ui.cyan('halo-agent token')} ${ui.gray('<value>')}          Update auth token`);
+    ui.commandTable([
+      ['pair <code>',           'One-click pair with the HALO dashboard'],
+      ['start',                 'Connect to Chrome and run the agent'],
+      ['install-autostart',     'Run automatically at every login'],
+      ['uninstall-autostart',   'Remove the login auto-start'],
+      ['init',                  'First-time setup (legacy token paste)'],
+      ['token <value>',         'Update the auth token'],
+    ]);
+    console.log('');
+    ui.hint('Get a pairing code: HALO dashboard → Profile → Auto-apply agent → Get pairing code.');
     console.log('');
     process.exit(1);
   }
@@ -123,7 +127,8 @@ async function runPair(code) {
   spin.stop(`Paired with HALO`);
   ui.muted(`  Token saved to ~/.halo-agent/config.json`);
   console.log('');
-  console.log(`  ${ui.gray('Next:')} ${ui.cyan('halo-agent start')}`);
+  ui.nextStep('halo-agent start', 'connect Chrome and start applying');
+  ui.hint('Or `halo-agent install-autostart` to run it at every login.');
   console.log('');
 }
 
@@ -308,7 +313,7 @@ async function runInit() {
   saveConfig(config);
   console.log('');
   ui.success('Config saved to ~/.halo-agent/config.json');
-  console.log(`  ${ui.gray('Next:')} ${ui.cyan('halo-agent start')}`);
+  ui.nextStep('halo-agent start', 'connect Chrome and start applying');
   console.log('');
 }
 
@@ -467,14 +472,14 @@ async function waitForChromeGone(timeoutMs) {
 async function runStart() {
   const config = loadConfig();
   if (!config || !config.token) {
-    ui.fail('No config found.');
-    console.log(`  ${ui.gray('Run')} ${ui.cyan('halo-agent pair <code>')} ${ui.gray('first. Get a code from the HALO dashboard.')}`);
+    ui.fail('Not paired yet — no config found.');
+    ui.nextStep('halo-agent pair <code>', 'get a code from the HALO dashboard');
     process.exit(1);
   }
 
   let version = '';
   try { version = require('./package.json').version; } catch {}
-  ui.banner(version);
+  ui.bigBanner(version); // hero frame — the one you'd screenshot
 
   // The agent runs its own isolated Chrome instance (separate --user-data-dir
   // at ~/.halo-agent/chrome-profile) so it never collides with the user's

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "halo-agent",
-  "version": "2.2.2",
+  "version": "2.2.4",
   "description": "HALO local apply agent — auto-fills job applications using your real Chrome session",
   "main": "index.js",
   "bin": {

package/poller.js

@@ -15,7 +15,8 @@ let sessionId = null;
 
 async function startPolling(chromeConn, config) {
   ui.success('Listening for jobs');
-  ui.muted(`  Polling every 5s. ${ui.cyan('Ctrl-C')} to stop.`);
+  ui.hint(`Queue one from HALO: a job's prep page → Approve & send to agent.`);
+  ui.muted(`  Polling every 5s · ${ui.cyan('Ctrl-C')} to stop`);
   console.log('');
 
   // Register agent session with backend

package/ui.js

@@ -41,15 +41,76 @@ const warn    = (msg) => console.log(`${yellow('!')} ${msg}`);
 const muted   = (msg) => console.log(gray(msg));
 const step    = (msg) => console.log(`${gray(sym.dot)} ${msg}`);
 
-// Banner shown on `start`. Three lines so it has presence on camera without
-// being a giant ASCII-art block that ages badly.
+// Strip ANSI so box math measures the VISIBLE width, not the escape-padded
+// string length. Without this, colored content overflows the box border.
+const STRIP_ANSI = /\x1b\[[0-9;]*m/g;
+const visLen = (s) => String(s).replace(STRIP_ANSI, '').length;
+
+// Box-drawing glyphs (rounded). ASCII fallback on legacy Windows terminals.
+const box = (process.platform === 'win32' && !process.env.WT_SESSION)
+  ? { tl: '+', tr: '+', bl: '+', br: '+', h: '-', v: '|' }
+  : { tl: '╭', tr: '╮', bl: '╰', br: '╯', h: '─', v: '│' };
+
+// The compact boxed wordmark. Ember mark + tagline + version, in a rounded
+// box — the Vercel/Bun look. Reads well on camera and in a small terminal,
+// and ages better than big ASCII art. The ⬢ is HALO's hex mark.
 function banner(version) {
-  const v = version ? gray(`v${version}`) : '';
-  const line = gray('─'.repeat(40));
+  const mark = `${ember('⬢')} ${ember(bold('HALO'))}`;
+  const ver  = version ? `${gray('agent')} ${gray('v' + version)}` : gray('agent');
+  // Two content lines.
+  const line1 = `${mark}  ${gray('·')}  ${ver}`;
+  const line2 = gray('auto-apply, in your own Chrome');
+  const inner = Math.max(visLen(line1), visLen(line2)) + 2; // 1 space padding each side
+  const pad = (s) => ' ' + s + ' '.repeat(inner - visLen(s) - 1);
+  const top = gray(box.tl + box.h.repeat(inner) + box.tr);
+  const bot = gray(box.bl + box.h.repeat(inner) + box.br);
+  const bar = gray(box.v);
+  console.log('');
+  console.log(`  ${top}`);
+  console.log(`  ${bar}${pad(line1)}${bar}`);
+  console.log(`  ${bar}${pad(line2)}${bar}`);
+  console.log(`  ${bot}`);
+  console.log('');
+}
+
+// Big block-letter wordmark for the hero moment (`start`) — the frame you'd
+// screenshot for a LinkedIn post. Five-row ASCII HALO in ember, tagline +
+// version underneath. Falls back to the compact boxed banner when color is
+// off (logs/CI) so the auto-start service log doesn't get a wall of blocks.
+const HALO_ART = [
+  '██   ██  █████  ██      ██████ ',
+  '██   ██ ██   ██ ██      ██  ██ ',
+  '███████ ███████ ██      ██  ██ ',
+  '██   ██ ██   ██ ██      ██  ██ ',
+  '██   ██ ██   ██ ███████ ██████ ',
+];
+function bigBanner(version) {
+  if (!useColor) { banner(version); return; }
+  const ver = version ? gray('· agent v' + version) : gray('· agent');
+  console.log('');
+  for (const row of HALO_ART) console.log('  ' + ember(row));
+  console.log('  ' + gray('auto-apply, in your own Chrome') + '   ' + ver);
   console.log('');
-  console.log(`  ${ember(bold('HALO'))} ${bold('Agent')}  ${v}`);
-  console.log(`  ${gray('Auto-apply, in your own Chrome.')}`);
-  console.log(`  ${line}`);
+}
+
+// Affordance helper: the obvious next command, rendered consistently so the
+// user always knows what to type next. Shown after pair/init/etc.
+function nextStep(cmd, note) {
+  const tail = note ? `   ${gray(note)}` : '';
+  console.log(`  ${gray('Next')} ${gray(sym.arrow)} ${cyan(cmd)}${tail}`);
+}
+
+// A hint line — softer than nextStep, for "you can also…" affordances.
+function hint(msg) {
+  console.log(`  ${gray(sym.dot)} ${gray(msg)}`);
+}
+
+// Aligned command table for the usage screen. rows: [[cmd, desc], ...].
+function commandTable(rows) {
+  const w = Math.max(...rows.map(([c]) => c.length));
+  for (const [cmd, desc] of rows) {
+    console.log(`    ${cyan(cmd.padEnd(w))}   ${gray(desc)}`);
+  }
 }
 
 // Lightweight spinner for waiting states ("Connecting to Chrome..."). Frames
@@ -81,5 +142,6 @@ function spinner(message) {
 
 module.exports = {
   bold, dim, red, green, yellow, blue, magenta, cyan, gray, ember,
-  sym, success, fail, info, warn, muted, step, banner, spinner,
+  sym, success, fail, info, warn, muted, step,
+  banner, bigBanner, spinner, nextStep, hint, commandTable, visLen,
 };