agl 43.7.0 → 43.9.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 (143) hide show
  1. package/changelog.md +33 -0
  2. package/dist_serve/bundle.js +871 -858
  3. package/dist_serve/bundle.js.map +2 -2
  4. package/dist_ts/00_commitinfo_data.js +1 -1
  5. package/dist_ts/aglapi/aglapisurface.document.js +824 -6
  6. package/dist_ts/aglapi/interfaces.d.ts +43 -0
  7. package/dist_ts/aglapi/interfaces.js +11 -1
  8. package/dist_ts/classes.apnsclient.d.ts +97 -0
  9. package/dist_ts/classes.apnsclient.js +363 -0
  10. package/dist_ts/classes.authmodels.js +19 -6
  11. package/dist_ts/classes.authstore.js +15 -2
  12. package/dist_ts/classes.cli.js +8 -1
  13. package/dist_ts/classes.controller.d.ts +30 -3
  14. package/dist_ts/classes.controller.js +250 -9
  15. package/dist_ts/classes.controllerdevices.d.ts +35 -7
  16. package/dist_ts/classes.controllerdevices.js +86 -13
  17. package/dist_ts/classes.controllerpush.d.ts +111 -0
  18. package/dist_ts/classes.controllerpush.js +299 -0
  19. package/dist_ts/classes.fcmclient.d.ts +78 -0
  20. package/dist_ts/classes.fcmclient.js +278 -0
  21. package/dist_ts/classes.inbox.d.ts +10 -2
  22. package/dist_ts/classes.inbox.js +9 -2
  23. package/dist_ts/classes.mcpclient.d.ts +5 -0
  24. package/dist_ts/classes.mcpclient.js +20 -8
  25. package/dist_ts/classes.mcpcontrollerhost.d.ts +3 -0
  26. package/dist_ts/classes.mcpcontrollerhost.js +21 -2
  27. package/dist_ts/classes.mcptools.d.ts +1 -1
  28. package/dist_ts/classes.mcptools.js +2 -1
  29. package/dist_ts/classes.mcpvalidation.js +4 -1
  30. package/dist_ts/classes.mcpworkercaller.d.ts +6 -0
  31. package/dist_ts/classes.mcpworkercaller.js +26 -4
  32. package/dist_ts/classes.pushdelivery.d.ts +115 -0
  33. package/dist_ts/classes.pushdelivery.js +311 -0
  34. package/dist_ts/classes.pushhandover.d.ts +46 -0
  35. package/dist_ts/classes.pushhandover.js +131 -0
  36. package/dist_ts/classes.pushregistrations.d.ts +96 -0
  37. package/dist_ts/classes.pushregistrations.js +263 -0
  38. package/dist_ts/classes.pushsettings.d.ts +125 -0
  39. package/dist_ts/classes.pushsettings.js +377 -0
  40. package/dist_ts/classes.ticketstore.d.ts +3 -3
  41. package/dist_ts/classes.ticketstore.js +23 -4
  42. package/dist_ts/classes.workercallers.d.ts +73 -2
  43. package/dist_ts/classes.workercallers.js +354 -43
  44. package/dist_ts/driver/classes.directreports.d.ts +5 -0
  45. package/dist_ts/driver/classes.directreports.js +3 -2
  46. package/dist_ts/fleet/classes.workerlaunches.d.ts +6 -4
  47. package/dist_ts/fleet/classes.workerlaunches.js +10 -9
  48. package/dist_ts/fleet/classes.workers.d.ts +12 -2
  49. package/dist_ts/fleet/classes.workers.js +82 -2
  50. package/dist_ts/functions.deviceapi.d.ts +23 -3
  51. package/dist_ts/functions.deviceapi.js +43 -3
  52. package/dist_ts/functions.mcptickettools.d.ts +60 -0
  53. package/dist_ts/functions.mcptickettools.js +4 -3
  54. package/dist_ts/functions.pushcli.d.ts +43 -0
  55. package/dist_ts/functions.pushcli.js +201 -0
  56. package/dist_ts/functions.pushcredentials.d.ts +53 -0
  57. package/dist_ts/functions.pushcredentials.js +111 -0
  58. package/dist_ts/functions.pushwire.d.ts +8 -0
  59. package/dist_ts/functions.pushwire.js +83 -0
  60. package/dist_ts/functions.remotecli.d.ts +2 -2
  61. package/dist_ts/functions.remotecli.js +4 -4
  62. package/dist_ts/functions.ticketcli.d.ts +4 -2
  63. package/dist_ts/functions.ticketcli.js +70 -4
  64. package/dist_ts/functions.ticketlisting.d.ts +38 -0
  65. package/dist_ts/functions.ticketlisting.js +211 -0
  66. package/dist_ts/functions.ticketvalidation.d.ts +62 -0
  67. package/dist_ts/functions.ticketvalidation.js +41 -3
  68. package/dist_ts/functions.workercallervalidation.js +3 -2
  69. package/dist_ts/functions.workerprocessproof.d.ts +12 -0
  70. package/dist_ts/functions.workerprocessproof.js +32 -1
  71. package/dist_ts/interfaces.auth.d.ts +27 -3
  72. package/dist_ts/interfaces.auth.js +9 -1
  73. package/dist_ts/interfaces.lifecycle.d.ts +7 -1
  74. package/dist_ts/interfaces.push.d.ts +69 -0
  75. package/dist_ts/interfaces.push.js +25 -0
  76. package/dist_ts/plugins.d.ts +3 -1
  77. package/dist_ts/plugins.js +4 -2
  78. package/dist_ts_interfaces/devices.d.ts +178 -2
  79. package/dist_ts_interfaces/devices.js +24 -2
  80. package/dist_ts_interfaces/index.d.ts +1 -0
  81. package/dist_ts_interfaces/index.js +2 -1
  82. package/dist_ts_interfaces/mcprequests.d.ts +3 -2
  83. package/dist_ts_interfaces/mcprequests.js +3 -1
  84. package/dist_ts_interfaces/push.d.ts +166 -0
  85. package/dist_ts_interfaces/push.js +24 -0
  86. package/dist_ts_interfaces/requests.tickets.d.ts +31 -3
  87. package/dist_ts_interfaces/requests.tickets.js +2 -2
  88. package/dist_ts_interfaces/tickets.d.ts +174 -2
  89. package/dist_ts_interfaces/tickets.js +20 -2
  90. package/dist_ts_interfaces/workercallers.d.ts +43 -3
  91. package/package.json +2 -2
  92. package/readme.md +95 -14
  93. package/ts/00_commitinfo_data.ts +1 -1
  94. package/ts/aglapi/aglapisurface.document.ts +823 -5
  95. package/ts/aglapi/interfaces.ts +10 -0
  96. package/ts/classes.apnsclient.ts +389 -0
  97. package/ts/classes.authmodels.ts +21 -5
  98. package/ts/classes.authstore.ts +14 -1
  99. package/ts/classes.cli.ts +7 -0
  100. package/ts/classes.controller.ts +273 -7
  101. package/ts/classes.controllerdevices.ts +94 -12
  102. package/ts/classes.controllerpush.ts +351 -0
  103. package/ts/classes.fcmclient.ts +292 -0
  104. package/ts/classes.inbox.ts +13 -2
  105. package/ts/classes.mcpclient.ts +22 -7
  106. package/ts/classes.mcpcontrollerhost.ts +22 -1
  107. package/ts/classes.mcptools.ts +1 -0
  108. package/ts/classes.mcpvalidation.ts +2 -0
  109. package/ts/classes.mcpworkercaller.ts +24 -2
  110. package/ts/classes.pushdelivery.ts +378 -0
  111. package/ts/classes.pushhandover.ts +98 -0
  112. package/ts/classes.pushregistrations.ts +244 -0
  113. package/ts/classes.pushsettings.ts +428 -0
  114. package/ts/classes.ticketstore.ts +21 -3
  115. package/ts/classes.workercallers.ts +329 -37
  116. package/ts/driver/classes.directreports.ts +7 -1
  117. package/ts/fleet/classes.workerlaunches.ts +9 -7
  118. package/ts/fleet/classes.workers.ts +65 -2
  119. package/ts/functions.deviceapi.ts +54 -2
  120. package/ts/functions.mcptickettools.ts +3 -2
  121. package/ts/functions.pushcli.ts +212 -0
  122. package/ts/functions.pushcredentials.ts +129 -0
  123. package/ts/functions.pushwire.ts +106 -0
  124. package/ts/functions.remotecli.ts +3 -2
  125. package/ts/functions.ticketcli.ts +70 -5
  126. package/ts/functions.ticketlisting.ts +214 -0
  127. package/ts/functions.ticketvalidation.ts +41 -2
  128. package/ts/functions.workercallervalidation.ts +2 -1
  129. package/ts/functions.workerprocessproof.ts +34 -0
  130. package/ts/interfaces.auth.ts +26 -3
  131. package/ts/interfaces.lifecycle.ts +7 -1
  132. package/ts/interfaces.push.ts +78 -0
  133. package/ts/plugins.ts +3 -1
  134. package/ts_interfaces/devices.schema.json +327 -0
  135. package/ts_interfaces/devices.ts +206 -1
  136. package/ts_interfaces/index.ts +1 -0
  137. package/ts_interfaces/mcprequests.ts +3 -0
  138. package/ts_interfaces/push.ts +162 -0
  139. package/ts_interfaces/requests.tickets.ts +32 -2
  140. package/ts_interfaces/tickets.ts +136 -3
  141. package/ts_interfaces/workercallers.ts +34 -2
  142. package/ts_web/00_commitinfo_data.ts +1 -1
  143. package/ts_web/elements.inbox.ts +50 -9
@@ -1622,6 +1622,136 @@ export const AGL_API_SURFACE: plugins.flexTypedRequest.IFlexTypedRequestSurface
1622
1622
  },
1623
1623
  "declaration": "/**\n * Moves or reorders a ticket assigned to the caller atomically: before `beforeTicketId`, or last\n * without it. Answers every ticket whose column or order changed. Review needs a linked branch with\n * its full sha; needs_input reports a blocker.\n */\nfunction agl_mcp_ticket_move(params: ITicketMove): Promise<{ tickets: ITicket[] }>;"
1624
1624
  },
1625
+ {
1626
+ "method": "agl.mcp.ticket.overview",
1627
+ "path": "agl.agl_mcp_ticket_overview",
1628
+ "summary": "Reads the board at a glance without any ticket's texts: counts by column, priority, AutoLabel, project and assignee, ea…",
1629
+ "description": "Reads the board at a glance without any ticket's texts: counts by column, priority, AutoLabel, project and\nassignee, each open epic's progress, the tickets that need someone (urgent, needs input, open questions,\nreview, ready without an assignee, stale) and the tickets changed last. Lists hold at most `limit` tickets and\ncarry the count of all they stand for.",
1630
+ "omitted": [
1631
+ "ownerToken"
1632
+ ],
1633
+ "inputSchema": {
1634
+ "type": "object",
1635
+ "additionalProperties": false,
1636
+ "properties": {
1637
+ "project": {
1638
+ "type": "string",
1639
+ "description": "Only this project's tickets."
1640
+ },
1641
+ "mine": {
1642
+ "type": "boolean",
1643
+ "description": "Only the tickets assigned to the caller's verified session."
1644
+ },
1645
+ "limit": {
1646
+ "type": "number",
1647
+ "description": "Tickets per list, 1 to 50; 5 when absent."
1648
+ },
1649
+ "staleDays": {
1650
+ "type": "number",
1651
+ "description": "Days without a change after which in_progress, needs_input and review work counts as stale, 1 to 365; 3 when absent."
1652
+ }
1653
+ }
1654
+ },
1655
+ "outputSchema": {
1656
+ "$ref": "#/$defs/ITicketOverview"
1657
+ },
1658
+ "declaration": "/**\n * Reads the board at a glance without any ticket's texts: counts by column, priority, AutoLabel, project and\n * assignee, each open epic's progress, the tickets that need someone (urgent, needs input, open questions,\n * review, ready without an assignee, stale) and the tickets changed last. Lists hold at most `limit` tickets and\n * carry the count of all they stand for.\n */\nfunction agl_mcp_ticket_overview(params?: ITicketOverviewRequest): Promise<ITicketOverview>;"
1659
+ },
1660
+ {
1661
+ "method": "agl.mcp.ticket.page",
1662
+ "path": "agl.agl_mcp_ticket_page",
1663
+ "summary": "Lists the board in pages of `limit` tickets (1 to 200, default 50, within 256 KiB), as summaries without description an…",
1664
+ "description": "Lists the board in pages of `limit` tickets (1 to 200, default 50, within 256 KiB), as summaries without\ndescription and source words unless `view` is `full`. Beyond the filters of the whole listing it narrows by\n`statuses`, `open`, `kind`, `priorities`, `parent` (direct children), `assignee` (a person or session id),\n`unassigned`, `keys` and `updatedSince`, and sorts by `board`, `updated`, `created` or `priority`. `total` and\n`columns` count everything the filters match. `nextCursor` continues with the same filters, sort and view;\n`moved` tells that the board changed since the first page.",
1665
+ "omitted": [
1666
+ "ownerToken"
1667
+ ],
1668
+ "inputSchema": {
1669
+ "type": "object",
1670
+ "additionalProperties": false,
1671
+ "properties": {
1672
+ "mine": {
1673
+ "type": "boolean"
1674
+ },
1675
+ "project": {
1676
+ "type": "string"
1677
+ },
1678
+ "status": {
1679
+ "$ref": "#/$defs/TTicketColumn"
1680
+ },
1681
+ "label": {
1682
+ "type": "string",
1683
+ "description": "Matches a hand label or an AutoLabel."
1684
+ },
1685
+ "text": {
1686
+ "type": "string"
1687
+ },
1688
+ "statuses": {
1689
+ "type": "array",
1690
+ "items": {
1691
+ "$ref": "#/$defs/TTicketColumn"
1692
+ }
1693
+ },
1694
+ "open": {
1695
+ "type": "boolean"
1696
+ },
1697
+ "kind": {
1698
+ "$ref": "#/$defs/TTicketKind"
1699
+ },
1700
+ "priorities": {
1701
+ "type": "array",
1702
+ "items": {
1703
+ "$ref": "#/$defs/TTicketPriority"
1704
+ }
1705
+ },
1706
+ "parent": {
1707
+ "type": "string",
1708
+ "description": "A ticket key: its direct children, as the board's epic filter matches them."
1709
+ },
1710
+ "assignee": {
1711
+ "type": "string",
1712
+ "description": "A person id or a session id (`harness:nativeId`), as a ticket's assignee holds them; never a display name."
1713
+ },
1714
+ "unassigned": {
1715
+ "type": "boolean"
1716
+ },
1717
+ "keys": {
1718
+ "type": "array",
1719
+ "items": {
1720
+ "type": "string"
1721
+ },
1722
+ "description": "Up to 200 keys: reads those tickets in one call."
1723
+ },
1724
+ "updatedSince": {
1725
+ "type": "string",
1726
+ "description": "An ISO 8601 instant: tickets changed at or after it."
1727
+ },
1728
+ "sort": {
1729
+ "$ref": "#/$defs/TTicketPageSort",
1730
+ "description": "`board` when absent."
1731
+ },
1732
+ "view": {
1733
+ "type": "string",
1734
+ "enum": [
1735
+ "summary",
1736
+ "full"
1737
+ ],
1738
+ "description": "`summary` (a ticket without its texts) when absent; `full` returns whole tickets."
1739
+ },
1740
+ "limit": {
1741
+ "type": "number",
1742
+ "description": "Tickets on the page, 1 to 200 (`ticketListPage.maximum`); 50 when absent."
1743
+ },
1744
+ "cursor": {
1745
+ "type": "string",
1746
+ "description": "A page's `nextCursor`, with the same filters, sort and view."
1747
+ }
1748
+ }
1749
+ },
1750
+ "outputSchema": {
1751
+ "$ref": "#/$defs/TTicketPage"
1752
+ },
1753
+ "declaration": "/**\n * Lists the board in pages of `limit` tickets (1 to 200, default 50, within 256 KiB), as summaries without\n * description and source words unless `view` is `full`. Beyond the filters of the whole listing it narrows by\n * `statuses`, `open`, `kind`, `priorities`, `parent` (direct children), `assignee` (a person or session id),\n * `unassigned`, `keys` and `updatedSince`, and sorts by `board`, `updated`, `created` or `priority`. `total` and\n * `columns` count everything the filters match. `nextCursor` continues with the same filters, sort and view;\n * `moved` tells that the board changed since the first page.\n */\nfunction agl_mcp_ticket_page(params?: ITicketPageRequest): Promise<TTicketPage>;"
1754
+ },
1625
1755
  {
1626
1756
  "method": "agl.mcp.ticket.search",
1627
1757
  "path": "agl.agl_mcp_ticket_search",
@@ -5732,6 +5862,400 @@ export const AGL_API_SURFACE: plugins.flexTypedRequest.IFlexTypedRequestSurface
5732
5862
  "name": "ITicketMove",
5733
5863
  "declaration": "interface ITicketMove { ticketId: string; columnId: TTicketColumn; beforeTicketId?: string; }"
5734
5864
  },
5865
+ {
5866
+ "name": "ITicketOverview",
5867
+ "schema": {
5868
+ "type": "object",
5869
+ "properties": {
5870
+ "revision": {
5871
+ "type": "number"
5872
+ },
5873
+ "total": {
5874
+ "type": "number"
5875
+ },
5876
+ "open": {
5877
+ "type": "number",
5878
+ "description": "Tickets that are neither released nor closed."
5879
+ },
5880
+ "columns": {
5881
+ "type": "object",
5882
+ "properties": {
5883
+ "backlog": {
5884
+ "type": "number"
5885
+ },
5886
+ "ready": {
5887
+ "type": "number"
5888
+ },
5889
+ "in_progress": {
5890
+ "type": "number"
5891
+ },
5892
+ "needs_input": {
5893
+ "type": "number"
5894
+ },
5895
+ "review": {
5896
+ "type": "number"
5897
+ },
5898
+ "landed": {
5899
+ "type": "number"
5900
+ },
5901
+ "released": {
5902
+ "type": "number"
5903
+ },
5904
+ "closed": {
5905
+ "type": "number"
5906
+ }
5907
+ },
5908
+ "required": [
5909
+ "backlog",
5910
+ "ready",
5911
+ "in_progress",
5912
+ "needs_input",
5913
+ "review",
5914
+ "landed",
5915
+ "released",
5916
+ "closed"
5917
+ ],
5918
+ "additionalProperties": false
5919
+ },
5920
+ "priorities": {
5921
+ "type": "object",
5922
+ "properties": {
5923
+ "urgent": {
5924
+ "type": "number"
5925
+ },
5926
+ "high": {
5927
+ "type": "number"
5928
+ },
5929
+ "normal": {
5930
+ "type": "number"
5931
+ },
5932
+ "low": {
5933
+ "type": "number"
5934
+ },
5935
+ "none": {
5936
+ "type": "number"
5937
+ }
5938
+ },
5939
+ "required": [
5940
+ "urgent",
5941
+ "high",
5942
+ "normal",
5943
+ "low",
5944
+ "none"
5945
+ ],
5946
+ "additionalProperties": false,
5947
+ "description": "Open tickets by priority."
5948
+ },
5949
+ "autoLabels": {
5950
+ "type": "object",
5951
+ "properties": {
5952
+ "openQuestion": {
5953
+ "type": "number"
5954
+ },
5955
+ "planned": {
5956
+ "type": "number"
5957
+ },
5958
+ "undeployed": {
5959
+ "type": "number"
5960
+ }
5961
+ },
5962
+ "required": [
5963
+ "openQuestion",
5964
+ "planned",
5965
+ "undeployed"
5966
+ ],
5967
+ "additionalProperties": false
5968
+ },
5969
+ "projects": {
5970
+ "type": "array",
5971
+ "items": {
5972
+ "type": "object",
5973
+ "properties": {
5974
+ "project": {
5975
+ "type": "string"
5976
+ },
5977
+ "total": {
5978
+ "type": "number"
5979
+ },
5980
+ "open": {
5981
+ "type": "number"
5982
+ },
5983
+ "columns": {
5984
+ "type": "object",
5985
+ "properties": {
5986
+ "backlog": {
5987
+ "type": "number"
5988
+ },
5989
+ "ready": {
5990
+ "type": "number"
5991
+ },
5992
+ "in_progress": {
5993
+ "type": "number"
5994
+ },
5995
+ "needs_input": {
5996
+ "type": "number"
5997
+ },
5998
+ "review": {
5999
+ "type": "number"
6000
+ },
6001
+ "landed": {
6002
+ "type": "number"
6003
+ },
6004
+ "released": {
6005
+ "type": "number"
6006
+ },
6007
+ "closed": {
6008
+ "type": "number"
6009
+ }
6010
+ },
6011
+ "additionalProperties": false
6012
+ }
6013
+ },
6014
+ "required": [
6015
+ "project",
6016
+ "total",
6017
+ "open",
6018
+ "columns"
6019
+ ],
6020
+ "additionalProperties": false
6021
+ },
6022
+ "description": "Most open work first; `projectsTotal` counts all."
6023
+ },
6024
+ "projectsTotal": {
6025
+ "type": "number"
6026
+ },
6027
+ "assignees": {
6028
+ "type": "array",
6029
+ "items": {
6030
+ "type": "object",
6031
+ "additionalProperties": false,
6032
+ "properties": {
6033
+ "open": {
6034
+ "type": "number"
6035
+ },
6036
+ "columns": {
6037
+ "type": "object",
6038
+ "properties": {
6039
+ "backlog": {
6040
+ "type": "number"
6041
+ },
6042
+ "ready": {
6043
+ "type": "number"
6044
+ },
6045
+ "in_progress": {
6046
+ "type": "number"
6047
+ },
6048
+ "needs_input": {
6049
+ "type": "number"
6050
+ },
6051
+ "review": {
6052
+ "type": "number"
6053
+ },
6054
+ "landed": {
6055
+ "type": "number"
6056
+ },
6057
+ "released": {
6058
+ "type": "number"
6059
+ },
6060
+ "closed": {
6061
+ "type": "number"
6062
+ }
6063
+ },
6064
+ "additionalProperties": false
6065
+ },
6066
+ "id": {
6067
+ "type": "string"
6068
+ },
6069
+ "name": {
6070
+ "type": "string"
6071
+ },
6072
+ "sessionId": {
6073
+ "type": "string"
6074
+ }
6075
+ },
6076
+ "required": [
6077
+ "columns",
6078
+ "id",
6079
+ "name",
6080
+ "open"
6081
+ ]
6082
+ },
6083
+ "description": "Who holds open tickets, most first; `assigneesTotal` counts all."
6084
+ },
6085
+ "assigneesTotal": {
6086
+ "type": "number"
6087
+ },
6088
+ "unassignedOpen": {
6089
+ "type": "number"
6090
+ },
6091
+ "epics": {
6092
+ "type": "array",
6093
+ "items": {
6094
+ "type": "object",
6095
+ "properties": {
6096
+ "key": {
6097
+ "type": "string"
6098
+ },
6099
+ "title": {
6100
+ "type": "string"
6101
+ },
6102
+ "project": {
6103
+ "type": "string"
6104
+ },
6105
+ "columnId": {
6106
+ "$ref": "#/$defs/TTicketColumn"
6107
+ },
6108
+ "children": {
6109
+ "type": "number"
6110
+ },
6111
+ "done": {
6112
+ "type": "number"
6113
+ },
6114
+ "columns": {
6115
+ "type": "object",
6116
+ "properties": {
6117
+ "backlog": {
6118
+ "type": "number"
6119
+ },
6120
+ "ready": {
6121
+ "type": "number"
6122
+ },
6123
+ "in_progress": {
6124
+ "type": "number"
6125
+ },
6126
+ "needs_input": {
6127
+ "type": "number"
6128
+ },
6129
+ "review": {
6130
+ "type": "number"
6131
+ },
6132
+ "landed": {
6133
+ "type": "number"
6134
+ },
6135
+ "released": {
6136
+ "type": "number"
6137
+ },
6138
+ "closed": {
6139
+ "type": "number"
6140
+ }
6141
+ },
6142
+ "additionalProperties": false
6143
+ }
6144
+ },
6145
+ "required": [
6146
+ "key",
6147
+ "title",
6148
+ "project",
6149
+ "columnId",
6150
+ "children",
6151
+ "done",
6152
+ "columns"
6153
+ ],
6154
+ "additionalProperties": false
6155
+ },
6156
+ "description": "Open epics with their direct children: how many, how many done, and where they stand; `epicsTotal` counts all."
6157
+ },
6158
+ "epicsTotal": {
6159
+ "type": "number"
6160
+ },
6161
+ "attention": {
6162
+ "type": "object",
6163
+ "properties": {
6164
+ "urgent": {
6165
+ "$ref": "#/$defs/ITicketOverviewGroup"
6166
+ },
6167
+ "needsInput": {
6168
+ "$ref": "#/$defs/ITicketOverviewGroup"
6169
+ },
6170
+ "openQuestions": {
6171
+ "$ref": "#/$defs/ITicketOverviewGroup"
6172
+ },
6173
+ "review": {
6174
+ "$ref": "#/$defs/ITicketOverviewGroup"
6175
+ },
6176
+ "unassignedReady": {
6177
+ "$ref": "#/$defs/ITicketOverviewGroup"
6178
+ },
6179
+ "stale": {
6180
+ "$ref": "#/$defs/ITicketOverviewGroup"
6181
+ }
6182
+ },
6183
+ "required": [
6184
+ "urgent",
6185
+ "needsInput",
6186
+ "openQuestions",
6187
+ "review",
6188
+ "unassignedReady",
6189
+ "stale"
6190
+ ],
6191
+ "additionalProperties": false
6192
+ },
6193
+ "recent": {
6194
+ "type": "array",
6195
+ "items": {
6196
+ "$ref": "#/$defs/ITicketSummary"
6197
+ },
6198
+ "description": "The tickets changed last, newest first."
6199
+ }
6200
+ },
6201
+ "required": [
6202
+ "revision",
6203
+ "total",
6204
+ "open",
6205
+ "columns",
6206
+ "priorities",
6207
+ "autoLabels",
6208
+ "projects",
6209
+ "projectsTotal",
6210
+ "assignees",
6211
+ "assigneesTotal",
6212
+ "unassignedOpen",
6213
+ "epics",
6214
+ "epicsTotal",
6215
+ "attention",
6216
+ "recent"
6217
+ ],
6218
+ "additionalProperties": false,
6219
+ "description": "The board at a glance, without any ticket's texts; see `ticketOverview`."
6220
+ },
6221
+ "declaration": "/** The board at a glance, without any ticket's texts; see `ticketOverview`. */\ninterface ITicketOverview {\n revision: number;\n total: number;\n /** Tickets that are neither released nor closed. */\n open: number;\n columns: Record<TTicketColumn, number>;\n /** Open tickets by priority. */\n priorities: Record<TTicketPriority, number>;\n autoLabels: Record<TTicketAutoLabel, number>;\n /** Most open work first; `projectsTotal` counts all. */\n projects: { project: string; total: number; open: number; columns: Partial<Record<TTicketColumn, number>> }[];\n projectsTotal: number;\n /** Who holds open tickets, most first; `assigneesTotal` counts all. */\n assignees: (Pick<ITicketPerson, 'id' | 'name' | 'sessionId'> & { open: number; columns: Partial<Record<TTicketColumn, number>> })[];\n assigneesTotal: number;\n unassignedOpen: number;\n /** Open epics with their direct children: how many, how many done, and where they stand; `epicsTotal` counts all. */\n epics: { key: string; title: string; project: string; columnId: TTicketColumn; children: number; done: number;\n columns: Partial<Record<TTicketColumn, number>> }[];\n epicsTotal: number;\n attention: {\n urgent: ITicketOverviewGroup;\n needsInput: ITicketOverviewGroup;\n openQuestions: ITicketOverviewGroup;\n review: ITicketOverviewGroup;\n unassignedReady: ITicketOverviewGroup;\n stale: ITicketOverviewGroup;\n };\n /** The tickets changed last, newest first. */\n recent: ITicketSummary[];\n}"
6222
+ },
6223
+ {
6224
+ "name": "ITicketOverviewGroup",
6225
+ "schema": {
6226
+ "type": "object",
6227
+ "properties": {
6228
+ "total": {
6229
+ "type": "number"
6230
+ },
6231
+ "tickets": {
6232
+ "type": "array",
6233
+ "items": {
6234
+ "$ref": "#/$defs/ITicketSummary"
6235
+ }
6236
+ }
6237
+ },
6238
+ "required": [
6239
+ "total",
6240
+ "tickets"
6241
+ ],
6242
+ "additionalProperties": false,
6243
+ "description": "Some tickets of a kind and how many there are in all."
6244
+ },
6245
+ "declaration": "/** Some tickets of a kind and how many there are in all. */\ninterface ITicketOverviewGroup { total: number; tickets: ITicketSummary[] }"
6246
+ },
6247
+ {
6248
+ "name": "ITicketOverviewRequest",
6249
+ "declaration": "interface ITicketOverviewRequest {\n /** Only this project's tickets. */\n project?: string;\n /** Only the tickets assigned to the caller's verified session. */\n mine?: boolean;\n /** Tickets per list, 1 to 50; 5 when absent. */\n limit?: number;\n /** Days without a change after which in_progress, needs_input and review work counts as stale, 1 to 365; 3 when absent. */\n staleDays?: number;\n}"
6250
+ },
6251
+ {
6252
+ "name": "ITicketPageBase",
6253
+ "declaration": "interface ITicketPageBase {\n /** How many tickets the filters match, on every page. */\n total: number;\n /** How many of them each column holds; a column without any is left out. */\n columns: Partial<Record<TTicketColumn, number>>;\n /** The board revision this page was read at. */\n revision: number;\n /** Present while more tickets follow: pass it as `cursor` with the same filters, sort and view. */\n nextCursor?: string;\n /**\n * The board changed since the first page of this cursor. A page continues after the last ticket shown as the board\n * stands now, so a ticket that changed its place meanwhile may be missing or shown twice; list again for an exact reading.\n */\n moved?: true;\n}"
6254
+ },
6255
+ {
6256
+ "name": "ITicketPageRequest",
6257
+ "declaration": "/**\n * One page of the board. Beyond a listing's filters it narrows by several columns (`statuses`), by open work (`open`:\n * true leaves out released and closed tickets, false keeps only those), kind, priorities, a parent's direct children,\n * an assignee (a person id or a session id), tickets without one, named keys and a time of last change.\n */\ninterface ITicketPageRequest extends ITicketFilters {\n statuses?: TTicketColumn[];\n open?: boolean;\n kind?: TTicketKind;\n priorities?: TTicketPriority[];\n /** A ticket key: its direct children, as the board's epic filter matches them. */\n parent?: string;\n /** A person id or a session id (`harness:nativeId`), as a ticket's assignee holds them; never a display name. */\n assignee?: string;\n unassigned?: boolean;\n /** Up to 200 keys: reads those tickets in one call. */\n keys?: string[];\n /** An ISO 8601 instant: tickets changed at or after it. */\n updatedSince?: string;\n /** `board` when absent. */\n sort?: TTicketPageSort;\n /** `summary` (a ticket without its texts) when absent; `full` returns whole tickets. */\n view?: 'summary' | 'full';\n /** Tickets on the page, 1 to 200 (`ticketListPage.maximum`); 50 when absent. */\n limit?: number;\n /** A page's `nextCursor`, with the same filters, sort and view. */\n cursor?: string;\n}"
6258
+ },
5735
6259
  {
5736
6260
  "name": "ITicketPerson",
5737
6261
  "schema": {
@@ -5945,6 +6469,137 @@ export const AGL_API_SURFACE: plugins.flexTypedRequest.IFlexTypedRequestSurface
5945
6469
  },
5946
6470
  "declaration": "interface ITicketSource {\n kind: 'owner_words' | 'driver' | 'worker';\n text: string;\n actor: ITicketActor;\n attachments: ITicketAttachment[];\n}"
5947
6471
  },
6472
+ {
6473
+ "name": "ITicketSummary",
6474
+ "schema": {
6475
+ "type": "object",
6476
+ "properties": {
6477
+ "key": {
6478
+ "type": "string"
6479
+ },
6480
+ "revision": {
6481
+ "type": "number"
6482
+ },
6483
+ "project": {
6484
+ "type": "string"
6485
+ },
6486
+ "kind": {
6487
+ "$ref": "#/$defs/TTicketKind"
6488
+ },
6489
+ "title": {
6490
+ "type": "string"
6491
+ },
6492
+ "columnId": {
6493
+ "$ref": "#/$defs/TTicketColumn"
6494
+ },
6495
+ "priority": {
6496
+ "$ref": "#/$defs/TTicketPriority"
6497
+ },
6498
+ "updatedAt": {
6499
+ "type": "string"
6500
+ },
6501
+ "assignee": {
6502
+ "type": "object",
6503
+ "properties": {
6504
+ "id": {
6505
+ "type": "string"
6506
+ },
6507
+ "name": {
6508
+ "type": "string"
6509
+ },
6510
+ "sessionId": {
6511
+ "type": "string"
6512
+ }
6513
+ },
6514
+ "required": [
6515
+ "id",
6516
+ "name"
6517
+ ],
6518
+ "additionalProperties": false
6519
+ },
6520
+ "parentId": {
6521
+ "type": "string"
6522
+ },
6523
+ "labels": {
6524
+ "type": "array",
6525
+ "items": {
6526
+ "type": "string"
6527
+ }
6528
+ },
6529
+ "autoLabels": {
6530
+ "type": "array",
6531
+ "items": {
6532
+ "$ref": "#/$defs/TTicketAutoLabel"
6533
+ }
6534
+ },
6535
+ "links": {
6536
+ "type": "object",
6537
+ "properties": {
6538
+ "branch": {
6539
+ "type": "number"
6540
+ },
6541
+ "commit": {
6542
+ "type": "number"
6543
+ },
6544
+ "release": {
6545
+ "type": "number"
6546
+ },
6547
+ "affects": {
6548
+ "type": "number"
6549
+ }
6550
+ },
6551
+ "additionalProperties": false,
6552
+ "description": "How many links of each kind the ticket holds."
6553
+ },
6554
+ "releasePlan": {
6555
+ "$ref": "#/$defs/ITicketReleasePlan"
6556
+ },
6557
+ "deployPlan": {
6558
+ "$ref": "#/$defs/ITicketDeployPlanInput"
6559
+ },
6560
+ "maintenanceWindow": {
6561
+ "type": "object",
6562
+ "properties": {
6563
+ "from": {
6564
+ "type": "string"
6565
+ },
6566
+ "to": {
6567
+ "type": "string"
6568
+ },
6569
+ "targets": {
6570
+ "type": "array",
6571
+ "items": {
6572
+ "type": "string"
6573
+ }
6574
+ }
6575
+ },
6576
+ "required": [
6577
+ "from",
6578
+ "to",
6579
+ "targets"
6580
+ ],
6581
+ "additionalProperties": false
6582
+ },
6583
+ "openQuestions": {
6584
+ "type": "number",
6585
+ "description": "Unanswered questions on the ticket."
6586
+ }
6587
+ },
6588
+ "required": [
6589
+ "key",
6590
+ "revision",
6591
+ "project",
6592
+ "kind",
6593
+ "title",
6594
+ "columnId",
6595
+ "priority",
6596
+ "updatedAt"
6597
+ ],
6598
+ "additionalProperties": false,
6599
+ "description": "A ticket without its description, source words and link details. Empty fields are left out."
6600
+ },
6601
+ "declaration": "/** A ticket without its description, source words and link details. Empty fields are left out. */\ninterface ITicketSummary {\n key: string;\n revision: number;\n project: string;\n kind: TTicketKind;\n title: string;\n columnId: TTicketColumn;\n priority: TTicketPriority;\n updatedAt: string;\n assignee?: Pick<ITicketPerson, 'id' | 'name' | 'sessionId'>;\n parentId?: string;\n labels?: string[];\n autoLabels?: TTicketAutoLabel[];\n /** How many links of each kind the ticket holds. */\n links?: Partial<Record<TTicketLink['kind'], number>>;\n releasePlan?: ITicketReleasePlan;\n deployPlan?: ITicketDeployPlanInput;\n maintenanceWindow?: Pick<ITicketMaintenanceWindow, 'from' | 'to' | 'targets'>;\n /** Unanswered questions on the ticket. */\n openQuestions?: number;\n}"
6602
+ },
5948
6603
  {
5949
6604
  "name": "ITypedRequest",
5950
6605
  "declaration": "interface ITypedRequest {\n /**\n * Transport-generated identity for one exact request attempt. Transports use\n * it with the method and correlation ID to reject stale responses and route\n * cancellation without confusing retries.\n */\n requestInstanceId?: string;\n /**\n * the method that the request response data is meant for\n */\n method: string;\n /**\n * any needed auth data\n */\n authInfo?: {\n jwt: string;\n };\n /**\n * localData tracks things within typedrequest.\n * needed for VirtualStreams\n */\n localData?: {\n firstTypedrouter?: any;\n };\n /**\n * server data that is added for dealing with the request server side. Will be omitted when sending the response\n */\n serverData?: {\n jwtData: any;\n jwtValid: boolean;\n };\n /**\n * the request data\n */\n request: object;\n /**\n * the response data\n */\n response: object;\n /**\n * any error information that might be encountered while dealing with a request\n */\n error?: {\n text: string;\n data: any;\n };\n /**\n * retry information for smartly advising the client to retry at a later point in time\n */\n retry?: {\n waitForMs: number;\n reason: string;\n };\n /**\n * a correlation id that\n * used for matching request and response\n * !important. Don't remove.\n */\n correlation?: {\n id: string;\n phase: 'request' | 'response';\n };\n}"
@@ -7141,19 +7796,182 @@ export const AGL_API_SURFACE: plugins.flexTypedRequest.IFlexTypedRequestSurface
7141
7796
  },
7142
7797
  "declaration": "/**\n * Evidence a ticket carries. A release is a repository's tag `v<version>`: its link names the repository (`org/name`)\n * and the commit the tag points at, and the package it published where there is one; a release linked by hand names\n * the package alone. `affects` records the version of a repository a bug was found in.\n */\ntype TTicketLink =\n | { kind: 'branch'; repo: string; branch: string; sha: string }\n | { kind: 'commit'; repo: string; sha: string }\n | { kind: 'release'; version: string; package?: string; repo?: string; sha?: string }\n | { kind: 'affects'; repo: string; version: string };"
7143
7798
  },
7799
+ {
7800
+ "name": "TTicketPage",
7801
+ "schema": {
7802
+ "anyOf": [
7803
+ {
7804
+ "type": "object",
7805
+ "additionalProperties": false,
7806
+ "properties": {
7807
+ "view": {
7808
+ "type": "string",
7809
+ "const": "summary"
7810
+ },
7811
+ "tickets": {
7812
+ "type": "array",
7813
+ "items": {
7814
+ "$ref": "#/$defs/ITicketSummary"
7815
+ }
7816
+ },
7817
+ "total": {
7818
+ "type": "number",
7819
+ "description": "How many tickets the filters match, on every page."
7820
+ },
7821
+ "columns": {
7822
+ "type": "object",
7823
+ "properties": {
7824
+ "backlog": {
7825
+ "type": "number"
7826
+ },
7827
+ "ready": {
7828
+ "type": "number"
7829
+ },
7830
+ "in_progress": {
7831
+ "type": "number"
7832
+ },
7833
+ "needs_input": {
7834
+ "type": "number"
7835
+ },
7836
+ "review": {
7837
+ "type": "number"
7838
+ },
7839
+ "landed": {
7840
+ "type": "number"
7841
+ },
7842
+ "released": {
7843
+ "type": "number"
7844
+ },
7845
+ "closed": {
7846
+ "type": "number"
7847
+ }
7848
+ },
7849
+ "additionalProperties": false,
7850
+ "description": "How many of them each column holds; a column without any is left out."
7851
+ },
7852
+ "revision": {
7853
+ "type": "number",
7854
+ "description": "The board revision this page was read at."
7855
+ },
7856
+ "nextCursor": {
7857
+ "type": "string",
7858
+ "description": "Present while more tickets follow: pass it as `cursor` with the same filters, sort and view."
7859
+ },
7860
+ "moved": {
7861
+ "type": "boolean",
7862
+ "const": true,
7863
+ "description": "The board changed since the first page of this cursor. A page continues after the last ticket shown as the board stands now, so a ticket that changed its place meanwhile may be missing or shown twice; list again for an exact reading."
7864
+ }
7865
+ },
7866
+ "required": [
7867
+ "columns",
7868
+ "revision",
7869
+ "tickets",
7870
+ "total",
7871
+ "view"
7872
+ ]
7873
+ },
7874
+ {
7875
+ "type": "object",
7876
+ "additionalProperties": false,
7877
+ "properties": {
7878
+ "view": {
7879
+ "type": "string",
7880
+ "const": "full"
7881
+ },
7882
+ "tickets": {
7883
+ "type": "array",
7884
+ "items": {
7885
+ "$ref": "#/$defs/ITicket"
7886
+ }
7887
+ },
7888
+ "total": {
7889
+ "type": "number",
7890
+ "description": "How many tickets the filters match, on every page."
7891
+ },
7892
+ "columns": {
7893
+ "type": "object",
7894
+ "properties": {
7895
+ "backlog": {
7896
+ "type": "number"
7897
+ },
7898
+ "ready": {
7899
+ "type": "number"
7900
+ },
7901
+ "in_progress": {
7902
+ "type": "number"
7903
+ },
7904
+ "needs_input": {
7905
+ "type": "number"
7906
+ },
7907
+ "review": {
7908
+ "type": "number"
7909
+ },
7910
+ "landed": {
7911
+ "type": "number"
7912
+ },
7913
+ "released": {
7914
+ "type": "number"
7915
+ },
7916
+ "closed": {
7917
+ "type": "number"
7918
+ }
7919
+ },
7920
+ "additionalProperties": false,
7921
+ "description": "How many of them each column holds; a column without any is left out."
7922
+ },
7923
+ "revision": {
7924
+ "type": "number",
7925
+ "description": "The board revision this page was read at."
7926
+ },
7927
+ "nextCursor": {
7928
+ "type": "string",
7929
+ "description": "Present while more tickets follow: pass it as `cursor` with the same filters, sort and view."
7930
+ },
7931
+ "moved": {
7932
+ "type": "boolean",
7933
+ "const": true,
7934
+ "description": "The board changed since the first page of this cursor. A page continues after the last ticket shown as the board stands now, so a ticket that changed its place meanwhile may be missing or shown twice; list again for an exact reading."
7935
+ }
7936
+ },
7937
+ "required": [
7938
+ "columns",
7939
+ "revision",
7940
+ "tickets",
7941
+ "total",
7942
+ "view"
7943
+ ]
7944
+ }
7945
+ ]
7946
+ },
7947
+ "declaration": "type TTicketPage = (ITicketPageBase & { view: 'summary'; tickets: ITicketSummary[] })\n | (ITicketPageBase & { view: 'full'; tickets: ITicket[] });"
7948
+ },
7949
+ {
7950
+ "name": "TTicketPageSort",
7951
+ "schema": {
7952
+ "type": "string",
7953
+ "enum": [
7954
+ "board",
7955
+ "updated",
7956
+ "created",
7957
+ "priority"
7958
+ ]
7959
+ },
7960
+ "declaration": "type TTicketPageSort = (readonly [\"board\", \"updated\", \"created\", \"priority\"])[number];"
7961
+ },
7144
7962
  {
7145
7963
  "name": "TTicketPriority",
7146
7964
  "schema": {
7147
7965
  "type": "string",
7148
7966
  "enum": [
7149
- "none",
7150
- "low",
7151
- "normal",
7967
+ "urgent",
7152
7968
  "high",
7153
- "urgent"
7969
+ "normal",
7970
+ "low",
7971
+ "none"
7154
7972
  ]
7155
7973
  },
7156
- "declaration": "type TTicketPriority = 'none' | 'low' | 'normal' | 'high' | 'urgent';"
7974
+ "declaration": "type TTicketPriority = (readonly [\"urgent\", \"high\", \"normal\", \"low\", \"none\"])[number];"
7157
7975
  },
7158
7976
  {
7159
7977
  "name": "TTicketReferenceContent",