agl 43.2.0 → 43.3.1

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 (213) hide show
  1. package/changelog.md +29 -0
  2. package/dist_serve/bundle.js +2845 -2638
  3. package/dist_serve/bundle.js.map +2 -2
  4. package/dist_serve/bundle.js.third-party-notices.json +1 -1
  5. package/dist_serve/bundle.js.third-party-notices.txt +1 -1
  6. package/dist_ts/00_commitinfo_data.js +1 -1
  7. package/dist_ts/aglapi/aglapisurface.document.js +197 -17
  8. package/dist_ts/classes.accountsactions.d.ts +3 -1
  9. package/dist_ts/classes.accountsactions.js +21 -3
  10. package/dist_ts/classes.authstore.d.ts +7 -0
  11. package/dist_ts/classes.authstore.js +9 -1
  12. package/dist_ts/classes.claudeharness.d.ts +29 -2
  13. package/dist_ts/classes.claudeharness.js +35 -6
  14. package/dist_ts/classes.codexclientadapter.d.ts +11 -0
  15. package/dist_ts/classes.codexclientadapter.js +14 -2
  16. package/dist_ts/classes.controller.d.ts +187 -12
  17. package/dist_ts/classes.controller.js +1208 -186
  18. package/dist_ts/classes.controllerdevices.d.ts +2 -0
  19. package/dist_ts/classes.controllerdevices.js +6 -1
  20. package/dist_ts/classes.inbox.d.ts +72 -0
  21. package/dist_ts/classes.inbox.js +231 -0
  22. package/dist_ts/classes.inferencerouter.d.ts +10 -0
  23. package/dist_ts/classes.inferencerouter.js +5 -3
  24. package/dist_ts/classes.inferenceservice.js +2 -2
  25. package/dist_ts/classes.mcpclient.d.ts +1 -1
  26. package/dist_ts/classes.mcpclient.js +24 -6
  27. package/dist_ts/classes.mcpcontrollerhost.js +6 -1
  28. package/dist_ts/classes.mcptools.js +18 -8
  29. package/dist_ts/classes.mcpvalidation.d.ts +5 -0
  30. package/dist_ts/classes.mcpvalidation.js +32 -2
  31. package/dist_ts/classes.nativesessions.d.ts +29 -4
  32. package/dist_ts/classes.nativesessions.js +41 -9
  33. package/dist_ts/classes.opencodeclient.d.ts +23 -2
  34. package/dist_ts/classes.opencodeclient.js +47 -3
  35. package/dist_ts/classes.publishedset.d.ts +38 -0
  36. package/dist_ts/classes.publishedset.js +50 -0
  37. package/dist_ts/classes.sessionfeed.d.ts +3 -3
  38. package/dist_ts/classes.sessionfeed.js +18 -26
  39. package/dist_ts/classes.systemmetricssampler.d.ts +6 -0
  40. package/dist_ts/classes.systemmetricssampler.js +15 -3
  41. package/dist_ts/classes.ticketstore.d.ts +50 -3
  42. package/dist_ts/classes.ticketstore.js +45 -8
  43. package/dist_ts/classes.workercallers.js +4 -2
  44. package/dist_ts/driver/classes.directreports.d.ts +14 -4
  45. package/dist_ts/driver/classes.directreports.js +42 -23
  46. package/dist_ts/driver/classes.directreportstore.d.ts +8 -1
  47. package/dist_ts/driver/classes.directreportstore.js +20 -10
  48. package/dist_ts/driver/classes.driverservice.d.ts +44 -3
  49. package/dist_ts/driver/classes.driverservice.js +50 -16
  50. package/dist_ts/fleet/classes.claudeworkers.d.ts +21 -5
  51. package/dist_ts/fleet/classes.claudeworkers.js +142 -46
  52. package/dist_ts/fleet/classes.codexworkers.d.ts +16 -4
  53. package/dist_ts/fleet/classes.codexworkers.js +22 -5
  54. package/dist_ts/fleet/classes.workercommand.d.ts +6 -1
  55. package/dist_ts/fleet/classes.workercommand.js +15 -4
  56. package/dist_ts/fleet/classes.workers.d.ts +21 -1
  57. package/dist_ts/fleet/classes.workers.js +80 -40
  58. package/dist_ts/fleet/classes.workerstore.js +14 -8
  59. package/dist_ts/fleet/functions.unbounddrivers.js +2 -2
  60. package/dist_ts/fleet/functions.workervalidation.js +11 -4
  61. package/dist_ts/fleet/interfaces.workers.d.ts +27 -5
  62. package/dist_ts/fleet/interfaces.workers.js +8 -4
  63. package/dist_ts/functions.agentmessage.d.ts +3 -0
  64. package/dist_ts/functions.agentmessage.js +4 -1
  65. package/dist_ts/functions.deviceapi.d.ts +198 -4
  66. package/dist_ts/functions.deviceapi.js +1060 -38
  67. package/dist_ts/functions.exactpersistence.d.ts +3 -0
  68. package/dist_ts/functions.exactpersistence.js +4 -0
  69. package/dist_ts/functions.fleetworkercli.d.ts +1 -1
  70. package/dist_ts/functions.fleetworkercli.js +11 -8
  71. package/dist_ts/functions.inferencecli.js +3 -1
  72. package/dist_ts/functions.mcpfleetworkertools.js +3 -3
  73. package/dist_ts/functions.ticketactor.d.ts +17 -1
  74. package/dist_ts/functions.ticketactor.js +55 -15
  75. package/dist_ts/functions.ticketvalidation.js +11 -2
  76. package/dist_ts/interfaces.auth.d.ts +1 -1
  77. package/dist_ts/interfaces.auth.js +9 -1
  78. package/dist_ts/plugins.d.ts +3 -1
  79. package/dist_ts/plugins.js +7 -2
  80. package/dist_ts_authswitch/authority-contract.d.ts +25 -0
  81. package/dist_ts_authswitch/authority-contract.js +1 -1
  82. package/dist_ts_authswitch/authority-overview.d.ts +8 -0
  83. package/dist_ts_authswitch/authority-overview.js +17 -6
  84. package/dist_ts_authswitch/authority-placement.d.ts +20 -16
  85. package/dist_ts_authswitch/authority-placement.js +17 -10
  86. package/dist_ts_authswitch/authority-renewal.d.ts +34 -0
  87. package/dist_ts_authswitch/authority-renewal.js +56 -0
  88. package/dist_ts_authswitch/classes.authoritybroker.d.ts +8 -0
  89. package/dist_ts_authswitch/classes.authoritybroker.js +35 -2
  90. package/dist_ts_authswitch/classes.authoritycli.d.ts +1 -0
  91. package/dist_ts_authswitch/classes.authoritycli.js +44 -3
  92. package/dist_ts_authswitch/classes.authorityclient.d.ts +6 -1
  93. package/dist_ts_authswitch/classes.authorityclient.js +12 -4
  94. package/dist_ts_authswitch/classes.authoritydaemon.js +8 -1
  95. package/dist_ts_authswitch/classes.authoritydatabase.js +6 -2
  96. package/dist_ts_authswitch/classes.authoritymodels.d.ts +7 -0
  97. package/dist_ts_authswitch/classes.authoritymodels.js +21 -5
  98. package/dist_ts_interfaces/devices.d.ts +1027 -7
  99. package/dist_ts_interfaces/devices.js +68 -2
  100. package/dist_ts_interfaces/fleetworkers.d.ts +37 -10
  101. package/dist_ts_interfaces/fleetworkers.js +19 -8
  102. package/dist_ts_interfaces/inbox.d.ts +234 -0
  103. package/dist_ts_interfaces/inbox.js +101 -0
  104. package/dist_ts_interfaces/index.d.ts +1 -0
  105. package/dist_ts_interfaces/index.js +2 -1
  106. package/dist_ts_interfaces/interfaces.d.ts +10 -3
  107. package/dist_ts_interfaces/interfaces.js +4 -2
  108. package/dist_ts_interfaces/mcprequests.d.ts +34 -4
  109. package/dist_ts_interfaces/mcprequests.js +11 -1
  110. package/dist_ts_interfaces/mcpworkspacerequests.d.ts +4 -1
  111. package/dist_ts_interfaces/mcpworkspacerequests.js +1 -1
  112. package/dist_ts_interfaces/nativesessions.d.ts +16 -3
  113. package/dist_ts_interfaces/plugins.d.ts +2 -1
  114. package/dist_ts_interfaces/plugins.js +4 -2
  115. package/dist_ts_interfaces/requests.accounts.d.ts +21 -0
  116. package/dist_ts_interfaces/requests.accounts.js +3 -1
  117. package/dist_ts_interfaces/requests.d.ts +3 -2
  118. package/dist_ts_interfaces/requests.js +1 -1
  119. package/dist_ts_interfaces/workercallers.d.ts +2 -0
  120. package/dist_ts_migration/classes.documentmigrationrunner.d.ts +14 -0
  121. package/dist_ts_migration/classes.documentmigrationrunner.js +20 -1
  122. package/dist_ts_migration/index.d.ts +1 -0
  123. package/dist_ts_migration/index.js +2 -1
  124. package/dist_ts_migration/v43_ticketactornames.d.ts +32 -0
  125. package/dist_ts_migration/v43_ticketactornames.js +236 -0
  126. package/docs/authswitch.md +20 -1
  127. package/package.json +3 -3
  128. package/readme.md +144 -27
  129. package/ts/00_commitinfo_data.ts +1 -1
  130. package/ts/aglapi/aglapisurface.document.ts +196 -16
  131. package/ts/classes.accountsactions.ts +30 -3
  132. package/ts/classes.authstore.ts +10 -0
  133. package/ts/classes.claudeharness.ts +45 -5
  134. package/ts/classes.codexclientadapter.ts +14 -1
  135. package/ts/classes.controller.ts +1412 -262
  136. package/ts/classes.controllerdevices.ts +6 -0
  137. package/ts/classes.inbox.ts +239 -0
  138. package/ts/classes.inferencerouter.ts +15 -2
  139. package/ts/classes.inferenceservice.ts +1 -1
  140. package/ts/classes.mcpclient.ts +24 -3
  141. package/ts/classes.mcpcontrollerhost.ts +5 -0
  142. package/ts/classes.mcptools.ts +17 -7
  143. package/ts/classes.mcpvalidation.ts +27 -1
  144. package/ts/classes.nativesessions.ts +63 -12
  145. package/ts/classes.opencodeclient.ts +55 -4
  146. package/ts/classes.publishedset.ts +56 -0
  147. package/ts/classes.sessionfeed.ts +17 -20
  148. package/ts/classes.systemmetricssampler.ts +13 -2
  149. package/ts/classes.ticketstore.ts +73 -12
  150. package/ts/classes.workercallers.ts +3 -1
  151. package/ts/driver/classes.directreports.ts +42 -23
  152. package/ts/driver/classes.directreportstore.ts +20 -9
  153. package/ts/driver/classes.driverservice.ts +75 -14
  154. package/ts/fleet/classes.claudeworkers.ts +112 -39
  155. package/ts/fleet/classes.codexworkers.ts +21 -6
  156. package/ts/fleet/classes.workercommand.ts +14 -4
  157. package/ts/fleet/classes.workers.ts +75 -41
  158. package/ts/fleet/classes.workerstore.ts +11 -7
  159. package/ts/fleet/functions.unbounddrivers.ts +1 -1
  160. package/ts/fleet/functions.workervalidation.ts +8 -3
  161. package/ts/fleet/interfaces.workers.ts +26 -7
  162. package/ts/functions.agentmessage.ts +3 -0
  163. package/ts/functions.deviceapi.ts +1292 -34
  164. package/ts/functions.exactpersistence.ts +5 -0
  165. package/ts/functions.fleetworkercli.ts +10 -7
  166. package/ts/functions.inferencecli.ts +2 -0
  167. package/ts/functions.mcpfleetworkertools.ts +2 -2
  168. package/ts/functions.ticketactor.ts +58 -14
  169. package/ts/functions.ticketvalidation.ts +11 -1
  170. package/ts/interfaces.auth.ts +8 -0
  171. package/ts/plugins.ts +7 -0
  172. package/ts_authswitch/authority-contract.ts +20 -0
  173. package/ts_authswitch/authority-overview.ts +28 -6
  174. package/ts_authswitch/authority-placement.ts +25 -17
  175. package/ts_authswitch/authority-renewal.ts +64 -0
  176. package/ts_authswitch/classes.authoritybroker.ts +34 -1
  177. package/ts_authswitch/classes.authoritycli.ts +49 -2
  178. package/ts_authswitch/classes.authorityclient.ts +14 -4
  179. package/ts_authswitch/classes.authoritydaemon.ts +9 -1
  180. package/ts_authswitch/classes.authoritydatabase.ts +5 -1
  181. package/ts_authswitch/classes.authoritymodels.ts +23 -3
  182. package/ts_authswitch/native-contracts.md +21 -0
  183. package/ts_authswitch/readme.md +1 -1
  184. package/ts_interfaces/devices.schema.json +3576 -603
  185. package/ts_interfaces/devices.ts +1111 -6
  186. package/ts_interfaces/fleetworkers.ts +38 -10
  187. package/ts_interfaces/inbox.ts +287 -0
  188. package/ts_interfaces/index.ts +1 -0
  189. package/ts_interfaces/interfaces.ts +9 -2
  190. package/ts_interfaces/mcprequests.ts +43 -4
  191. package/ts_interfaces/mcpworkspacerequests.ts +4 -2
  192. package/ts_interfaces/nativesessions.ts +17 -3
  193. package/ts_interfaces/plugins.ts +3 -1
  194. package/ts_interfaces/requests.accounts.ts +20 -0
  195. package/ts_interfaces/requests.ts +4 -0
  196. package/ts_interfaces/workercallers.ts +2 -0
  197. package/ts_migration/classes.documentmigrationrunner.ts +21 -0
  198. package/ts_migration/index.ts +1 -0
  199. package/ts_migration/v43_ticketactornames.ts +225 -0
  200. package/ts_web/00_commitinfo_data.ts +1 -1
  201. package/ts_web/accounts.plugins.ts +4 -2
  202. package/ts_web/classes.accountsreadmodel.ts +33 -0
  203. package/ts_web/classes.browserpresentation.ts +10 -5
  204. package/ts_web/classes.inboxfeed.ts +329 -0
  205. package/ts_web/classes.nativesessionstate.ts +9 -23
  206. package/ts_web/elements.accounts.ts +81 -0
  207. package/ts_web/elements.deployments.ts +66 -2
  208. package/ts_web/elements.fleetworker.ts +4 -2
  209. package/ts_web/elements.harnesscontrollerapp.ts +107 -37
  210. package/ts_web/elements.inbox.ts +808 -0
  211. package/ts_web/functions.inbox.ts +95 -0
  212. package/ts_web/functions.sessioncards.ts +40 -0
  213. package/ts_web/plugins.ts +2 -0
@@ -0,0 +1,95 @@
1
+ import * as plugins from './plugins.js';
2
+ import type * as interfaces from '../ts_interfaces/index.js';
3
+
4
+ type TInboxItem = interfaces.TControllerInboxItem;
5
+
6
+ /** How the Inbox names and marks each kind: its label, its icon and the tone of the icon's tile. */
7
+ export const inboxKindViews: Readonly<Record<interfaces.TControllerInboxKind, {
8
+ readonly label: string;
9
+ readonly icon: string;
10
+ readonly tone: plugins.deesCatalog.TTone;
11
+ }>> = {
12
+ permission: { label: 'Permission', icon: 'lucide:ShieldAlert', tone: 'warning' },
13
+ question: { label: 'Question', icon: 'lucide:CircleHelp', tone: 'info' },
14
+ elicitation: { label: 'MCP form', icon: 'lucide:ClipboardList', tone: 'neutral' },
15
+ native_wait: { label: 'Waits in its client', icon: 'lucide:Hourglass', tone: 'neutral' },
16
+ driver: { label: 'Driver', icon: 'lucide:ShipWheel', tone: 'warning' },
17
+ deploy_go: { label: 'Deploy go', icon: 'lucide:Rocket', tone: 'success' },
18
+ window_go: { label: 'Window go', icon: 'lucide:CalendarClock', tone: 'success' },
19
+ ticket_question: { label: 'Ticket question', icon: 'lucide:CircleHelp', tone: 'info' },
20
+ };
21
+
22
+ /** The chips' words. */
23
+ export const inboxChipLabels: Readonly<Record<interfaces.TControllerInboxChip, string>> = {
24
+ all: 'All', sessions: 'Sessions', board: 'Board', deploys: 'Deploys',
25
+ };
26
+
27
+ const harnessNames: Readonly<Record<interfaces.TControllerSessionFeedHarness, string>> = {
28
+ claude: 'Claude Code', codex: 'Codex', flex: 'Flex', opencode: 'OpenCode',
29
+ };
30
+
31
+ /** A harness as the Inbox names it. */
32
+ export const inboxHarnessName = (harnessArg: interfaces.TControllerSessionFeedHarness): string => harnessNames[harnessArg];
33
+
34
+ /** How long an item waits, short: "just now", "12 min", "3 h", "2 d". */
35
+ export const inboxAge = (sinceArg: number, nowArg = Date.now()): string => {
36
+ const minutes = Math.floor(Math.max(0, nowArg - sinceArg) / 60_000);
37
+ if (minutes < 1) return 'just now';
38
+ if (minutes < 60) return `${minutes} min`;
39
+ const hours = Math.floor(minutes / 60);
40
+ if (hours < 48) return `${hours} h`;
41
+ return `${Math.floor(hours / 24)} d`;
42
+ };
43
+
44
+ /** Where an item lives, in one line: the session (and the subagent or host) or the ticket and its question. */
45
+ export const inboxWhereText = (itemArg: TInboxItem): string => {
46
+ const where = itemArg.where;
47
+ switch (where.kind) {
48
+ case 'conversation': return where.name;
49
+ case 'child': return `${where.childName} in ${where.name}`;
50
+ case 'native': return `${where.name} on ${where.host}`;
51
+ case 'driver': return 'The driver';
52
+ case 'ticket': {
53
+ const question = 'question' in itemArg ? itemArg.question : undefined;
54
+ return question ? `${where.ticketKey} · ${question.id}` : where.ticketKey;
55
+ }
56
+ }
57
+ };
58
+
59
+ /** Who asked an item, where the item says: a ticket question's asker. */
60
+ export const inboxAskedBy = (itemArg: TInboxItem): string | undefined => (
61
+ 'question' in itemArg && itemArg.question && 'askedBy' in itemArg.question ? itemArg.question.askedBy.name : undefined
62
+ );
63
+
64
+ /** What the "Open" action of an item says: its session, its ticket or the driver. */
65
+ export const inboxOpenLabel = (itemArg: TInboxItem): string => (
66
+ itemArg.where.kind === 'ticket' ? 'Open ticket' : itemArg.where.kind === 'driver' ? 'Open Driver' : 'Open in session'
67
+ );
68
+
69
+ /**
70
+ * How an answer that did not come back ended. The owner refused it, and nothing was stored, when the controller
71
+ * answered with a typed refusal; anything else (a controller answer that its outcome is unknown, a time-out, a lost
72
+ * connection) leaves the outcome unknown, and the answer is never sent again on its own.
73
+ */
74
+ export type TInboxAnswerFailure =
75
+ | { kind: 'refused'; code: string; message: string }
76
+ | { kind: 'unknown'; message: string };
77
+
78
+ export const inboxAnswerFailure = (errorArg: unknown): TInboxAnswerFailure => {
79
+ const message = errorArg instanceof Error && errorArg.message ? errorArg.message : 'The answer failed.';
80
+ if (errorArg instanceof plugins.typedrequest.TypedResponseError) {
81
+ const code = errorArg.errorData?.code;
82
+ if (typeof code === 'string' && code !== 'outcome_unknown') return { kind: 'refused', code, message };
83
+ }
84
+ return { kind: 'unknown', message };
85
+ };
86
+
87
+ /** A ticket question's answer as words: the options' labels and the free text. */
88
+ export const inboxTicketAnswerText = (questionArg: interfaces.ITicketQuestion): string => {
89
+ const answer = questionArg.answer;
90
+ if (!answer) return '';
91
+ return [
92
+ ...answer.choices.map((choiceArg) => questionArg.options.find((optionArg) => optionArg.id === choiceArg)?.label ?? choiceArg),
93
+ ...(answer.text === undefined ? [] : [answer.text]),
94
+ ].join(', ');
95
+ };
@@ -0,0 +1,40 @@
1
+ import type * as plugins from './plugins.js';
2
+ import type * as interfaces from '../ts_interfaces/index.js';
3
+
4
+ /*
5
+ * A session's pending requests as dees-catalog's cards show them. The conversation view, a native session's state and
6
+ * the Inbox map them here alone, so a card reads the same wherever it is answered.
7
+ */
8
+
9
+ /** A pending permission as its card, under the card id `idArg`; `sessionIdArg` names the session the card belongs to. */
10
+ export const permissionCard = (
11
+ requestArg: interfaces.IControllerPermission,
12
+ idArg: string,
13
+ sessionIdArg?: string,
14
+ ): plugins.deesCatalog.IHarnessPermissionRequest => ({
15
+ id: idArg,
16
+ ...(sessionIdArg === undefined ? {} : { sessionId: sessionIdArg }),
17
+ createdAt: requestArg.createdAt,
18
+ title: requestArg.title || 'Permission requested',
19
+ type: requestArg.type,
20
+ metadata: { ...(requestArg.patterns.length > 0 ? { patterns: requestArg.patterns } : {}), ...requestArg.metadata },
21
+ });
22
+
23
+ /** The card id of question `indexArg` of a request with `countArg` questions, keyed `keyArg`: numbered when it asks several. */
24
+ export const questionCardId = (keyArg: string, countArg: number, indexArg: number): string => (
25
+ countArg > 1 ? `${keyArg}#${indexArg}` : keyArg
26
+ );
27
+
28
+ /** A pending question request as its cards, one per question, keyed `keyArg`. */
29
+ export const questionCards = (
30
+ requestArg: interfaces.IControllerQuestion,
31
+ keyArg: string,
32
+ sessionIdArg?: string,
33
+ ): plugins.deesCatalog.IHarnessQuestionRequest[] => requestArg.questions.map((questionArg, indexArg) => ({
34
+ id: questionCardId(keyArg, requestArg.questions.length, indexArg),
35
+ ...(sessionIdArg === undefined ? {} : { sessionId: sessionIdArg }),
36
+ question: questionArg.question,
37
+ options: questionArg.options.map((optionArg) => ({ label: optionArg.label, description: optionArg.description })),
38
+ multiSelect: questionArg.multiple === true,
39
+ allowCustom: questionArg.custom !== false,
40
+ }));
package/ts_web/plugins.ts CHANGED
@@ -46,6 +46,7 @@ import type {
46
46
  ILiveBrowserPaintRendererOptions,
47
47
  IPaintPictureRendererOptions,
48
48
  TPaintPictureCapabilityReason,
49
+ PaintVideoRouteError,
49
50
  TPaintVideoRouteEndReason,
50
51
  ILiveBrowserPresentationRun,
51
52
  ILiveBrowserVideoClient,
@@ -95,6 +96,7 @@ export type {
95
96
  ILiveBrowserPaintRendererOptions,
96
97
  IPaintPictureRendererOptions,
97
98
  TPaintPictureCapabilityReason,
99
+ PaintVideoRouteError,
98
100
  TPaintVideoRouteEndReason,
99
101
  ILiveBrowserPresentationRun,
100
102
  ILiveBrowserVideoClient,