halo-agent 2.3.0 → 2.4.0

package/orchestrator.js

@@ -54,6 +54,8 @@ async function fillFields(page, aep, opts) {
 const { detectCaptcha, solveCaptcha, injectCaptchaToken } = require('./captcha');
 const { visionFill, visionNavigateAndSubmit, visionFillSkipped } = require('./vision');
 const { scanWorkday } = require('./scanWorkday');
+const { scanAccessibility } = require('./scanAccessibility');
+const { findApplyPath } = require('./findApplyPath');
 
 // ATS types that need vision fallback due to shadow DOM / canvas.
 // 'workday' was here historically because the AX-tree scan returned no usable
@@ -164,6 +166,36 @@ async function runJob(queueItem, chromeConn, config, reportStatus) {
     // May return a new page object if Apply opened a new tab.
     page = await clickApplyIfNeeded(page);
 
+    // STEP 1.5: Find the apply path if the page still has no fields.
+    //
+    // clickApplyIfNeeded only handles obvious cases (a literal "Apply" button
+    // outside the form). It misses:
+    //   - tabs (Overview / Application on Mercor's Ashby-wrapped careers page)
+    //   - "Continue to application" CTAs below the fold
+    //   - non-semantic styled divs that act as the entry point
+    //
+    // findApplyPath checks the cache, then probes the AX tree for apply-keyword
+    // clickables, then falls back to vision. Bounded to 2 click hops. If it
+    // still can't find fields, we surface NEEDS_ATTENTION below instead of the
+    // blind resume-uploader hack.
+    try {
+      const earlyScan = await scanAccessibility(page);
+      if (!earlyScan || earlyScan.length === 0) {
+        console.log('[orchestrator] No fields after clickApplyIfNeeded  invoking findApplyPath');
+        const result = await findApplyPath(page, { config, anthropicKey });
+        if (result.found) {
+          console.log(`[orchestrator] findApplyPath: ${result.method} succeeded (${result.fields_after} fields)`);
+        } else {
+          console.warn('[orchestrator] findApplyPath: no apply path found  form may need manual navigation');
+          // We continue anyway  handlePageGate / smartFill may still find
+          // something. If everything fails downstream, the existing NEEDS_ATTENTION
+          // surface fires from the orchestrator's terminal error handler.
+        }
+      }
+    } catch (e) {
+      console.warn(`[orchestrator] findApplyPath threw: ${e.message}`);
+    }
+
     // STEP 2: Vision gate detection — handles modals, resume prompts, login walls, preamble screens.
     // Runs before captcha check so the form is actually visible before we try to fill it.
     const gateResult = await handlePageGate(page, aep, tempResumeFile, config);

package/package.json

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