agl 43.0.2 → 43.0.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.
- package/changelog.md +6 -0
- package/dist_serve/bundle.js +749 -749
- package/dist_serve/bundle.js.map +2 -2
- package/dist_ts/00_commitinfo_data.js +1 -1
- package/dist_ts/aglapi/aglapisurface.document.js +37 -2
- package/dist_ts/classes.claudeharness.js +19 -6
- package/dist_ts/classes.codexclientadapter.d.ts +2 -1
- package/dist_ts/classes.codexclientadapter.js +11 -6
- package/dist_ts/classes.codexprojection.d.ts +8 -1
- package/dist_ts/classes.codexprojection.js +22 -2
- package/dist_ts/classes.sessionfeed.d.ts +20 -2
- package/dist_ts/classes.sessionfeed.js +63 -24
- package/dist_ts/fleet/classes.claudeworkers.d.ts +4 -1
- package/dist_ts/fleet/classes.claudeworkers.js +52 -6
- package/dist_ts/fleet/classes.codexworkers.d.ts +2 -1
- package/dist_ts/fleet/classes.codexworkers.js +34 -9
- package/dist_ts/fleet/classes.workers.js +9 -5
- package/dist_ts/fleet/functions.workervalidation.js +4 -2
- package/dist_ts/fleet/interfaces.workers.d.ts +27 -2
- package/dist_ts/fleet/interfaces.workers.js +7 -1
- package/dist_ts_interfaces/fleetworkers.d.ts +17 -1
- package/dist_ts_interfaces/interfaces.d.ts +20 -0
- package/dist_ts_interfaces/interfaces.js +2 -1
- package/dist_ts_interfaces/requests.fleetworkers.d.ts +11 -2
- package/dist_ts_interfaces/sessionfeed.d.ts +12 -2
- package/dist_ts_interfaces/sessionfeed.js +1 -1
- package/package.json +2 -2
- package/readme.md +1 -1
- package/ts/00_commitinfo_data.ts +1 -1
- package/ts/aglapi/aglapisurface.document.ts +36 -1
- package/ts/classes.claudeharness.ts +19 -3
- package/ts/classes.codexclientadapter.ts +9 -6
- package/ts/classes.codexprojection.ts +23 -2
- package/ts/classes.sessionfeed.ts +77 -29
- package/ts/fleet/classes.claudeworkers.ts +57 -9
- package/ts/fleet/classes.codexworkers.ts +35 -11
- package/ts/fleet/classes.workers.ts +8 -4
- package/ts/fleet/functions.workervalidation.ts +3 -1
- package/ts/fleet/interfaces.workers.ts +25 -2
- package/ts_interfaces/fleetworkers.ts +17 -1
- package/ts_interfaces/interfaces.ts +22 -0
- package/ts_interfaces/requests.fleetworkers.ts +11 -2
- package/ts_interfaces/sessionfeed.ts +12 -2
- package/ts_web/00_commitinfo_data.ts +1 -1
- package/ts_web/classes.controllersocketclient.ts +10 -2
|
@@ -20,6 +20,12 @@ export class FleetNativeTurnError extends Error {
|
|
|
20
20
|
this.name = 'FleetNativeTurnError';
|
|
21
21
|
}
|
|
22
22
|
}
|
|
23
|
+
/**
|
|
24
|
+
* Whether a Claude Code job its inventory lists waits for a person in Claude Code itself: its process reports
|
|
25
|
+
* `waiting` while the job has not failed. A failed job is a failure, never a wait, and a `blocked` state alone is no
|
|
26
|
+
* wait: a live job whose turn ended shows status `idle` with state `done` or `blocked`, and counts as idle.
|
|
27
|
+
*/
|
|
28
|
+
export const fleetClaudeNativeWait = (agentArg) => (agentArg.status === 'waiting' && agentArg.state !== 'failed' ? { reason: 'native_prompt' } : undefined);
|
|
23
29
|
/**
|
|
24
30
|
* A report starts a line; workers end a turn on `result:` or `needs input:`. A line addressed to the driver
|
|
25
31
|
* (`driver:`, `@driver`, `question for the driver`), or a direct report's `owner question:`, `cross-subject:` (work
|
|
@@ -96,4 +102,4 @@ export const boundedFleetReport = (text) => {
|
|
|
96
102
|
* endings and surrounding whitespace do not count, so a harness that normalises either still matches.
|
|
97
103
|
*/
|
|
98
104
|
export const fleetMessageDigest = (text) => plugins.crypto.createHash('sha256').update(text.replace(/\r\n?/gu, '\n').trim()).digest('hex');
|
|
99
|
-
//# sourceMappingURL=data:application/json;base64,
|
|
105
|
+
//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW50ZXJmYWNlcy53b3JrZXJzLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vdHMvZmxlZXQvaW50ZXJmYWNlcy53b3JrZXJzLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLE9BQU8sS0FBSyxPQUFPLE1BQU0sZUFBZSxDQUFDO0FBSXpDLE1BQU0sT0FBTyxrQkFBbUIsU0FBUSxLQUFLO0lBQ0UsVUFBVTtJQUF2RCxZQUFZLE9BQWUsRUFBa0IsVUFBbUIsRUFBRSxPQUFzQjtRQUFJLEtBQUssQ0FBQyxPQUFPLEVBQUUsT0FBTyxDQUFDLENBQUM7MEJBQXZFLFVBQVU7UUFBOEQsSUFBSSxDQUFDLElBQUksR0FBRyxvQkFBb0IsQ0FBQztJQUFDLENBQUM7Q0FDeko7QUFDRDs7OztHQUlHO0FBQ0gsTUFBTSxPQUFPLG9CQUFxQixTQUFRLEtBQUs7SUFDakIsSUFBSTtJQUFoQyxZQUE0QixJQUFpRSxFQUFFLE9BQWU7UUFBSSxLQUFLLENBQUMsT0FBTyxDQUFDLENBQUM7b0JBQXJHLElBQUk7UUFBa0csSUFBSSxDQUFDLElBQUksR0FBRyxzQkFBc0IsQ0FBQztJQUFDLENBQUM7Q0FDeEs7QUF1QkQ7Ozs7R0FJRztBQUNILE1BQU0sQ0FBQyxNQUFNLHFCQUFxQixHQUFHLENBQUMsUUFBcUQsRUFBcUMsRUFBRSxDQUFDLENBQ2pJLFFBQVEsQ0FBQyxNQUFNLEtBQUssU0FBUyxJQUFJLFFBQVEsQ0FBQyxLQUFLLEtBQUssUUFBUSxDQUFDLENBQUMsQ0FBQyxFQUFFLE1BQU0sRUFBRSxlQUFlLEVBQUUsQ0FBQyxDQUFDLENBQUMsU0FBUyxDQUN2RyxDQUFDO0FBa0ZGOzs7OztHQUtHO0FBQ0gsTUFBTSxDQUFDLE1BQU0saUJBQWlCLEdBQUcsdUxBQXVMLENBQUM7QUFDek4sd0hBQXdIO0FBQ3hILE1BQU0sZ0JBQWdCLEdBQUcsRUFBRSxHQUFHLElBQUksRUFBRSxtQkFBbUIsR0FBRyxDQUFDLEdBQUcsSUFBSSxFQUFFLG9CQUFvQixH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
|
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import type { IControllerSystemMetrics } from './interfaces.js';
|
|
1
|
+
import type { IControllerSystemMetrics, TControllerModelLimitKind } from './interfaces.js';
|
|
2
2
|
import type { ITicketActor } from './tickets.js';
|
|
3
3
|
import type { IFleetTicketSync } from './fleet.js';
|
|
4
4
|
export type TFleetWorkerHarness = 'claude' | 'codex';
|
|
@@ -142,11 +142,27 @@ export interface IFleetWorker {
|
|
|
142
142
|
/** `error` is a session binding that stayed on this worker; the next repair that leaves none on it clears the error. */
|
|
143
143
|
errorSource?: 'binding';
|
|
144
144
|
}
|
|
145
|
+
/**
|
|
146
|
+
* How the worker's newest native turn ended, as its harness recorded it: a Codex turn's status, with the limit kind of
|
|
147
|
+
* a failure Codex named as a provider limit; a Claude Code job its inventory lists as failed or done. `turnId` names
|
|
148
|
+
* the turn: a Codex turn id, or a Claude Code prompt's transcript uuid (the session id while AGL sees no prompt). A
|
|
149
|
+
* Codex failure stays until a turn with another id is observed. A Claude Code inventory lists the job's state, not a
|
|
150
|
+
* turn's: listing the job `working`, `blocked` or `done` replaces a failure, which stays only while the inventory lists
|
|
151
|
+
* the job with no state, `stopped`, or not at all.
|
|
152
|
+
*/
|
|
153
|
+
export interface IFleetWorkerTurnOutcome {
|
|
154
|
+
turnId: string;
|
|
155
|
+
state: 'completed' | 'interrupted' | 'failed';
|
|
156
|
+
limit?: TControllerModelLimitKind;
|
|
157
|
+
}
|
|
145
158
|
export interface IFleetWorkerReport {
|
|
146
159
|
worker: IFleetWorker;
|
|
160
|
+
/** The native status, whatever `outcome` says: refresh's settled check, adopt, the board pump and direct reports read this. */
|
|
147
161
|
status: 'busy' | 'idle' | 'blocked' | 'stopped' | 'archived' | 'reaped' | 'gone';
|
|
148
162
|
turnId?: string;
|
|
149
163
|
turnStatus?: string;
|
|
164
|
+
/** Absent while the newest turn runs, and when the harness states no outcome. */
|
|
165
|
+
outcome?: IFleetWorkerTurnOutcome;
|
|
150
166
|
reportId?: string;
|
|
151
167
|
text: string;
|
|
152
168
|
truncated: boolean;
|
|
@@ -899,6 +899,21 @@ export interface IControllerPromptQueueHold {
|
|
|
899
899
|
/** Unix milliseconds when the queue resumes on its own; absent while it waits for the user. */
|
|
900
900
|
resumeAt?: number;
|
|
901
901
|
}
|
|
902
|
+
/**
|
|
903
|
+
* Why a harness says its session waits for a person in the harness's own client: `approval` and `user_input`, Codex's
|
|
904
|
+
* thread flags `waitingOnApproval` and `waitingOnUserInput`; `native_prompt`, Claude Code's `requires_action`, or a
|
|
905
|
+
* Claude Code job whose process its inventory lists as waiting without the job having failed; `unrecognized`, a wait
|
|
906
|
+
* signal AGL does not know.
|
|
907
|
+
*/
|
|
908
|
+
export type TControllerNativeWaitReason = 'approval' | 'user_input' | 'native_prompt' | 'unrecognized';
|
|
909
|
+
export declare const controllerNativeWaitReasons: readonly TControllerNativeWaitReason[];
|
|
910
|
+
/**
|
|
911
|
+
* A wait the harness signals, projected only: it carries no request id, so nothing in AGL can answer it. Whether AGL
|
|
912
|
+
* holds a request it can answer is `attention`.
|
|
913
|
+
*/
|
|
914
|
+
export interface IControllerNativeWait {
|
|
915
|
+
reason: TControllerNativeWaitReason;
|
|
916
|
+
}
|
|
902
917
|
export interface IControllerSession {
|
|
903
918
|
id: IControllerRuntimeId;
|
|
904
919
|
title: string;
|
|
@@ -912,6 +927,11 @@ export interface IControllerSession {
|
|
|
912
927
|
codexActivity?: import('./codex.js').IControllerCodexActivitySummary;
|
|
913
928
|
/** True while OpenCode has a pending permission or question for this session. */
|
|
914
929
|
attention?: boolean;
|
|
930
|
+
/**
|
|
931
|
+
* Set while the harness signals that the session waits for a person in its own client (Codex, Claude Code), which
|
|
932
|
+
* it does only while the session is busy. Absent is no proof that nothing waits: a harness does not signal every wait.
|
|
933
|
+
*/
|
|
934
|
+
nativeWait?: IControllerNativeWait;
|
|
915
935
|
/** Why the last run failed, while the session reports that failure (Flex). */
|
|
916
936
|
error?: IControllerSessionError;
|
|
917
937
|
/** Set while the running prompt waits to call the model again (Flex). */
|
|
@@ -146,6 +146,7 @@ export const controllerProjectRemovalBlockedCodes = [
|
|
|
146
146
|
];
|
|
147
147
|
/** Upper bound of the persisted operator-readable block explanation. */
|
|
148
148
|
export const controllerProjectRemovalBlockedReasonMaxLength = 256;
|
|
149
|
+
export const controllerNativeWaitReasons = ['approval', 'user_input', 'native_prompt', 'unrecognized'];
|
|
149
150
|
/** Upper bound of the text an agent message carries, before the controller's header. */
|
|
150
151
|
export const controllerAgentMessageMaxTextBytes = 16 * 1024;
|
|
151
152
|
/** Upper bound, in characters, of the sender label an agent message declares. */
|
|
@@ -213,4 +214,4 @@ export const controllerEventTypes = [
|
|
|
213
214
|
/** What a deploy target runs, whether its probe answers, or which tickets run nowhere changed. */
|
|
214
215
|
'deployments.changed',
|
|
215
216
|
];
|
|
216
|
-
//# sourceMappingURL=data:application/json;base64,
|
|
217
|
+
//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW50ZXJmYWNlcy5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3RzX2ludGVyZmFjZXMvaW50ZXJmYWNlcy50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFPQSxNQUFNLENBQUMsTUFBTSx5QkFBeUIsR0FBRyxFQUFXLENBQUM7QUFDckQsTUFBTSxDQUFDLE1BQU0sa0NBQWtDLEdBQUcsQ0FBVSxDQUFDO0FBQzdELE1BQU0sQ0FBQyxNQUFNLHFCQUFxQixHQUFHLEtBQWMsQ0FBQztBQUNwRCx5R0FBeUc7QUFDekcsTUFBTSxDQUFDLE1BQU0seUJBQXlCLEdBQUcsd0JBQWlDLENBQUM7QUFDM0UsTUFBTSxDQUFDLE1BQU0sMkJBQTJCLEdBQUcsRUFBRSxHQUFHLElBQUksQ0FBQztBQUNyRCxNQUFNLENBQUMsTUFBTSxrQ0FBa0MsR0FBRyxHQUFHLEdBQUcsSUFBSSxDQUFDO0FBQzdELE1BQU0sQ0FBQyxNQUFNLHFDQUFxQyxHQUFHLEVBQUUsR0FBRyxJQUFJLENBQUM7QUFDL0QsTUFBTSxDQUFDLE1BQU0sbUNBQW1DLEdBQUcsRUFBRSxDQUFDO0FBQ3RELE1BQU0sQ0FBQyxNQUFNLCtCQUErQixHQUFHLEdBQUcsQ0FBQztBQUNuRCxNQUFNLENBQUMsTUFBTSxnQ0FBZ0MsR0FBRyxHQUFHLEdBQUcsSUFBSSxDQUFDO0FBQzNEOzs7O0dBSUc7QUFDSCxNQUFNLENBQUMsTUFBTSwrQkFBK0IsR0FDMUMsOERBQXVFLENBQUM7QUFDMUUsTUFBTSxDQUFDLE1BQU0sMkJBQTJCLEdBQUcsRUFBRSxHQUFHLElBQUksQ0FBQztBQUNyRCxNQUFNLENBQUMsTUFBTSw2QkFBNkIsR0FBRyxDQUFDLENBQUM7QUFDL0MsTUFBTSxDQUFDLE1BQU0saUNBQWlDLEdBQUcsRUFBRSxHQUFHLElBQUksR0FBRyxJQUFJLENBQUM7QUFDbEUsTUFBTSxDQUFDLE1BQU0sc0NBQXNDLEdBQUcsRUFBRSxHQUFHLElBQUksR0FBRyxJQUFJLENBQUM7QUFDdkUsTUFBTSxD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
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
import type * as plugins from './plugins.js';
|
|
2
|
-
import type { IFleetWorker, IFleetWorkerJob, IFleetWorkerReport, TFleetWorkerAction, TFleetWorkerRequest, TFleetWorkerResponse } from './fleetworkers.js';
|
|
3
|
-
import type { IControllerDraftAttachment, IControllerMessageBundle } from './interfaces.js';
|
|
2
|
+
import type { IFleetWorker, IFleetWorkerJob, IFleetWorkerReport, IFleetWorkerTurnOutcome, TFleetWorkerAction, TFleetWorkerRequest, TFleetWorkerResponse } from './fleetworkers.js';
|
|
3
|
+
import type { IControllerDraftAttachment, IControllerMessageBundle, IControllerNativeWait } from './interfaces.js';
|
|
4
4
|
export declare const controllerMcpFleetWorkerMethods: Array<`agl.mcp.fleet.worker.${TFleetWorkerAction}`>;
|
|
5
5
|
export type TControllerMcpFleetWorkerRequest<T extends TFleetWorkerAction> = {
|
|
6
6
|
method: `agl.mcp.fleet.worker.${T}`;
|
|
@@ -17,6 +17,15 @@ export interface IControllerFleetWorkerView {
|
|
|
17
17
|
worker: IFleetWorker;
|
|
18
18
|
/** Absent until the controller observed the worker. */
|
|
19
19
|
status?: IFleetWorkerReport['status'];
|
|
20
|
+
/** How the newest turn the controller observed ended; see `IFleetWorkerReport.outcome`. */
|
|
21
|
+
outcome?: IFleetWorkerTurnOutcome;
|
|
22
|
+
/** When the newest turn the controller observed started (ISO 8601), where the harness states it. */
|
|
23
|
+
turnStartedAt?: string;
|
|
24
|
+
/**
|
|
25
|
+
* The wait for a person in the harness's own client that the controller last observed: a Claude Code job whose
|
|
26
|
+
* process its inventory lists as waiting without the job having failed. Absent is no proof that nothing waits.
|
|
27
|
+
*/
|
|
28
|
+
nativeWait?: IControllerNativeWait;
|
|
20
29
|
/** The tail of the newest assistant text the controller last observed, for harnesses whose poll records it. */
|
|
21
30
|
excerpt?: string;
|
|
22
31
|
}
|
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
import type * as plugins from './plugins.js';
|
|
2
|
-
import type { IControllerRuntimeId } from './interfaces.js';
|
|
2
|
+
import type { IControllerNativeWait, IControllerRuntimeId } from './interfaces.js';
|
|
3
3
|
/**
|
|
4
4
|
* The session feed: one read model of every session of every harness AGL knows — the conversations it tracks, the
|
|
5
5
|
* Flex and OpenCode conversations of its projects, the fleet's workers, the Claude Code sessions of the host's own and
|
|
@@ -7,7 +7,10 @@ import type { IControllerRuntimeId } from './interfaces.js';
|
|
|
7
7
|
* automatic session list. Its row mirrors dees-catalog's `IHarnessSessionRow` without importing it, plus where a row opens.
|
|
8
8
|
*/
|
|
9
9
|
export type TControllerSessionFeedHarness = 'claude' | 'codex' | 'flex' | 'opencode';
|
|
10
|
-
/**
|
|
10
|
+
/**
|
|
11
|
+
* `needs_input`: a question or permission AGL holds, or a wait the harness signals in its own client, waits for the
|
|
12
|
+
* owner; `failed`: the session reports an error, its newest turn failed or it is gone.
|
|
13
|
+
*/
|
|
11
14
|
export type TControllerSessionFeedState = 'needs_input' | 'working' | 'completed' | 'failed';
|
|
12
15
|
export declare const controllerSessionFeedStates: readonly TControllerSessionFeedState[];
|
|
13
16
|
export interface IControllerSessionFeedTicket {
|
|
@@ -46,6 +49,13 @@ export interface IControllerSessionFeedRow {
|
|
|
46
49
|
/** Unix milliseconds of the session's last activity. */
|
|
47
50
|
updatedAt: number;
|
|
48
51
|
open: TControllerSessionFeedOpen;
|
|
52
|
+
/**
|
|
53
|
+
* On a `needs_input` row AGL holds no question or permission for: the harness waits in its own client, which AGL
|
|
54
|
+
* cannot answer, for `reason`. A `needs_input` row without it holds a request the owner answers in AGL.
|
|
55
|
+
*/
|
|
56
|
+
nativeWait?: IControllerNativeWait;
|
|
57
|
+
/** On a `completed` row: its newest turn was interrupted. */
|
|
58
|
+
interrupted?: true;
|
|
49
59
|
}
|
|
50
60
|
/**
|
|
51
61
|
* The feed keeps every session that needs input or works; it keeps the newest failed and completed ones up to these
|
|
@@ -27,4 +27,4 @@ export const isControllerSessionFeedRowId = (valueArg) => {
|
|
|
27
27
|
* session, worker or agent lists or acknowledges through them, so a worker never hides its own failure.
|
|
28
28
|
*/
|
|
29
29
|
export const controllerMcpSessionFeedMethods = ['agl.mcp.sessionfeed.list', 'agl.mcp.sessionfeed.acknowledge'];
|
|
30
|
-
//# sourceMappingURL=data:application/json;base64,
|
|
30
|
+
//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoic2Vzc2lvbmZlZWQuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi90c19pbnRlcmZhY2VzL3Nlc3Npb25mZWVkLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQWVBLE1BQU0sQ0FBQyxNQUFNLDJCQUEyQixHQUEyQyxDQUFDLGFBQWEsRUFBRSxTQUFTLEVBQUUsV0FBVyxFQUFFLFFBQVEsQ0FBQyxDQUFDO0FBeUNySTs7O0dBR0c7QUFDSCxNQUFNLENBQUMsTUFBTSwyQkFBMkIsR0FBRyxFQUFFLFNBQVMsRUFBRSxHQUFHLEVBQUUsTUFBTSxFQUFFLEdBQUcsRUFBRSxZQUFZLEVBQUUsR0FBRyxFQUFFLE9BQU8sRUFBRSxDQUFDLEVBQUUsU0FBUyxFQUFFLEdBQUcsRUFBVyxDQUFDO0FBRW5JLDZIQUE2SDtBQUM3SCxNQUFNLENBQUMsTUFBTSw0QkFBNEIsR0FBRyxDQUFDLE9BQTJCLEVBQXNCLEVBQUU7SUFDOUYsTUFBTSxJQUFJLEdBQUcsT0FBTyxFQUFFLE9BQU8sQ0FBQyxPQUFPLEVBQUUsR0FBRyxDQUFDLENBQUMsSUFBSSxFQUFFLENBQUM7SUFDbkQsSUFBSSxDQUFDLElBQUk7UUFBRSxPQUFPLFNBQVMsQ0FBQztJQUM1QixNQUFNLEtBQUssR0FBRywyQkFBMkIsQ0FBQyxZQUFZLENBQUM7SUFDdkQsT0FBTyxJQUFJLENBQUMsTUFBTSxJQUFJLEtBQUssQ0FBQyxDQUFDLENBQUMsSUFBSSxDQUFDLENBQUMsQ0FBQyxJQUFJLElBQUksQ0FBQyxLQUFLLENBQUMsQ0FBQyxDQUFDLEtBQUssR0FBRyxDQUFDLENBQUMsQ0FBQyxDQUFDLFNBQVMsRUFBRSxFQUFFLENBQUM7QUFDbEYsQ0FBQyxDQUFDO0FBcUJGLE1BQU0sQ0FBQyxNQUFNLDhCQUE4QixHQUE2QyxDQUFDLFFBQVEsRUFBRSxPQUFPLEVBQUUsTUFBTSxFQUFFLFVBQVUsQ0FBQyxDQUFDO0FBRWhJLDhIQUE4SDtBQUM5SCxNQUFNLENBQUMsTUFBTSw0QkFBNEIsR0FBRyxDQUFDLFFBQWlCLEVBQXNCLEVBQUU7SUFDcEYsSUFBSSxPQUFPLFFBQVEsS0FBSyxRQUFRLElBQUksSUFBSSxXQUFXLEVBQUUsQ0FBQyxNQUFNLENBQUMsUUFBUSxDQUFDLENBQUMsVUFBVSxHQUFHLEdBQUc7UUFBRSxPQUFPLEtBQUssQ0FBQztJQUN0RyxNQUFNLFNBQVMsR0FBRyxRQUFRLENBQUMsT0FBTyxDQUFDLEdBQUcsQ0FBQyxDQUFDO0lBQ3hDLE9BQU8sU0FBUyxHQUFHLENBQUM7V0FDZCw4QkFBb0QsQ0FBQyxRQUFRLENBQUMsUUFBUSxDQUFDLEtBQUssQ0FBQyxDQUFDLEVBQUUsU0FBUyxDQUFDLENBQUM7V0FDNUYsaUJBQWlCLENBQUMsSUFBSSxDQUFDLFFBQVEsQ0FBQyxLQUFLLENBQUMsU0FBUyxHQUFHLENBQUMsQ0FBQyxDQUFDLENBQUM7QUFDN0QsQ0FBQyxDQUFDO0FBaUJGOzs7R0FHRztBQUNILE1BQU0sQ0FBQyxNQUFNLCtCQUErQixHQUFHLENBQUMsMEJBQTBCLEVBQUUsaUNBQWlDLENBQVUsQ0FBQyJ9
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "agl",
|
|
3
|
-
"version": "43.0.
|
|
3
|
+
"version": "43.0.3",
|
|
4
4
|
"controllerUpgradeManagementVersion": 2,
|
|
5
5
|
"controllerManagementProtocolVersion": 1,
|
|
6
6
|
"controllerGatewaySourcesVersion": 1,
|
|
@@ -93,7 +93,7 @@
|
|
|
93
93
|
"devDependencies": {
|
|
94
94
|
"@api.global/typedopenapi": "^0.10.2",
|
|
95
95
|
"@git.zone/tsrepo": "^1.1.1",
|
|
96
|
-
"@types/node": "26.6.
|
|
96
|
+
"@types/node": "26.6.6",
|
|
97
97
|
"@types/proper-lockfile": "^4.1.4",
|
|
98
98
|
"@types/ws": "8.18.1",
|
|
99
99
|
"ai": "7.0.112",
|
package/readme.md
CHANGED
|
@@ -2670,7 +2670,7 @@ A removal that fails is resumed with backoff, and it resumes across restarts and
|
|
|
2670
2670
|
|
|
2671
2671
|
### Conversations
|
|
2672
2672
|
|
|
2673
|
-
The sidebar is the session list (`controller.sessionfeed.list`, then `sessionfeed` deltas). It holds the sessions of every harness across every registered project: the conversations AGL tracks, the Flex and OpenCode sessions of a project folder that AGL does not track yet, the threads on the shared Codex app-server, Claude terminals, and the Claude Code sessions of the host's home and of the fleet profiles' own homes. A conversation that is tracked, run by a fleet worker and present on the Codex server is one row. Each row shows its harness, its state (working, needing input, completed or failed), its name, the last reply's opening for tracked conversations and workers, the tickets it is linked to, and when it last changed; a newly created session joins at the feed's next pass. Selecting a row opens it: a tracked conversation opens, an untracked one is tracked first, a Claude terminal opens in the Terminals view, a session a fleet worker runs opens that worker, and any other Claude Code session or Codex thread opens where it runs, whatever its directory (see [Sessions outside every project](#sessions-outside-every-project)). Opening a session never registers a project: the project matters only when a new session is started. A row AGL cannot open says why in the sidebar, for example that its project is no longer registered. A ticket chip opens that ticket on the board. Right-click, the ContextMenu key or Shift+F10 opens the row's menu: a conversation's own menu, **Rename** and **Terminate** for a terminal, or **Copy session id**, **Copy directory** and **Make direct report…** (see [Driver session](#driver-session)) for a native session. Conversations archived in AGL leave the list.
|
|
2673
|
+
The sidebar is the session list (`controller.sessionfeed.list`, then `sessionfeed` deltas). It holds the sessions of every harness across every registered project: the conversations AGL tracks, the Flex and OpenCode sessions of a project folder that AGL does not track yet, the threads on the shared Codex app-server, Claude terminals, and the Claude Code sessions of the host's home and of the fleet profiles' own homes. A conversation that is tracked, run by a fleet worker and present on the Codex server is one row. A row needs input when AGL holds a question or permission for it, or when the harness signals that it waits in its own client, which AGL cannot answer: a Codex thread waiting on an approval, on user input or on a flag AGL does not know, a Claude Code `requires_action` without a card, or a Claude Code job whose process its inventory lists as waiting without the job having failed (a job listed blocked whose turn ended, status idle, is completed); such a row carries `nativeWait` with its reason (`agl feed list --json`). A fleet worker whose newest turn failed (a failed Codex turn, with its limit kind, or a failed Claude Code job) is failed until a newer turn starts, which moves the row, or until Claude Code lists the job working, blocked or done again; an interrupted turn's row is completed with `interrupted`. Each row shows its harness, its state (working, needing input, completed or failed), its name, the last reply's opening for tracked conversations and workers, the tickets it is linked to, and when it last changed; a newly created session joins at the feed's next pass. Selecting a row opens it: a tracked conversation opens, an untracked one is tracked first, a Claude terminal opens in the Terminals view, a session a fleet worker runs opens that worker, and any other Claude Code session or Codex thread opens where it runs, whatever its directory (see [Sessions outside every project](#sessions-outside-every-project)). Opening a session never registers a project: the project matters only when a new session is started. A row AGL cannot open says why in the sidebar, for example that its project is no longer registered. A ticket chip opens that ticket on the board. Right-click, the ContextMenu key or Shift+F10 opens the row's menu: a conversation's own menu, **Rename** and **Terminate** for a terminal, or **Copy session id**, **Copy directory** and **Make direct report…** (see [Driver session](#driver-session)) for a native session. Conversations archived in AGL leave the list.
|
|
2674
2674
|
|
|
2675
2675
|
A failed row of any kind leads its menu with **Acknowledge and remove** (`controller.sessionfeed.acknowledge`). The controller records, for the owner, that row's failure as of the time the row shows, and the row leaves the Failed group until the session moves again: new activity or a new failure brings it back. Nothing else changes: the session and its transcript, a fleet worker's dispatch fence and error, its tickets and the unknown-dispatch record stay as they are, and nothing is sent, resumed or stopped. The acknowledgements are kept in the controller's database and survive a restart; a row that changed since it was listed, is no longer failed or is gone is refused. From the command line the owner does the same with `agl feed` (see [CLI](#cli)); no agent, worker or MCP tool can acknowledge, so a worker never hides its own failure. The composer's open-sessions action shows the sidebar and moves focus into the list. The list header offers three actions.
|
|
2676
2676
|
|
package/ts/00_commitinfo_data.ts
CHANGED
|
@@ -2915,6 +2915,23 @@ export const AGL_API_SURFACE: plugins.flexTypedRequest.IFlexTypedRequestSurface
|
|
|
2915
2915
|
},
|
|
2916
2916
|
"declaration": "/**\n * A usage or rate limit a model provider reported. `usage_limit` means the account's quota is\n * spent until it resets; `rate_limit` is a throttle. `usage_reserve` is AGL's own: the account\n * reached its usage threshold (`maxUsagePercent`), so the rest of its quota is kept for use\n * outside AGL until the window resets. Times are Unix milliseconds.\n */\ninterface IControllerModelLimit {\n kind: TControllerModelLimitKind;\n /** The provider that reported the limit, for example `openai`. */\n provider: string;\n resetsAt?: number;\n /** The delay the provider asked for before the next request, in milliseconds. */\n retryAfterMs?: number;\n planType?: string;\n /** The exhausted limit window, for example `5h` or `7d`. */\n window?: string;\n}"
|
|
2917
2917
|
},
|
|
2918
|
+
{
|
|
2919
|
+
"name": "IControllerNativeWait",
|
|
2920
|
+
"schema": {
|
|
2921
|
+
"type": "object",
|
|
2922
|
+
"properties": {
|
|
2923
|
+
"reason": {
|
|
2924
|
+
"$ref": "#/$defs/TControllerNativeWaitReason"
|
|
2925
|
+
}
|
|
2926
|
+
},
|
|
2927
|
+
"required": [
|
|
2928
|
+
"reason"
|
|
2929
|
+
],
|
|
2930
|
+
"additionalProperties": false,
|
|
2931
|
+
"description": "A wait the harness signals, projected only: it carries no request id, so nothing in AGL can answer it. Whether AGL holds a request it can answer is `attention`."
|
|
2932
|
+
},
|
|
2933
|
+
"declaration": "/**\n * A wait the harness signals, projected only: it carries no request id, so nothing in AGL can answer it. Whether AGL\n * holds a request it can answer is `attention`.\n */\ninterface IControllerNativeWait {\n reason: TControllerNativeWaitReason;\n}"
|
|
2934
|
+
},
|
|
2918
2935
|
{
|
|
2919
2936
|
"name": "IControllerOpenCodeModelChoice",
|
|
2920
2937
|
"schema": {
|
|
@@ -3586,6 +3603,10 @@ export const AGL_API_SURFACE: plugins.flexTypedRequest.IFlexTypedRequestSurface
|
|
|
3586
3603
|
"type": "boolean",
|
|
3587
3604
|
"description": "True while OpenCode has a pending permission or question for this session."
|
|
3588
3605
|
},
|
|
3606
|
+
"nativeWait": {
|
|
3607
|
+
"$ref": "#/$defs/IControllerNativeWait",
|
|
3608
|
+
"description": "Set while the harness signals that the session waits for a person in its own client (Codex, Claude Code), which it does only while the session is busy. Absent is no proof that nothing waits: a harness does not signal every wait."
|
|
3609
|
+
},
|
|
3589
3610
|
"error": {
|
|
3590
3611
|
"$ref": "#/$defs/IControllerSessionError",
|
|
3591
3612
|
"description": "Why the last run failed, while the session reports that failure (Flex)."
|
|
@@ -3612,7 +3633,7 @@ export const AGL_API_SURFACE: plugins.flexTypedRequest.IFlexTypedRequestSurface
|
|
|
3612
3633
|
],
|
|
3613
3634
|
"additionalProperties": false
|
|
3614
3635
|
},
|
|
3615
|
-
"declaration": "interface IControllerSession {\n id: IControllerRuntimeId;\n title: string;\n parentId?: IControllerRuntimeId;\n createdAt: number;\n updatedAt: number;\n /** Unix milliseconds when the session was archived in OpenCode; absent for active sessions. */\n archivedAt?: number;\n status: TControllerSessionStatus;\n /** Bounded native writer state for Codex sidebar rows. */\n codexActivity?: IControllerCodexActivitySummary;\n /** True while OpenCode has a pending permission or question for this session. */\n attention?: boolean;\n /** Why the last run failed, while the session reports that failure (Flex). */\n error?: IControllerSessionError;\n /** Set while the running prompt waits to call the model again (Flex). */\n retrying?: IControllerSessionRetrying;\n /** Set while a provider limit holds the session's queued prompts (Flex). */\n promptQueueHold?: IControllerPromptQueueHold;\n /** Present only on the controller-owned driver session, which no session list shows. */\n role?: TControllerSessionRole;\n}"
|
|
3636
|
+
"declaration": "interface IControllerSession {\n id: IControllerRuntimeId;\n title: string;\n parentId?: IControllerRuntimeId;\n createdAt: number;\n updatedAt: number;\n /** Unix milliseconds when the session was archived in OpenCode; absent for active sessions. */\n archivedAt?: number;\n status: TControllerSessionStatus;\n /** Bounded native writer state for Codex sidebar rows. */\n codexActivity?: IControllerCodexActivitySummary;\n /** True while OpenCode has a pending permission or question for this session. */\n attention?: boolean;\n /**\n * Set while the harness signals that the session waits for a person in its own client (Codex, Claude Code), which\n * it does only while the session is busy. Absent is no proof that nothing waits: a harness does not signal every wait.\n */\n nativeWait?: IControllerNativeWait;\n /** Why the last run failed, while the session reports that failure (Flex). */\n error?: IControllerSessionError;\n /** Set while the running prompt waits to call the model again (Flex). */\n retrying?: IControllerSessionRetrying;\n /** Set while a provider limit holds the session's queued prompts (Flex). */\n promptQueueHold?: IControllerPromptQueueHold;\n /** Present only on the controller-owned driver session, which no session list shows. */\n role?: TControllerSessionRole;\n}"
|
|
3616
3637
|
},
|
|
3617
3638
|
{
|
|
3618
3639
|
"name": "IControllerSessionDetail",
|
|
@@ -5680,6 +5701,20 @@ export const AGL_API_SURFACE: plugins.flexTypedRequest.IFlexTypedRequestSurface
|
|
|
5680
5701
|
},
|
|
5681
5702
|
"declaration": "type TControllerModelRetryReason = 'rate_limit' | 'overloaded' | 'unavailable';"
|
|
5682
5703
|
},
|
|
5704
|
+
{
|
|
5705
|
+
"name": "TControllerNativeWaitReason",
|
|
5706
|
+
"schema": {
|
|
5707
|
+
"type": "string",
|
|
5708
|
+
"enum": [
|
|
5709
|
+
"approval",
|
|
5710
|
+
"user_input",
|
|
5711
|
+
"native_prompt",
|
|
5712
|
+
"unrecognized"
|
|
5713
|
+
],
|
|
5714
|
+
"description": "Why a harness says its session waits for a person in the harness's own client: `approval` and `user_input`, Codex's thread flags `waitingOnApproval` and `waitingOnUserInput`; `native_prompt`, Claude Code's `requires_action`, or a Claude Code job whose process its inventory lists as waiting without the job having failed; `unrecognized`, a wait signal AGL does not know."
|
|
5715
|
+
},
|
|
5716
|
+
"declaration": "/**\n * Why a harness says its session waits for a person in the harness's own client: `approval` and `user_input`, Codex's\n * thread flags `waitingOnApproval` and `waitingOnUserInput`; `native_prompt`, Claude Code's `requires_action`, or a\n * Claude Code job whose process its inventory lists as waiting without the job having failed; `unrecognized`, a wait\n * signal AGL does not know.\n */\ntype TControllerNativeWaitReason = 'approval' | 'user_input' | 'native_prompt' | 'unrecognized';"
|
|
5717
|
+
},
|
|
5683
5718
|
{
|
|
5684
5719
|
"name": "TControllerPendingPromptState",
|
|
5685
5720
|
"schema": {
|
|
@@ -208,6 +208,11 @@ interface IClaudeSessionState {
|
|
|
208
208
|
turn?: IClaudeCommand;
|
|
209
209
|
/** Claude Code runs a turn, AGL's or one it started itself (a background task's notification). */
|
|
210
210
|
cliRunning: boolean;
|
|
211
|
+
/**
|
|
212
|
+
* Claude Code's last session state was `requires_action`: it holds a prompt for a person, which reaches AGL only
|
|
213
|
+
* through `canUseTool`. `running`, `idle` and the end of its process clear it.
|
|
214
|
+
*/
|
|
215
|
+
requiresAction?: true;
|
|
211
216
|
/** The uuids the running turn has taken in so far. */
|
|
212
217
|
consumed: Set<string>;
|
|
213
218
|
currentApiId?: string;
|
|
@@ -291,7 +296,9 @@ export class ClaudeHarness {
|
|
|
291
296
|
...(document.archivedAt === undefined ? {} : { archivedAt: document.archivedAt.getTime() }),
|
|
292
297
|
// A turn that failed leaves the conversation in error until the next one starts, as a failed Codex turn does.
|
|
293
298
|
status: busy ? (state.retrying ? 'retry' : 'busy') : state.error ? 'error' : 'idle',
|
|
294
|
-
...(this.requests(nativeIdArg).length > 0 ? { attention: true }
|
|
299
|
+
...(this.requests(nativeIdArg).length > 0 ? { attention: true }
|
|
300
|
+
// A prompt Claude Code holds without handing it to AGL, such as one inherited from an earlier process of the session.
|
|
301
|
+
: state.requiresAction ? { nativeWait: { reason: 'native_prompt' as const } } : {}),
|
|
295
302
|
...(state.error ? { error: structuredClone(state.error) } : {}),
|
|
296
303
|
...(busy && state.retrying ? { retrying: { ...state.retrying } } : {}),
|
|
297
304
|
};
|
|
@@ -829,6 +836,7 @@ export class ClaudeHarness {
|
|
|
829
836
|
state.error = { message: claudeErrorText(`Claude Code stopped${runtimeArg.closing ? '' : ' unexpectedly'}${cause ? `: ${cause}` : '.'}`) };
|
|
830
837
|
}
|
|
831
838
|
state.cliRunning = false;
|
|
839
|
+
delete state.requiresAction;
|
|
832
840
|
state.consumed.clear();
|
|
833
841
|
state.retrying = undefined;
|
|
834
842
|
for (const command of [...state.commands.values()]) {
|
|
@@ -876,8 +884,16 @@ export class ClaudeHarness {
|
|
|
876
884
|
this.changed(state, 'session.changed');
|
|
877
885
|
}
|
|
878
886
|
} else if (message.subtype === 'session_state_changed') {
|
|
879
|
-
|
|
880
|
-
|
|
887
|
+
const sessionState = message.state;
|
|
888
|
+
if (sessionState !== 'running' && sessionState !== 'requires_action' && sessionState !== 'idle') return;
|
|
889
|
+
const busy = this.busy(state), waited = state.requiresAction === true;
|
|
890
|
+
this.transition(state, () => {
|
|
891
|
+
state.cliRunning = sessionState !== 'idle';
|
|
892
|
+
if (sessionState === 'requires_action') state.requiresAction = true;
|
|
893
|
+
else delete state.requiresAction;
|
|
894
|
+
});
|
|
895
|
+
// A wait that comes or goes while the turn runs on changes the session too, though not its status.
|
|
896
|
+
if (waited !== (sessionState === 'requires_action') && busy === this.busy(state)) this.changed(state, 'session.changed');
|
|
881
897
|
}
|
|
882
898
|
return;
|
|
883
899
|
}
|
|
@@ -1,8 +1,8 @@
|
|
|
1
1
|
import * as plugins from './plugins.js';
|
|
2
|
-
import type { IControllerUsage, IControllerCodexActivity, IControllerCodexActivitySummary, IControllerCodexCollaborationMode, IControllerCodexModelChoice, IControllerCodexModelOption, IControllerEvent, IControllerMessagePage, IControllerMessageBundle, IControllerPermission, IControllerQuestion, IControllerSession, IControllerSessionError, TControllerCodexCollaborationMode, TControllerCodexCollaborationModeAuthority, TControllerSessionStatus } from '../ts_interfaces/index.js';
|
|
2
|
+
import type { IControllerUsage, IControllerCodexActivity, IControllerCodexActivitySummary, IControllerCodexCollaborationMode, IControllerCodexModelChoice, IControllerCodexModelOption, IControllerEvent, IControllerMessagePage, IControllerMessageBundle, IControllerNativeWait, IControllerPermission, IControllerQuestion, IControllerSession, IControllerSessionError, TControllerCodexCollaborationMode, TControllerCodexCollaborationModeAuthority, TControllerSessionStatus } from '../ts_interfaces/index.js';
|
|
3
3
|
import { controllerMaxToolEventBytes } from '../ts_interfaces/index.js';
|
|
4
4
|
import { CodexSupervisor } from './classes.codexsupervisor.js';
|
|
5
|
-
import { codexArray, codexBoundedText, codexNonnegativeInteger, codexItemBundle, codexRecord, codexRuntimeId, codexSession, codexSessionId, codexString, codexText, codexThreadId, codexTurnError, codexTurnErrorBundle, codexTurnUsage, codexUsageTotal, isCodexTerminalItemStatus, type ICodexUsageTotal, type TCodexAnswerMeta, type TCodexTerminalTurnStatus } from './classes.codexprojection.js';
|
|
5
|
+
import { codexArray, codexBoundedText, codexNativeWait, codexNonnegativeInteger, codexItemBundle, codexRecord, codexRuntimeId, codexSession, codexSessionId, codexString, codexText, codexThreadId, codexTurnError, codexTurnErrorBundle, codexTurnUsage, codexUsageTotal, isCodexTerminalItemStatus, type ICodexUsageTotal, type TCodexAnswerMeta, type TCodexTerminalTurnStatus } from './classes.codexprojection.js';
|
|
6
6
|
import { codexPublicThreadId, codexQualifiedIdentity } from './functions.codexidentity.js';
|
|
7
7
|
import { maxCodexTurnPartialReplyBytes, maxCodexTurnRecordsPerSession, maxCodexTurnStopAnchors, type ICodexTurnRecord, type ICodexTurnRecordStore, type ICodexTurnStop } from './classes.codexturnstore.js';
|
|
8
8
|
|
|
@@ -495,12 +495,15 @@ export class CodexClientAdapter {
|
|
|
495
495
|
|
|
496
496
|
/**
|
|
497
497
|
* The one place a live status changes. The failure a status reported goes with it: only a failed
|
|
498
|
-
* turn states why, with the error Codex recorded on it.
|
|
498
|
+
* turn states why, with the error Codex recorded on it. So does a wait: only a thread status Codex
|
|
499
|
+
* sends with its active flags states one (`codexNativeWait`).
|
|
499
500
|
*/
|
|
500
|
-
private setSessionStatus(scopeArg: ICodexSessionScope, statusArg: TControllerSessionStatus, errorArg?: IControllerSessionError): void {
|
|
501
|
+
private setSessionStatus(scopeArg: ICodexSessionScope, statusArg: TControllerSessionStatus, errorArg?: IControllerSessionError, nativeWaitArg?: IControllerNativeWait): void {
|
|
501
502
|
scopeArg.session.status = statusArg;
|
|
502
503
|
if (errorArg) scopeArg.session.error = errorArg;
|
|
503
504
|
else delete scopeArg.session.error;
|
|
505
|
+
if (nativeWaitArg) scopeArg.session.nativeWait = nativeWaitArg;
|
|
506
|
+
else delete scopeArg.session.nativeWait;
|
|
504
507
|
}
|
|
505
508
|
|
|
506
509
|
private scope(threadIdArg: string): ICodexSessionScope {
|
|
@@ -1760,9 +1763,9 @@ export class CodexClientAdapter {
|
|
|
1760
1763
|
}
|
|
1761
1764
|
const scope = this.scope(threadId);
|
|
1762
1765
|
if (method === 'thread/status/changed') {
|
|
1763
|
-
const
|
|
1766
|
+
const threadStatus = codexRecord(params.status), status = codexString(threadStatus.type);
|
|
1764
1767
|
if (!['active', 'idle', 'notLoaded', 'systemError'].includes(status)) throw new Error('Invalid native thread status.');
|
|
1765
|
-
this.setSessionStatus(scope, status === 'active' ? 'busy' : status === 'systemError' ? 'error' : 'idle');
|
|
1768
|
+
this.setSessionStatus(scope, status === 'active' ? 'busy' : status === 'systemError' ? 'error' : 'idle', undefined, codexNativeWait(threadStatus));
|
|
1766
1769
|
scope.session.updatedAt = Date.now();
|
|
1767
1770
|
scope.revision += 1;
|
|
1768
1771
|
scope.statusRevision += 1;
|
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
import * as plugins from './plugins.js';
|
|
2
|
-
import type { IControllerMessage, IControllerMessageBundle, IControllerSession, IControllerSessionError, IControllerRuntimeId, IControllerUsage, TControllerModelLimitKind, TControllerToolStatus } from '../ts_interfaces/index.js';
|
|
2
|
+
import type { IControllerMessage, IControllerMessageBundle, IControllerNativeWait, IControllerSession, IControllerSessionError, IControllerRuntimeId, IControllerUsage, TControllerModelLimitKind, TControllerNativeWaitReason, TControllerToolStatus } from '../ts_interfaces/index.js';
|
|
3
3
|
import { isCodexThreadId, isCodexSessionId } from './functions.codexidentity.js';
|
|
4
4
|
|
|
5
5
|
export type TCodexTerminalTurnStatus = 'completed' | 'interrupted' | 'failed';
|
|
@@ -147,16 +147,37 @@ export const codexCommandTitle = (valueArg: unknown): string => {
|
|
|
147
147
|
return unique.length === 0 ? '' : codexText(unique.join(' · '), maxCodexTitleBytes).split('\n')[0]!;
|
|
148
148
|
};
|
|
149
149
|
|
|
150
|
+
/** Codex's `ThreadActiveFlag`s in the controller's words. */
|
|
151
|
+
const codexWaitReasons: ReadonlyMap<unknown, TControllerNativeWaitReason> = new Map([
|
|
152
|
+
['waitingOnApproval', 'approval'],
|
|
153
|
+
['waitingOnUserInput', 'user_input'],
|
|
154
|
+
]);
|
|
155
|
+
|
|
156
|
+
/**
|
|
157
|
+
* Why an active Codex thread waits for a person, from its `ThreadStatus`; the one reading of Codex's `activeFlags`. An
|
|
158
|
+
* active thread without flags works, and so does one whose status carries no flag list, as Codex's did before it had
|
|
159
|
+
* flags. Any other flag, or a list that is not one, is a wait AGL does not know (`unrecognized`): still a wait, never
|
|
160
|
+
* work or idleness. Of several flags the first AGL knows names the reason.
|
|
161
|
+
*/
|
|
162
|
+
export const codexNativeWait = (statusArg: Record<string, unknown>): IControllerNativeWait | undefined => {
|
|
163
|
+
const flags = statusArg.activeFlags;
|
|
164
|
+
if (statusArg.type !== 'active' || flags === undefined || Array.isArray(flags) && flags.length === 0) return undefined;
|
|
165
|
+
const known = Array.isArray(flags) ? flags.slice(0, 16).map((flag) => codexWaitReasons.get(flag)).find((reason) => reason !== undefined) : undefined;
|
|
166
|
+
return { reason: known ?? 'unrecognized' };
|
|
167
|
+
};
|
|
168
|
+
|
|
150
169
|
export const codexSession = (valueArg: unknown, directoryArg: string): IControllerSession => {
|
|
151
170
|
const thread = codexRecord(valueArg);
|
|
152
171
|
if (codexString(thread.cwd) !== directoryArg) throw new Error('Codex thread belongs to another project directory.');
|
|
153
|
-
const
|
|
172
|
+
const threadStatus = codexRecord(thread.status), status = codexString(threadStatus.type);
|
|
154
173
|
if (!['active', 'idle', 'notLoaded', 'systemError'].includes(status)) throw new Error('Unknown Codex thread status.');
|
|
174
|
+
const nativeWait = codexNativeWait(threadStatus);
|
|
155
175
|
return {
|
|
156
176
|
id: codexRuntimeId(codexSessionId(thread.id)),
|
|
157
177
|
title: codexText(thread.name || thread.preview, 8192) || 'New Codex conversation',
|
|
158
178
|
createdAt: codexTimestamp(thread.createdAt), updatedAt: codexTimestamp(thread.updatedAt),
|
|
159
179
|
status: status === 'active' ? 'busy' : status === 'systemError' ? 'error' : 'idle',
|
|
180
|
+
...(nativeWait ? { nativeWait } : {}),
|
|
160
181
|
...(typeof thread.parentThreadId === 'string' ? { parentId: codexRuntimeId(codexSessionId(thread.parentThreadId)) } : {}),
|
|
161
182
|
};
|
|
162
183
|
};
|