humanish 0.116.0 → 0.117.0

package/docs/architecture/browser-control.md

@@ -103,10 +103,16 @@ Observation requires a PNG and state signature. It may include bounded URL,
 title, text, fractional scroll position and heard speech; those remain
 runtime-only under the existing loop contract. Arbitrary `appState` is refused
 because v1 has no closed schema for it. The protocol does not truncate strings,
-round coordinates, or silently drop unsupported state. A Codex participant's
-`humanish_ui` call is checked before it reaches the protocol: a wait longer than 30 seconds is
-shortened to 30 seconds there, and the trace records a `wait shortened` notice with both
-durations.
+round coordinates, or silently drop unsupported state. A participant may ask for a
+longer wait than one request carries. The computer-use loop shortens it to the study's
+`actor.maxWaitMs` (by default two minutes, or 30 seconds on a desktop with speech, whose heard
+speech reaches the participant only with a screenshot), records a `wait shortened` notice with both
+durations when it does, and sends the rest as consecutive waits of at most 30 seconds. The Codex
+participant's `humanish_ui` schema leaves a wait's length open for that reason; the wire still
+refuses a single wait over 30 seconds. A wait that names no duration, as every OpenAI computer-use
+wait does, reaches the desktop with a length too: the study's `actor.idleWaitMs` (5 seconds by
+default) when the participant's turn only waits or takes screenshots, and 500 ms after an action in
+the same turn.
 
 Click, double-click, move, scroll and drag may carry `heldKeys`, which the
 OpenAI provider maps from its computer tool's `keys`. The Codex participant's

package/docs/contracts/schemas.md

@@ -76,17 +76,17 @@ map each one to its v3 key.
 A study declares its route and composes code primitives; it is not a hardcoded kind. The
 top-level keys:
 
-| Key                                                               | Meaning                                                                                                                                            |
-| ----------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `schema`, `id`, `title`, `description`                            | the document's identity                                                                                                                            |
-| `route`                                                           | required: `preview`, `computer-use`, `shared-world`, `terminal` or `scripted`                                                                      |
-| `mode`                                                            | `dry-run` (the default) or `live`                                                                                                                  |
-| `actor`                                                           | who drives it, one object: `type`, `model`, `localAgent`, `persona`, `mission`, `tasks`, `maxOutputTokens`, `reasoningEffort`, `stopWhen`, `dwell` |
-| `participants`                                                    | a count, a homogeneous `{ count, instruction }`, or a list of entries (below)                                                                      |
-| `surfaces`                                                        | scripted only: `[desktop]` or `[desktop, mobile]`                                                                                                  |
-| `caps`                                                            | the route's budget (below)                                                                                                                         |
-| `scenario`                                                        | scripted only: a committed scenario id or path                                                                                                     |
-| `subject`, `execution`, `policies`, `review`, `defaults`, `comms` | as below                                                                                                                                           |
+| Key                                                               | Meaning                                                                                                                                                                       |
+| ----------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `schema`, `id`, `title`, `description`                            | the document's identity                                                                                                                                                       |
+| `route`                                                           | required: `preview`, `computer-use`, `shared-world`, `terminal` or `scripted`                                                                                                 |
+| `mode`                                                            | `dry-run` (the default) or `live`                                                                                                                                             |
+| `actor`                                                           | who drives it, one object: `type`, `model`, `localAgent`, `persona`, `mission`, `tasks`, `maxOutputTokens`, `maxWaitMs`, `idleWaitMs`, `reasoningEffort`, `stopWhen`, `dwell` |
+| `participants`                                                    | a count, a homogeneous `{ count, instruction }`, or a list of entries (below)                                                                                                 |
+| `surfaces`                                                        | scripted only: `[desktop]` or `[desktop, mobile]`                                                                                                                             |
+| `caps`                                                            | the route's budget (below)                                                                                                                                                    |
+| `scenario`                                                        | scripted only: a committed scenario id or path                                                                                                                                |
+| `subject`, `execution`, `policies`, `review`, `defaults`, `comms` | as below                                                                                                                                                                      |
 
 The parser reads only the declared route's keys. A key that route never reads is an error that
 names the route, such as "route: computer-use does not read scenario. Remove it.", and an
@@ -985,6 +985,14 @@ Core-owned fields:
   “provider reply cut off by the output limit; asking again” notice. A second
   cut-off reply to the same request ends the session with
   `stopCause: provider_output_limit`.
+- optional `waitSettings`: the wait lengths a computer-use participant's session
+  applied, in milliseconds, defaults included. `maxWaitMs` is the longest one
+  wait action lasts (`actor.maxWaitMs`); a longer wait is shortened to it.
+  `idleWaitMs` is how long a wait that names no duration lasts in a turn that
+  only waits or takes screenshots (`actor.idleWaitMs`), and `settleWaitMs` how
+  long such a wait lasts after an action in the same turn. Each `ui_action` for
+  a wait is titled with the length it lasted. Absent on other routes and on
+  earlier bundles
 - optional `conversation`: how the first-party OpenAI computer-use provider
   carried the conversation between requests. `mode` is `threaded` (the server
   kept it through `previous_response_id`) or `explicit_context` (the server kept

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "humanish",
-  "version": "0.116.0",
+  "version": "0.117.0",
   "description": "Synthetic user research for apps, CLIs, and agent-facing product flows.",
   "keywords": [
     "cli",
@@ -91,7 +91,7 @@
     "comms:agentmail:contract": "node --import tsx scripts/agentmail-contract-check.mjs",
     "format": "oxfmt",
     "format:check": "oxfmt --check",
-    "lint": "node scripts/check-lint-cap.mjs --max-warnings=436",
+    "lint": "node scripts/check-lint-cap.mjs --max-warnings=426",
     "knip": "knip",
     "prose:check": "node scripts/check-code-prose.mjs",
     "vocabulary:check": "tsx scripts/check-retired-words.ts",