things-api 0.19.2 → 0.19.3

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,39 @@ 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 ""
+set frontIsThings to false
 set focusRole to ""
 set focusSub to ""
 set canInspect to true
@@ -70,70 +154,159 @@ 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
 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`;
+
+return "front=" & frontName & linefeed & "isfront=" & frontIsThings & linefeed & "running=" & thingsRunning & linefeed & "form=" & sheetForm & linefeed & "depth=" & sheetDepth & linefeed & "kind=" & sheetKind & linefeed & "census=" & census & linefeed & "role=" & focusRole & linefeed & "subrole=" & focusSub & linefeed & "inspectable=" & canInspect & linefeed & "stalled=" & stalled & linefeed & "failed=" & failed`;
 }
 /**
  * Parse the census record into a {@link UiState}. Returns null when the output
@@ -150,6 +323,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 +331,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 +350,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 +378,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 +394,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 +434,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

@@ -558,6 +558,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 +615,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)