agent-director 0.17.2 → 0.17.4
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 +19 -14
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -246,7 +246,7 @@ success and make no exact transcript-confirmation claim. Manual
|
|
|
246
246
|
operations (`no_enter`, `key`, empty text, pane hashes and permission answers)
|
|
247
247
|
return an empty object on success; their input-ownership refusals are in
|
|
248
248
|
[Manual input ownership](../../docs/caller-contract.md#manual-input-ownership).
|
|
249
|
-
Supported launches,
|
|
249
|
+
Supported launches, fallback readiness 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
|
|
@@ -255,8 +255,10 @@ with `outcome: "gateway_refused"`; see
|
|
|
255
255
|
[Cursor input outcomes](../../docs/caller-contract.md#cursor-input-outcomes).
|
|
256
256
|
|
|
257
257
|
Pass `allow_pending: true` to also allow a `pending` row: a launch (spawn,
|
|
258
|
-
reuse or resume) whose agent has not reported in yet, for example to
|
|
259
|
-
|
|
258
|
+
reuse or resume) whose agent has not reported in yet, for example to answer a
|
|
259
|
+
startup choice with `key` (including `key: "Enter"`). See
|
|
260
|
+
[pending startup screens](../../docs/caller-contract.md#pending-rows-and-startup-screens)
|
|
261
|
+
for text answers and Enter-only sends. Keys are delivered only to a
|
|
260
262
|
session started by the row's current launch. `ended` and `missing` rows are
|
|
261
263
|
rejected, including retries of an existing delivery request. State, relay and
|
|
262
264
|
dialog guards precede native capability selection and request reconciliation.
|
|
@@ -266,13 +268,16 @@ only a session an earlier launch left behind is found, gets
|
|
|
266
268
|
|
|
267
269
|
`allow_pending` preserves native readiness and transcript requirements on
|
|
268
270
|
supported launches; it does not make a startup dialog an ordinary composer.
|
|
269
|
-
|
|
270
|
-
|
|
271
|
+
Ordinary pending Claude fallback has a readiness wait, and pending Claude and
|
|
272
|
+
Codex fallback have a hook check; see
|
|
273
|
+
[Ordinary text submission](../../docs/caller-contract.md#ordinary-text-submission).
|
|
271
274
|
`SubmissionUnconfirmedDetails` describes only a failed fallback hook observation:
|
|
272
275
|
`keys_sent: true`, `submission_confirmed: false` and `row_state`. Native
|
|
273
|
-
uncertainty,
|
|
276
|
+
uncertainty, Claude fallback's `not_started` refusals, Claude paced typing
|
|
277
|
+
failures, Codex fallback failures and Cursor gateway refusals carry additional
|
|
274
278
|
runtime fields, including `outcome`, `phase`, `bytes_attempted`,
|
|
275
|
-
`enter_may_have_been_sent` and `reason`;
|
|
279
|
+
`enter_may_have_been_sent` and `reason`;
|
|
280
|
+
native attempts can also carry
|
|
276
281
|
`request_id` and `last_queue`.
|
|
277
282
|
Read these through `AgentDirectorError.errDetails`, whose type is
|
|
278
283
|
`Readonly<Record<string, unknown>> | null`, and check their values; see
|
|
@@ -281,7 +286,7 @@ for the fields and recovery.
|
|
|
281
286
|
|
|
282
287
|
`liveness_note: "unreported"` means an alive agent has not reported since
|
|
283
288
|
launch. Action on a pending row belongs to the
|
|
284
|
-
[caller contract](../../docs/caller-contract.md#
|
|
289
|
+
[caller contract](../../docs/caller-contract.md#pending-rows-and-startup-screens).
|
|
285
290
|
|
|
286
291
|
### readPane
|
|
287
292
|
|
|
@@ -584,11 +589,11 @@ carry one, typed as exported interfaces: `ErrRelayFallenBack`
|
|
|
584
589
|
(`DialogMaybeOpenDetails`), `ErrPauseTimeout` (`PauseTimeoutDetails`) and
|
|
585
590
|
`ErrSubmissionUnconfirmed`
|
|
586
591
|
(`SubmissionUnconfirmedDetails`, for failed fallback hook observation).
|
|
587
|
-
Native,
|
|
588
|
-
generic `errDetails` record. So does the
|
|
589
|
-
pane answer whose key was sent but not recorded
|
|
590
|
-
`key_sent` `true` and `request_token`). Read facts from
|
|
591
|
-
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`.
|
|
592
597
|
|
|
593
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.
|
|
594
599
|
|
|
@@ -670,7 +675,7 @@ These classes correspond to the shared CLI `err_name` contract. They surface bad
|
|
|
670
675
|
|---|---|
|
|
671
676
|
| `ErrSpawnNotFound` | No spawn row matches the supplied `instance_id`. |
|
|
672
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). |
|
|
673
|
-
| `ErrSubmissionUnconfirmed` | `SubmissionUnconfirmedDetails` describes failed fallback hook observation; native,
|
|
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`. |
|
|
674
679
|
| `ErrSpawnNotPausable` | The target spawn is not in a pausable (`waiting`) state. |
|
|
675
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). |
|
|
676
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. |
|