agent-director 0.17.1 → 0.17.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +8 -6
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -223,7 +223,7 @@ alone (`"Escape"`, `"Enter"`, `"Up"`, `"Down"`, `"Tab"`, or one character),
|
|
|
223
223
|
never followed by Enter. With `expect_pane_sha256` (the `pane_sha256` of
|
|
224
224
|
the `readPane` you looked at, with its `n_lines`), nothing is sent if the
|
|
225
225
|
pane changed since (`ErrPaneChanged`); on a relayed Spawn a match also
|
|
226
|
-
passes the dialog hold (`ErrDialogMaybeOpen`, see "Answering a request at
|
|
226
|
+
passes the API's dialog hold (`ErrDialogMaybeOpen`, see "Answering a request at
|
|
227
227
|
the pane" below). Pass it only for a pane a person or an LLM judged, never
|
|
228
228
|
from an automatic flow.
|
|
229
229
|
|
|
@@ -250,7 +250,9 @@ Supported launches, Codex fallback paste and input restrictions, omitted-ID
|
|
|
250
250
|
behavior, structured outcomes and recovery are in
|
|
251
251
|
[Ordinary text submission](../../docs/caller-contract.md#ordinary-text-submission).
|
|
252
252
|
Allow sufficient `callTimeoutMs` for that delivery window; a timeout does not
|
|
253
|
-
cancel submission.
|
|
253
|
+
cancel submission. Cursor sends with Enter can return `ErrSubmissionUnconfirmed`
|
|
254
|
+
with `outcome: "gateway_refused"`; see
|
|
255
|
+
[Cursor input outcomes](../../docs/caller-contract.md#cursor-input-outcomes).
|
|
254
256
|
|
|
255
257
|
Pass `allow_pending: true` to also allow a `pending` row: a launch (spawn,
|
|
256
258
|
reuse or resume) whose agent has not reported in yet, for example to dismiss a
|
|
@@ -268,7 +270,7 @@ For fallback input to a pending Codex row, the bounded hook-state observation
|
|
|
268
270
|
and its unconfirmed result are described in the caller contract.
|
|
269
271
|
`SubmissionUnconfirmedDetails` describes only a failed fallback hook observation:
|
|
270
272
|
`keys_sent: true`, `submission_confirmed: false` and `row_state`. Native
|
|
271
|
-
uncertainty
|
|
273
|
+
uncertainty, Codex fallback failures and Cursor gateway refusals carry additional
|
|
272
274
|
runtime fields, including `outcome`, `phase`, `bytes_attempted`,
|
|
273
275
|
`enter_may_have_been_sent` and `reason`; native attempts can also carry
|
|
274
276
|
`request_id` and `last_queue`.
|
|
@@ -582,8 +584,8 @@ carry one, typed as exported interfaces: `ErrRelayFallenBack`
|
|
|
582
584
|
(`DialogMaybeOpenDetails`), `ErrPauseTimeout` (`PauseTimeoutDetails`) and
|
|
583
585
|
`ErrSubmissionUnconfirmed`
|
|
584
586
|
(`SubmissionUnconfirmedDetails`, for failed fallback hook observation).
|
|
585
|
-
Native
|
|
586
|
-
record. So does the `ErrInternal` of a
|
|
587
|
+
Native, fallback paste and Cursor gateway facts remain available through the
|
|
588
|
+
generic `errDetails` record. So does the `ErrInternal` of a
|
|
587
589
|
pane answer whose key was sent but not recorded (`PaneKeySentDetails`:
|
|
588
590
|
`key_sent` `true` and `request_token`). Read facts from `errDetails`, never
|
|
589
591
|
from `errDescription`.
|
|
@@ -668,7 +670,7 @@ These classes correspond to the shared CLI `err_name` contract. They surface bad
|
|
|
668
670
|
|---|---|
|
|
669
671
|
| `ErrSpawnNotFound` | No spawn row matches the supplied `instance_id`. |
|
|
670
672
|
| `ErrSpawnNotInteractive` | New input requires a live interactive state (`waiting`/`working`/`ask_user`/`check_permission`); `pending`, `ended`, and `missing` are rejected. With `allow_pending: true`, `sendKeys` allows a `pending` row but delivers keys only to a session started by the row's current launch: a `pending` row with no launch start or launch token recorded, or where only a session an earlier launch left behind is found, is still refused and nothing is sent. `ended` and `missing` rows are refused even when observing an existing delivery request; see [Ordinary text submission](../../docs/caller-contract.md#ordinary-text-submission). |
|
|
671
|
-
| `ErrSubmissionUnconfirmed` | `SubmissionUnconfirmedDetails` describes failed fallback hook observation; native
|
|
673
|
+
| `ErrSubmissionUnconfirmed` | `SubmissionUnconfirmedDetails` describes failed fallback hook observation; native, fallback paste and Cursor gateway outcome fields are available through the generic `errDetails` record. See [Ordinary text submission](../../docs/caller-contract.md#ordinary-text-submission) for automatic delivery, [Cursor input outcomes](../../docs/caller-contract.md#cursor-input-outcomes) for `gateway_refused`, and [Manual input ownership](../../docs/caller-contract.md#manual-input-ownership) for manual `sendKeys`. |
|
|
672
674
|
| `ErrSpawnNotPausable` | The target spawn is not in a pausable (`waiting`) state. |
|
|
673
675
|
| `ErrPauseTimeout` | Exit keys were sent but `ended` was not observed; `errDetails` has the `PauseTimeoutDetails` shape. See [When pause cannot confirm exit](../../docs/caller-contract.md#when-pause-cannot-confirm-exit). |
|
|
674
676
|
| `ErrSpawnNotResumable` | `resume` applies only to a finished (`ended`/`missing`) spawn. A live spawn is refused because its agent is running. A `pending` spawn is refused too: it is a launch (spawn, reuse or resume) in progress whose agent has not reported in, a resumed row included. Abandoned or failed launch handling is owned by [Caller contract](../../docs/caller-contract.md) and [Maintenance](../../docs/maintenance.md). Also returned when the row changed after `resume` examined it; nothing is written. |
|