atsfill 0.0.3.dev6__tar.gz → 0.0.3.dev8__tar.gz

{atsfill-0.0.3.dev6 → atsfill-0.0.3.dev8}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: atsfill
-Version: 0.0.3.dev6
+Version: 0.0.3.dev8
 Summary: Read, dry-run and submit job application forms on hiring systems: Ashby, Greenhouse, Teamtailor, Welcome to the Jungle.
 Keywords: job-applications,ats,ashby,greenhouse,teamtailor,ai-agents,cli
 Author: shbernal
@@ -53,7 +53,7 @@ It is built for agents with a shell: every command prints one JSON document and
 ## Supported hiring systems
 
 <!-- badges -->
-![ashby: send broken 2026-10-19](https://img.shields.io/badge/ashby-send%20broken%202026--10--19-f7768e) ![greenhouse: unverified](https://img.shields.io/badge/greenhouse-unverified-565f89) ![teamtailor: unverified](https://img.shields.io/badge/teamtailor-unverified-565f89) ![wttj: unverified](https://img.shields.io/badge/wttj-unverified-565f89)
+![ashby: send verified 2026-10-19](https://img.shields.io/badge/ashby-send%20verified%202026--10--19-9ece6a) ![greenhouse: dry run verified 2026-10-19](https://img.shields.io/badge/greenhouse-dry%20run%20verified%202026--10--19-7aa2f7) ![teamtailor: unverified](https://img.shields.io/badge/teamtailor-unverified-565f89) ![wttj: unverified](https://img.shields.io/badge/wttj-unverified-565f89)
 <!-- /badges -->
 
 | System | Account needed | `read` without a browser |

{atsfill-0.0.3.dev6 → atsfill-0.0.3.dev8}/README.md

@@ -29,7 +29,7 @@ It is built for agents with a shell: every command prints one JSON document and
 ## Supported hiring systems
 
 <!-- badges -->
-![ashby: send broken 2026-10-19](https://img.shields.io/badge/ashby-send%20broken%202026--10--19-f7768e) ![greenhouse: unverified](https://img.shields.io/badge/greenhouse-unverified-565f89) ![teamtailor: unverified](https://img.shields.io/badge/teamtailor-unverified-565f89) ![wttj: unverified](https://img.shields.io/badge/wttj-unverified-565f89)
+![ashby: send verified 2026-10-19](https://img.shields.io/badge/ashby-send%20verified%202026--10--19-9ece6a) ![greenhouse: dry run verified 2026-10-19](https://img.shields.io/badge/greenhouse-dry%20run%20verified%202026--10--19-7aa2f7) ![teamtailor: unverified](https://img.shields.io/badge/teamtailor-unverified-565f89) ![wttj: unverified](https://img.shields.io/badge/wttj-unverified-565f89)
 <!-- /badges -->
 
 | System | Account needed | `read` without a browser |

{atsfill-0.0.3.dev6 → atsfill-0.0.3.dev8}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "atsfill"
-version = "0.0.3.dev6"
+version = "0.0.3.dev8"
 description = "Read, dry-run and submit job application forms on hiring systems: Ashby, Greenhouse, Teamtailor, Welcome to the Jungle."
 readme = "README.md"
 license = "MIT"

{atsfill-0.0.3.dev6 → atsfill-0.0.3.dev8}/pyproject.toml.orig

@@ -1,6 +1,6 @@
 [project]
 name = "atsfill"
-version = "0.0.3.dev6"
+version = "0.0.3.dev8"
 description = "Read, dry-run and submit job application forms on hiring systems: Ashby, Greenhouse, Teamtailor, Welcome to the Jungle."
 readme = "README.md"
 license = "MIT"

{atsfill-0.0.3.dev6 → atsfill-0.0.3.dev8}/src/atsfill/adapters/ashby.py

@@ -1,12 +1,14 @@
 """Ashby (`jobs.ashbyhq.com`, and career pages embedding it), as docs/adapters/ashby.md observes.
 
-Every change posts `ApiSetFormValue`, whose response holds the form as Ashby will receive it:
-that is the read-back, kept per form since a survey answer returns the survey alone.
+Every change posts a mutation whose response holds the form as Ashby will receive it: that is
+the read-back, kept per form since a survey answer returns the survey alone.
 """
 
 import json
 import time
 import urllib.request
+from collections.abc import Callable
+from functools import partial
 from typing import Any
 from urllib.parse import parse_qs, urlsplit
 
@@ -31,6 +33,7 @@ TYPES = {
     "String": FieldType.TEXT,
     "Email": FieldType.TEXT,
     "LongText": FieldType.TEXT,
+    "Url": FieldType.TEXT,
     "Date": FieldType.DATE,
     "Number": FieldType.TEXT,
     "Phone": FieldType.PHONE,
@@ -42,6 +45,7 @@ TYPES = {
 }
 SETTLE_S = 1.5
 READ_BACK_TIMEOUT_S = 30
+SAVE_TIMEOUT_MS = 30_000
 SUBMIT_TIMEOUT_MS = 90_000
 
 
@@ -70,7 +74,7 @@ class Ashby:
 
     def __init__(self) -> None:
         self._forms: list[dict[str, Any]] = []  # the application form, then each survey
-        self._pending = 0
+        self._pending: set[Any] = set()  # GraphQL requests in flight, since `read_form`
         self._last_change = 0.0
         self._hosted: str | None = None  # the jobs.ashbyhq.com posting a custom domain embeds
 
@@ -132,6 +136,7 @@ class Ashby:
         return [self._field(e) for e in self._entries()]
 
     def fill(self, page: Page, answers: dict[str, Answer]) -> None:
+        """One save at a time: saves in flight together overwrite each other at Ashby."""
         fields = {e["field"]["path"]: self._field(e) for e in self._entries()}
         for field_id, answer in answers.items():
             entry = page.locator(f'[data-field-path="{field_id}"]')
@@ -140,30 +145,49 @@ class Ashby:
                 case FieldType.TEXT | FieldType.DATE | FieldType.PHONE, str():
                     box = entry.locator("input, textarea").first
                     box.fill(answer)
-                    box.blur()
+                    self._saved(page, box.blur)
+                case FieldType.CHOICE, str() if entry.locator("input[role=combobox]").count():
+                    entry.locator("input[role=combobox]").fill(answer)
+                    option = page.get_by_role("option", name=answer, exact=True)
+                    self._saved(page, option.click)
                 case FieldType.CHOICE, str():
-                    entry.get_by_text(answer, exact=True).click()
+                    self._saved(page, entry.get_by_text(answer, exact=True).click)
                 case FieldType.MULTI_CHOICE, list():
                     for value in answer:
-                        entry.get_by_text(value, exact=True).click()
+                        self._saved(page, entry.get_by_text(value, exact=True).click)
                 case FieldType.TYPEAHEAD, str():
-                    box = entry.locator("input[role=combobox]")
-                    box.fill(answer)
-                    page.get_by_role("option").filter(has_text=answer).first.click()
+                    entry.locator("input[role=combobox]").fill(answer)
+                    option = page.get_by_role("option").filter(has_text=answer).first
+                    self._saved(page, option.click)
                 case FieldType.FILE, str():
-                    entry.locator("input[type=file]").set_input_files(answer)
+                    upload = entry.locator("input[type=file]")
+                    self._saved(page, partial(upload.set_input_files, answer))
                 case kind, _:
                     raise Unsupported(
                         f"form_shape: cannot fill {field_id}, a {kind}, with {answer!r}"
                     )
         self._answered = list(answers)
 
+    def _saved(self, page: Page, change: Callable[[], None]) -> None:
+        """Makes the change, then waits for its save and any other request it set off. A
+        change Ashby does not save shows in the read-back."""
+        try:
+            with page.expect_response(
+                lambda r: _op(r).startswith("ApiSetFormValue"), timeout=SAVE_TIMEOUT_MS
+            ):
+                change()
+        except Timeout:
+            return
+        deadline = time.monotonic() + SAVE_TIMEOUT_MS / 1000
+        while self._pending and time.monotonic() < deadline:
+            page.wait_for_timeout(100)
+
     def read_back(self, page: Page) -> dict[str, Answer]:
         """Ashby's last returned form, once every answer is held and no request is in flight."""
         deadline = time.monotonic() + READ_BACK_TIMEOUT_S
         while time.monotonic() < deadline:
             values = self._values()
-            quiet = self._pending == 0 and time.monotonic() - self._last_change > SETTLE_S
+            quiet = not self._pending and time.monotonic() - self._last_change > SETTLE_S
             if quiet and all(values.get(i) is not None for i in self._answered):
                 break
             page.wait_for_timeout(250)
@@ -248,15 +272,18 @@ class Ashby:
 
     def _on_request(self, request: Any) -> None:
         if "/api/non-user-graphql" in request.url:
-            self._pending += 1
+            self._pending.add(request)
 
     def _on_finished(self, request: Any) -> None:
         if "/api/non-user-graphql" in request.url:
-            self._pending -= 1
+            self._pending.discard(request)
             self._last_change = time.monotonic()
 
     def _on_response(self, response: Response) -> None:
-        if _op(response) == "ApiSetFormValue" and response.ok:
-            render = response.json()["data"]["setFormValue"]
-            if render:
+        """Any response holding a form render: a value goes to `ApiSetFormValue`, a file to
+        `ApiSetFormValueToFile` once its upload ends, after saves made later."""
+        if not _op(response).startswith("ApiSetFormValue") or not response.ok:
+            return
+        for render in (response.json().get("data") or {}).values():
+            if isinstance(render, dict) and "sections" in render:
                 self._replace(render)

{atsfill-0.0.3.dev6 → atsfill-0.0.3.dev8}/src/atsfill/adapters/greenhouse.py

@@ -2,13 +2,14 @@
 pages embedding them), as docs/adapters/greenhouse.md observes.
 
 Nothing but an attached file reaches Greenhouse before submit, so the read-back is the page:
-input values, the shown value of each select, the phone country's flag, the attached file's name.
+input values, the shown value of each select, the phone's dial code, the attached file's name.
 """
 
 import json
 import re
 import time
 import urllib.request
+from contextlib import suppress
 from typing import Any
 from urllib.parse import parse_qs, urlencode, urlsplit
 
@@ -25,6 +26,7 @@ EMBED_TIMEOUT_MS = 15_000
 OPTIONS_TIMEOUT_MS = 3_000
 HYDRATE_TIMEOUT_MS = 15_000
 FORM_TIMEOUT_MS = 20_000
+ANSWER_TIMEOUT_MS = 15_000  # an upload's file name, a suggestion: past it, a mismatch
 SUBMIT_TIMEOUT_MS = 90_000
 API_TYPES = {
     "input_text": FieldType.TEXT,
@@ -34,6 +36,9 @@ API_TYPES = {
     "multi_value_multi_select": FieldType.MULTI_CHOICE,
 }
 YES_NO = ["Yes", "No"]
+# Sections the page adds or names its own way, or shows a question of only on another answer
+# (EEOC race after Hispanic/Latino): `read_api` declines a posting with any (ADR 0011).
+UNMAPPED = ("education", "compliance", "demographic_questions")
 
 # The fields in page order. A select's options are read by opening it, from Python.
 _READ = """form => {
@@ -48,12 +53,14 @@ _READ = """form => {
   const required = el => el.getAttribute("aria-required") === "true" || el.required;
   const found = [];
   for (const el of form.querySelectorAll("input, textarea")) {
-    if (!el.id || ["hidden", "search", "file", "checkbox", "radio"].includes(el.type)) continue;
+    if (!el.id || ["hidden", "search", "file", "checkbox"].includes(el.type)) continue;
     const combo = el.getAttribute("role") === "combobox";
+    if (combo && el.closest(".phone-input")) continue;  // the phone's country, set by its number
     const shell = el.closest(".select");
     const multi = combo && !!shell?.querySelector(".select__value-container--is-multi");
     found.push([el, {id: el.id, label: text(labelFor(el)), required: required(el),
-      kind: combo ? (multi ? "multi" : "select") : el.type === "tel" ? "tel" : "text",
+      kind: combo ? (multi ? "multi" : "select")
+        : ["tel", "number", "radio"].includes(el.type) ? el.type : "text",
       maxLength: el.maxLength > 0 ? el.maxLength : null}]);
   }
   for (const group of form.querySelectorAll("fieldset.checkbox")) {
@@ -80,8 +87,8 @@ _READ = """form => {
   return found.map(([, field]) => field);
 }"""
 
-# What each field shows: a select its shown value (the phone country its flag's code), a file
-# its attached name, a checkbox group its checked labels.
+# What each field shows: a select its shown value, a file its attached name, a checkbox group
+# its checked labels, the phone its country's dial code then its number.
 _READ_BACK = """(form, ids) => {
   const text = el => el ? el.textContent.replace(/\\s+/g, " ").trim() : null;
   const out = {};
@@ -94,10 +101,12 @@ _READ_BACK = """(form, ids) => {
         .map(b => text(document.querySelector(`label[for="${CSS.escape(b.id)}"]`)));
     } else if (el?.getAttribute("role") === "combobox") {
       const select = el.closest(".select");
-      const flag = select.querySelector(".select__single-value .iti__flag");
       const multi = [...select.querySelectorAll(".select__multi-value__label")].map(text);
-      out[id] = flag ? "flag:" + [...flag.classList].find(c => /^iti__[a-z]{2}$/.test(c)).slice(5)
-        : multi.length ? multi : text(select.querySelector(".select__single-value"));
+      out[id] = multi.length ? multi : text(select.querySelector(".select__single-value"));
+    } else if (el?.type === "tel" && el.closest(".phone-input")) {
+      const dial = text(el.closest(".phone-input").querySelector(".select__single-value"));
+      const number = el.value.startsWith(dial) ? el.value.slice(dial.length).trim() : el.value;
+      out[id] = dial && number ? `${dial} ${number}` : null;
     } else {
       const box = form.querySelector(`input[type=checkbox][name="${id}"]`) ?? el;
       out[id] = box?.type === "checkbox" ? (box.checked ? "Yes" : "No") : el?.value ?? null;
@@ -117,11 +126,11 @@ class Greenhouse:
     def __init__(self) -> None:
         self._fields: dict[str, Field] = {}
         self._kinds: dict[str, str] = {}  # how the page renders each field
-        self._flags: dict[str, dict[str, str]] = {}  # per select, option text by flag code
         self._embed: str | None = None  # the job_app URL a company page embeds
 
     def detect(self, url: str, page: Page | None) -> bool:
         """A board URL, or a company page whose `#grnhse_iframe` embeds a job application."""
+        self._embed = None  # one process detects many postings: a survey, the gate
         if _board_job(url):
             return True
         if page is None:
@@ -181,7 +190,8 @@ class Greenhouse:
                 case "file":
                     upload = page.locator(_upload(field_id))
                     upload.locator("input[type=file]").set_input_files(values[0])
-                    upload.locator(".file-upload__filename").wait_for()
+                    with suppress(Timeout):
+                        upload.locator(".file-upload__filename").wait_for(timeout=ANSWER_TIMEOUT_MS)
                 case "consent":
                     box = page.locator(f"{FORM} input[type=checkbox][name='{field_id}']").first
                     if box.is_checked() != (answer == "Yes"):
@@ -194,15 +204,15 @@ class Greenhouse:
                     suggested = self._fields[field_id].type is FieldType.TYPEAHEAD
                     for value in values:
                         _select(page, field_id, value, suggested)
+                case "tel":  # the number's dial code picks the country
+                    page.locator(_by_id(field_id)).press_sequentially(values[0], delay=20)
+                case "number" if not re.fullmatch(r"-?\d+(\.\d+)?", values[0]):
+                    pass  # the input takes no text: left empty, it reads back as a mismatch
                 case _:
                     page.locator(_by_id(field_id)).fill(values[0])
 
     def read_back(self, page: Page) -> dict[str, Answer]:
         values = page.locator(FORM).evaluate(_READ_BACK, list(self._fields))
-        for field_id, flags in self._flags.items():
-            shown = values.get(field_id)
-            if isinstance(shown, str) and shown.startswith("flag:"):
-                values[field_id] = flags.get(shown[5:], shown)
         return {k: v for k, v in values.items() if v not in (None, "", [])}
 
     def submit(self, page: Page) -> str | None:
@@ -213,7 +223,7 @@ class Greenhouse:
     def _field(self, page: Page, raw: dict[str, Any]) -> Field:
         kind, options = raw["kind"], raw.get("options")
         match kind:
-            case "text":
+            case "text" | "number":
                 field_type = FieldType.TEXT
             case "tel":
                 field_type = FieldType.PHONE
@@ -229,7 +239,7 @@ class Greenhouse:
                     field_type = FieldType.TYPEAHEAD
                 else:
                     field_type = FieldType.MULTI_CHOICE if kind == "multi" else FieldType.CHOICE
-            case _:
+            case _:  # a radio input, not seen on a posting yet
                 raise Unsupported(f"form_shape: {raw['id']} is a {kind}")
         return Field(
             raw["id"],
@@ -252,12 +262,6 @@ class Greenhouse:
             box.press("Escape")
             return None
         options = [t.strip() for t in menu.all_inner_texts()]
-        flags = menu.evaluate_all(
-            "items => items.map(i => [...(i.querySelector('.iti__flag')?.classList ?? [])]"
-            ".find(c => /^iti__[a-z]{2}$/.test(c))?.slice(5))"
-        )
-        if any(flags):
-            self._flags[field_id] = {f: o for f, o in zip(flags, options, strict=True) if f}
         box.press("Escape")
         return options
 
@@ -294,39 +298,22 @@ def _board_job(url: str) -> tuple[str, str] | None:
 
 
 def _api_fields(job: dict[str, Any]) -> list[Field] | None:
-    if job.get("education") or any(
+    if any(job.get(k) for k in UNMAPPED) or any(
         c.get("requires_consent") or c.get("requires_processing_consent")
         for c in job.get("data_compliance") or []
     ):
-        return None  # the page adds education rows or consent boxes the API does not list
+        return None
     fields = []
     for question in job["questions"] + (job.get("location_questions") or []):
         entry = question["fields"][0]  # a file's paste-in textarea comes second
-        if entry["type"] == "input_hidden":
+        if entry["type"] == "input_hidden":  # a location's latitude and longitude
             continue
         name = entry["name"]
-        field_type = API_TYPES[entry["type"]]
-        options = [v["label"] for v in entry.get("values") or []] or None
-        if name == "phone":
-            fields.append(Field("country", "Country", FieldType.CHOICE, question["required"]))
-            field_type = FieldType.PHONE
+        field_type = FieldType.PHONE if name == "phone" else API_TYPES[entry["type"]]
         if name == "location":
             name, field_type = "candidate-location", FieldType.TYPEAHEAD
+        options = [v["label"] for v in entry.get("values") or []] or None
         fields.append(Field(name, question["label"], field_type, question["required"], options))
-    for section in job.get("compliance") or []:
-        for question in section["questions"]:
-            entry = question["fields"][0]
-            options = [v["label"] for v in entry.get("values") or []] or None
-            kind = API_TYPES[entry["type"]]
-            fields.append(
-                Field(entry["name"], question["label"], kind, question["required"], options)
-            )
-    for question in (job.get("demographic_questions") or {}).get("questions", []):
-        options = [o["label"] for o in question["answer_options"]]
-        kind = API_TYPES[question["type"]]
-        fields.append(
-            Field(str(question["id"]), question["label"], kind, question["required"], options)
-        )
     return fields
 
 
@@ -345,12 +332,16 @@ def _exact(value: str) -> re.Pattern[str]:
 
 def _select(page: Page, field_id: str, value: str, suggested: bool) -> None:
     """Types into a react-select and picks the option: hovered then Enter, which every select
-    takes (Country saves only on Enter). A suggestion list takes its first suggestion."""
+    takes. A suggestion list takes its first suggestion. No option leaves the select empty."""
     box = page.locator(_by_id(field_id))
     box.click()
     box.press_sequentially(value, delay=20)
     menu = page.locator(f"{_by_id(f'react-select-{field_id}-listbox')} [role=option]")
     option = menu.first if suggested else menu.filter(has_text=_exact(value)).first
-    option.wait_for()
+    try:
+        option.wait_for(timeout=ANSWER_TIMEOUT_MS)
+    except Timeout:
+        box.press("Escape")
+        return
     option.hover()
     box.press("Enter")

{atsfill-0.0.3.dev6 → atsfill-0.0.3.dev8}/src/atsfill/registry.toml

@@ -19,8 +19,8 @@ kind = "ats"
 account = "none"
 hosting = ["hosted", "embedded"]
 adapter = "ashby"
-send_verified = { date = 2026-10-18, version = "0.0.2", by = "shbernal", commit = "ff8ea46" }
-send_broken = { date = 2026-10-19, version = "0.0.2", commit = "916319c", by = "shbernal", reason = "the résumé reads back empty after its upload", cause = "unknown" }
+send_verified = { date = 2026-10-19, version = "0.0.2", by = "shbernal", commit = "7622376" }
+dry_run_verified = { date = 2026-10-19, version = "0.0.2", by = "gate", commit = "c230c5e" }
 
 [teamtailor]
 kind = "ats"
@@ -33,6 +33,7 @@ kind = "ats"
 account = "none"
 hosting = ["hosted", "embedded"]
 adapter = "greenhouse"
+dry_run_verified = { date = 2026-10-19, version = "0.0.2", by = "gate", commit = "c0fb0c5" }
 
 [wttj]
 kind = "board"