agent-director 0.17.3 → 0.17.5
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 +10 -9
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -273,9 +273,10 @@ Codex fallback have a hook check; see
|
|
|
273
273
|
[Ordinary text submission](../../docs/caller-contract.md#ordinary-text-submission).
|
|
274
274
|
`SubmissionUnconfirmedDetails` describes only a failed fallback hook observation:
|
|
275
275
|
`keys_sent: true`, `submission_confirmed: false` and `row_state`. Native
|
|
276
|
-
uncertainty, Claude fallback's `not_started` refusals,
|
|
277
|
-
and Cursor gateway refusals carry additional
|
|
278
|
-
`outcome`, `phase`, `bytes_attempted`,
|
|
276
|
+
uncertainty, Claude fallback's `not_started` refusals, Claude paced typing
|
|
277
|
+
failures, Codex fallback failures and Cursor gateway refusals carry additional
|
|
278
|
+
runtime fields, including `outcome`, `phase`, `bytes_attempted`,
|
|
279
|
+
`enter_may_have_been_sent` and `reason`;
|
|
279
280
|
native attempts can also carry
|
|
280
281
|
`request_id` and `last_queue`.
|
|
281
282
|
Read these through `AgentDirectorError.errDetails`, whose type is
|
|
@@ -588,11 +589,11 @@ carry one, typed as exported interfaces: `ErrRelayFallenBack`
|
|
|
588
589
|
(`DialogMaybeOpenDetails`), `ErrPauseTimeout` (`PauseTimeoutDetails`) and
|
|
589
590
|
`ErrSubmissionUnconfirmed`
|
|
590
591
|
(`SubmissionUnconfirmedDetails`, for failed fallback hook observation).
|
|
591
|
-
Native, Claude readiness, Codex paste and Cursor gateway
|
|
592
|
-
through the generic `errDetails` record. So does the
|
|
593
|
-
pane answer whose key was sent but not recorded
|
|
594
|
-
`key_sent` `true` and `request_token`). Read facts from
|
|
595
|
-
from `errDescription`.
|
|
592
|
+
Native, Claude readiness, Claude paced typing, Codex paste and Cursor gateway
|
|
593
|
+
facts remain available through the generic `errDetails` record. So does the
|
|
594
|
+
`ErrInternal` of a pane answer whose key was sent but not recorded
|
|
595
|
+
(`PaneKeySentDetails`: `key_sent` `true` and `request_token`). Read facts from
|
|
596
|
+
`errDetails`, never from `errDescription`.
|
|
596
597
|
|
|
597
598
|
The public typed-error surface falls into four groups. Every class named below is exported from the package entry point. The tables are self-sufficient for choosing what to catch; the CLI error contract also applies to group 4.
|
|
598
599
|
|
|
@@ -674,7 +675,7 @@ These classes correspond to the shared CLI `err_name` contract. They surface bad
|
|
|
674
675
|
|---|---|
|
|
675
676
|
| `ErrSpawnNotFound` | No spawn row matches the supplied `instance_id`. |
|
|
676
677
|
| `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). |
|
|
677
|
-
| `ErrSubmissionUnconfirmed` | `SubmissionUnconfirmedDetails` describes failed fallback hook observation; native, Claude readiness, Codex 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`. |
|
|
678
|
+
| `ErrSubmissionUnconfirmed` | `SubmissionUnconfirmedDetails` describes failed fallback hook observation; native, Claude readiness, Claude paced typing, Codex 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`. |
|
|
678
679
|
| `ErrSpawnNotPausable` | The target spawn is not in a pausable (`waiting`) state. |
|
|
679
680
|
| `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). |
|
|
680
681
|
| `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. |
|