From c01ffcee687e3ed7597e79700eaaf1dcca34c228 Mon Sep 17 00:00:00 2001 From: abrichr Date: Sat, 8 Aug 2026 20:47:35 +0200 Subject: [PATCH 1/2] docs: explain the mobile decision path --- README.md | 19 +++++++++++++++++++ 1 file changed, 19 insertions(+) diff --git a/README.md b/README.md index 2371749aa..7d0840fc7 100644 --- a/README.md +++ b/README.md @@ -126,6 +126,25 @@ state, record identity, target uniqueness, and the fresh application view. Afterward it waits for settled state and evaluates the declared effect. If the contract cannot be established, it returns evidence and halts. +### A focused question when a person is needed + +A halted run can send one signed task to the OpenAdapt phone view. The task can +ask about record identity, target ambiguity, a required human step, a saved +result, uncertain delivery, or an optional step. The phone shows only the +actions that the certified workflow permits. It does not click the application +or declare success. + +After an answer, the customer-controlled runner reads the live application +again. It checks the current pause, session, workflow state, identity, target, +and effect requirements before it continues. Protected screenshots stay on the +runner. The hosted path carries closed status values and counts; a customer-run +local portal can show the full evidence inside the customer's boundary. + +[Try the interactive mobile decision demo](https://app.openadapt.ai/demo/attention) +with synthetic application data. A domain label in the demo comes from that +fixture. A production workflow uses the reviewed entity class in its exact +qualification contract, or the neutral `record` or `item` label. + ### Deterministic healthy runs The compiler retains structural, accessibility, visual, OCR, spatial, and From 85678bbd6c5f9915a8bc7fc2391dfdeb21b41c2c Mon Sep 17 00:00:00 2001 From: abrichr Date: Sat, 8 Aug 2026 20:54:08 +0200 Subject: [PATCH 2/2] docs: bind mobile actions to the pause capability --- README.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index 7d0840fc7..d217abb41 100644 --- a/README.md +++ b/README.md @@ -131,8 +131,8 @@ contract cannot be established, it returns evidence and halts. A halted run can send one signed task to the OpenAdapt phone view. The task can ask about record identity, target ambiguity, a required human step, a saved result, uncertain delivery, or an optional step. The phone shows only the -actions that the certified workflow permits. It does not click the application -or declare success. +actions that the current sealed pause capability permits. It does not click the +application or declare success. After an answer, the customer-controlled runner reads the live application again. It checks the current pause, session, workflow state, identity, target,