agent-director 0.13.0 → 0.14.0
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 -7
- package/dist/index.d.ts +1 -1
- package/dist/types.d.ts +46 -0
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -147,13 +147,16 @@ const result = await client.status({ instance_id: "<id>" });
|
|
|
147
147
|
console.log(result.state);
|
|
148
148
|
```
|
|
149
149
|
|
|
150
|
-
|
|
151
|
-
`
|
|
152
|
-
|
|
153
|
-
|
|
154
|
-
|
|
155
|
-
|
|
156
|
-
|
|
150
|
+
`StatusResult`, `GetResult` and each `ListRow` expose
|
|
151
|
+
`family_state: "working" | "waiting"`, separately from `state`.
|
|
152
|
+
[Usage](../../docs/usage.md#family-state) defines membership and raw
|
|
153
|
+
aggregation; the [caller contract](../../docs/caller-contract.md#family-reporting-limits)
|
|
154
|
+
defines reporting limits.
|
|
155
|
+
|
|
156
|
+
`status`, `get` and `list` use `[state] settle_ms` in the CLI's
|
|
157
|
+
`~/.config/agent-director/config.toml` for [independent state and family
|
|
158
|
+
settling](../../docs/configuration.md#settle-time-state). Verbs that act on a
|
|
159
|
+
Spawn judge its live state, which can be newer than its reported state.
|
|
157
160
|
|
|
158
161
|
### list
|
|
159
162
|
|
package/dist/index.d.ts
CHANGED
|
@@ -12,4 +12,4 @@ export type { CheckedLocation, UnreachableReason } from "./errors.js";
|
|
|
12
12
|
export type { ClientOptions, Logger } from "./types.js";
|
|
13
13
|
export type { VerbSummary, PermissionRequestInfo, ListRow, Delivery, RequestDelivery, PaneAnswer, ProvenGoneHow, } from "./types.js";
|
|
14
14
|
export type { RelayFallenBackDetails, OpenRequestFacts, PaneAnswerInProgressDetails, ClaimTooSoonDetails, PaneChangedDetails, PaneKeySentDetails, SubmissionUnconfirmedDetails, DialogMaybeOpenDetails, } from "./types.js";
|
|
15
|
-
export type { SpawnParams, SpawnResult, StatusParams, StatusResult, GetParams, GetResult, SendKeysParams, SendKeysResult, ReadPaneParams, ReadPaneResult, KillParams, KillResult, DecideParams, DecideResult, GetPermissionParams, GetPermissionResult, RecordPaneAnswerParams, RecordPaneAnswerResult, ResumeParams, ResumeResult, FindMissingParams, FindMissingResult, ExpireParams, ExpireResult, MakeTemplateParams, MakeTemplateResult, ListParams, ListResult, ListSubagentsParams, ListSubagentsResult, SubagentRecord, PauseParams, PauseResult, VersionParams, VersionResult, } from "./types.js";
|
|
15
|
+
export type { SpawnParams, SpawnResult, StatusParams, StatusResult, ContextReading, GetParams, GetResult, SendKeysParams, SendKeysResult, ReadPaneParams, ReadPaneResult, KillParams, KillResult, DecideParams, DecideResult, GetPermissionParams, GetPermissionResult, RecordPaneAnswerParams, RecordPaneAnswerResult, ResumeParams, ResumeResult, FindMissingParams, FindMissingResult, ExpireParams, ExpireResult, MakeTemplateParams, MakeTemplateResult, ListParams, ListResult, ListSubagentsParams, ListSubagentsResult, SubagentRecord, PauseParams, PauseResult, VersionParams, VersionResult, } from "./types.js";
|
package/dist/types.d.ts
CHANGED
|
@@ -252,6 +252,13 @@ export interface ListRow {
|
|
|
252
252
|
* its live state, which can be newer: a refusal can name a state this field does not show yet.
|
|
253
253
|
*/
|
|
254
254
|
state: string;
|
|
255
|
+
/**
|
|
256
|
+
* Complete stored family: self and live descendants, including through retained terminal
|
|
257
|
+
* intermediates. Waiting means every live member is waiting, or no live members remain.
|
|
258
|
+
* Uses raw member states and settles once in either direction with `[state] settle_ms`,
|
|
259
|
+
* independently of `state`. This report does not establish readiness or task success.
|
|
260
|
+
*/
|
|
261
|
+
family_state: "working" | "waiting";
|
|
255
262
|
/** Canonicalized working directory. */
|
|
256
263
|
cwd: string;
|
|
257
264
|
/** The agent the row runs: `"claude"` (Claude Code), `"codex"` (Codex) or `"cursor"` (Cursor). Set at spawn; resume follows it. */
|
|
@@ -435,6 +442,8 @@ export interface StatusParams {
|
|
|
435
442
|
}
|
|
436
443
|
/** The row's reported lifecycle state. */
|
|
437
444
|
export interface StatusResult {
|
|
445
|
+
/** Experimental context estimate for the current session. */
|
|
446
|
+
context: ContextReading;
|
|
438
447
|
/**
|
|
439
448
|
* Current lifecycle state (pending/waiting/working/ask_user/check_permission/ended/missing).
|
|
440
449
|
* pending means a launch (spawn, reuse or resume) is in progress and the agent has not
|
|
@@ -450,6 +459,13 @@ export interface StatusResult {
|
|
|
450
459
|
* can be newer: a refusal can name a state status does not show yet.
|
|
451
460
|
*/
|
|
452
461
|
state: string;
|
|
462
|
+
/**
|
|
463
|
+
* Complete stored family: self and live descendants, including through retained terminal
|
|
464
|
+
* intermediates. Waiting means every live member is waiting, or no live members remain.
|
|
465
|
+
* Uses raw member states and settles once in either direction with `[state] settle_ms`,
|
|
466
|
+
* independently of `state`. This report does not establish readiness or task success.
|
|
467
|
+
*/
|
|
468
|
+
family_state: "working" | "waiting";
|
|
453
469
|
/**
|
|
454
470
|
* Start of the launch in progress (RFC3339 UTC, millisecond precision); present only on a
|
|
455
471
|
* pending row, omitted otherwise. It follows the row's live state: with `[state] settle_ms`
|
|
@@ -457,6 +473,25 @@ export interface StatusResult {
|
|
|
457
473
|
*/
|
|
458
474
|
launch_started_at?: string | null;
|
|
459
475
|
}
|
|
476
|
+
/**
|
|
477
|
+
* Experimental: agent internals and this output shape have no stable-format guarantee.
|
|
478
|
+
* Unavailable readings retain all five null fields. The Codex 0.159.2 OpenAI rollout
|
|
479
|
+
* source estimates last-response occupancy from its own usage and reported usable window;
|
|
480
|
+
* it does not represent cumulative billing. Claude 2.1.280 first-party pairs native capacity
|
|
481
|
+
* callbacks with transcript usage for the same resolved model and response, without provider,
|
|
482
|
+
* endpoint or window overrides. Cursor remains unknown: managed ACP lacks the ordinary
|
|
483
|
+
* usage-bearing afterAgentResponse/stop path and manual /summarize; its prompt result has only
|
|
484
|
+
* stopReason. Both captured Cursor versions have a shared-resource native preCompact executor
|
|
485
|
+
* path, but automatic managed delivery remains unqualified and managed support incomplete.
|
|
486
|
+
*/
|
|
487
|
+
export interface ContextReading {
|
|
488
|
+
used_tokens: number | null;
|
|
489
|
+
window_tokens: number | null;
|
|
490
|
+
fraction: number | null;
|
|
491
|
+
source: string | null;
|
|
492
|
+
/** Measurement time in RFC3339 UTC, never the time of the read. */
|
|
493
|
+
as_of: string | null;
|
|
494
|
+
}
|
|
460
495
|
/** The id whose row is requested. */
|
|
461
496
|
export interface GetParams {
|
|
462
497
|
/** Id of the Spawn to fetch. */
|
|
@@ -464,6 +499,8 @@ export interface GetParams {
|
|
|
464
499
|
}
|
|
465
500
|
/** One tracked agent row, with its current session and request facts. */
|
|
466
501
|
export interface GetResult {
|
|
502
|
+
/** Experimental context estimate for the current session. */
|
|
503
|
+
context: ContextReading;
|
|
467
504
|
instance_id: string;
|
|
468
505
|
parent_id: string;
|
|
469
506
|
/**
|
|
@@ -481,6 +518,13 @@ export interface GetResult {
|
|
|
481
518
|
* its live state, which can be newer: a refusal can name a state this field does not show yet.
|
|
482
519
|
*/
|
|
483
520
|
state: string;
|
|
521
|
+
/**
|
|
522
|
+
* Complete stored family: self and live descendants, including through retained terminal
|
|
523
|
+
* intermediates. Waiting means every live member is waiting, or no live members remain.
|
|
524
|
+
* Uses raw member states and settles once in either direction with `[state] settle_ms`,
|
|
525
|
+
* independently of `state`. This report does not establish readiness or task success.
|
|
526
|
+
*/
|
|
527
|
+
family_state: "working" | "waiting";
|
|
484
528
|
cwd: string;
|
|
485
529
|
/** The agent the row runs: `"claude"` (Claude Code), `"codex"` (Codex) or `"cursor"` (Cursor). Set at spawn; resume follows it. */
|
|
486
530
|
agent: string;
|
|
@@ -1045,6 +1089,8 @@ export interface ListSubagentsParams {
|
|
|
1045
1089
|
* (trailing zeros dropped, no fraction on a whole second), exactly as the CLI prints it.
|
|
1046
1090
|
*/
|
|
1047
1091
|
export interface SubagentRecord {
|
|
1092
|
+
/** Experimental reading; unknown without evidence belonging to this child. */
|
|
1093
|
+
context: ContextReading;
|
|
1048
1094
|
/** The subagent's id, unique among the records shown for its row. */
|
|
1049
1095
|
subagent_id: string;
|
|
1050
1096
|
/** The id of the row (agent) the subagent belongs to. */
|