agl 43.10.2 → 43.12.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 +22 -0
- package/dist_serve/bundle.js +2 -2
- package/dist_serve/bundle.js.map +2 -2
- package/dist_ts/00_commitinfo_data.js +1 -1
- package/dist_ts/classes.apnsclient.d.ts +5 -3
- package/dist_ts/classes.apnsclient.js +10 -5
- package/dist_ts/classes.controller.js +11 -4
- package/dist_ts/classes.controllerdevices.d.ts +4 -3
- package/dist_ts/classes.controllerdevices.js +3 -2
- package/dist_ts/classes.controllerpush.d.ts +6 -1
- package/dist_ts/classes.controllerpush.js +25 -2
- package/dist_ts/classes.fcmclient.d.ts +2 -1
- package/dist_ts/classes.fcmclient.js +3 -2
- package/dist_ts/classes.pushregistrations.d.ts +13 -3
- package/dist_ts/classes.pushregistrations.js +56 -27
- package/dist_ts/fleet/classes.deploymonitor.d.ts +7 -8
- package/dist_ts/fleet/classes.deploymonitor.js +16 -14
- package/dist_ts/fleet/classes.releasereconciler.d.ts +2 -1
- package/dist_ts/fleet/classes.releasereconciler.js +3 -2
- package/dist_ts/fleet/classes.runtime.js +9 -5
- package/dist_ts/fleet/classes.service.d.ts +12 -2
- package/dist_ts/fleet/classes.service.js +55 -17
- package/dist_ts/fleet/functions.discovery.d.ts +11 -2
- package/dist_ts/fleet/functions.discovery.js +55 -12
- package/dist_ts/fleet/functions.rebase.js +5 -2
- package/dist_ts/fleet/functions.toolchain.d.ts +20 -0
- package/dist_ts/fleet/functions.toolchain.js +50 -0
- package/dist_ts/fleet/functions.validation.d.ts +2 -0
- package/dist_ts/fleet/functions.validation.js +11 -3
- package/dist_ts/functions.mcpfleettools.js +2 -2
- package/dist_ts_interfaces/devices.d.ts +31 -8
- package/dist_ts_interfaces/devices.js +2 -2
- package/dist_ts_interfaces/fleet.d.ts +23 -0
- package/package.json +1 -1
- package/readme.md +26 -6
- package/ts/00_commitinfo_data.ts +1 -1
- package/ts/classes.apnsclient.ts +9 -4
- package/ts/classes.controller.ts +9 -3
- package/ts/classes.controllerdevices.ts +4 -2
- package/ts/classes.controllerpush.ts +31 -1
- package/ts/classes.fcmclient.ts +2 -1
- package/ts/classes.pushregistrations.ts +56 -24
- package/ts/fleet/classes.deploymonitor.ts +19 -16
- package/ts/fleet/classes.releasereconciler.ts +2 -1
- package/ts/fleet/classes.runtime.ts +8 -4
- package/ts/fleet/classes.service.ts +50 -17
- package/ts/fleet/functions.discovery.ts +54 -12
- package/ts/fleet/functions.rebase.ts +4 -1
- package/ts/fleet/functions.toolchain.ts +56 -0
- package/ts/fleet/functions.validation.ts +7 -2
- package/ts/functions.mcpfleettools.ts +1 -1
- package/ts_interfaces/devices.schema.json +25 -4
- package/ts_interfaces/devices.ts +32 -8
- package/ts_interfaces/fleet.ts +15 -0
- package/ts_web/00_commitinfo_data.ts +1 -1
package/ts_interfaces/devices.ts
CHANGED
|
@@ -17,7 +17,7 @@
|
|
|
17
17
|
import type { ITypedRequest, implementsTR } from '@api.global/typedrequest-interfaces';
|
|
18
18
|
|
|
19
19
|
/** The device protocol this controller speaks. */
|
|
20
|
-
export const deviceProtocolVersion = { major: 1, minor:
|
|
20
|
+
export const deviceProtocolVersion = { major: 1, minor: 5 } as const;
|
|
21
21
|
|
|
22
22
|
/** The scheme of a pairing payload: `agl-pair:?origin=<https origin>&controller=<controller id>&code=<base64url>`. */
|
|
23
23
|
export const devicePairingScheme = 'agl-pair' as const;
|
|
@@ -883,10 +883,18 @@ export const devicePushReportSentence = 'A direct report has a new result.';
|
|
|
883
883
|
/** The text of the owner's test notification. Since protocol 1.4. */
|
|
884
884
|
export const devicePushTestSentence = 'Push from AGL works.';
|
|
885
885
|
|
|
886
|
+
/**
|
|
887
|
+
* The buttons a notification offers, for an item a device answers from the notification itself. `permission`: Allow
|
|
888
|
+
* once (`device.permission.reply` with `reply: 'once'`), Reject (`reply: 'reject'`) and Open, which opens the item in
|
|
889
|
+
* the app. On iOS it is also the notification's category (`aps.category`). Since protocol 1.5.
|
|
890
|
+
*/
|
|
891
|
+
export type TDevicePushActions = 'permission';
|
|
892
|
+
|
|
886
893
|
/**
|
|
887
894
|
* One Inbox item that came: an alert (iOS: thread `inbox`, interruption level `active`; Android: channel Inbox). With
|
|
888
895
|
* previews off it says only the kind's fixed sentence; with previews on also where the item lives, what it asks and
|
|
889
|
-
* its id
|
|
896
|
+
* its id, and for a permission the device can answer (`device.inbox.list` names its answer `session` or `child`) the
|
|
897
|
+
* buttons and the ids their reply names. Tapping it opens the Inbox. Since protocol 1.4.
|
|
890
898
|
*/
|
|
891
899
|
export interface IDevicePushInboxData {
|
|
892
900
|
type: 'inbox';
|
|
@@ -906,6 +914,18 @@ export interface IDevicePushInboxData {
|
|
|
906
914
|
title?: string;
|
|
907
915
|
/** Previews on only: the item's id, as `device.inbox.list` names it. */
|
|
908
916
|
itemId?: string;
|
|
917
|
+
/**
|
|
918
|
+
* Previews on only, and only for an item the device answers from the notification: the buttons it offers. Set
|
|
919
|
+
* together with `sessionId` and `permissionId` (and `childSessionId` for a direct child's permission), never alone.
|
|
920
|
+
* Since protocol 1.5.
|
|
921
|
+
*/
|
|
922
|
+
actions?: TDevicePushActions;
|
|
923
|
+
/** With `actions`: `device.permission.reply`'s `sessionId`. Since protocol 1.5. */
|
|
924
|
+
sessionId?: string;
|
|
925
|
+
/** With `actions`, only for a direct child's permission: `device.permission.reply`'s `childSessionId`. Since protocol 1.5. */
|
|
926
|
+
childSessionId?: string;
|
|
927
|
+
/** With `actions`: `device.permission.reply`'s `permissionId`. Since protocol 1.5. */
|
|
928
|
+
permissionId?: string;
|
|
909
929
|
}
|
|
910
930
|
|
|
911
931
|
/**
|
|
@@ -927,7 +947,7 @@ export interface IDevicePushSummaryData {
|
|
|
927
947
|
/**
|
|
928
948
|
* A direct report's new `result:` line, sent only to a registration with `reports` (iOS: thread `reports`,
|
|
929
949
|
* interruption level `passive`; Android: channel Reports, low importance). It leaves the badge alone: a result waits
|
|
930
|
-
* for nobody. Since protocol 1.4.
|
|
950
|
+
* for nobody. Tapping it opens the Driver tab, where the direct reports are. Since protocol 1.4.
|
|
931
951
|
*/
|
|
932
952
|
export interface IDevicePushReportData {
|
|
933
953
|
type: 'report';
|
|
@@ -969,9 +989,11 @@ export interface IDevicePushClearData {
|
|
|
969
989
|
* What a notification from the host carries, the same for both platforms, each value a string because FCM data carries
|
|
970
990
|
* only strings: FCM sends it as a data-only message's `data` (the Android app builds the notification itself), APNs as
|
|
971
991
|
* the payload's `agl` object beside `aps` (an alert push for `inbox`, `summary`, `report` and `test`, a background push
|
|
972
|
-
* for `clear`). No notification carries a session's or a ticket's id with previews off.
|
|
973
|
-
*
|
|
974
|
-
*
|
|
992
|
+
* for `clear`). No notification carries a session's or a ticket's id with previews off. An inbox notification with
|
|
993
|
+
* `actions` names its category on iOS (`aps.category`); an app that registers no category of that name shows it without
|
|
994
|
+
* buttons. A later minor may add keys and types: an app ignores keys it does not know, and a notification whose `type`
|
|
995
|
+
* it does not know, except an iOS alert push, which the system presents from `aps` without running the app. Since
|
|
996
|
+
* protocol 1.4.
|
|
975
997
|
*/
|
|
976
998
|
export type TDevicePushData =
|
|
977
999
|
| IDevicePushInboxData
|
|
@@ -1665,8 +1687,10 @@ export interface IReq_DeviceHostGet extends implementsTR<ITypedRequest, IReq_Dev
|
|
|
1665
1687
|
/**
|
|
1666
1688
|
* Registers this device for notifications of what comes into the Inbox, and with `reports` of the direct reports'
|
|
1667
1689
|
* results too: one registration per device, which the next one replaces, so an app registers again with its current
|
|
1668
|
-
* token on every connect.
|
|
1669
|
-
*
|
|
1690
|
+
* token on every connect. A token is one device's: the registration of any other device holding the same platform's
|
|
1691
|
+
* token (the same app, paired before) ends with it. Taken also while the host holds no credential to send with (the
|
|
1692
|
+
* answer's `available` says so). The token stays on the host: no answer, event or log repeats it. Scope `device`.
|
|
1693
|
+
* Since protocol 1.4.
|
|
1670
1694
|
*/
|
|
1671
1695
|
export interface IReq_DevicePushRegister extends implementsTR<ITypedRequest, IReq_DevicePushRegister> {
|
|
1672
1696
|
method: 'device.push.register';
|
package/ts_interfaces/fleet.ts
CHANGED
|
@@ -79,6 +79,8 @@ export interface IFleetConfiguration {
|
|
|
79
79
|
export interface IFleetScope extends IFleetConfiguration {
|
|
80
80
|
repositories: IFleetRepository[];
|
|
81
81
|
skipped?: IFleetDiscoverySkip[];
|
|
82
|
+
/** The canonical checkouts discovery found that declare neither a release nor a fleet section, by real path. */
|
|
83
|
+
unconfigured?: string[];
|
|
82
84
|
}
|
|
83
85
|
export type TFleetOperation = 'land' | 'release' | 'tooling' | 'audit' | 'reconcile';
|
|
84
86
|
export interface IFleetLandRequest { repo: string; branch: string; ticketKey: string; tests?: string[] }
|
|
@@ -158,10 +160,23 @@ export interface IFleetUnboundDriver {
|
|
|
158
160
|
*/
|
|
159
161
|
nativeMessage?: string;
|
|
160
162
|
}
|
|
163
|
+
/** A discovered repository the audit could not read; the audit goes on with the others. */
|
|
164
|
+
export interface IFleetUnauditedRepository { repo: string; path: string; reason: string }
|
|
165
|
+
/**
|
|
166
|
+
* A landed ticket whose branch or commit link names a repository fleet discovery did not admit, so no release of it
|
|
167
|
+
* releases the ticket from there: `repo` is the name as the link holds it, `reason` why discovery did not admit it.
|
|
168
|
+
*/
|
|
169
|
+
export interface IFleetLandedOutsideFleet { ticketKey: string; repo: string; reason: string }
|
|
161
170
|
export interface IFleetAuditResult {
|
|
162
171
|
operation: 'audit'; entries: IFleetAuditEntry[]; removed: string[];
|
|
163
172
|
/** The audited repositories with the source of each setting, and the checkouts discovery did not admit. */
|
|
164
173
|
repositories?: IFleetRepository[]; skipped?: IFleetDiscoverySkip[];
|
|
174
|
+
/** The repositories whose audit failed, each with its reason. */
|
|
175
|
+
unaudited?: IFleetUnauditedRepository[];
|
|
176
|
+
/** The landed tickets whose code links name a repository outside the fleet, each with why. */
|
|
177
|
+
landedOutsideFleet?: IFleetLandedOutsideFleet[];
|
|
178
|
+
/** Why the board could not be read for `landedOutsideFleet`. */
|
|
179
|
+
landedOutsideFleetError?: string;
|
|
165
180
|
/** Claude Code background jobs that look like drivers and that no worker binds. */
|
|
166
181
|
unboundDrivers?: IFleetUnboundDriver[];
|
|
167
182
|
/** The Claude Code inventories the unbound driver search could not read, each with its reason. */
|