agent-director 0.17.2 → 0.17.3

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.
Files changed (2) hide show
  1. package/README.md +16 -12
  2. 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, Codex fallback paste and input restrictions, omitted-ID
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 dismiss a
259
- prompt the agent shows before it reports in. Keys are delivered only to a
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,15 @@ 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
- For fallback input to a pending Codex row, the bounded hook-state observation
270
- and its unconfirmed result are described in the caller contract.
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, Codex fallback failures and Cursor gateway refusals carry additional
274
- runtime fields, including `outcome`, `phase`, `bytes_attempted`,
275
- `enter_may_have_been_sent` and `reason`; native attempts can also carry
276
+ uncertainty, Claude fallback's `not_started` refusals, Codex fallback failures
277
+ and Cursor gateway refusals carry additional runtime fields, including
278
+ `outcome`, `phase`, `bytes_attempted`, `enter_may_have_been_sent` and `reason`;
279
+ native attempts can also carry
276
280
  `request_id` and `last_queue`.
277
281
  Read these through `AgentDirectorError.errDetails`, whose type is
278
282
  `Readonly<Record<string, unknown>> | null`, and check their values; see
@@ -281,7 +285,7 @@ for the fields and recovery.
281
285
 
282
286
  `liveness_note: "unreported"` means an alive agent has not reported since
283
287
  launch. Action on a pending row belongs to the
284
- [caller contract](../../docs/caller-contract.md#caller-contract).
288
+ [caller contract](../../docs/caller-contract.md#pending-rows-and-startup-screens).
285
289
 
286
290
  ### readPane
287
291
 
@@ -584,8 +588,8 @@ carry one, typed as exported interfaces: `ErrRelayFallenBack`
584
588
  (`DialogMaybeOpenDetails`), `ErrPauseTimeout` (`PauseTimeoutDetails`) and
585
589
  `ErrSubmissionUnconfirmed`
586
590
  (`SubmissionUnconfirmedDetails`, for failed fallback hook observation).
587
- Native, fallback paste and Cursor gateway facts remain available through the
588
- generic `errDetails` record. So does the `ErrInternal` of a
591
+ Native, Claude readiness, Codex paste and Cursor gateway facts remain available
592
+ through the generic `errDetails` record. So does the `ErrInternal` of a
589
593
  pane answer whose key was sent but not recorded (`PaneKeySentDetails`:
590
594
  `key_sent` `true` and `request_token`). Read facts from `errDetails`, never
591
595
  from `errDescription`.
@@ -670,7 +674,7 @@ These classes correspond to the shared CLI `err_name` contract. They surface bad
670
674
  |---|---|
671
675
  | `ErrSpawnNotFound` | No spawn row matches the supplied `instance_id`. |
672
676
  | `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, 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`. |
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`. |
674
678
  | `ErrSpawnNotPausable` | The target spawn is not in a pausable (`waiting`) state. |
675
679
  | `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
680
  | `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. |
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "agent-director",
3
- "version": "0.17.2",
3
+ "version": "0.17.3",
4
4
  "type": "module",
5
5
  "os": ["linux", "darwin"],
6
6
  "cpu": ["x64", "arm64"],