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.
Files changed (55) hide show
  1. package/changelog.md +22 -0
  2. package/dist_serve/bundle.js +2 -2
  3. package/dist_serve/bundle.js.map +2 -2
  4. package/dist_ts/00_commitinfo_data.js +1 -1
  5. package/dist_ts/classes.apnsclient.d.ts +5 -3
  6. package/dist_ts/classes.apnsclient.js +10 -5
  7. package/dist_ts/classes.controller.js +11 -4
  8. package/dist_ts/classes.controllerdevices.d.ts +4 -3
  9. package/dist_ts/classes.controllerdevices.js +3 -2
  10. package/dist_ts/classes.controllerpush.d.ts +6 -1
  11. package/dist_ts/classes.controllerpush.js +25 -2
  12. package/dist_ts/classes.fcmclient.d.ts +2 -1
  13. package/dist_ts/classes.fcmclient.js +3 -2
  14. package/dist_ts/classes.pushregistrations.d.ts +13 -3
  15. package/dist_ts/classes.pushregistrations.js +56 -27
  16. package/dist_ts/fleet/classes.deploymonitor.d.ts +7 -8
  17. package/dist_ts/fleet/classes.deploymonitor.js +16 -14
  18. package/dist_ts/fleet/classes.releasereconciler.d.ts +2 -1
  19. package/dist_ts/fleet/classes.releasereconciler.js +3 -2
  20. package/dist_ts/fleet/classes.runtime.js +9 -5
  21. package/dist_ts/fleet/classes.service.d.ts +12 -2
  22. package/dist_ts/fleet/classes.service.js +55 -17
  23. package/dist_ts/fleet/functions.discovery.d.ts +11 -2
  24. package/dist_ts/fleet/functions.discovery.js +55 -12
  25. package/dist_ts/fleet/functions.rebase.js +5 -2
  26. package/dist_ts/fleet/functions.toolchain.d.ts +20 -0
  27. package/dist_ts/fleet/functions.toolchain.js +50 -0
  28. package/dist_ts/fleet/functions.validation.d.ts +2 -0
  29. package/dist_ts/fleet/functions.validation.js +11 -3
  30. package/dist_ts/functions.mcpfleettools.js +2 -2
  31. package/dist_ts_interfaces/devices.d.ts +31 -8
  32. package/dist_ts_interfaces/devices.js +2 -2
  33. package/dist_ts_interfaces/fleet.d.ts +23 -0
  34. package/package.json +1 -1
  35. package/readme.md +26 -6
  36. package/ts/00_commitinfo_data.ts +1 -1
  37. package/ts/classes.apnsclient.ts +9 -4
  38. package/ts/classes.controller.ts +9 -3
  39. package/ts/classes.controllerdevices.ts +4 -2
  40. package/ts/classes.controllerpush.ts +31 -1
  41. package/ts/classes.fcmclient.ts +2 -1
  42. package/ts/classes.pushregistrations.ts +56 -24
  43. package/ts/fleet/classes.deploymonitor.ts +19 -16
  44. package/ts/fleet/classes.releasereconciler.ts +2 -1
  45. package/ts/fleet/classes.runtime.ts +8 -4
  46. package/ts/fleet/classes.service.ts +50 -17
  47. package/ts/fleet/functions.discovery.ts +54 -12
  48. package/ts/fleet/functions.rebase.ts +4 -1
  49. package/ts/fleet/functions.toolchain.ts +56 -0
  50. package/ts/fleet/functions.validation.ts +7 -2
  51. package/ts/functions.mcpfleettools.ts +1 -1
  52. package/ts_interfaces/devices.schema.json +25 -4
  53. package/ts_interfaces/devices.ts +32 -8
  54. package/ts_interfaces/fleet.ts +15 -0
  55. package/ts_web/00_commitinfo_data.ts +1 -1
@@ -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: 4 } as const;
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. Tapping it opens the Inbox. Since protocol 1.4.
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. A later minor may add keys and
973
- * types: an app ignores keys it does not know, and a notification whose `type` it does not know, except an iOS alert
974
- * push, which the system presents from `aps` without running the app. Since protocol 1.4.
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. Taken also while the host holds no credential to send with (the answer's `available` says
1669
- * so). The token stays on the host: no answer, event or log repeats it. Scope `device`. Since protocol 1.4.
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';
@@ -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. */
@@ -3,6 +3,6 @@
3
3
  */
4
4
  export const commitinfo = {
5
5
  name: 'agl',
6
- version: '43.10.2',
6
+ version: '43.12.0',
7
7
  description: 'Agent Gateway Layer for OpenCode, FlexHarness, and Codex sessions'
8
8
  }