Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
3 changes: 3 additions & 0 deletions crates/bsk-cli/skill/references/cooperation.md
Original file line number Diff line number Diff line change
Expand Up @@ -32,6 +32,9 @@ is replayed to wait for success. Untargeted keys, visual clicks and other action
retain strict observation checks. For these, pass `--observation ID` from the sync alongside
`--context ID`. Supplementary reads do not replace that strict baseline. Read the returned
evidence before choosing the operation; sync again for the next strict action.
Under target policy, every successful sync returns a new top-level receipt, including
`kind: "unchanged"`. Sync again after a refused or failed untargeted attempt too, and
inspect the new evidence before choosing the next action.
Prefer a targeted key, such as `press Enter --ref @e3`, when the intended recipient is known.
Scripts have their own rules; see [Scripts](#scripts).

Expand Down
1 change: 1 addition & 0 deletions crates/bsk-cli/skill/references/help-and-recovery.md
Original file line number Diff line number Diff line change
Expand Up @@ -30,6 +30,7 @@ substring is enough.
| Help `cancelled` / `timed_out` | Respect rejection or the blocker; do not repeat the request. |
| Help `disabled` | No human action was confirmed. Re-observe and follow the disabled-help rules below. |
| Stale ref or target failure | Inspect the live target and choose the appropriate action. A missing, hidden or covered target is not evidence of human takeover. |
| `Could not clear the extension overlay from the click point` | The extension's control UI may cover the intended target. Temporarily turn off **Control hints** in the extension popup, then sync and inspect that same target before retrying. A page mask reported by VOM is separate from the extension overlay and may still block the action. |
| `precondition_failed` | Compare `target`, `field`, `expected` and `actual`, then reconsider the decision. A new context does not make the expected value true. |
| Control revoked | Wait while the person is active, then sync and reconcile completed steps. |
| Unknown tab/session | List current tabs/sessions; never guess IDs or use another task's session. |
Expand Down