things-api 0.19.2 → 0.19.4

package/dist/write/vectors/ui-state.js

@@ -47,6 +47,65 @@ export const AX_DIALOG_SHELL_SNIPPET = `		set shellRef to missing value
 				set sheetDepth to sheetDepth + 1
 			end repeat
 		end if`;
+/** Probes whose absence makes the census unusable for a keystroke decision. */
+const CRITICAL_PROBES = ["running", "frontmost", "dialog"];
+/** Every probe name the census can report, for parsing its record back. */
+const KNOWN_PROBES = new Set([
+    "running",
+    "frontmost",
+    "dialog",
+    "frontapp",
+    "focus",
+]);
+/**
+ * Per-APPLE-EVENT budget for every read in the census (`with timeout of N
+ * seconds`). Without one, osascript's default is two MINUTES: a System Events
+ * call that does not come back is then bounded only by the caller's own process
+ * deadline, which is how issue #629's field incident spent ~15s per inspection
+ * and ~56s per drive discovering nothing. With one, a read that will not answer
+ * raises AppleScript error -1712 and the census carries on to the next probe —
+ * or stops, if the probe was one the caller decides on.
+ */
+const PROBE_TIMEOUT_S = 2;
+/**
+ * Wall-clock budget for the WHOLE census, checked between probes. `with
+ * timeout` bounds one Apple event, not a run of them, so a surface that is
+ * merely slow (rather than wedged) could still add up. Past this, the remaining
+ * probes are skipped and reported as stalled rather than waited on.
+ */
+const CENSUS_BUDGET_S = 8;
+/**
+ * The transport deadline for one census hop — the backstop under the in-script
+ * budgets, not the mechanism. Deliberately far below the 15s step timeout that
+ * bounded the old single-shot script: nothing here may take this long, and if
+ * it does the caller must hear about it while the drive can still be aborted
+ * cleanly rather than after four of them have gone by.
+ */
+export const CENSUS_TIMEOUT_MS = 12_000;
+/** Did a probe the caller has to DECIDE on fail to answer? */
+export function censusUnverifiable(state) {
+    if (state === null)
+        return true;
+    return CRITICAL_PROBES.some((p) => state.stalledProbes.includes(p) || state.failedProbes.includes(p));
+}
+/** Name the probes that did not answer, for a diagnostic someone has to act on. */
+export function describeUnprovenProbes(state) {
+    const label = {
+        running: "whether Things is running",
+        frontmost: "whether Things owns the screen",
+        dialog: "which dialog is open",
+        frontapp: "which application owns the screen",
+        focus: "which element has keyboard focus",
+    };
+    const parts = [];
+    if (state.stalledProbes.length > 0) {
+        parts.push(`did not answer in time: ${state.stalledProbes.map((p) => label[p]).join(", ")}`);
+    }
+    if (state.failedProbes.length > 0) {
+        parts.push(`could not be read: ${state.failedProbes.map((p) => label[p]).join(", ")}`);
+    }
+    return parts.join("; ");
+}
 /** A recognizable token in the script so a test runner can key off the ui-state command. */
 export const UI_STATE_MARKER = "-- ui-state census (read-only)";
 /** The label every ui-state dispatch carries (one stable command shape). */
@@ -54,14 +113,51 @@ export const UI_STATE_LABEL = "read the window and focus state";
 /** The Things application's process name — the frontmost value that means "us". */
 export const THINGS_PROCESS = "Things3";
 /**
- * The census script. Every read is wrapped: a surface that will not answer
- * degrades that ONE field rather than failing the whole census, because the
- * cases this exists for — a foreign modal, an AX-blind session — are exactly
- * the cases where half the tree is unreadable.
+ * The census script — ADDRESSED probes, each on its own Apple-event budget
+ * (issue #629).
+ *
+ * WHAT CHANGED, AND WHY IT HAD TO. The 0.19.2 census was one unbounded script
+ * that opened with two UNADDRESSED queries: `first application process whose
+ * frontmost is true` (the entire process table enumerated) and `value of
+ * attribute "AXFocusedUIElement"` on whatever that returned (a system-wide
+ * focused-element resolution). Everything else the ui vector runs — every step
+ * the field incident's log shows succeeding, inside the very sheet the census
+ * could not describe — is addressed: `tell process "Things3" to …`. So the one
+ * script that stalled was the one script that left the addressed style, and it
+ * stalled on the critical path of BOTH the per-step guard and the cleanup that
+ * was supposed to recover from it. Rebuilt here so that:
+ *
+ *   - the decision-critical facts are ADDRESSED and are proven FIRST;
+ *   - every read carries `with timeout of ${PROBE_TIMEOUT_S} seconds`, so a
+ *     surface that will not answer costs seconds, not the caller's whole
+ *     deadline;
+ *   - a critical probe that does not answer STOPS the census then and there —
+ *     the remaining probes cannot change what the caller must now do (abort and
+ *     clean up), so waiting for them is pure latency;
+ *   - the two unaddressed queries survive only as DECORATION, last, skipped
+ *     entirely when the addressed probes already answered the question they
+ *     were there to answer.
+ *
+ * Every probe still degrades one field rather than failing the census, and what
+ * could not be proven is NAMED (`stalled=` / `failed=`) instead of silently
+ * reading as a clean "nothing is open".
  */
 export function axUiStateScript() {
     return `${UI_STATE_MARKER}
-set frontName to ""
+${CENSUS_BODY}
+
+return ${censusRecord("linefeed")}`;
+}
+/**
+ * The census BODY — every probe, leaving its verdict in the AppleScript variables
+ * the record below reads. Split out of {@link axUiStateScript} (DRVLAT1, issue
+ * #633) so the SAME probes can run as the in-script prelude of a keystroke hop
+ * ({@link axFocusGuardPrelude}) rather than as a separate osascript round-trip.
+ * Nothing about the probes, their budgets or their order differs between the two
+ * uses: it is one body, compiled into two scripts.
+ */
+const CENSUS_BODY = `set frontName to ""
+set frontIsThings to false
 set focusRole to ""
 set focusSub to ""
 set canInspect to true
@@ -70,70 +166,234 @@ set sheetForm to "none"
 set sheetKind to "none"
 set sheetDepth to 0
 set census to ""
-tell application "System Events"
+set stalled to ""
+set failed to ""
+set halted to false
+set t0 to (current date)
+
+-- P1 running: a name-keyed lookup, no Accessibility round-trip.
+try
+	with timeout of ${PROBE_TIMEOUT_S} seconds
+		tell application "System Events" to set thingsRunning to (exists application process "${THINGS_PROCESS}")
+	end timeout
+on error errMsg number errNum
+	if errNum is -1712 then
+		set stalled to stalled & "running "
+	else
+		set failed to failed & "running "
+	end if
+	set halted to true
+end try
+
+-- P2 frontmost, ADDRESSED: the single fact the per-step input guard decides on.
+if (not halted) and thingsRunning then
 	try
-		set fp to first application process whose frontmost is true
-		set frontName to (name of fp) as text
-		try
-			set fe to value of attribute "AXFocusedUIElement" of fp
-			set focusRole to (role of fe) as text
-			try
-				set focusSub to (subrole of fe) as text
-			end try
-		on error
-			set canInspect to false
-		end try
-	on error
-		set canInspect to false
+		with timeout of ${PROBE_TIMEOUT_S} seconds
+			tell application "System Events" to tell process "${THINGS_PROCESS}" to set frontIsThings to (frontmost as boolean)
+		end timeout
+		if frontIsThings then set frontName to "${THINGS_PROCESS}"
+	on error errMsg number errNum
+		if errNum is -1712 then
+			set stalled to stalled & "frontmost "
+		else
+			set failed to failed & "frontmost "
+		end if
+		set halted to true
 	end try
+end if
+
+-- P3 dialog: shell, form, stack depth and control census — all addressed
+-- inside the Things process, which is the shape every working drive step uses.
+if (not halted) and thingsRunning then
 	try
-		if (exists application process "${THINGS_PROCESS}") then set thingsRunning to true
-	end try
-end tell
-if thingsRunning then
-	tell application "System Events" to tell process "${THINGS_PROCESS}"
+		with timeout of ${PROBE_TIMEOUT_S} seconds
+			tell application "System Events" to tell process "${THINGS_PROCESS}"
 ${AX_DIALOG_SHELL_SNIPPET}
-		if shellRef is not missing value then
-			set nCb to -1
-			set nPu to -1
-			set nBt to -1
-			set nGp to -1
-			set nTf to -1
-			try
-				set nCb to (count of checkboxes of shellRef)
-			end try
-			try
-				set nPu to (count of pop up buttons of shellRef)
-			end try
-			try
-				set nBt to (count of buttons of shellRef)
-			end try
-			try
-				set nGp to (count of groups of shellRef)
-			end try
-			try
-				set nTf to (count of text fields of shellRef)
-			end try
-			set census to "cb:" & nCb & " pu:" & nPu & " bt:" & nBt & " gp:" & nGp & " tf:" & nTf
-			set winId to ""
+				if shellRef is not missing value then
+					set nCb to -1
+					set nPu to -1
+					set nBt to -1
+					set nGp to -1
+					set nTf to -1
+					try
+						set nCb to (count of checkboxes of shellRef)
+					end try
+					try
+						set nPu to (count of pop up buttons of shellRef)
+					end try
+					try
+						set nBt to (count of buttons of shellRef)
+					end try
+					try
+						set nGp to (count of groups of shellRef)
+					end try
+					try
+						set nTf to (count of text fields of shellRef)
+					end try
+					set census to "cb:" & nCb & " pu:" & nPu & " bt:" & nBt & " gp:" & nGp & " tf:" & nTf
+					set winId to ""
+					try
+						set winId to (value of attribute "AXIdentifier" of shellRef) as text
+					end try
+					if winId starts with "MovePopUpDialog-" then
+						set sheetKind to "move-picker"
+					else if nCb is 2 and nPu is 1 and nBt is 2 and nGp is 1 and nTf is 0 then
+						set groupOk to false
+						try
+							set g to group 1 of shellRef
+							if ((count of text fields of g) + (count of pop up buttons of g)) > 0 then set groupOk to true
+						end try
+						if groupOk then set sheetKind to "repeat"
+					end if
+					if sheetKind is "none" then set sheetKind to "other"
+				end if
+			end tell
+		end timeout
+	on error errMsg number errNum
+		if errNum is -1712 then
+			set stalled to stalled & "dialog "
+		else
+			set failed to failed & "dialog "
+		end if
+		set halted to true
+	end try
+end if
+
+-- P4 frontapp: the ONLY enumeration left, and it runs only when the addressed
+-- probe has already said the screen is not ours — its whole job is naming the
+-- application in the refusal sentence.
+if (not halted) and (not frontIsThings) then
+	if ((current date) - t0) > ${CENSUS_BUDGET_S} then
+		set stalled to stalled & "frontapp "
+	else
+		try
+			with timeout of ${PROBE_TIMEOUT_S} seconds
+				tell application "System Events" to set frontName to (name of first application process whose frontmost is true) as text
+			end timeout
+		on error errMsg number errNum
+			if errNum is -1712 then
+				set stalled to stalled & "frontapp "
+			else
+				set failed to failed & "frontapp "
+			end if
+		end try
+	end if
+end if
+
+-- P5 focus: decoration, and the most expensive read in the census. Addressed at
+-- the process that owns the screen rather than resolved system-wide, run last,
+-- and skipped outright once the budget is spent. An ERROR here (as opposed to a
+-- timeout) is the secure-system-modal signature: macOS exposes no tree for one.
+if not halted then
+	if ((current date) - t0) > ${CENSUS_BUDGET_S} then
+		set stalled to stalled & "focus "
+	else
+		set focusTarget to frontName
+		if focusTarget is "" then
+			set stalled to stalled & "focus "
+		else
 			try
-				set winId to (value of attribute "AXIdentifier" of shellRef) as text
+				with timeout of ${PROBE_TIMEOUT_S} seconds
+					tell application "System Events" to tell process focusTarget
+						set fe to value of attribute "AXFocusedUIElement"
+						-- No focused element is a perfectly ordinary state (an app
+						-- with no key window); it is not an unreadable screen.
+						if fe is not missing value then
+							set focusRole to (role of fe) as text
+							try
+								set focusSub to (subrole of fe) as text
+							end try
+						end if
+					end tell
+				end timeout
+			on error errMsg number errNum
+				if errNum is -1712 then
+					set stalled to stalled & "focus "
+				else
+					set canInspect to false
+					set failed to failed & "focus "
+				end if
 			end try
-			if winId starts with "MovePopUpDialog-" then
-				set sheetKind to "move-picker"
-			else if nCb is 2 and nPu is 1 and nBt is 2 and nGp is 1 and nTf is 0 then
-				set groupOk to false
-				try
-					set g to group 1 of shellRef
-					if ((count of text fields of g) + (count of pop up buttons of g)) > 0 then set groupOk to true
-				end try
-				if groupOk then set sheetKind to "repeat"
-			end if
-			if sheetKind is "none" then set sheetKind to "other"
 		end if
-	end tell
-end if
-return "front=" & frontName & linefeed & "running=" & thingsRunning & linefeed & "form=" & sheetForm & linefeed & "depth=" & sheetDepth & linefeed & "kind=" & sheetKind & linefeed & "census=" & census & linefeed & "role=" & focusRole & linefeed & "subrole=" & focusSub & linefeed & "inspectable=" & canInspect`;
+	end if
+end if`;
+/**
+ * The census RECORD, joined by `sep` — `linefeed` for the stand-alone census
+ * script, a single-line separator for the guard prelude's `log` line (a logged
+ * record has to survive as ONE stderr line to be recovered).
+ */
+function censusRecord(sep) {
+    return `"front=" & frontName & ${sep} & "isfront=" & frontIsThings & ${sep} & "running=" & thingsRunning & ${sep} & "form=" & sheetForm & ${sep} & "depth=" & sheetDepth & ${sep} & "kind=" & sheetKind & ${sep} & "census=" & census & ${sep} & "role=" & focusRole & ${sep} & "subrole=" & focusSub & ${sep} & "inspectable=" & canInspect & ${sep} & "stalled=" & stalled & ${sep} & "failed=" & failed`;
+}
+/** The stderr line prefix carrying a folded guard's census record. */
+export const GUARD_LOG_PREFIX = "#FGCENSUS ";
+/** The separator joining that record's fields on its single line. */
+export const GUARD_LOG_SEP = " ~|~ ";
+/**
+ * What a folded guard RAISES when it refuses. Deliberately a machine tag rather
+ * than a sentence: the refusal a caller reads is still built by
+ * {@link judgeFocusGuard} in TypeScript, from the census this same hop logged, so
+ * there is exactly ONE place the wording lives and the in-script judgement can
+ * never drift from it.
+ */
+export const GUARD_REFUSED_TAG = "#FGREFUSE";
+/**
+ * The census as the IN-SCRIPT PRELUDE of the hop it guards (DRVLAT1, issue #633).
+ *
+ * The per-step focus guard used to be its own osascript round-trip: census hop,
+ * then keystroke hop. That is both a hop of latency per typed control AND a
+ * TOCTOU window — the screen can change between the census that approved the
+ * keystroke and the keystroke itself. Prepending the census to the very script
+ * that types closes both: the probes and the input now run in one process, in
+ * order, with nothing dispatched in between.
+ *
+ * The prelude LOGS its census record (stderr, one line) and then judges it
+ * IN-SCRIPT, raising {@link GUARD_REFUSED_TAG} — a bare tag — when the input must
+ * not be sent. The caller recovers the logged record, parses it into the same
+ * {@link UiState} the stand-alone census yields, and asks {@link judgeFocusGuard}
+ * for the sentence. So the DECISION is made before the keystroke, in-script, and
+ * the WORDING is still single-sourced in TypeScript.
+ *
+ * `expectedSheet` is the dialog the drive has observed itself driving; pass null
+ * where no dialog invariant applies.
+ */
+export function axFocusGuardPrelude(expectedSheet) {
+    const critical = CRITICAL_PROBES.map((p) => `  if stalled contains "${p} " then set fgBad to true
+  if failed contains "${p} " then set fgBad to true`).join("\n");
+    const sheetClause = expectedSheet === null
+        ? ""
+        : `\n  if sheetKind is not "${expectedSheet}" then set fgBad to true`;
+    return `${UI_STATE_MARKER}
+${CENSUS_BODY}
+
+log "${GUARD_LOG_PREFIX}" & ${censusRecord(`"${GUARD_LOG_SEP}"`)}
+set fgBad to false
+${critical}
+if not canInspect then set fgBad to true
+if not frontIsThings then set fgBad to true${sheetClause}
+if fgBad then error "${GUARD_REFUSED_TAG}"
+`;
+}
+/**
+ * Recover a folded guard's census from the hop's stderr: the parsed state (null
+ * when no record was logged) and the stderr with that line removed, so a failure
+ * message a caller reads never carries the machinery.
+ */
+export function parseGuardLog(stderr) {
+    const kept = [];
+    let record = null;
+    for (const line of stderr.split(/\r?\n/)) {
+        const at = line.indexOf(GUARD_LOG_PREFIX);
+        if (at >= 0) {
+            record = line.slice(at + GUARD_LOG_PREFIX.length);
+            continue;
+        }
+        kept.push(line);
+    }
+    return {
+        state: record === null ? null : parseUiState(record.split(GUARD_LOG_SEP).join("\n")),
+        stderr: kept.join("\n").trim(),
+    };
 }
 /**
  * Parse the census record into a {@link UiState}. Returns null when the output
@@ -150,6 +410,7 @@ export function parseUiState(stdout) {
     }
     if (!fields.has("kind") || !fields.has("inspectable"))
         return null;
+    const probes = (key) => (fields.get(key) ?? "").split(/\s+/).filter((p) => KNOWN_PROBES.has(p));
     const kindRaw = fields.get("kind") ?? "none";
     const sheetKind = kindRaw === "repeat" || kindRaw === "move-picker" || kindRaw === "other" ? kindRaw : "none";
     const formRaw = fields.get("form") ?? "none";
@@ -157,12 +418,17 @@ export function parseUiState(stdout) {
     const frontRaw = fields.get("front") ?? "";
     const frontmostApp = frontRaw === "" ? null : frontRaw;
     const role = fields.get("role") ?? "";
-    const subrole = fields.get("subrole") ?? "";
+    // AppleScript coerces an absent attribute to the literal words "missing
+    // value"; that is "no subrole", not a subrole named that.
+    const subroleRaw = fields.get("subrole") ?? "";
+    const subrole = subroleRaw === "missing value" ? "" : subroleRaw;
     const census = fields.get("census") ?? "";
     const depth = Number(fields.get("depth") ?? "0");
     return {
         thingsRunning: fields.get("running") === "true",
-        thingsFrontmost: frontmostApp === THINGS_PROCESS,
+        // Decided by the ADDRESSED probe, not by comparing a name the enumeration
+        // may never have been asked for (issue #629).
+        thingsFrontmost: fields.get("isfront") === "true",
         frontmostApp,
         sheetOpen: sheetKind !== "none",
         sheetKind,
@@ -171,14 +437,19 @@ export function parseUiState(stdout) {
         sheetControls: census === "" ? null : census,
         focusOwner: frontmostApp === null ? null : { app: frontmostApp, role, subrole: subrole || null },
         inspectable: fields.get("inspectable") === "true",
+        stalledProbes: probes("stalled"),
+        failedProbes: probes("failed"),
     };
 }
 /**
  * Read the census through the injected runner. Returns null on a transport
  * failure — an UNKNOWN state, which every caller treats fail-closed (the guard
  * refuses; the cleanup path does not send a blind Escape).
+ *
+ * `timeoutMs` defaults to {@link CENSUS_TIMEOUT_MS}: a census is not a drive
+ * step and must not borrow a drive step's patience (issue #629).
  */
-export async function readUiState(run, timeoutMs) {
+export async function readUiState(run, timeoutMs = CENSUS_TIMEOUT_MS) {
     const res = await run({ primitive: "resolve", label: UI_STATE_LABEL, script: axUiStateScript() }, timeoutMs);
     if (!res.ok)
         return null;
@@ -194,6 +465,12 @@ export async function readUiState(run, timeoutMs) {
 export function describeFocusOwner(state) {
     if (state === null)
         return "the window state could not be read";
+    // #629: an inspection that did not come back says nothing about who owns the
+    // screen — and saying "an unidentified application is frontmost" would read
+    // as a measurement. Name the probe that stalled instead.
+    if (censusUnverifiable(state)) {
+        return `the window state inspection did not complete (${describeUnprovenProbes(state)})`;
+    }
     if (!state.inspectable) {
         return ("a system dialog owns the screen — macOS does not expose it to other apps, so it cannot be " +
             `identified from here${state.frontmostApp === null ? "" : ` (frontmost application: ${state.frontmostApp})`}`);
@@ -204,11 +481,36 @@ export function describeFocusOwner(state) {
         ? `${app} is frontmost`
         : `${app} is frontmost and keyboard focus is on a ${role}`;
 }
-/** A one-line human summary of the census, for a diagnostic line or a warning. */
+/**
+ * A one-line human summary of the census, for a diagnostic line or a warning.
+ *
+ * Reports WHAT EACH PROBE PROVED. A stalled probe leaves its clause reading
+ * "could not be determined" and is named at the end — never omitted, and never
+ * rendered as its default (issue #629: a census that could not see the open
+ * Repeat sheet used to report a clean screen).
+ */
 export function describeUiState(state) {
-    const front = state.thingsFrontmost
-        ? "Things is frontmost"
-        : `${state.frontmostApp ?? "an unidentified application"} is frontmost`;
+    const unproven = (p) => state.stalledProbes.includes(p) || state.failedProbes.includes(p);
+    const trailer = () => {
+        const unprovenText = describeUnprovenProbes(state);
+        return unprovenText === "" ? "" : ` — ${unprovenText}`;
+    };
+    if (unproven("running")) {
+        return `nothing about the screen could be established${trailer()}`;
+    }
+    if (!state.thingsRunning && !unproven("frontmost")) {
+        return `Things is not running${trailer()}`;
+    }
+    const front = unproven("frontmost")
+        ? "whether Things owns the screen could not be determined"
+        : state.thingsFrontmost
+            ? "Things is frontmost"
+            : unproven("frontapp")
+                ? "another application is frontmost (it could not be named)"
+                : `${state.frontmostApp ?? "an unidentified application"} is frontmost`;
+    if (unproven("dialog")) {
+        return `${front}; whether a dialog is open in Things could not be determined${trailer()}`;
+    }
     const sheet = state.sheetKind === "none"
         ? "no dialog is open in Things"
         : state.sheetKind === "repeat"
@@ -219,7 +521,7 @@ export function describeUiState(state) {
     // A stack means the thing in front is sitting ON another dialog, and each one
     // has to be dismissed in turn (MODALX1 §6).
     const stacked = state.sheetDepth > 1 ? `, on top of ${state.sheetDepth - 1} more` : "";
-    return `${front}; ${sheet}${stacked}`;
+    return `${front}; ${sheet}${stacked}${trailer()}`;
 }
 /**
  * The warning an OPEN Things dialog earns, wherever it is reported.

package/dist/write/vectors/ui-state.js.map

@@ -1 +1 @@
-{"version":3,"file":"ui-state.js","sourceRoot":"","sources":["../../../src/write/vectors/ui-state.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"ui-state.js","sourceRoot":"","sources":["../../../src/write/vectors/ui-state.ts"],"names":[],"mappings":"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"}

package/dist/write/vectors/ui.d.ts

@@ -63,6 +63,41 @@ export type UiRunner = (command: UiCommand, timeoutMs: number) => Promise<UiRunR
 export declare const AX_FOCUS_GUARD_HANDLERS = "on fgFrontApp()\n\tset frontName to \"\"\n\ttry\n\t\ttell application \"System Events\" to set frontName to (name of first application process whose frontmost is true) as text\n\tend try\n\treturn frontName\nend fgFrontApp\n\non fgAssertFront(what)\n\tset f to my fgFrontApp()\n\tif f is \"Things3\" then return true\n\tif f is \"\" then\n\t\terror \"refused to \" & what & \": the frontmost application could not be read, so there is no proof the keystrokes would reach Things \u2014 nothing was typed\"\n\tend if\n\terror \"refused to \" & what & \": \" & f & \" is frontmost, not Things \u2014 a keystroke goes to whatever owns the screen, so nothing was typed\"\nend fgAssertFront";
 /** resolve-element: does the element exist right now? Returns "true"/"false". */
 export declare function axResolveScript(path: string): string;
+/**
+ * The AppleScript variable a folded candidate resolution binds the live element
+ * to. Every addressed script takes its target as `(<path>)`, so handing it this
+ * name — with {@link axCandidatePrelude} in front — makes the resolution and the
+ * action ONE hop instead of two (DRVLAT1, issue #633).
+ */
+export declare const STEP_ELEMENT_REF = "fgStepEl";
+/**
+ * The message a folded candidate resolution raises when NONE of a step's expected
+ * element shapes appeared. Byte-identical to the driver's own wording for the
+ * separate-hop resolution it replaces, so a report reads the same either way.
+ */
+export declare const CANDIDATES_MISSED: string;
+/**
+ * IN-SCRIPT CANDIDATE RESOLUTION (DRVLAT1, issue #633).
+ *
+ * A candidate-addressed step used to dispatch one `resolve` hop PER CANDIDATE PER
+ * POLL ROUND before the hop that acted on whichever answered — a process spawn
+ * each, on top of a 300ms JS-side poll floor. This prelude does the same work in
+ * the acting hop's own process: it polls the candidates in the SAME priority
+ * order, binds the first that exists to {@link STEP_ELEMENT_REF}, and fails closed
+ * with {@link CANDIDATES_MISSED} when the window elapses with none of them there.
+ *
+ * Collapsing it is also strictly better against TOCTOU: the element the script
+ * acts on is the one it just proved exists, with nothing dispatched in between.
+ */
+export declare function axCandidatePrelude(paths: string[], timeoutMs?: number): string;
+/**
+ * wait: poll for ANY of the awaited element shapes to appear, IN-SCRIPT (DRVLAT1).
+ * One hop for the whole wait instead of one per candidate per round — which is
+ * what a slow host paid most: the dialog the drive is waiting for is exactly the
+ * thing that is slow when the app is busy. Returns "true", or "false" when the
+ * window elapses with none of them present (the driver's abort path is unchanged).
+ */
+export declare function axWaitAnyScript(paths: string[], timeoutMs: number): string;
 /** press: AXPress the element. */
 export declare function axPressScript(path: string): string;
 /**
@@ -458,7 +493,7 @@ export declare function axSelectHeadingRowScript(tablePath: string, ordinal: num
  * naming expected vs observed. Pure System Events + Things scripting, background-
  * capable. One stable command shape per primitive.
  */
-export declare function axAssertEligibleScript(targetUuid: string, menuItemPath: string): string;
+export declare function axAssertEligibleScript(targetUuid: string, menuItemPath: string, settleMs?: number): string;
 /** activate: foreground Things (the fallback preamble step). */
 export declare function axActivateScript(): string;
 /**
@@ -558,6 +593,15 @@ export declare function axAbortScript(): string;
  * the census to decide that.
  */
 export declare function axCancelDialogScript(): string;
+/**
+ * The Cancel button's on-screen FRAME, resolved through the same addressed
+ * dialog-shell path the AXPress dismissal uses (issue #629). Feeds the pointer
+ * fallback: if `AXPress` on the button reports success and the dialog is still
+ * standing, a real click at the button's own AX-resolved centre is the next
+ * thing to try before discarding the window wholesale. The frame comes from the
+ * tree, never from a remembered coordinate, so a moved dialog fails closed.
+ */
+export declare function axCancelFrameScript(): string;
 /**
  * The PROVEN app-level clearance / relocation maneuver (SESSGATE, #480, live-host
  * recovery): close the front Things window — which takes an attached modal sheet
@@ -606,6 +650,13 @@ export interface ClearResult {
     sheetKind?: UiSheetKind;
     /** Who owned the screen when the cleanup started, when it was not Things. */
     focusOwner?: string;
+    /**
+     * True when the cleanup ran WITHOUT a working window-state inspection (issue
+     * #629) — the dismissal and its proof came from addressed reads alone, so the
+     * outcome is real but the identity of what was dismissed was taken from what
+     * this drive had already observed rather than re-confirmed.
+     */
+    unverified?: boolean;
 }
 /**
  * resolve-frame: read the element's on-screen frame (top-left origin, points)
@@ -693,7 +744,16 @@ export declare function judgeFocusGuard(state: UiState | null, expectedSheet: Ui
  * cannot see and would otherwise discover hours later on another device.
  */
 export declare function describeCleanup(clear: ClearResult): string;
-/** Compile one recipe step into its primitive command (no dispatch). */
+/**
+ * Compile one recipe step into its primitive command (no dispatch).
+ *
+ * A CANDIDATE-ADDRESSED step compiles to ONE script that resolves its own element
+ * and then acts on it (DRVLAT1, issue #633): the addressed body is generated
+ * against {@link STEP_ELEMENT_REF} and {@link axCandidatePrelude} is prepended, so
+ * the resolution that used to be a separate `resolve` hop (or several) now rides
+ * the acting hop. Steps whose script is JXA, or that resolve their own target,
+ * are unaffected.
+ */
 export declare function commandForStep(step: UiStep, targetUuid: string): UiCommand;
 /**
  * The ui vector. Config-gated: when `ui.enabled` is false the matrix reports