agent-director 0.18.6 → 0.18.7
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 +5 -0
- package/dist/types.d.ts +13 -2
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -127,6 +127,11 @@ const result = await client.status({ instance_id: "<id>" });
|
|
|
127
127
|
console.log(result.state);
|
|
128
128
|
```
|
|
129
129
|
|
|
130
|
+
`get`, each `getMany` row and `status` expose `failure_reason: string | null`;
|
|
131
|
+
`list` omits it. Claude Code and Codex always return `null`. See
|
|
132
|
+
[Failure reasons](../../docs/caller-contract.md#failure-reasons) for recording
|
|
133
|
+
support and behaviour.
|
|
134
|
+
|
|
130
135
|
`StatusResult`, `GetResult` and each `ListRow` carry:
|
|
131
136
|
|
|
132
137
|
- `family_state: "working" | "waiting"`; see
|
package/dist/types.d.ts
CHANGED
|
@@ -502,8 +502,9 @@ export interface SpawnParams {
|
|
|
502
502
|
* The launch result. The row is `pending` from its insert until
|
|
503
503
|
* the agent reports in (Cursor: verified first prompt), then `waiting`.
|
|
504
504
|
* Cursor initialization, session creation and requested mode validation happen
|
|
505
|
-
* asynchronously. This result does not confirm them
|
|
506
|
-
*
|
|
505
|
+
* asynchronously. This result does not confirm them. Recorded Cursor failures
|
|
506
|
+
* appear as failure_reason on get, get-many and status, and in the gateway pane.
|
|
507
|
+
* Trail events are audit-only. Missing still requires process evidence.
|
|
507
508
|
*/
|
|
508
509
|
export interface SpawnResult {
|
|
509
510
|
/** The id the new Spawn is tracked under. */
|
|
@@ -577,6 +578,8 @@ export interface StatusResult {
|
|
|
577
578
|
* can be newer: a refusal can name a state status does not show yet.
|
|
578
579
|
*/
|
|
579
580
|
state: string;
|
|
581
|
+
/** As GetResult's: the sanitized Cursor failure for the reported state, or null. Other agents do not record reasons. */
|
|
582
|
+
failure_reason: string | null;
|
|
580
583
|
/**
|
|
581
584
|
* Complete stored family: self and live descendants, including through retained terminal
|
|
582
585
|
* intermediates. A live member counts as working while its raw state is not waiting or it
|
|
@@ -670,6 +673,14 @@ export interface GetResult {
|
|
|
670
673
|
* this field does not show yet.
|
|
671
674
|
*/
|
|
672
675
|
state: string;
|
|
676
|
+
/**
|
|
677
|
+
* Sanitized Cursor failure for this reported state's current interval; null when none
|
|
678
|
+
* is recorded. Waiting means a failed turn; missing means a failed session. Only
|
|
679
|
+
* agent "cursor" records reasons; other agents return null regardless of outcome.
|
|
680
|
+
* Follows state settling and clears with the next prompt or lifecycle transition,
|
|
681
|
+
* including rotation or a new launch. Never authorizes replay.
|
|
682
|
+
*/
|
|
683
|
+
failure_reason: string | null;
|
|
673
684
|
/**
|
|
674
685
|
* Complete stored family: self and live descendants, including through retained terminal
|
|
675
686
|
* intermediates. A live member counts as working while its raw state is not waiting or it
|