agl 42.0.0 → 42.2.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/changelog.md +44 -0
- package/dist_serve/bundle.js +2520 -2158
- package/dist_serve/bundle.js.map +2 -2
- package/dist_ts/00_commitinfo_data.js +1 -1
- package/dist_ts/aglapi/aglapisurface.document.js +124 -10
- package/dist_ts/classes.accountsactions.d.ts +3 -1
- package/dist_ts/classes.accountsactions.js +16 -1
- package/dist_ts/classes.authstore.d.ts +2 -0
- package/dist_ts/classes.authstore.js +58 -17
- package/dist_ts/classes.cli.js +19 -49
- package/dist_ts/classes.configurationauthority.js +2 -2
- package/dist_ts/classes.controller.d.ts +71 -2
- package/dist_ts/classes.controller.js +500 -113
- package/dist_ts/classes.controllerdevices.d.ts +128 -0
- package/dist_ts/classes.controllerdevices.js +472 -0
- package/dist_ts/classes.controllerservice.d.ts +20 -2
- package/dist_ts/classes.controllerservice.js +42 -6
- package/dist_ts/classes.flexservice.js +8 -3
- package/dist_ts/classes.inferencegateway.d.ts +30 -2
- package/dist_ts/classes.inferencegateway.js +115 -20
- package/dist_ts/classes.inferencerouter.d.ts +16 -0
- package/dist_ts/classes.inferencerouter.js +5 -3
- package/dist_ts/classes.inferenceservice.js +7 -3
- package/dist_ts/classes.sessionfeed.d.ts +10 -1
- package/dist_ts/classes.sessionfeed.js +12 -2
- package/dist_ts/classes.ticketmodels.js +4 -3
- package/dist_ts/classes.ticketnotifier.js +9 -2
- package/dist_ts/classes.ticketstore.js +9 -5
- package/dist_ts/classes.upgradecoordinator.d.ts +6 -1
- package/dist_ts/classes.upgradecoordinator.js +9 -2
- package/dist_ts/classes.upgradetransaction.d.ts +27 -1
- package/dist_ts/classes.upgradetransaction.js +92 -2
- package/dist_ts/classes.validation.d.ts +2 -0
- package/dist_ts/classes.validation.js +2 -2
- package/dist_ts/configuration/functions.master.d.ts +7 -2
- package/dist_ts/configuration/functions.master.js +7 -4
- package/dist_ts/driver/classes.drivereventrelay.d.ts +1 -1
- package/dist_ts/driver/classes.drivereventrelay.js +3 -3
- package/dist_ts/fleet/classes.boardpump.d.ts +1 -1
- package/dist_ts/fleet/classes.boardpump.js +7 -4
- package/dist_ts/fleet/classes.claudeworkers.d.ts +6 -0
- package/dist_ts/fleet/classes.claudeworkers.js +17 -7
- package/dist_ts/fleet/classes.deploymodels.d.ts +19 -0
- package/dist_ts/fleet/classes.deploymodels.js +140 -0
- package/dist_ts/fleet/functions.validation.d.ts +8 -1
- package/dist_ts/fleet/functions.validation.js +65 -3
- package/dist_ts/fleet/interfaces.workers.d.ts +6 -0
- package/dist_ts/fleet/interfaces.workers.js +65 -2
- package/dist_ts/functions.deviceapi.d.ts +28 -0
- package/dist_ts/functions.deviceapi.js +246 -0
- package/dist_ts/functions.deviceproof.d.ts +33 -0
- package/dist_ts/functions.deviceproof.js +93 -0
- package/dist_ts/functions.fleetworkercli.d.ts +16 -3
- package/dist_ts/functions.fleetworkercli.js +21 -7
- package/dist_ts/functions.inferencecli.js +4 -2
- package/dist_ts/functions.mcptickettools.d.ts +1 -0
- package/dist_ts/functions.remotecli.d.ts +1 -1
- package/dist_ts/functions.remotecli.js +12 -7
- package/dist_ts/functions.ticketvalidation.d.ts +36 -3
- package/dist_ts/functions.ticketvalidation.js +45 -14
- package/dist_ts/interfaces.auth.d.ts +1 -1
- package/dist_ts/interfaces.auth.js +7 -1
- package/dist_ts_authswitch/authority-contract.d.ts +23 -0
- package/dist_ts_authswitch/authority-contract.js +1 -1
- package/dist_ts_authswitch/classes.authoritybroker.d.ts +6 -0
- package/dist_ts_authswitch/classes.authoritybroker.js +31 -4
- package/dist_ts_authswitch/classes.authoritycli.d.ts +1 -0
- package/dist_ts_authswitch/classes.authoritycli.js +26 -1
- package/dist_ts_authswitch/classes.authorityclient.d.ts +3 -1
- package/dist_ts_authswitch/classes.authorityclient.js +10 -4
- package/dist_ts_authswitch/classes.authoritydaemon.js +7 -1
- package/dist_ts_authswitch/classes.authorityimport.js +2 -2
- package/dist_ts_authswitch/classes.authoritymodels.d.ts +3 -0
- package/dist_ts_authswitch/classes.authoritymodels.js +10 -3
- package/dist_ts_authswitch/testsupport.js +4 -4
- package/dist_ts_authswitch/ts_migration/0012_account_claude_code.d.ts +11 -0
- package/dist_ts_authswitch/ts_migration/0012_account_claude_code.js +18 -0
- package/dist_ts_authswitch/ts_migration/index.js +3 -1
- package/dist_ts_interfaces/deployments.d.ts +104 -0
- package/dist_ts_interfaces/deployments.js +8 -0
- package/dist_ts_interfaces/devices.d.ts +331 -0
- package/dist_ts_interfaces/devices.js +34 -0
- package/dist_ts_interfaces/fleet.d.ts +2 -0
- package/dist_ts_interfaces/index.d.ts +3 -0
- package/dist_ts_interfaces/index.js +4 -1
- package/dist_ts_interfaces/interfaces.d.ts +4 -2
- package/dist_ts_interfaces/interfaces.js +3 -2
- package/dist_ts_interfaces/mcprequests.d.ts +1 -1
- package/dist_ts_interfaces/requests.accounts.d.ts +18 -0
- package/dist_ts_interfaces/requests.accounts.js +1 -1
- package/dist_ts_interfaces/requests.d.ts +3 -2
- package/dist_ts_interfaces/requests.devices.d.ts +89 -0
- package/dist_ts_interfaces/requests.devices.js +2 -0
- package/dist_ts_interfaces/requests.js +1 -1
- package/dist_ts_interfaces/tickets.d.ts +53 -4
- package/dist_ts_interfaces/tickets.js +6 -2
- package/dist_ts_migration/index.d.ts +1 -0
- package/dist_ts_migration/index.js +2 -1
- package/dist_ts_migration/v41_ticketmigrationmarkers.d.ts +19 -0
- package/dist_ts_migration/v41_ticketmigrationmarkers.js +85 -0
- package/docs/authswitch.md +6 -0
- package/package.json +5 -5
- package/readme.md +84 -16
- package/ts/00_commitinfo_data.ts +1 -1
- package/ts/aglapi/aglapisurface.document.ts +123 -9
- package/ts/classes.accountsactions.ts +24 -0
- package/ts/classes.authstore.ts +54 -14
- package/ts/classes.cli.ts +17 -54
- package/ts/classes.configurationauthority.ts +1 -1
- package/ts/classes.controller.ts +697 -167
- package/ts/classes.controllerdevices.ts +469 -0
- package/ts/classes.controllerservice.ts +49 -6
- package/ts/classes.flexservice.ts +7 -2
- package/ts/classes.inferencegateway.ts +133 -19
- package/ts/classes.inferencerouter.ts +20 -2
- package/ts/classes.inferenceservice.ts +6 -3
- package/ts/classes.sessionfeed.ts +13 -1
- package/ts/classes.ticketmodels.ts +3 -2
- package/ts/classes.ticketnotifier.ts +8 -1
- package/ts/classes.ticketstore.ts +8 -4
- package/ts/classes.upgradecoordinator.ts +14 -4
- package/ts/classes.upgradetransaction.ts +118 -0
- package/ts/classes.validation.ts +1 -1
- package/ts/configuration/functions.master.ts +6 -3
- package/ts/driver/classes.drivereventrelay.ts +2 -2
- package/ts/fleet/classes.boardpump.ts +7 -4
- package/ts/fleet/classes.claudeworkers.ts +16 -6
- package/ts/fleet/classes.deploymodels.ts +44 -0
- package/ts/fleet/functions.validation.ts +50 -2
- package/ts/fleet/interfaces.workers.ts +56 -1
- package/ts/functions.deviceapi.ts +295 -0
- package/ts/functions.deviceproof.ts +118 -0
- package/ts/functions.fleetworkercli.ts +26 -8
- package/ts/functions.inferencecli.ts +3 -1
- package/ts/functions.remotecli.ts +11 -5
- package/ts/functions.ticketvalidation.ts +48 -13
- package/ts/interfaces.auth.ts +6 -0
- package/ts_authswitch/authority-contract.ts +18 -0
- package/ts_authswitch/classes.authoritybroker.ts +29 -3
- package/ts_authswitch/classes.authoritycli.ts +29 -0
- package/ts_authswitch/classes.authorityclient.ts +12 -4
- package/ts_authswitch/classes.authoritydaemon.ts +8 -1
- package/ts_authswitch/classes.authorityimport.ts +1 -1
- package/ts_authswitch/classes.authoritymodels.ts +5 -1
- package/ts_authswitch/native-contracts.md +10 -0
- package/ts_authswitch/testsupport.ts +3 -3
- package/ts_authswitch/ts_migration/0012_account_claude_code.ts +17 -0
- package/ts_authswitch/ts_migration/index.ts +2 -0
- package/ts_interfaces/deployments.ts +98 -0
- package/ts_interfaces/devices.schema.json +890 -0
- package/ts_interfaces/devices.ts +392 -0
- package/ts_interfaces/fleet.ts +2 -0
- package/ts_interfaces/index.ts +3 -0
- package/ts_interfaces/interfaces.ts +4 -1
- package/ts_interfaces/mcprequests.ts +1 -1
- package/ts_interfaces/requests.accounts.ts +16 -0
- package/ts_interfaces/requests.devices.ts +95 -0
- package/ts_interfaces/requests.ts +12 -0
- package/ts_interfaces/tickets.ts +34 -4
- package/ts_migration/index.ts +1 -0
- package/ts_migration/v41_ticketmigrationmarkers.ts +28 -0
- package/ts_web/00_commitinfo_data.ts +1 -1
- package/ts_web/classes.accountsreadmodel.ts +12 -1
- package/ts_web/classes.controllersocketclient.ts +27 -0
- package/ts_web/elements.accounts.ts +44 -0
- package/ts_web/elements.devices.ts +752 -0
- package/ts_web/elements.harnesscontrollerapp.ts +18 -1
- package/ts_web/elements.ticketboard.ts +15 -4
|
@@ -0,0 +1,246 @@
|
|
|
1
|
+
import { deviceLabelMaximumCharacters, deviceMessageMaximumBytes, } from '../dist_ts_interfaces/devices.js';
|
|
2
|
+
import { isControllerSessionFeedRowId } from '../dist_ts_interfaces/sessionfeed.js';
|
|
3
|
+
import { assertKeys, assertObject, assertQuestionAnswers } from './classes.validation.js';
|
|
4
|
+
import { sessionFeedRowId } from './classes.sessionfeed.js';
|
|
5
|
+
/*
|
|
6
|
+
* The device API's requests and projections: what a device may ask, checked before anything is read, and the reduced
|
|
7
|
+
* shapes of what it gets. A device sees the session feed without host paths, tickets or terminals, transcripts with
|
|
8
|
+
* tool calls reduced to name, title and status, and an allowlist of events.
|
|
9
|
+
*/
|
|
10
|
+
/** The controller events a device receives, each projected by `deviceEvent`; every other event never reaches one. */
|
|
11
|
+
export const deviceRelayedEventTypes = new Set([
|
|
12
|
+
'sessionfeed.changed',
|
|
13
|
+
'sessions.changed',
|
|
14
|
+
'session.changed',
|
|
15
|
+
'session.history.changed',
|
|
16
|
+
'permissions.changed',
|
|
17
|
+
'session.text.updated',
|
|
18
|
+
'session.text.delta',
|
|
19
|
+
]);
|
|
20
|
+
/** A feed row as a device sees it; none for a terminal row, which a device does not open. */
|
|
21
|
+
export const deviceSessionRow = (rowArg) => (rowArg.open.kind === 'terminal' ? undefined : {
|
|
22
|
+
id: rowArg.id,
|
|
23
|
+
harness: rowArg.harness,
|
|
24
|
+
state: rowArg.state,
|
|
25
|
+
name: rowArg.name,
|
|
26
|
+
...(rowArg.excerpt === undefined ? {} : { excerpt: rowArg.excerpt }),
|
|
27
|
+
updatedAt: rowArg.updatedAt,
|
|
28
|
+
});
|
|
29
|
+
export const deviceSessionRows = (rowsArg) => rowsArg
|
|
30
|
+
.flatMap((rowArg) => deviceSessionRow(rowArg) ?? []);
|
|
31
|
+
/** A feed change as a device applies it: the same epoch and revision, terminal rows left out. */
|
|
32
|
+
export const deviceFeedDelta = (deltaArg) => 'reset' in deltaArg
|
|
33
|
+
? { epoch: deltaArg.epoch, revision: deltaArg.revision, reset: true, upserts: [], removed: [] }
|
|
34
|
+
: {
|
|
35
|
+
epoch: deltaArg.epoch,
|
|
36
|
+
revision: deltaArg.revision,
|
|
37
|
+
reset: false,
|
|
38
|
+
upserts: deviceSessionRows(deltaArg.upserts),
|
|
39
|
+
removed: [...deltaArg.removed],
|
|
40
|
+
};
|
|
41
|
+
/** One source message of a transcript as one device message: its reasoning, text and tool calls as parts, in order. */
|
|
42
|
+
const deviceMessage = (bundleArg) => {
|
|
43
|
+
const first = bundleArg.messages[0];
|
|
44
|
+
if (!first)
|
|
45
|
+
return undefined;
|
|
46
|
+
const parts = [];
|
|
47
|
+
for (const message of bundleArg.messages) {
|
|
48
|
+
for (const reasoning of message.reasoning ?? []) {
|
|
49
|
+
if (reasoning.text !== '')
|
|
50
|
+
parts.push({ type: 'reasoning', id: reasoning.id.nativeId, text: reasoning.text });
|
|
51
|
+
}
|
|
52
|
+
if (message.toolCall) {
|
|
53
|
+
parts.push({
|
|
54
|
+
type: 'tool',
|
|
55
|
+
id: message.toolCall.id.nativeId,
|
|
56
|
+
tool: message.toolCall.name,
|
|
57
|
+
...(message.toolCall.title === undefined ? {} : { title: message.toolCall.title }),
|
|
58
|
+
status: message.toolCall.status,
|
|
59
|
+
});
|
|
60
|
+
}
|
|
61
|
+
else if (message.text !== '' || message.streaming === true) {
|
|
62
|
+
// A streaming part is listed while still empty: its live text applies to it.
|
|
63
|
+
parts.push({ type: 'text', id: message.id.nativeId, text: message.text });
|
|
64
|
+
}
|
|
65
|
+
}
|
|
66
|
+
return {
|
|
67
|
+
id: bundleArg.sourceMessageId.nativeId,
|
|
68
|
+
role: bundleArg.messages.some((messageArg) => messageArg.role === 'user') ? 'user' : 'assistant',
|
|
69
|
+
createdAt: first.createdAt,
|
|
70
|
+
parts,
|
|
71
|
+
};
|
|
72
|
+
};
|
|
73
|
+
/** A transcript page's messages, oldest first. */
|
|
74
|
+
export const deviceMessages = (bundlesArg) => bundlesArg
|
|
75
|
+
.flatMap((bundleArg) => deviceMessage(bundleArg) ?? []);
|
|
76
|
+
export const devicePermissions = (permissionsArg) => permissionsArg
|
|
77
|
+
.map((permissionArg) => ({
|
|
78
|
+
id: permissionArg.id.nativeId,
|
|
79
|
+
title: permissionArg.title,
|
|
80
|
+
type: permissionArg.type,
|
|
81
|
+
patterns: [...permissionArg.patterns],
|
|
82
|
+
}));
|
|
83
|
+
export const deviceQuestions = (questionsArg) => questionsArg
|
|
84
|
+
.map((questionArg) => ({
|
|
85
|
+
id: questionArg.id.nativeId,
|
|
86
|
+
questions: questionArg.questions.map((itemArg) => ({
|
|
87
|
+
question: itemArg.question,
|
|
88
|
+
header: itemArg.header,
|
|
89
|
+
options: itemArg.options.map(({ label, description }) => ({ label, description })),
|
|
90
|
+
...(itemArg.multiple === undefined ? {} : { multiple: itemArg.multiple }),
|
|
91
|
+
...(itemArg.custom === undefined ? {} : { custom: itemArg.custom }),
|
|
92
|
+
})),
|
|
93
|
+
}));
|
|
94
|
+
/**
|
|
95
|
+
* The row id a device names a conversation by, when the feed lists it as something a device opens; events about any
|
|
96
|
+
* other session (a driver, a child, a terminal's agent, one the feed has not listed yet) reach no device.
|
|
97
|
+
*/
|
|
98
|
+
const visibleRowId = (sessionIdArg, rowOfArg) => {
|
|
99
|
+
if (!sessionIdArg || sessionIdArg.harnessId === 'controller')
|
|
100
|
+
return undefined;
|
|
101
|
+
const rowId = sessionFeedRowId(sessionIdArg.harnessId, sessionIdArg.nativeId);
|
|
102
|
+
const row = rowOfArg(rowId);
|
|
103
|
+
return row && row.open.kind !== 'terminal' ? rowId : undefined;
|
|
104
|
+
};
|
|
105
|
+
/** A controller event as a device receives it, or none. `rowOfArg` answers the feed's published rows. */
|
|
106
|
+
export const deviceEvent = (eventArg, rowOfArg) => {
|
|
107
|
+
switch (eventArg.type) {
|
|
108
|
+
case 'sessionfeed.changed':
|
|
109
|
+
return eventArg.sessionFeed ? { type: 'sessionfeed.changed', delta: deviceFeedDelta(eventArg.sessionFeed) } : undefined;
|
|
110
|
+
case 'sessions.changed':
|
|
111
|
+
return { type: 'sessions.changed' };
|
|
112
|
+
case 'session.changed':
|
|
113
|
+
case 'session.history.changed':
|
|
114
|
+
case 'permissions.changed': {
|
|
115
|
+
if (!eventArg.sessionId)
|
|
116
|
+
return eventArg.type === 'permissions.changed' ? { type: 'sessions.changed' } : undefined;
|
|
117
|
+
const sessionId = visibleRowId(eventArg.sessionId, rowOfArg);
|
|
118
|
+
return sessionId === undefined ? undefined : { type: 'session.changed', sessionId };
|
|
119
|
+
}
|
|
120
|
+
case 'session.text.updated': {
|
|
121
|
+
const update = eventArg.textUpdate;
|
|
122
|
+
const sessionId = visibleRowId(update?.sessionId, rowOfArg);
|
|
123
|
+
return update && sessionId !== undefined ? {
|
|
124
|
+
type: 'session.text.updated',
|
|
125
|
+
update: { sessionId, messageId: update.messageId.nativeId, partId: update.partId.nativeId, text: update.text },
|
|
126
|
+
} : undefined;
|
|
127
|
+
}
|
|
128
|
+
case 'session.text.delta': {
|
|
129
|
+
const delta = eventArg.textDelta;
|
|
130
|
+
const sessionId = visibleRowId(delta?.sessionId, rowOfArg);
|
|
131
|
+
return delta && sessionId !== undefined ? {
|
|
132
|
+
type: 'session.text.delta',
|
|
133
|
+
delta: {
|
|
134
|
+
sessionId,
|
|
135
|
+
messageId: delta.messageId.nativeId,
|
|
136
|
+
partId: delta.partId.nativeId,
|
|
137
|
+
delta: delta.delta,
|
|
138
|
+
baseTextUtf8Bytes: delta.baseTextUtf8Bytes,
|
|
139
|
+
textUtf8Bytes: delta.textUtf8Bytes,
|
|
140
|
+
},
|
|
141
|
+
} : undefined;
|
|
142
|
+
}
|
|
143
|
+
default:
|
|
144
|
+
return undefined;
|
|
145
|
+
}
|
|
146
|
+
};
|
|
147
|
+
const assertText = (valueArg, nameArg, maximumBytesArg) => {
|
|
148
|
+
if (typeof valueArg !== 'string' || valueArg.length === 0 || Buffer.byteLength(valueArg, 'utf8') > maximumBytesArg) {
|
|
149
|
+
throw new Error(`${nameArg} must contain 1-${maximumBytesArg} UTF-8 bytes.`);
|
|
150
|
+
}
|
|
151
|
+
return valueArg;
|
|
152
|
+
};
|
|
153
|
+
const assertDeviceId = (valueArg) => {
|
|
154
|
+
if (typeof valueArg !== 'string' || !/^[A-Za-z0-9_-]{24}$/u.test(valueArg))
|
|
155
|
+
throw new Error('deviceId is not a device id.');
|
|
156
|
+
return valueArg;
|
|
157
|
+
};
|
|
158
|
+
const assertRowId = (valueArg) => {
|
|
159
|
+
if (!isControllerSessionFeedRowId(valueArg))
|
|
160
|
+
throw new Error('sessionId must name a session as the session feed does.');
|
|
161
|
+
return valueArg;
|
|
162
|
+
};
|
|
163
|
+
/** A device's name or model: one line of 1 to 64 characters, its surrounding blanks dropped. */
|
|
164
|
+
const assertDeviceLabel = (valueArg, nameArg) => {
|
|
165
|
+
const label = typeof valueArg === 'string' ? valueArg.trim() : '';
|
|
166
|
+
if (label.length === 0 || [...label].length > deviceLabelMaximumCharacters || /\p{Cc}/u.test(label)) {
|
|
167
|
+
throw new Error(`${nameArg} must be one line of 1-${deviceLabelMaximumCharacters} characters.`);
|
|
168
|
+
}
|
|
169
|
+
return label;
|
|
170
|
+
};
|
|
171
|
+
export const assertDevicePairRequest = (valueArg) => {
|
|
172
|
+
const value = assertObject(valueArg, 'device pair request');
|
|
173
|
+
assertKeys(value, ['code', 'name', 'model', 'publicKey', 'proof']);
|
|
174
|
+
return {
|
|
175
|
+
code: assertText(value.code, 'code', 64),
|
|
176
|
+
name: assertDeviceLabel(value.name, 'name'),
|
|
177
|
+
model: assertDeviceLabel(value.model, 'model'),
|
|
178
|
+
publicKey: assertText(value.publicKey, 'publicKey', 256),
|
|
179
|
+
proof: assertText(value.proof, 'proof', 128),
|
|
180
|
+
};
|
|
181
|
+
};
|
|
182
|
+
export const assertDeviceAuthChallengeRequest = (valueArg) => {
|
|
183
|
+
const value = assertObject(valueArg, 'device challenge request');
|
|
184
|
+
assertKeys(value, ['deviceId']);
|
|
185
|
+
return { deviceId: assertDeviceId(value.deviceId) };
|
|
186
|
+
};
|
|
187
|
+
export const assertDeviceAuthProveRequest = (valueArg) => {
|
|
188
|
+
const value = assertObject(valueArg, 'device proof request');
|
|
189
|
+
assertKeys(value, ['deviceId', 'signature']);
|
|
190
|
+
return { deviceId: assertDeviceId(value.deviceId), signature: assertText(value.signature, 'signature', 128) };
|
|
191
|
+
};
|
|
192
|
+
export const assertDeviceSessionReadRequest = (valueArg) => {
|
|
193
|
+
const value = assertObject(valueArg, 'device session read request');
|
|
194
|
+
assertKeys(value, ['sessionId'], ['before', 'limit']);
|
|
195
|
+
if (value.limit !== undefined && (!Number.isSafeInteger(value.limit) || value.limit < 1 || value.limit > 50)) {
|
|
196
|
+
throw new Error('limit must be an integer from 1 to 50.');
|
|
197
|
+
}
|
|
198
|
+
return {
|
|
199
|
+
sessionId: assertRowId(value.sessionId),
|
|
200
|
+
...(value.before === undefined ? {} : { before: assertText(value.before, 'before', 4096) }),
|
|
201
|
+
...(value.limit === undefined ? {} : { limit: value.limit }),
|
|
202
|
+
};
|
|
203
|
+
};
|
|
204
|
+
export const assertDeviceSessionSendRequest = (valueArg) => {
|
|
205
|
+
const value = assertObject(valueArg, 'device session send request');
|
|
206
|
+
assertKeys(value, ['sessionId', 'text']);
|
|
207
|
+
const text = assertText(value.text, 'text', deviceMessageMaximumBytes);
|
|
208
|
+
if (!text.trim() || text.includes('\0'))
|
|
209
|
+
throw new Error('text must be a message that is not blank.');
|
|
210
|
+
return { sessionId: assertRowId(value.sessionId), text };
|
|
211
|
+
};
|
|
212
|
+
export const assertDevicePermissionReplyRequest = (valueArg) => {
|
|
213
|
+
const value = assertObject(valueArg, 'device permission reply request');
|
|
214
|
+
assertKeys(value, ['sessionId', 'permissionId', 'reply'], ['message']);
|
|
215
|
+
if (value.reply !== 'once' && value.reply !== 'reject')
|
|
216
|
+
throw new Error('reply must be once or reject.');
|
|
217
|
+
return {
|
|
218
|
+
sessionId: assertRowId(value.sessionId),
|
|
219
|
+
permissionId: assertText(value.permissionId, 'permissionId', 512),
|
|
220
|
+
reply: value.reply,
|
|
221
|
+
...(value.message === undefined ? {} : { message: assertText(value.message, 'message', 2048) }),
|
|
222
|
+
};
|
|
223
|
+
};
|
|
224
|
+
export const assertDeviceQuestionReplyRequest = (valueArg) => {
|
|
225
|
+
const value = assertObject(valueArg, 'device question reply request');
|
|
226
|
+
assertKeys(value, ['sessionId', 'questionId', 'answers']);
|
|
227
|
+
return {
|
|
228
|
+
sessionId: assertRowId(value.sessionId),
|
|
229
|
+
questionId: assertText(value.questionId, 'questionId', 512),
|
|
230
|
+
answers: assertQuestionAnswers(value.answers),
|
|
231
|
+
};
|
|
232
|
+
};
|
|
233
|
+
export const assertDevicePairingCancelRequest = (valueArg) => {
|
|
234
|
+
const value = assertObject(valueArg, 'pairing cancel request');
|
|
235
|
+
assertKeys(value, ['pairingId']);
|
|
236
|
+
if (typeof value.pairingId !== 'string' || !/^[A-Za-z0-9_-]{22}$/u.test(value.pairingId)) {
|
|
237
|
+
throw new Error('pairingId is not a pairing id.');
|
|
238
|
+
}
|
|
239
|
+
return { pairingId: value.pairingId };
|
|
240
|
+
};
|
|
241
|
+
export const assertDeviceRevokeRequest = (valueArg) => {
|
|
242
|
+
const value = assertObject(valueArg, 'device revoke request');
|
|
243
|
+
assertKeys(value, ['deviceId']);
|
|
244
|
+
return { deviceId: assertDeviceId(value.deviceId) };
|
|
245
|
+
};
|
|
246
|
+
//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZnVuY3Rpb25zLmRldmljZWFwaS5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3RzL2Z1bmN0aW9ucy5kZXZpY2VhcGkudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBVUEsT0FBTyxFQUNMLDRCQUE0QixFQUM1Qix5QkFBeUIsR0FlMUIsTUFBTSw2QkFBNkIsQ0FBQztBQUNyQyxPQUFPLEVBQUUsNEJBQTRCLEVBQUUsTUFBTSxpQ0FBaUMsQ0FBQztBQUMvRSxPQUFPLEVBQUUsVUFBVSxFQUFFLFlBQVksRUFBRSxxQkFBcUIsRUFBRSxNQUFNLHlCQUF5QixDQUFDO0FBQzFGLE9BQU8sRUFBRSxnQkFBZ0IsRUFBRSxNQUFNLDBCQUEwQixDQUFDO0FBRTVEOzs7O0dBSUc7QUFFSCxxSEFBcUg7QUFDckgsTUFBTSxDQUFDLE1BQU0sdUJBQXVCLEdBQXNDLElBQUksR0FBRyxDQUF1QjtJQUN0RyxxQkFBcUI7SUFDckIsa0JBQWtCO0lBQ2xCLGlCQUFpQjtJQUNqQix5QkFBeUI7SUFDekIscUJBQXFCO0lBQ3JCLHNCQUFzQjtJQUN0QixvQkFBb0I7Q0FDckIsQ0FBQyxDQUFDO0FBRUgsNkZBQTZGO0FBQzdGLE1BQU0sQ0FBQyxNQUFNLGdCQUFnQixHQUFHLENBQUMsTUFBaUMsRUFBaUMsRUFBRSxDQUFDLENBQ3BHLE1BQU0sQ0FBQyxJQUFJLENBQUMsSUFBSSxLQUFLLFVBQVUsQ0FBQyxDQUFDLENBQUMsU0FBUyxDQUFDLENBQUMsQ0FBQztJQUM1QyxFQUFFLEVBQUUsTUFBTSxDQUFDLEVBQUU7SUFDYixPQUFPLEVBQUUsTUFBTSxDQUFDLE9BQU87SUFDdkIsS0FBSyxFQUFFLE1BQU0sQ0FBQyxLQUFLO0lBQ25CLElBQUksRUFBRSxNQUFNLENBQUMsSUFBSTtJQUNqQixHQUFHLENBQUMsTUFBTSxDQUFDLE9BQU8sS0FBSyxTQUFTLENBQUMsQ0FBQyxDQUFDLEVBQUUsQ0FBQyxDQUFDLENBQUMsRUFBRSxPQUFPLEVBQUUsTUFBTSxDQUFDLE9B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
|
|
@@ -0,0 +1,33 @@
|
|
|
1
|
+
import * as plugins from './plugins.js';
|
|
2
|
+
/**
|
|
3
|
+
* The bytes of a base64url text without padding, refused (undefined) unless it is exactly that text's canonical form,
|
|
4
|
+
* of `byteLengthArg` bytes when given and of at most `maximumBytesArg` otherwise.
|
|
5
|
+
*/
|
|
6
|
+
export declare const decodeDeviceBase64Url: (valueArg: unknown, sizeArg: {
|
|
7
|
+
bytes: number;
|
|
8
|
+
} | {
|
|
9
|
+
maximumBytes: number;
|
|
10
|
+
}) => Buffer | undefined;
|
|
11
|
+
export interface IDeviceMessageBinding {
|
|
12
|
+
/** `controller:<port>`. */
|
|
13
|
+
controllerId: string;
|
|
14
|
+
/** The controller's public origin, exactly as it is configured. */
|
|
15
|
+
origin: string;
|
|
16
|
+
/** The device key, SubjectPublicKeyInfo DER. */
|
|
17
|
+
publicKey: Uint8Array;
|
|
18
|
+
}
|
|
19
|
+
/** The message a device signs to pair: it binds the key to this controller, origin and code. */
|
|
20
|
+
export declare const devicePairingMessage: (bindingArg: IDeviceMessageBinding, codeArg: Uint8Array) => Buffer;
|
|
21
|
+
/** The message a device signs to authenticate one connection: it binds the key to this controller, origin and nonce. */
|
|
22
|
+
export declare const deviceAuthenticationMessage: (bindingArg: IDeviceMessageBinding, nonceArg: Uint8Array) => Buffer;
|
|
23
|
+
/**
|
|
24
|
+
* A device's public key: a P-256 SubjectPublicKeyInfo in DER with an uncompressed point on the curve, in exactly the
|
|
25
|
+
* form `node:crypto` exports it again, so one key has one text and one fingerprint. Undefined for anything else.
|
|
26
|
+
*/
|
|
27
|
+
export declare const importDevicePublicKey: (spkiArg: Uint8Array) => plugins.crypto.KeyObject | undefined;
|
|
28
|
+
/** Whether `signatureArg` (ECDSA P-256 with SHA-256, DER) is the key's signature of `messageArg`. */
|
|
29
|
+
export declare const verifyDeviceSignature: (keyArg: plugins.crypto.KeyObject, messageArg: Uint8Array, signatureArg: Uint8Array) => boolean;
|
|
30
|
+
/** A key's fingerprint for people to compare: SHA-256 of the SPKI, the first 16 bytes as 8 groups of 4 uppercase hex. */
|
|
31
|
+
export declare const deviceKeyFingerprint: (spkiArg: Uint8Array) => string;
|
|
32
|
+
/** The QR code's payload: `agl-pair:?origin=<https origin>&controller=<controller id>&code=<base64url>`, each once. */
|
|
33
|
+
export declare const devicePairingPayload: (originArg: string, controllerIdArg: string, codeArg: Uint8Array) => string;
|
|
@@ -0,0 +1,93 @@
|
|
|
1
|
+
import * as plugins from './plugins.js';
|
|
2
|
+
import { deviceAuthenticationMessageLabel, devicePairingMessageLabel, devicePairingScheme, deviceSecretBytes, } from '../dist_ts_interfaces/devices.js';
|
|
3
|
+
/*
|
|
4
|
+
* The cryptography of the device protocol (`ts_interfaces/devices.ts`): the messages a device key signs, the P-256 key
|
|
5
|
+
* and signature checks, the fingerprint people compare, and the pairing payload of the QR code. Everything runs on
|
|
6
|
+
* `node:crypto`; the signed messages are byte for byte what HarnessKit's `DeviceProof` builds.
|
|
7
|
+
*/
|
|
8
|
+
/** Everything of a P-256 SubjectPublicKeyInfo in DER before the uncompressed point's 64 bytes. */
|
|
9
|
+
const p256SpkiPrefix = Buffer.from('3059301306072a8648ce3d020106082a8648ce3d03010703420004', 'hex');
|
|
10
|
+
const p256SpkiBytes = p256SpkiPrefix.byteLength + 64;
|
|
11
|
+
const base64UrlPattern = /^[A-Za-z0-9_-]+$/u;
|
|
12
|
+
/**
|
|
13
|
+
* The bytes of a base64url text without padding, refused (undefined) unless it is exactly that text's canonical form,
|
|
14
|
+
* of `byteLengthArg` bytes when given and of at most `maximumBytesArg` otherwise.
|
|
15
|
+
*/
|
|
16
|
+
export const decodeDeviceBase64Url = (valueArg, sizeArg) => {
|
|
17
|
+
if (typeof valueArg !== 'string' || !base64UrlPattern.test(valueArg))
|
|
18
|
+
return undefined;
|
|
19
|
+
const maximum = 'bytes' in sizeArg ? sizeArg.bytes : sizeArg.maximumBytes;
|
|
20
|
+
if (valueArg.length > Math.ceil((maximum * 4) / 3))
|
|
21
|
+
return undefined;
|
|
22
|
+
const bytes = Buffer.from(valueArg, 'base64url');
|
|
23
|
+
if (bytes.toString('base64url') !== valueArg)
|
|
24
|
+
return undefined;
|
|
25
|
+
if ('bytes' in sizeArg ? bytes.byteLength !== sizeArg.bytes : bytes.byteLength === 0)
|
|
26
|
+
return undefined;
|
|
27
|
+
return bytes;
|
|
28
|
+
};
|
|
29
|
+
/** A signed message: each field as a 4-byte big-endian length followed by its bytes. */
|
|
30
|
+
const signedMessage = (fieldsArg) => Buffer.concat(fieldsArg.flatMap((fieldArg) => {
|
|
31
|
+
const length = Buffer.alloc(4);
|
|
32
|
+
length.writeUInt32BE(fieldArg.byteLength);
|
|
33
|
+
return [length, fieldArg];
|
|
34
|
+
}));
|
|
35
|
+
/** The message a device signs to pair: it binds the key to this controller, origin and code. */
|
|
36
|
+
export const devicePairingMessage = (bindingArg, codeArg) => signedMessage([
|
|
37
|
+
Buffer.from(devicePairingMessageLabel, 'utf8'),
|
|
38
|
+
Buffer.from(bindingArg.controllerId, 'utf8'),
|
|
39
|
+
Buffer.from(bindingArg.origin, 'utf8'),
|
|
40
|
+
plugins.crypto.createHash('sha256').update(codeArg).digest(),
|
|
41
|
+
bindingArg.publicKey,
|
|
42
|
+
]);
|
|
43
|
+
/** The message a device signs to authenticate one connection: it binds the key to this controller, origin and nonce. */
|
|
44
|
+
export const deviceAuthenticationMessage = (bindingArg, nonceArg) => {
|
|
45
|
+
if (nonceArg.byteLength !== deviceSecretBytes)
|
|
46
|
+
throw new Error(`A device nonce is ${deviceSecretBytes} bytes.`);
|
|
47
|
+
return signedMessage([
|
|
48
|
+
Buffer.from(deviceAuthenticationMessageLabel, 'utf8'),
|
|
49
|
+
Buffer.from(bindingArg.controllerId, 'utf8'),
|
|
50
|
+
Buffer.from(bindingArg.origin, 'utf8'),
|
|
51
|
+
nonceArg,
|
|
52
|
+
bindingArg.publicKey,
|
|
53
|
+
]);
|
|
54
|
+
};
|
|
55
|
+
/**
|
|
56
|
+
* A device's public key: a P-256 SubjectPublicKeyInfo in DER with an uncompressed point on the curve, in exactly the
|
|
57
|
+
* form `node:crypto` exports it again, so one key has one text and one fingerprint. Undefined for anything else.
|
|
58
|
+
*/
|
|
59
|
+
export const importDevicePublicKey = (spkiArg) => {
|
|
60
|
+
const spki = Buffer.from(spkiArg);
|
|
61
|
+
if (spki.byteLength !== p256SpkiBytes || !spki.subarray(0, p256SpkiPrefix.byteLength).equals(p256SpkiPrefix)) {
|
|
62
|
+
return undefined;
|
|
63
|
+
}
|
|
64
|
+
let key;
|
|
65
|
+
try {
|
|
66
|
+
key = plugins.crypto.createPublicKey({ key: spki, format: 'der', type: 'spki' });
|
|
67
|
+
}
|
|
68
|
+
catch {
|
|
69
|
+
return undefined;
|
|
70
|
+
}
|
|
71
|
+
if (key.asymmetricKeyType !== 'ec' || key.asymmetricKeyDetails?.namedCurve !== 'prime256v1')
|
|
72
|
+
return undefined;
|
|
73
|
+
return key.export({ format: 'der', type: 'spki' }).equals(spki) ? key : undefined;
|
|
74
|
+
};
|
|
75
|
+
/** Whether `signatureArg` (ECDSA P-256 with SHA-256, DER) is the key's signature of `messageArg`. */
|
|
76
|
+
export const verifyDeviceSignature = (keyArg, messageArg, signatureArg) => {
|
|
77
|
+
try {
|
|
78
|
+
return plugins.crypto.verify('sha256', messageArg, { key: keyArg, dsaEncoding: 'der' }, signatureArg);
|
|
79
|
+
}
|
|
80
|
+
catch {
|
|
81
|
+
return false;
|
|
82
|
+
}
|
|
83
|
+
};
|
|
84
|
+
/** A key's fingerprint for people to compare: SHA-256 of the SPKI, the first 16 bytes as 8 groups of 4 uppercase hex. */
|
|
85
|
+
export const deviceKeyFingerprint = (spkiArg) => plugins.crypto.createHash('sha256').update(spkiArg)
|
|
86
|
+
.digest().subarray(0, 16).toString('hex').toUpperCase().match(/.{4}/gu).join(' ');
|
|
87
|
+
/** Percent-encodes everything in a query value but letters, digits and `-._~`, as HarnessKit's payload writer does. */
|
|
88
|
+
const queryValue = (valueArg) => encodeURIComponent(valueArg)
|
|
89
|
+
.replace(/[!'()*]/gu, (characterArg) => `%${characterArg.charCodeAt(0).toString(16).toUpperCase()}`);
|
|
90
|
+
/** The QR code's payload: `agl-pair:?origin=<https origin>&controller=<controller id>&code=<base64url>`, each once. */
|
|
91
|
+
export const devicePairingPayload = (originArg, controllerIdArg, codeArg) => (`${devicePairingScheme}:?origin=${queryValue(originArg)}&controller=${queryValue(controllerIdArg)}`
|
|
92
|
+
+ `&code=${Buffer.from(codeArg).toString('base64url')}`);
|
|
93
|
+
//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZnVuY3Rpb25zLmRldmljZXByb29mLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vdHMvZnVuY3Rpb25zLmRldmljZXByb29mLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLE9BQU8sS0FBSyxPQUFPLE1BQU0sY0FBYyxDQUFDO0FBQ3hDLE9BQU8sRUFDTCxnQ0FBZ0MsRUFDaEMseUJBQXlCLEVBQ3pCLG1CQUFtQixFQUNuQixpQkFBaUIsR0FDbEIsTUFBTSw2QkFBNkIsQ0FBQztBQUVyQzs7OztHQUlHO0FBRUgsa0dBQWtHO0FBQ2xHLE1BQU0sY0FBYyxHQUFHLE1BQU0sQ0FBQyxJQUFJLENBQUMsd0RBQXdELEVBQUUsS0FBSyxDQUFDLENBQUM7QUFDcEcsTUFBTSxhQUFhLEdBQUcsY0FBYyxDQUFDLFVBQVUsR0FBRyxFQUFFLENBQUM7QUFDckQsTUFBTSxnQkFBZ0IsR0FBRyxtQkFBbUIsQ0FBQztBQUU3Qzs7O0dBR0c7QUFDSCxNQUFNLENBQUMsTUFBTSxxQkFBcUIsR0FBRyxDQUNuQyxRQUFpQixFQUNqQixPQUFxRCxFQUNqQyxFQUFFO0lBQ3RCLElBQUksT0FBTyxRQUFRLEtBQUssUUFBUSxJQUFJLENBQUMsZ0JBQWdCLENBQUMsSUFBSSxDQUFDLFFBQVEsQ0FBQztRQUFFLE9BQU8sU0FBUyxDQUFDO0lBQ3ZGLE1BQU0sT0FBTyxHQUFHLE9BQU8sSUFBSSxPQUFPLENBQUMsQ0FBQyxDQUFDLE9BQU8sQ0FBQyxLQUFLLENBQUMsQ0FBQyxDQUFDLE9BQU8sQ0FBQyxZQUFZLENBQUM7SUFDMUUsSUFBSSxRQUFRLENBQUMsTUFBTSxHQUFHLElBQUksQ0FBQyxJQUFJLENBQUMsQ0FBQyxPQUFPLEdBQUcsQ0FBQyxDQUFDLEdBQUcsQ0FBQyxDQUFDO1FBQUUsT0FBTyxTQUFTLENBQUM7SUFDckUsTUFBTSxLQUFLLEdBQUcsTUFBTSxDQUFDLElBQUksQ0FBQyxRQUFRLEVBQUUsV0FBVyxDQUFDLENBQUM7SUFDakQsSUFBSSxLQUFL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
|
|
@@ -1,13 +1,20 @@
|
|
|
1
1
|
import { type IFleetWatchChange, type IFleetWatchProbeOptions } from './fleet/functions.watchprobes.js';
|
|
2
2
|
import type { IFleetWorker, TFleetWorkerAction, TFleetWorkerRequest, IFleetEventCursor, IFleetWatchResult } from '../dist_ts_interfaces/fleetworkers.js';
|
|
3
|
-
export declare const fleetWorkerCliHelp = "Usage: agl fleet worker start NAME --profile ID --cwd PATH --prompt-file FILE\n agl fleet worker adopt NAME --profile ID --cwd PATH --native-id ID [--relaunch-file FILE]\n agl fleet worker adopt NAME --profile ID --cwd PATH --native-id ID --rebind --reason TEXT\n agl fleet worker resolve-lost NAME --reason TEXT\n agl fleet worker reconfirm NAME --reason TEXT\n agl fleet worker steer NAME --message-file FILE\n agl fleet worker steer --messages-file FILE (JSON array of {name,text})\n agl fleet worker message NAME|NATIVE_ID --message-file FILE\n agl fleet worker native-message NATIVE_ID --message-file FILE --sender LABEL\n agl fleet worker report|stop|archive NAME\n agl fleet worker refresh NAME --next-name NAME [--profile ID] --handoff-file FILE [--note-file FILE]\n agl fleet worker move NAME --next-name NAME --profile CODEX_PROFILE --handoff-file FILE [--note-file FILE]\n agl fleet worker list [--archived]\n agl fleet worker status JOB_ID\n agl fleet watch [--cursor JSON] [--once] [--lines] [--site NAME=URL \u2026] [--ci OWNER/REPO[@REF] \u2026]\n [--gitea URL] [--gitea-token-file FILE] [--probe-interval SECONDS]\nAll accept --ticket KEY, --json and --port PORT. Actions and report require --ticket; list/status/watch accept it as a filter.\nProfiles live in fleet.workerProfiles in the Configuration master.\nMutation and report commands wait for the returned job; MCP tools return its handle immediately.\nrefresh --profile ID starts the successor on that configured profile, which must run the worker's own harness (only move\nchanges the harness); without --profile the successor keeps the worker's recorded profile.\nWatch emits one JSON object per poll with events and the continuation cursor. Ctrl-C disconnects observation only.\nWatch runs until stopped in ten-minute windows, each under a fresh owner capability, so a pending upgrade waits at most one window.\nA failed window writes a {\"disconnected\":\u2026} line and retries from the cursor; after a restart the next page has reset: true.\n--lines writes one plain line per event or change instead, nothing for an empty page or a host load sample.\n--site probes NAME's URL with a GET and --ci follows a Gitea repository's combined commit status on REF (default main)\nevery --probe-interval seconds (default 60); each writes its state first and then one {\"change\":\u2026} line per change.\n--gitea defaults to https://code.foss.global; a token from --gitea-token-file reaches private repositories over https.\nSteer and message reach a live worker through a relay and resume a reaped or stopped one with its saved options.\nMessage addresses one worker by its name or by its native session id (a unique prefix of at least 8 characters).\nnative-message wakes a settled (done, blocked or stopped) Claude Code background job that no fleet worker binds, named by\nits session id or a unique prefix of at least 8 characters, through Claude Code itself, as the browser's native session\nsend does. The text arrives behind the session_message attribution header with the --sender label and the local owner\ncapability, never as the job's user. A running, failed or held job, a fleet worker's session and a project conversation\nare refused with their reason. A native wake holds no dispatch fence, writes no ticket comment and does not observe the\nwoken turn; the receipt names the command that adopts the job. It takes no --ticket.\nAdopt registers a native session as it is. --relaunch-file resumes a settled Claude Code session under the fleet with the\nfile's prompt, so the worker calls AGL with a verified identity; a background job continues as a copy under a new\nsession id. The adopt refuses while the session still runs: its owner stops it first, the adopt never does.\n--rebind requires --ticket and --reason. It moves the existing Claude worker NAME (same ticket, cwd and profile) onto\nthe settled background job ID of its lane, records the resolver and a ticket comment, and sends and resumes nothing;\nthe next steer wakes ID with its saved options. A fresh inventory must list ID settled (reaped or stopped) and the\nworker's own session settled or not at all; ID's transcript must hold the newest record of the worker's (a copy\nClaude Code started), or else the inventory must list ID under the worker's name and cwd. It refuses an unresolved or\nlost dispatch, a reconfirmation without its saved comment, a running job, a predecessor/successor link and a session\nany worker is bound to. Repeating it only synchronizes the comment. Codex workers are not re-bound.\nClaude receipts prove queued delivery, not consumption. Unknown dispatches are never retried automatically.\nresolve-lost requires --ticket and a reason. It proves Claude absence, records the resolver and ticket comment,\nand sends nothing. A live fence holder or running job refuses; lost workers allow stop/archive and are no longer polled.\nFor an unidentified start, other registered workers' native UUIDs (all owners, archived included) are excluded.\nA same-name/cwd session still refuses. An unexcluded candidate is named by session id, name, cwd and startedAt.\nreconfirm requires --ticket and a reason. It clears a steer fence whose native session a fresh inventory shows as the\nsame session, settled before and after its transcript is read, and records from the transcript whether the message\narrived (delivered, not-found or unproven) with the resolver and a ticket comment. It sends nothing; steer again to resend.\n";
|
|
3
|
+
export declare const fleetWorkerCliHelp = "Usage: agl fleet worker start NAME --profile ID --cwd PATH --prompt-file FILE\n agl fleet worker adopt NAME --profile ID --cwd PATH --native-id ID [--relaunch-file FILE]\n agl fleet worker adopt NAME --profile ID --cwd PATH --native-id ID --rebind --reason TEXT\n agl fleet worker resolve-lost NAME --reason TEXT\n agl fleet worker reconfirm NAME --reason TEXT\n agl fleet worker steer NAME --message-file FILE\n agl fleet worker steer --messages-file FILE (JSON array of {name,text})\n agl fleet worker message NAME|NATIVE_ID --message-file FILE [--ticket KEY]\n agl fleet worker native-message NATIVE_ID --message-file FILE --sender LABEL\n agl fleet worker report|stop|archive NAME\n agl fleet worker refresh NAME --next-name NAME [--profile ID] --handoff-file FILE [--note-file FILE]\n agl fleet worker move NAME --next-name NAME --profile CODEX_PROFILE --handoff-file FILE [--note-file FILE]\n agl fleet worker list [--archived]\n agl fleet worker status JOB_ID\n agl fleet watch [--cursor JSON] [--once] [--lines] [--site NAME=URL \u2026] [--ci OWNER/REPO[@REF] \u2026]\n [--gitea URL] [--gitea-token-file FILE] [--probe-interval SECONDS]\nAll accept --ticket KEY, --json and --port PORT. Actions and report require --ticket, except message; list/status/watch accept it as a filter.\nProfiles live in fleet.workerProfiles in the Configuration master.\nMutation and report commands wait for the returned job; MCP tools return its handle immediately.\nrefresh --profile ID starts the successor on that configured profile, which must run the worker's own harness (only move\nchanges the harness); without --profile the successor keeps the worker's recorded profile.\nWatch emits one JSON object per poll with events and the continuation cursor. Ctrl-C disconnects observation only.\nWatch runs until stopped in ten-minute windows, each under a fresh owner capability, so a pending upgrade waits at most one window.\nA failed window writes a {\"disconnected\":\u2026} line and retries from the cursor; after a restart the next page has reset: true.\n--lines writes one plain line per event or change instead, nothing for an empty page or a host load sample.\n--site probes NAME's URL with a GET and --ci follows a Gitea repository's combined commit status on REF (default main)\nevery --probe-interval seconds (default 60); each writes its state first and then one {\"change\":\u2026} line per change.\n--gitea defaults to https://code.foss.global; a token from --gitea-token-file reaches private repositories over https.\nSteer and message reach a live worker through a relay and resume a reaped or stopped one with its saved options.\nMessage addresses one worker by its name or by its native session id (a unique prefix of at least 8 characters).\nWithout --ticket it steers the worker on its own ticket; a --ticket the worker is not on, and a worker on no ticket, are refused.\nnative-message wakes a settled (done, blocked or stopped) Claude Code background job that no fleet worker binds, named by\nits session id or a unique prefix of at least 8 characters, through Claude Code itself, as the browser's native session\nsend does. The text arrives behind the session_message attribution header with the --sender label and the local owner\ncapability, never as the job's user. A running, failed or held job, a fleet worker's session and a project conversation\nare refused with their reason. A native wake holds no dispatch fence, writes no ticket comment and does not observe the\nwoken turn; the receipt names the command that adopts the job. It takes no --ticket.\nAdopt registers a native session as it is. --relaunch-file resumes a settled Claude Code session under the fleet with the\nfile's prompt, so the worker calls AGL with a verified identity; a background job continues as a copy under a new\nsession id. The adopt refuses while the session still runs: its owner stops it first, the adopt never does.\n--rebind requires --ticket and --reason. It moves the existing Claude worker NAME (same ticket, cwd and profile) onto\nthe settled background job ID of its lane, records the resolver and a ticket comment, and sends and resumes nothing;\nthe next steer wakes ID with its saved options. A fresh inventory must list ID settled (reaped or stopped) and the\nworker's own session settled or not at all; ID's transcript must hold the newest record of the worker's (a copy\nClaude Code started), or else the inventory must list ID under the worker's name and cwd. It refuses an unresolved or\nlost dispatch, a reconfirmation without its saved comment, a running job, a predecessor/successor link and a session\nany worker is bound to. Repeating it only synchronizes the comment. Codex workers are not re-bound.\nClaude receipts prove queued delivery, not consumption. Unknown dispatches are never retried automatically.\nresolve-lost requires --ticket and a reason. It proves Claude absence, records the resolver and ticket comment,\nand sends nothing. A live fence holder or running job refuses; lost workers allow stop/archive and are no longer polled.\nFor an unidentified start, other registered workers' native UUIDs (all owners, archived included) are excluded.\nA same-name/cwd session still refuses. An unexcluded candidate is named by session id, name, cwd and startedAt.\nreconfirm requires --ticket and a reason. It clears a steer fence whose native session a fresh inventory shows as the\nsame session, settled before and after its transcript is read, and records from the transcript whether the message\narrived (delivered, not-found or unproven) with the resolver and a ticket comment. It sends nothing; steer again to resend.\n";
|
|
4
|
+
/** A `message` steer before its recipient is resolved: without --ticket it names no ticket yet. */
|
|
5
|
+
export type TFleetWorkerCliMessageRequest = Omit<TFleetWorkerRequest<'steer'>, 'ticketKey'> & {
|
|
6
|
+
ticketKey?: string;
|
|
7
|
+
};
|
|
4
8
|
export interface IFleetWorkerCliArguments {
|
|
5
9
|
action: TFleetWorkerAction;
|
|
6
|
-
request: TFleetWorkerRequest<TFleetWorkerAction
|
|
10
|
+
request: TFleetWorkerRequest<TFleetWorkerAction> | TFleetWorkerCliMessageRequest;
|
|
7
11
|
port: number;
|
|
8
12
|
json: boolean;
|
|
9
13
|
once: boolean;
|
|
10
|
-
/**
|
|
14
|
+
/**
|
|
15
|
+
* `message`: the steer recipient is a worker name or native session id the controller's worker list resolves;
|
|
16
|
+
* `fleetWorkerMessageRequest` then addresses it and names its ticket.
|
|
17
|
+
*/
|
|
11
18
|
target?: string;
|
|
12
19
|
/** `message`: the file the message came from, which a refusal's native-message command names. */
|
|
13
20
|
messageFile?: string;
|
|
@@ -22,6 +29,12 @@ export interface IFleetWorkerCliArguments {
|
|
|
22
29
|
* command that wakes a settled Claude Code background job with the same file.
|
|
23
30
|
*/
|
|
24
31
|
export declare const resolveFleetWorkerTarget: (workers: IFleetWorker[], target: string, messageFile?: string) => IFleetWorker;
|
|
32
|
+
/**
|
|
33
|
+
* The steer `message` sends once its recipient resolved to `worker` (AGL-919): addressed by the worker's name, on the
|
|
34
|
+
* ticket --ticket named or else on the worker's own. A --ticket the worker is not on and a worker on no ticket are
|
|
35
|
+
* refused before anything is sent; the fleet still checks the ticket when it takes the steer.
|
|
36
|
+
*/
|
|
37
|
+
export declare const fleetWorkerMessageRequest: (request: TFleetWorkerCliMessageRequest, worker: IFleetWorker) => TFleetWorkerRequest<'steer'>;
|
|
25
38
|
export declare const parseFleetWorkerCliArguments: (args: string[]) => Promise<IFleetWorkerCliArguments>;
|
|
26
39
|
/** The line a continuing watch writes for each failed attempt to reach the controller. */
|
|
27
40
|
export interface IFleetWatchDisconnection {
|