agent-director 0.18.6 → 0.18.8

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 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; later failure appears in
506
- * the pane and ad.cursor.failed. Missing still requires process evidence.
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
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "agent-director",
3
- "version": "0.18.6",
3
+ "version": "0.18.8",
4
4
  "type": "module",
5
5
  "os": ["linux", "darwin"],
6
6
  "cpu": ["x64", "arm64"],