@aeolus-fleet/trierarch-plugin 0.0.0 → 0.20.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 (157) hide show
  1. package/LICENSE +201 -0
  2. package/README.md +39 -1
  3. package/dist/adapters/crypto/idempotency-keys.d.ts +3 -0
  4. package/dist/adapters/crypto/idempotency-keys.js +4 -0
  5. package/dist/adapters/crypto/idempotency-keys.js.map +1 -0
  6. package/dist/adapters/crypto/request-hasher.d.ts +3 -0
  7. package/dist/adapters/crypto/request-hasher.js +4 -0
  8. package/dist/adapters/crypto/request-hasher.js.map +1 -0
  9. package/dist/adapters/fleet/console-sessions.d.ts +2 -0
  10. package/dist/adapters/fleet/console-sessions.js +23 -0
  11. package/dist/adapters/fleet/console-sessions.js.map +1 -0
  12. package/dist/adapters/fleet/rest-fleet-door.d.ts +2 -0
  13. package/dist/adapters/fleet/rest-fleet-door.js +122 -0
  14. package/dist/adapters/fleet/rest-fleet-door.js.map +1 -0
  15. package/dist/adapters/http/version.d.ts +6 -0
  16. package/dist/adapters/http/version.js +12 -0
  17. package/dist/adapters/http/version.js.map +1 -0
  18. package/dist/adapters/prisma/client.d.ts +10 -0
  19. package/dist/adapters/prisma/client.js +20 -0
  20. package/dist/adapters/prisma/client.js.map +1 -0
  21. package/dist/adapters/prisma/connection-store.d.ts +4 -0
  22. package/dist/adapters/prisma/connection-store.js +28 -0
  23. package/dist/adapters/prisma/connection-store.js.map +1 -0
  24. package/dist/adapters/prisma/fleet-forgetter.d.ts +4 -0
  25. package/dist/adapters/prisma/fleet-forgetter.js +10 -0
  26. package/dist/adapters/prisma/fleet-forgetter.js.map +1 -0
  27. package/dist/adapters/prisma/fleet-switches.d.ts +4 -0
  28. package/dist/adapters/prisma/fleet-switches.js +10 -0
  29. package/dist/adapters/prisma/fleet-switches.js.map +1 -0
  30. package/dist/adapters/prisma/generated/browser.d.ts +24 -0
  31. package/dist/adapters/prisma/generated/browser.js +18 -0
  32. package/dist/adapters/prisma/generated/browser.js.map +1 -0
  33. package/dist/adapters/prisma/generated/client.d.ts +43 -0
  34. package/dist/adapters/prisma/generated/client.js +38 -0
  35. package/dist/adapters/prisma/generated/client.js.map +1 -0
  36. package/dist/adapters/prisma/generated/commonInputTypes.d.ts +235 -0
  37. package/dist/adapters/prisma/generated/commonInputTypes.js +11 -0
  38. package/dist/adapters/prisma/generated/commonInputTypes.js.map +1 -0
  39. package/dist/adapters/prisma/generated/enums.d.ts +1 -0
  40. package/dist/adapters/prisma/generated/enums.js +12 -0
  41. package/dist/adapters/prisma/generated/enums.js.map +1 -0
  42. package/dist/adapters/prisma/generated/internal/class.d.ts +154 -0
  43. package/dist/adapters/prisma/generated/internal/class.js +50 -0
  44. package/dist/adapters/prisma/generated/internal/class.js.map +1 -0
  45. package/dist/adapters/prisma/generated/internal/prismaNamespace.d.ts +766 -0
  46. package/dist/adapters/prisma/generated/internal/prismaNamespace.js +117 -0
  47. package/dist/adapters/prisma/generated/internal/prismaNamespace.js.map +1 -0
  48. package/dist/adapters/prisma/generated/internal/prismaNamespaceBrowser.d.ts +78 -0
  49. package/dist/adapters/prisma/generated/internal/prismaNamespaceBrowser.js +87 -0
  50. package/dist/adapters/prisma/generated/internal/prismaNamespaceBrowser.js.map +1 -0
  51. package/dist/adapters/prisma/generated/models/Connection.d.ts +1011 -0
  52. package/dist/adapters/prisma/generated/models/Connection.js +2 -0
  53. package/dist/adapters/prisma/generated/models/Connection.js.map +1 -0
  54. package/dist/adapters/prisma/generated/models/FleetSwitch.d.ts +945 -0
  55. package/dist/adapters/prisma/generated/models/FleetSwitch.js +2 -0
  56. package/dist/adapters/prisma/generated/models/FleetSwitch.js.map +1 -0
  57. package/dist/adapters/prisma/generated/models/InstallationRequest.d.ts +1030 -0
  58. package/dist/adapters/prisma/generated/models/InstallationRequest.js +2 -0
  59. package/dist/adapters/prisma/generated/models/InstallationRequest.js.map +1 -0
  60. package/dist/adapters/prisma/generated/models.d.ts +4 -0
  61. package/dist/adapters/prisma/generated/models.js +2 -0
  62. package/dist/adapters/prisma/generated/models.js.map +1 -0
  63. package/dist/adapters/prisma/installation-requests.d.ts +4 -0
  64. package/dist/adapters/prisma/installation-requests.js +25 -0
  65. package/dist/adapters/prisma/installation-requests.js.map +1 -0
  66. package/dist/adapters/prisma/migrate.d.ts +5 -0
  67. package/dist/adapters/prisma/migrate.js +40 -0
  68. package/dist/adapters/prisma/migrate.js.map +1 -0
  69. package/dist/adapters/trpc/router.d.ts +303 -0
  70. package/dist/adapters/trpc/router.js +227 -0
  71. package/dist/adapters/trpc/router.js.map +1 -0
  72. package/dist/app.d.ts +42 -0
  73. package/dist/app.js +205 -0
  74. package/dist/app.js.map +1 -0
  75. package/dist/bin/aeolus-trierarch-plugin.d.ts +2 -0
  76. package/dist/bin/aeolus-trierarch-plugin.js +61 -0
  77. package/dist/bin/aeolus-trierarch-plugin.js.map +1 -0
  78. package/dist/config.d.ts +32 -0
  79. package/dist/config.js +49 -0
  80. package/dist/config.js.map +1 -0
  81. package/dist/core/assignment/assign-crews.d.ts +27 -0
  82. package/dist/core/assignment/assign-crews.js +49 -0
  83. package/dist/core/assignment/assign-crews.js.map +1 -0
  84. package/dist/core/assignment/check-crew-settings.d.ts +19 -0
  85. package/dist/core/assignment/check-crew-settings.js +24 -0
  86. package/dist/core/assignment/check-crew-settings.js.map +1 -0
  87. package/dist/core/assignment/placement.d.ts +59 -0
  88. package/dist/core/assignment/placement.js +113 -0
  89. package/dist/core/assignment/placement.js.map +1 -0
  90. package/dist/core/assignment/read-placement.d.ts +17 -0
  91. package/dist/core/assignment/read-placement.js +39 -0
  92. package/dist/core/assignment/read-placement.js.map +1 -0
  93. package/dist/core/connection/connect.d.ts +26 -0
  94. package/dist/core/connection/connect.js +44 -0
  95. package/dist/core/connection/connect.js.map +1 -0
  96. package/dist/core/connection/ports.d.ts +177 -0
  97. package/dist/core/connection/ports.js +2 -0
  98. package/dist/core/connection/ports.js.map +1 -0
  99. package/dist/core/connection/read-connection.d.ts +14 -0
  100. package/dist/core/connection/read-connection.js +24 -0
  101. package/dist/core/connection/read-connection.js.map +1 -0
  102. package/dist/core/installation/delete-fleet.d.ts +21 -0
  103. package/dist/core/installation/delete-fleet.js +21 -0
  104. package/dist/core/installation/delete-fleet.js.map +1 -0
  105. package/dist/core/installation/ports.d.ts +46 -0
  106. package/dist/core/installation/ports.js +2 -0
  107. package/dist/core/installation/ports.js.map +1 -0
  108. package/dist/core/installation/read-fleet.d.ts +18 -0
  109. package/dist/core/installation/read-fleet.js +9 -0
  110. package/dist/core/installation/read-fleet.js.map +1 -0
  111. package/dist/core/installation/request-id.d.ts +8 -0
  112. package/dist/core/installation/request-id.js +10 -0
  113. package/dist/core/installation/request-id.js.map +1 -0
  114. package/dist/core/installation/served.d.ts +12 -0
  115. package/dist/core/installation/served.js +8 -0
  116. package/dist/core/installation/served.js.map +1 -0
  117. package/dist/core/installation/set-fleet-enabled.d.ts +24 -0
  118. package/dist/core/installation/set-fleet-enabled.js +21 -0
  119. package/dist/core/installation/set-fleet-enabled.js.map +1 -0
  120. package/dist/core/machines/join-machine.d.ts +40 -0
  121. package/dist/core/machines/join-machine.js +35 -0
  122. package/dist/core/machines/join-machine.js.map +1 -0
  123. package/dist/core/machines/label-machines.d.ts +25 -0
  124. package/dist/core/machines/label-machines.js +120 -0
  125. package/dist/core/machines/label-machines.js.map +1 -0
  126. package/dist/core/machines/list-machines.d.ts +34 -0
  127. package/dist/core/machines/list-machines.js +47 -0
  128. package/dist/core/machines/list-machines.js.map +1 -0
  129. package/dist/core/machines/ports.d.ts +4 -0
  130. package/dist/core/machines/ports.js +2 -0
  131. package/dist/core/machines/ports.js.map +1 -0
  132. package/dist/core/machines/silent.d.ts +9 -0
  133. package/dist/core/machines/silent.js +9 -0
  134. package/dist/core/machines/silent.js.map +1 -0
  135. package/dist/core/operator/authenticate-operator.d.ts +21 -0
  136. package/dist/core/operator/authenticate-operator.js +26 -0
  137. package/dist/core/operator/authenticate-operator.js.map +1 -0
  138. package/dist/core/operator/ports.d.ts +15 -0
  139. package/dist/core/operator/ports.js +2 -0
  140. package/dist/core/operator/ports.js.map +1 -0
  141. package/dist/core/shared/clock.d.ts +4 -0
  142. package/dist/core/shared/clock.js +2 -0
  143. package/dist/core/shared/clock.js.map +1 -0
  144. package/dist/core/shared/errors.d.ts +10 -0
  145. package/dist/core/shared/errors.js +6 -0
  146. package/dist/core/shared/errors.js.map +1 -0
  147. package/dist/core/shared/result.d.ts +16 -0
  148. package/dist/core/shared/result.js +7 -0
  149. package/dist/core/shared/result.js.map +1 -0
  150. package/dist/index.d.ts +3 -0
  151. package/dist/index.js +3 -0
  152. package/dist/index.js.map +1 -0
  153. package/package.json +47 -3
  154. package/prisma.config.ts +18 -0
  155. package/src/adapters/prisma/migrations/20261006220000_init/migration.sql +35 -0
  156. package/src/adapters/prisma/migrations/migration_lock.toml +3 -0
  157. package/src/adapters/prisma/schema.prisma +58 -0
@@ -0,0 +1,8 @@
1
+ import { type DomainError } from '../shared/errors.js';
2
+ import type { Err } from '../shared/result.js';
3
+ import type { InstallationRequest, InstallationRequests } from './ports.js';
4
+ /** What a request id already answered: the earlier request when it is the same one, a refusal when it was another. */
5
+ export declare function earlierAnswer(requests: InstallationRequests, request: {
6
+ requestId: string;
7
+ requestHash: string;
8
+ }): Promise<InstallationRequest | Err<DomainError<'REQUEST_ID_USED'>> | undefined>;
@@ -0,0 +1,10 @@
1
+ import { refuse } from '../shared/errors.js';
2
+ /** What a request id already answered: the earlier request when it is the same one, a refusal when it was another. */
3
+ export async function earlierAnswer(requests, request) {
4
+ const earlier = await requests.find(request.requestId);
5
+ if (!earlier) {
6
+ return undefined;
7
+ }
8
+ return earlier.requestHash === request.requestHash ? earlier : refuse('REQUEST_ID_USED', `The request id ${request.requestId} was used for another request`);
9
+ }
10
+ //# sourceMappingURL=request-id.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"request-id.js","sourceRoot":"","sources":["../../../src/core/installation/request-id.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAoB,MAAM,qBAAqB,CAAC;AAI/D,sHAAsH;AACtH,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,QAA8B,EAC9B,OAAmD;IAEnD,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IACvD,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,OAAO,OAAO,CAAC,WAAW,KAAK,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,iBAAiB,EAAE,kBAAkB,OAAO,CAAC,SAAS,+BAA+B,CAAC,CAAC;AAC/J,CAAC"}
@@ -0,0 +1,12 @@
1
+ import type { FleetId } from '@aeolus-fleet/common';
2
+ import type { FleetSwitches, InstallationMode } from './ports.js';
3
+ /** Whether the trierarch plugin serves the fleet now: off, it does nothing for that fleet. */
4
+ export type IsServed = (fleetId: FleetId) => Promise<boolean>;
5
+ /**
6
+ * Policy: the trierarch plugin serves every fleet of an open installation, and a fleet of
7
+ * an enabled one only once the hosting service switched it on (decision 0021).
8
+ */
9
+ export declare function createIsServed(deps: {
10
+ installation: InstallationMode;
11
+ switches: FleetSwitches;
12
+ }): IsServed;
@@ -0,0 +1,8 @@
1
+ /**
2
+ * Policy: the trierarch plugin serves every fleet of an open installation, and a fleet of
3
+ * an enabled one only once the hosting service switched it on (decision 0021).
4
+ */
5
+ export function createIsServed(deps) {
6
+ return async (fleetId) => deps.installation === 'open' || (await deps.switches.find(fleetId)) === true;
7
+ }
8
+ //# sourceMappingURL=served.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"served.js","sourceRoot":"","sources":["../../../src/core/installation/served.ts"],"names":[],"mappings":"AAOA;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,IAAiE;IAC9F,OAAO,KAAK,EAAE,OAAO,EAAE,EAAE,CAAC,IAAI,CAAC,YAAY,KAAK,MAAM,IAAI,CAAC,MAAM,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,KAAK,IAAI,CAAC;AACzG,CAAC"}
@@ -0,0 +1,24 @@
1
+ import type { FleetId } from '@aeolus-fleet/common';
2
+ import type { Clock } from '../shared/clock.js';
3
+ import type { DomainError } from '../shared/errors.js';
4
+ import { type Result } from '../shared/result.js';
5
+ import type { FleetSwitches, InstallationRequests, RequestHasher } from './ports.js';
6
+ export type SetFleetEnabled = (input: {
7
+ requestId: string;
8
+ fleetId: FleetId;
9
+ isEnabled: boolean;
10
+ }) => Promise<Result<{
11
+ fleetId: FleetId;
12
+ isEnabled: boolean;
13
+ }, DomainError<'REQUEST_ID_USED'>>>;
14
+ /**
15
+ * Use case: the hosting service switches the trierarch plugin on or off for a fleet
16
+ * (decision 0021). Off keeps everything of the fleet, so on again resumes. A
17
+ * replayed request id answers what it answered first and changes nothing.
18
+ */
19
+ export declare function createSetFleetEnabled(deps: {
20
+ switches: FleetSwitches;
21
+ requests: InstallationRequests;
22
+ hasher: RequestHasher;
23
+ clock: Clock;
24
+ }): SetFleetEnabled;
@@ -0,0 +1,21 @@
1
+ import { ok } from '../shared/result.js';
2
+ import { earlierAnswer } from './request-id.js';
3
+ /**
4
+ * Use case: the hosting service switches the trierarch plugin on or off for a fleet
5
+ * (decision 0021). Off keeps everything of the fleet, so on again resumes. A
6
+ * replayed request id answers what it answered first and changes nothing.
7
+ */
8
+ export function createSetFleetEnabled(deps) {
9
+ return async ({ requestId, fleetId, isEnabled }) => {
10
+ const requestHash = deps.hasher.hash(`setEnabled ${fleetId} ${String(isEnabled)}`);
11
+ const earlier = await earlierAnswer(deps.requests, { requestId, requestHash });
12
+ if (earlier !== undefined) {
13
+ return 'isOk' in earlier ? earlier : ok({ fleetId, isEnabled: earlier.isEnabled === true });
14
+ }
15
+ const at = deps.clock.now();
16
+ await deps.switches.set(fleetId, { isEnabled, at });
17
+ await deps.requests.record({ requestId, kind: 'setEnabled', requestHash, fleetId, isEnabled, at });
18
+ return ok({ fleetId, isEnabled });
19
+ };
20
+ }
21
+ //# sourceMappingURL=set-fleet-enabled.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"set-fleet-enabled.js","sourceRoot":"","sources":["../../../src/core/installation/set-fleet-enabled.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,EAAE,EAAe,MAAM,qBAAqB,CAAC;AAEtD,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAIhD;;;;GAIG;AACH,MAAM,UAAU,qBAAqB,CAAC,IAAsG;IAC1I,OAAO,KAAK,EAAE,EAAE,SAAS,EAAE,OAAO,EAAE,SAAS,EAAE,EAAE,EAAE;QACjD,MAAM,WAAW,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,cAAc,OAAO,IAAI,MAAM,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;QACnF,MAAM,OAAO,GAAG,MAAM,aAAa,CAAC,IAAI,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,WAAW,EAAE,CAAC,CAAC;QAC/E,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;YAC1B,OAAO,MAAM,IAAI,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,OAAO,EAAE,SAAS,EAAE,OAAO,CAAC,SAAS,KAAK,IAAI,EAAE,CAAC,CAAC;QAC9F,CAAC;QACD,MAAM,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC;QAC5B,MAAM,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC,CAAC;QACpD,MAAM,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,YAAY,EAAE,WAAW,EAAE,OAAO,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC,CAAC;QACnG,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC,CAAC;IACpC,CAAC,CAAC;AACJ,CAAC"}
@@ -0,0 +1,40 @@
1
+ import type { CrewLine, FleetId, ShipId } from '@aeolus-fleet/common';
2
+ import type { ConnectionStore, FleetDoor } from '../connection/ports.js';
3
+ import { type DomainError } from '../shared/errors.js';
4
+ import { type Result } from '../shared/result.js';
5
+ import type { IdempotencyKeys } from './ports.js';
6
+ /** The type of every machine's ship: its trierarch's. */
7
+ export declare const TRIERARCH_TYPE = "trierarch";
8
+ export type JoinRefusal = DomainError<'NOT_CONNECTED' | 'NAME_TAKEN' | 'FLEET_UNAVAILABLE'>;
9
+ /**
10
+ * A joined machine: its trierarch's ship, its starting prompt as the fleet
11
+ * issued it (decision 0019), and the line that sets the machine up, shown
12
+ * once like the secret it holds.
13
+ */
14
+ export interface JoinedMachine {
15
+ shipId: ShipId;
16
+ name: string;
17
+ prompt: string;
18
+ crewLines: CrewLine[];
19
+ secret: string;
20
+ setupLine: string;
21
+ }
22
+ export type JoinMachine = (input: {
23
+ fleetId: FleetId;
24
+ name: string;
25
+ }) => Promise<Result<JoinedMachine, JoinRefusal>>;
26
+ /**
27
+ * Use case: the operator brings a machine into the fleet. The trierarch
28
+ * plugin commissions its trierarch's ship, of type trierarch with crew:run
29
+ * beside the send and receive every agent ship has, under a new idempotency
30
+ * key, and answers its starting prompt with one ready-to-run setup line built
31
+ * from the fleet's URL, the ship's id and its secret: `aeolus-trierarch init`
32
+ * takes them as flags and never parses a prompt. The secret is never kept or
33
+ * logged.
34
+ */
35
+ export declare function createJoinMachine(deps: {
36
+ door: FleetDoor;
37
+ connections: ConnectionStore;
38
+ keys: IdempotencyKeys;
39
+ fleetUrl: string;
40
+ }): JoinMachine;
@@ -0,0 +1,35 @@
1
+ import { refuse } from '../shared/errors.js';
2
+ import { ok } from '../shared/result.js';
3
+ /** The type of every machine's ship: its trierarch's. */
4
+ export const TRIERARCH_TYPE = 'trierarch';
5
+ /** What a trierarch may do beyond sending and receiving: crew the ships assigned to it (decision 0030). */
6
+ const TRIERARCH_SCOPES = ['crew:run'];
7
+ /** The package a machine sets up its trierarch with. */
8
+ const TRIERARCH_PACKAGE = '@aeolus-fleet/trierarch';
9
+ /**
10
+ * Use case: the operator brings a machine into the fleet. The trierarch
11
+ * plugin commissions its trierarch's ship, of type trierarch with crew:run
12
+ * beside the send and receive every agent ship has, under a new idempotency
13
+ * key, and answers its starting prompt with one ready-to-run setup line built
14
+ * from the fleet's URL, the ship's id and its secret: `aeolus-trierarch init`
15
+ * takes them as flags and never parses a prompt. The secret is never kept or
16
+ * logged.
17
+ */
18
+ export function createJoinMachine(deps) {
19
+ return async ({ fleetId, name }) => {
20
+ const crew = await deps.connections.find(fleetId);
21
+ if (!crew) {
22
+ return refuse('NOT_CONNECTED', 'The trierarch plugin is not connected to this fleet: connect it in the console');
23
+ }
24
+ const commissioned = await deps.door.commission(crew.crewToken, { name, type: TRIERARCH_TYPE, fleetScopes: TRIERARCH_SCOPES, idempotencyKey: deps.keys.next() });
25
+ if (!commissioned.isOk) {
26
+ return commissioned.error.code === 'CONFLICT'
27
+ ? refuse('NAME_TAKEN', commissioned.error.message)
28
+ : refuse('FLEET_UNAVAILABLE', `The fleet did not commission the machine's ship: ${commissioned.error.message}`);
29
+ }
30
+ const { shipId, prompt, crewLines, secret } = commissioned.value;
31
+ const setupLine = `npx ${TRIERARCH_PACKAGE} init --fleet-url ${deps.fleetUrl} --ship-id ${shipId} --secret ${secret}`;
32
+ return ok({ shipId, name, prompt, crewLines, secret, setupLine });
33
+ };
34
+ }
35
+ //# sourceMappingURL=join-machine.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"join-machine.js","sourceRoot":"","sources":["../../../src/core/machines/join-machine.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,MAAM,EAAoB,MAAM,qBAAqB,CAAC;AAC/D,OAAO,EAAE,EAAE,EAAe,MAAM,qBAAqB,CAAC;AAGtD,yDAAyD;AACzD,MAAM,CAAC,MAAM,cAAc,GAAG,WAAW,CAAC;AAE1C,2GAA2G;AAC3G,MAAM,gBAAgB,GAAG,CAAC,UAAU,CAAC,CAAC;AAEtC,wDAAwD;AACxD,MAAM,iBAAiB,GAAG,yBAAyB,CAAC;AAoBpD;;;;;;;;GAQG;AACH,MAAM,UAAU,iBAAiB,CAAC,IAAgG;IAChI,OAAO,KAAK,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE;QACjC,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAClD,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,OAAO,MAAM,CAAC,eAAe,EAAE,gFAAgF,CAAC,CAAC;QACnH,CAAC;QACD,MAAM,YAAY,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,SAAS,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,cAAc,EAAE,WAAW,EAAE,gBAAgB,EAAE,cAAc,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QACjK,IAAI,CAAC,YAAY,CAAC,IAAI,EAAE,CAAC;YACvB,OAAO,YAAY,CAAC,KAAK,CAAC,IAAI,KAAK,UAAU;gBAC3C,CAAC,CAAC,MAAM,CAAC,YAAY,EAAE,YAAY,CAAC,KAAK,CAAC,OAAO,CAAC;gBAClD,CAAC,CAAC,MAAM,CAAC,mBAAmB,EAAE,oDAAoD,YAAY,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;QACpH,CAAC;QACD,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,YAAY,CAAC,KAAK,CAAC;QACjE,MAAM,SAAS,GAAG,OAAO,iBAAiB,qBAAqB,IAAI,CAAC,QAAQ,cAAc,MAAM,aAAa,MAAM,EAAE,CAAC;QACtH,OAAO,EAAE,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,CAAC;IACpE,CAAC,CAAC;AACJ,CAAC"}
@@ -0,0 +1,25 @@
1
+ import { type FleetId } from '@aeolus-fleet/common';
2
+ import type { ConnectionStore, FleetDoor } from '../connection/ports.js';
3
+ import { type DomainError } from '../shared/errors.js';
4
+ import { type Result } from '../shared/result.js';
5
+ /** What a pass did: the labels it defined and the values it put on and took off trierarch ships; why it labelled nothing, when it did not. */
6
+ export interface LabelOutcome {
7
+ defined: number;
8
+ assigned: number;
9
+ unassigned: number;
10
+ skipped?: string;
11
+ }
12
+ export type LabelMachines = (fleetId: FleetId) => Promise<Result<LabelOutcome, DomainError<'NOT_CONNECTED' | 'FLEET_UNAVAILABLE'>>>;
13
+ /**
14
+ * Use case: one pass of machine labels for a fleet (docs/trierarch.md,
15
+ * "Machine labels"). The trierarch plugin defines os and arch, which it owns,
16
+ * and labels each trierarch ship with the values its machine reports: the
17
+ * value it reports now goes on first, then any other value of that label comes
18
+ * off. A key another ship owns is left alone. Without the label scopes it
19
+ * labels nothing and says why. Placement reads the labels; a request already
20
+ * assigned stays where it is when they change.
21
+ */
22
+ export declare function createLabelMachines(deps: {
23
+ door: FleetDoor;
24
+ connections: ConnectionStore;
25
+ }): LabelMachines;
@@ -0,0 +1,120 @@
1
+ import { MACHINE_ARCH, MACHINE_OS, trierarchReportDetailsSchema } from '@aeolus-fleet/common';
2
+ import { refuse } from '../shared/errors.js';
3
+ import { ok } from '../shared/result.js';
4
+ import { TRIERARCH_TYPE } from './join-machine.js';
5
+ /** The machine labels the trierarch plugin owns: each key, its values, and the part of the report it is read from. */
6
+ const MACHINE_KEYS = [
7
+ { key: 'os', values: MACHINE_OS },
8
+ { key: 'arch', values: MACHINE_ARCH },
9
+ ];
10
+ const LABEL_SCOPES = ['labels:define', 'labels:assign'];
11
+ /** The refusals that mean the fleet changed since it was read (a key taken, a ship or value gone): read again on the next pass. */
12
+ const CHANGED = new Set(['CONFLICT', 'NOT_FOUND']);
13
+ const NO_LABEL_SCOPES = 'its ship holds no label scopes, and scopes never change: retire its ship and connect the trierarch plugin again to label machines';
14
+ /**
15
+ * Use case: one pass of machine labels for a fleet (docs/trierarch.md,
16
+ * "Machine labels"). The trierarch plugin defines os and arch, which it owns,
17
+ * and labels each trierarch ship with the values its machine reports: the
18
+ * value it reports now goes on first, then any other value of that label comes
19
+ * off. A key another ship owns is left alone. Without the label scopes it
20
+ * labels nothing and says why. Placement reads the labels; a request already
21
+ * assigned stays where it is when they change.
22
+ */
23
+ export function createLabelMachines(deps) {
24
+ const unavailable = (refusal) => refuse('FLEET_UNAVAILABLE', `The fleet did not answer the machine labels: ${refusal.message}`);
25
+ return async (fleetId) => {
26
+ const crew = await deps.connections.find(fleetId);
27
+ if (!crew) {
28
+ return refuse('NOT_CONNECTED', 'The trierarch plugin is not connected to this fleet: connect it in the console');
29
+ }
30
+ const own = await deps.door.getShip(crew.crewToken, { shipId: crew.shipId });
31
+ if (!own.isOk) {
32
+ return unavailable(own.error);
33
+ }
34
+ if (!LABEL_SCOPES.every((scope) => own.value.scopes.includes(scope))) {
35
+ return ok({ defined: 0, assigned: 0, unassigned: 0, skipped: NO_LABEL_SCOPES });
36
+ }
37
+ const done = await labelPass(deps.door, crew);
38
+ return done.isOk ? done : unavailable(done.error);
39
+ };
40
+ }
41
+ async function settle(done) {
42
+ const result = await done;
43
+ return result.isOk || !CHANGED.has(result.error.code) ? result : ok(undefined);
44
+ }
45
+ async function labelPass(door, crew) {
46
+ const outcome = { defined: 0, assigned: 0, unassigned: 0 };
47
+ const listed = await settle(door.listLabels(crew.crewToken));
48
+ if (!listed.isOk) {
49
+ return listed;
50
+ }
51
+ const labels = new Map();
52
+ for (const { key, values } of MACHINE_KEYS) {
53
+ const label = listed.value?.find((each) => each.key === key);
54
+ if (label !== undefined) {
55
+ if (label.ownerShipId === crew.shipId) {
56
+ labels.set(key, label);
57
+ }
58
+ continue;
59
+ }
60
+ const defined = await settle(door.defineLabel(crew.crewToken, { key, values: [...values] }));
61
+ if (!defined.isOk) {
62
+ return defined;
63
+ }
64
+ if (defined.value !== undefined) {
65
+ labels.set(key, { ...defined.value, key, ownerShipId: crew.shipId });
66
+ outcome.defined += 1;
67
+ }
68
+ }
69
+ const ships = await settle(door.listShips(crew.crewToken));
70
+ if (!ships.isOk) {
71
+ return ships;
72
+ }
73
+ for (const ship of (ships.value ?? []).filter((each) => each.type === TRIERARCH_TYPE && each.status !== 'retired')) {
74
+ const read = await settle(door.getShip(crew.crewToken, { shipId: ship.shipId }));
75
+ if (!read.isOk) {
76
+ return read;
77
+ }
78
+ const details = trierarchReportDetailsSchema.safeParse(read.value?.report?.details);
79
+ const machine = details.success ? details.data.machine : undefined;
80
+ for (const { key } of MACHINE_KEYS) {
81
+ const label = labels.get(key);
82
+ if (label === undefined) {
83
+ continue;
84
+ }
85
+ const relabelled = await relabel(door, {
86
+ crewToken: crew.crewToken,
87
+ ship,
88
+ wanted: label.values.find((each) => each.value === machine?.[key])?.valueId,
89
+ carried: ship.labels.filter((each) => each.labelId === label.labelId).map((each) => each.valueId),
90
+ });
91
+ if (!relabelled.isOk) {
92
+ return relabelled;
93
+ }
94
+ outcome.assigned += relabelled.value.assigned;
95
+ outcome.unassigned += relabelled.value.unassigned;
96
+ }
97
+ }
98
+ return ok(outcome);
99
+ }
100
+ /** Puts the wanted value on first, so the ship is never without the label while it changes; then takes every other value of the label off. */
101
+ async function relabel(door, change) {
102
+ const { crewToken, ship, wanted, carried } = change;
103
+ const counted = { assigned: 0, unassigned: 0 };
104
+ if (wanted !== undefined && !carried.includes(wanted)) {
105
+ const assigned = await door.assignLabel(crewToken, { shipId: ship.shipId, valueId: wanted });
106
+ if (!assigned.isOk && !CHANGED.has(assigned.error.code)) {
107
+ return assigned;
108
+ }
109
+ counted.assigned += assigned.isOk ? 1 : 0;
110
+ }
111
+ for (const valueId of carried.filter((each) => each !== wanted)) {
112
+ const unassigned = await door.unassignLabel(crewToken, { shipId: ship.shipId, valueId });
113
+ if (!unassigned.isOk && !CHANGED.has(unassigned.error.code)) {
114
+ return unassigned;
115
+ }
116
+ counted.unassigned += unassigned.isOk ? 1 : 0;
117
+ }
118
+ return ok(counted);
119
+ }
120
+ //# sourceMappingURL=label-machines.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"label-machines.js","sourceRoot":"","sources":["../../../src/core/machines/label-machines.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,34 @@
1
+ import { type FleetId, type ShipId, type TrierarchReportDetails } from '@aeolus-fleet/common';
2
+ import type { ConnectionStore, FleetDoor } from '../connection/ports.js';
3
+ import type { Clock } from '../shared/clock.js';
4
+ import { type DomainError } from '../shared/errors.js';
5
+ import { type Result } from '../shared/result.js';
6
+ /** A machine as the trierarch plugin reads it from the fleet: its trierarch's ship, its last report and what it reported it can do. */
7
+ export interface Machine {
8
+ shipId: ShipId;
9
+ name: string;
10
+ status: 'awaitingCrew' | 'crewed';
11
+ lastSeenAt: Date | null;
12
+ /** Its trierarch's last seen is older than the threshold: it gets no new requests, and keeps those it holds. */
13
+ isSilent: boolean;
14
+ report: {
15
+ state: string;
16
+ note: string | null;
17
+ reportedAt: Date;
18
+ } | null;
19
+ /** Null until its trierarch reports details, and for details that are not a trierarch's. */
20
+ details: TrierarchReportDetails | null;
21
+ }
22
+ export type ListMachines = (fleetId: FleetId) => Promise<Result<Machine[], DomainError<'NOT_CONNECTED' | 'FLEET_UNAVAILABLE'>>>;
23
+ /**
24
+ * Use case: the fleet's machines, read from the fleet each time: its active
25
+ * ships of type trierarch, each with its trierarch's last report and the
26
+ * details it reported (decision 0030), and whether it is silent. The
27
+ * trierarch plugin keeps none of it.
28
+ */
29
+ export declare function createListMachines(deps: {
30
+ door: FleetDoor;
31
+ connections: ConnectionStore;
32
+ clock: Clock;
33
+ silentAfterMs: number;
34
+ }): ListMachines;
@@ -0,0 +1,47 @@
1
+ import { trierarchReportDetailsSchema } from '@aeolus-fleet/common';
2
+ import { refuse } from '../shared/errors.js';
3
+ import { ok } from '../shared/result.js';
4
+ import { TRIERARCH_TYPE } from './join-machine.js';
5
+ import { isSilent } from './silent.js';
6
+ /**
7
+ * Use case: the fleet's machines, read from the fleet each time: its active
8
+ * ships of type trierarch, each with its trierarch's last report and the
9
+ * details it reported (decision 0030), and whether it is silent. The
10
+ * trierarch plugin keeps none of it.
11
+ */
12
+ export function createListMachines(deps) {
13
+ const unavailable = (message) => refuse('FLEET_UNAVAILABLE', `The fleet did not answer the machines: ${message}`);
14
+ return async (fleetId) => {
15
+ const crew = await deps.connections.find(fleetId);
16
+ if (!crew) {
17
+ return refuse('NOT_CONNECTED', 'The trierarch plugin is not connected to this fleet: connect it in the console');
18
+ }
19
+ const listed = await deps.door.listShips(crew.crewToken);
20
+ if (!listed.isOk) {
21
+ return unavailable(listed.error.message);
22
+ }
23
+ const machines = [];
24
+ for (const ship of listed.value) {
25
+ if (ship.type !== TRIERARCH_TYPE || ship.status === 'retired') {
26
+ continue;
27
+ }
28
+ const read = await deps.door.getShip(crew.crewToken, { shipId: ship.shipId });
29
+ if (!read.isOk) {
30
+ return unavailable(read.error.message);
31
+ }
32
+ const { report } = read.value;
33
+ const details = trierarchReportDetailsSchema.safeParse(report?.details);
34
+ machines.push({
35
+ shipId: ship.shipId,
36
+ name: ship.name,
37
+ status: ship.status,
38
+ lastSeenAt: ship.lastSeenAt,
39
+ isSilent: isSilent(ship.lastSeenAt, { now: deps.clock.now(), silentAfterMs: deps.silentAfterMs }),
40
+ report: report && { state: report.state, note: report.note, reportedAt: report.reportedAt },
41
+ details: details.success ? details.data : null,
42
+ });
43
+ }
44
+ return ok(machines);
45
+ };
46
+ }
47
+ //# sourceMappingURL=list-machines.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"list-machines.js","sourceRoot":"","sources":["../../../src/core/machines/list-machines.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,4BAA4B,EAA0D,MAAM,sBAAsB,CAAC;AAI5H,OAAO,EAAE,MAAM,EAAoB,MAAM,qBAAqB,CAAC;AAC/D,OAAO,EAAE,EAAE,EAAe,MAAM,qBAAqB,CAAC;AACtD,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAiBvC;;;;;GAKG;AACH,MAAM,UAAU,kBAAkB,CAAC,IAA4F;IAC7H,MAAM,WAAW,GAAG,CAAC,OAAe,EAAE,EAAE,CAAC,MAAM,CAAC,mBAAmB,EAAE,0CAA0C,OAAO,EAAE,CAAC,CAAC;IAC1H,OAAO,KAAK,EAAE,OAAO,EAAE,EAAE;QACvB,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAClD,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,OAAO,MAAM,CAAC,eAAe,EAAE,gFAAgF,CAAC,CAAC;QACnH,CAAC;QACD,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACzD,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;YACjB,OAAO,WAAW,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAC3C,CAAC;QACD,MAAM,QAAQ,GAAc,EAAE,CAAC;QAC/B,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;YAChC,IAAI,IAAI,CAAC,IAAI,KAAK,cAAc,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;gBAC9D,SAAS;YACX,CAAC;YACD,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;YAC9E,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;gBACf,OAAO,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;YACzC,CAAC;YACD,MAAM,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC;YAC9B,MAAM,OAAO,GAAG,4BAA4B,CAAC,SAAS,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;YACxE,QAAQ,CAAC,IAAI,CAAC;gBACZ,MAAM,EAAE,IAAI,CAAC,MAAM;gBACnB,IAAI,EAAE,IAAI,CAAC,IAAI;gBACf,MAAM,EAAE,IAAI,CAAC,MAAM;gBACnB,UAAU,EAAE,IAAI,CAAC,UAAU;gBAC3B,QAAQ,EAAE,QAAQ,CAAC,IAAI,CAAC,UAAU,EAAE,EAAE,GAAG,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,EAAE,aAAa,EAAE,IAAI,CAAC,aAAa,EAAE,CAAC;gBACjG,MAAM,EAAE,MAAM,IAAI,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,UAAU,EAAE,MAAM,CAAC,UAAU,EAAE;gBAC3F,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI;aAC/C,CAAC,CAAC;QACL,CAAC;QACD,OAAO,EAAE,CAAC,QAAQ,CAAC,CAAC;IACtB,CAAC,CAAC;AACJ,CAAC"}
@@ -0,0 +1,4 @@
1
+ /** Outbound port: a new idempotency key for each commission the trierarch plugin makes. */
2
+ export interface IdempotencyKeys {
3
+ next(): string;
4
+ }
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=ports.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"ports.js","sourceRoot":"","sources":["../../../src/core/machines/ports.ts"],"names":[],"mappings":""}
@@ -0,0 +1,9 @@
1
+ /**
2
+ * Policy: a machine is silent once its trierarch's last seen is older than
3
+ * the threshold (docs/trierarch.md, "Assignment"). A trierarch no session
4
+ * crews has no last seen and is never silent. Nothing moves because of it.
5
+ */
6
+ export declare function isSilent(lastSeenAt: Date | null, at: {
7
+ now: Date;
8
+ silentAfterMs: number;
9
+ }): boolean;
@@ -0,0 +1,9 @@
1
+ /**
2
+ * Policy: a machine is silent once its trierarch's last seen is older than
3
+ * the threshold (docs/trierarch.md, "Assignment"). A trierarch no session
4
+ * crews has no last seen and is never silent. Nothing moves because of it.
5
+ */
6
+ export function isSilent(lastSeenAt, at) {
7
+ return lastSeenAt !== null && at.now.getTime() - lastSeenAt.getTime() > at.silentAfterMs;
8
+ }
9
+ //# sourceMappingURL=silent.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"silent.js","sourceRoot":"","sources":["../../../src/core/machines/silent.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,UAAU,QAAQ,CAAC,UAAuB,EAAE,EAAwC;IACxF,OAAO,UAAU,KAAK,IAAI,IAAI,EAAE,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,UAAU,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,aAAa,CAAC;AAC3F,CAAC"}
@@ -0,0 +1,21 @@
1
+ import type { FleetId, Scope } from '@aeolus-fleet/common';
2
+ import { type DomainError } from '../shared/errors.js';
3
+ import { type Result } from '../shared/result.js';
4
+ import type { ConsoleSessions } from './ports.js';
5
+ export type AuthenticateOperator = (cookie: string | undefined) => Promise<Result<{
6
+ fleetId: FleetId;
7
+ scopes: readonly Scope[];
8
+ }, DomainError<'NOT_THE_OPERATOR'>>>;
9
+ /**
10
+ * Use case: whether a request comes from the operator. The trierarch plugin has no login
11
+ * of its own: the console's server forwards the console session cookie, and
12
+ * the fleet says whose session it is (decisions 0017, 0030). The trierarch plugin serves every
13
+ * fleet at its FLEET_URL, each with its own connection, so any signed-in
14
+ * operator there is let through as the operator of their own fleet. A
15
+ * viewer session is let through too, with the viewer ship's scopes, which
16
+ * the fleet answers; what each scope may call is the API's to check
17
+ * (decision 0022).
18
+ */
19
+ export declare function createAuthenticateOperator(deps: {
20
+ sessions: ConsoleSessions;
21
+ }): AuthenticateOperator;
@@ -0,0 +1,26 @@
1
+ import { refuse } from '../shared/errors.js';
2
+ import { ok } from '../shared/result.js';
3
+ /**
4
+ * Use case: whether a request comes from the operator. The trierarch plugin has no login
5
+ * of its own: the console's server forwards the console session cookie, and
6
+ * the fleet says whose session it is (decisions 0017, 0030). The trierarch plugin serves every
7
+ * fleet at its FLEET_URL, each with its own connection, so any signed-in
8
+ * operator there is let through as the operator of their own fleet. A
9
+ * viewer session is let through too, with the viewer ship's scopes, which
10
+ * the fleet answers; what each scope may call is the API's to check
11
+ * (decision 0022).
12
+ */
13
+ export function createAuthenticateOperator(deps) {
14
+ const refusal = refuse('NOT_THE_OPERATOR', 'Sign in to the console of your fleet');
15
+ return async (cookie) => {
16
+ if (cookie === undefined) {
17
+ return refusal;
18
+ }
19
+ const session = await deps.sessions.check(cookie);
20
+ if (!session.isOk) {
21
+ return refusal;
22
+ }
23
+ return ok({ fleetId: session.value.fleetId, scopes: session.value.scopes });
24
+ };
25
+ }
26
+ //# sourceMappingURL=authenticate-operator.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"authenticate-operator.js","sourceRoot":"","sources":["../../../src/core/operator/authenticate-operator.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,MAAM,EAAoB,MAAM,qBAAqB,CAAC;AAC/D,OAAO,EAAE,EAAE,EAAe,MAAM,qBAAqB,CAAC;AAKtD;;;;;;;;;GASG;AACH,MAAM,UAAU,0BAA0B,CAAC,IAAmC;IAC5E,MAAM,OAAO,GAAG,MAAM,CAAC,kBAAkB,EAAE,sCAAsC,CAAC,CAAC;IACnF,OAAO,KAAK,EAAE,MAAM,EAAE,EAAE;QACtB,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YACzB,OAAO,OAAO,CAAC;QACjB,CAAC;QACD,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QAClD,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;YAClB,OAAO,OAAO,CAAC;QACjB,CAAC;QACD,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;IAC9E,CAAC,CAAC;AACJ,CAAC"}
@@ -0,0 +1,15 @@
1
+ import type { ConsoleSessionOutput, FleetId, Scope } from '@aeolus-fleet/common';
2
+ import type { FleetRefusal } from '../connection/ports.js';
3
+ import type { Result } from '../shared/result.js';
4
+ /**
5
+ * Outbound port: asks the fleet whether a forwarded console session cookie is
6
+ * a signed-in operator's or a viewer's (`console.session`, decisions 0012 and
7
+ * 0022), with its ship's scopes.
8
+ */
9
+ export interface ConsoleSessions {
10
+ check(cookie: string): Promise<Result<{
11
+ fleetId: FleetId;
12
+ kind: ConsoleSessionOutput['kind'];
13
+ scopes: readonly Scope[];
14
+ }, FleetRefusal>>;
15
+ }
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=ports.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"ports.js","sourceRoot":"","sources":["../../../src/core/operator/ports.ts"],"names":[],"mappings":""}
@@ -0,0 +1,4 @@
1
+ /** Outbound port: the time now. Tests hold their own clock. */
2
+ export interface Clock {
3
+ now(): Date;
4
+ }
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=clock.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"clock.js","sourceRoot":"","sources":["../../../src/core/shared/clock.ts"],"names":[],"mappings":""}
@@ -0,0 +1,10 @@
1
+ import { type Err } from './result.js';
2
+ /** Every reason the trierarch plugin's core refuses a request. */
3
+ export type DomainErrorKind = 'ALREADY_CONNECTED' | 'SECRET_REFUSED' | 'OTHER_FLEET' | 'MISSING_SCOPES' | 'NOT_THE_OPERATOR' | 'REQUEST_ID_USED' | 'NOT_CONNECTED' | 'NAME_TAKEN' | 'FLEET_UNAVAILABLE';
4
+ /** Why the core refused a request. Adapters map the kind to their own error shape; the message is safe to show. */
5
+ export interface DomainError<K extends DomainErrorKind = DomainErrorKind> {
6
+ readonly kind: K;
7
+ readonly message: string;
8
+ }
9
+ /** A refusal: the error result of the given kind. */
10
+ export declare function refuse<K extends DomainErrorKind>(kind: K, message: string): Err<DomainError<K>>;
@@ -0,0 +1,6 @@
1
+ import { err } from './result.js';
2
+ /** A refusal: the error result of the given kind. */
3
+ export function refuse(kind, message) {
4
+ return err({ kind, message });
5
+ }
6
+ //# sourceMappingURL=errors.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../src/core/shared/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAY,MAAM,aAAa,CAAC;AAoB5C,qDAAqD;AACrD,MAAM,UAAU,MAAM,CAA4B,IAAO,EAAE,OAAe;IACxE,OAAO,GAAG,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;AAChC,CAAC"}
@@ -0,0 +1,16 @@
1
+ /**
2
+ * The outcome of a domain operation: its value, or why the domain refused.
3
+ * The core never throws; only adapters throw, for system failures such as a
4
+ * lost database connection.
5
+ */
6
+ export type Result<T, E> = Ok<T> | Err<E>;
7
+ export interface Ok<T> {
8
+ readonly isOk: true;
9
+ readonly value: T;
10
+ }
11
+ export interface Err<E> {
12
+ readonly isOk: false;
13
+ readonly error: E;
14
+ }
15
+ export declare function ok<T>(value: T): Ok<T>;
16
+ export declare function err<E>(error: E): Err<E>;
@@ -0,0 +1,7 @@
1
+ export function ok(value) {
2
+ return { isOk: true, value };
3
+ }
4
+ export function err(error) {
5
+ return { isOk: false, error };
6
+ }
7
+ //# sourceMappingURL=result.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"result.js","sourceRoot":"","sources":["../../../src/core/shared/result.ts"],"names":[],"mappings":"AAiBA,MAAM,UAAU,EAAE,CAAI,KAAQ;IAC5B,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;AAC/B,CAAC;AAED,MAAM,UAAU,GAAG,CAAI,KAAQ;IAC7B,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;AAChC,CAAC"}
@@ -0,0 +1,3 @@
1
+ /** The trierarch plugin package's entry: its app, for whoever runs or tests it beside the fleet. */
2
+ export { createTrierarchPluginApp, type TrierarchPluginApp } from './app.js';
3
+ export type { TrierarchPluginRouter } from './adapters/trpc/router.js';