@aeolus-fleet/trierarch-plugin 0.39.0 → 0.40.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 (121) hide show
  1. package/README.md +19 -9
  2. package/dist/adapters/crypto/sealed-box-sealer.d.ts +1 -1
  3. package/dist/adapters/fleet/console-sessions.js +3 -3
  4. package/dist/adapters/fleet/console-sessions.js.map +1 -1
  5. package/dist/adapters/fleet/core-version.d.ts +1 -1
  6. package/dist/adapters/fleet/core-version.js +1 -1
  7. package/dist/adapters/fleet/rest-fleet-door.js +1 -1
  8. package/dist/adapters/fleet/rest-fleet-door.js.map +1 -1
  9. package/dist/adapters/prisma/fleet-forgetter.d.ts +1 -1
  10. package/dist/adapters/prisma/fleet-forgetter.js +2 -2
  11. package/dist/adapters/prisma/fleet-forgetter.js.map +1 -1
  12. package/dist/adapters/prisma/generated/browser.d.ts +32 -0
  13. package/dist/adapters/prisma/generated/client.d.ts +32 -0
  14. package/dist/adapters/prisma/generated/commonInputTypes.d.ts +150 -0
  15. package/dist/adapters/prisma/generated/internal/class.d.ts +44 -0
  16. package/dist/adapters/prisma/generated/internal/class.js +4 -4
  17. package/dist/adapters/prisma/generated/internal/class.js.map +1 -1
  18. package/dist/adapters/prisma/generated/internal/prismaNamespace.d.ts +360 -1
  19. package/dist/adapters/prisma/generated/internal/prismaNamespace.js +46 -1
  20. package/dist/adapters/prisma/generated/internal/prismaNamespace.js.map +1 -1
  21. package/dist/adapters/prisma/generated/internal/prismaNamespaceBrowser.d.ts +51 -0
  22. package/dist/adapters/prisma/generated/internal/prismaNamespaceBrowser.js +46 -1
  23. package/dist/adapters/prisma/generated/internal/prismaNamespaceBrowser.js.map +1 -1
  24. package/dist/adapters/prisma/generated/models/McpConfiguration.d.ts +1004 -0
  25. package/dist/adapters/prisma/generated/models/McpConfiguration.js +2 -0
  26. package/dist/adapters/prisma/generated/models/McpConfiguration.js.map +1 -0
  27. package/dist/adapters/prisma/generated/models/McpConfigurationEvent.d.ts +1141 -0
  28. package/dist/adapters/prisma/generated/models/McpConfigurationEvent.js +2 -0
  29. package/dist/adapters/prisma/generated/models/McpConfigurationEvent.js.map +1 -0
  30. package/dist/adapters/prisma/generated/models/McpDelivery.d.ts +1204 -0
  31. package/dist/adapters/prisma/generated/models/McpDelivery.js +2 -0
  32. package/dist/adapters/prisma/generated/models/McpDelivery.js.map +1 -0
  33. package/dist/adapters/prisma/generated/models/McpSecret.d.ts +948 -0
  34. package/dist/adapters/prisma/generated/models/McpSecret.js +2 -0
  35. package/dist/adapters/prisma/generated/models/McpSecret.js.map +1 -0
  36. package/dist/adapters/prisma/generated/models.d.ts +4 -0
  37. package/dist/adapters/prisma/mcp-configurations.d.ts +11 -0
  38. package/dist/adapters/prisma/mcp-configurations.js +44 -0
  39. package/dist/adapters/prisma/mcp-configurations.js.map +1 -0
  40. package/dist/adapters/prisma/mcp-deliveries.d.ts +9 -0
  41. package/dist/adapters/prisma/mcp-deliveries.js +47 -0
  42. package/dist/adapters/prisma/mcp-deliveries.js.map +1 -0
  43. package/dist/adapters/trpc/router.d.ts +63 -5
  44. package/dist/adapters/trpc/router.js +60 -2
  45. package/dist/adapters/trpc/router.js.map +1 -1
  46. package/dist/app.d.ts +2 -6
  47. package/dist/app.js +56 -59
  48. package/dist/app.js.map +1 -1
  49. package/dist/bin/aeolus-trierarch-plugin.js +1 -2
  50. package/dist/bin/aeolus-trierarch-plugin.js.map +1 -1
  51. package/dist/config.d.ts +6 -10
  52. package/dist/config.js +5 -54
  53. package/dist/config.js.map +1 -1
  54. package/dist/core/assignment/assign-crews.d.ts +5 -1
  55. package/dist/core/assignment/assign-crews.js +4 -2
  56. package/dist/core/assignment/assign-crews.js.map +1 -1
  57. package/dist/core/assignment/check-crew-settings.d.ts +3 -0
  58. package/dist/core/assignment/check-crew-settings.js +2 -1
  59. package/dist/core/assignment/check-crew-settings.js.map +1 -1
  60. package/dist/core/assignment/placement.d.ts +3 -1
  61. package/dist/core/assignment/placement.js +27 -7
  62. package/dist/core/assignment/placement.js.map +1 -1
  63. package/dist/core/assignment/read-placement.d.ts +7 -1
  64. package/dist/core/assignment/read-placement.js +14 -2
  65. package/dist/core/assignment/read-placement.js.map +1 -1
  66. package/dist/core/connection/ports.d.ts +2 -0
  67. package/dist/core/mcp-configuration/distribute-mcp-configuration.d.ts +38 -0
  68. package/dist/core/mcp-configuration/distribute-mcp-configuration.js +97 -0
  69. package/dist/core/mcp-configuration/distribute-mcp-configuration.js.map +1 -0
  70. package/dist/core/mcp-configuration/mcp-configuration.d.ts +107 -0
  71. package/dist/core/mcp-configuration/mcp-configuration.js +205 -0
  72. package/dist/core/mcp-configuration/mcp-configuration.js.map +1 -0
  73. package/dist/core/mcp-configuration/mcp-delivery.d.ts +59 -0
  74. package/dist/core/mcp-configuration/mcp-delivery.js +32 -0
  75. package/dist/core/mcp-configuration/mcp-delivery.js.map +1 -0
  76. package/dist/core/mcp-configuration/ports.d.ts +79 -0
  77. package/dist/core/mcp-configuration/ports.js.map +1 -0
  78. package/dist/core/mcp-configuration/read-mcp-configuration.d.ts +8 -0
  79. package/dist/core/mcp-configuration/read-mcp-configuration.js +6 -0
  80. package/dist/core/mcp-configuration/read-mcp-configuration.js.map +1 -0
  81. package/dist/core/mcp-configuration/replace-mcp-configuration.d.ts +24 -0
  82. package/dist/core/mcp-configuration/replace-mcp-configuration.js +30 -0
  83. package/dist/core/mcp-configuration/replace-mcp-configuration.js.map +1 -0
  84. package/dist/core/mcp-configuration/sealing-key.js.map +1 -0
  85. package/dist/core/mcp-configuration/take-mcp-configuration-message.d.ts +30 -0
  86. package/dist/core/mcp-configuration/take-mcp-configuration-message.js +74 -0
  87. package/dist/core/mcp-configuration/take-mcp-configuration-message.js.map +1 -0
  88. package/dist/core/operator/authenticate-operator.d.ts +3 -1
  89. package/dist/core/operator/authenticate-operator.js +7 -4
  90. package/dist/core/operator/authenticate-operator.js.map +1 -1
  91. package/dist/core/operator/ports.d.ts +2 -1
  92. package/dist/core/shared/errors.d.ts +1 -1
  93. package/dist/core/shared/errors.js.map +1 -1
  94. package/package.json +3 -3
  95. package/src/adapters/prisma/migrations/20261109120000_mcp_configurations/migration.sql +35 -0
  96. package/src/adapters/prisma/migrations/20261109130000_mcp_deliveries/migration.sql +15 -0
  97. package/src/adapters/prisma/schema.prisma +65 -0
  98. package/dist/core/mcp-servers/mcp-servers.d.ts +0 -46
  99. package/dist/core/mcp-servers/mcp-servers.js +0 -112
  100. package/dist/core/mcp-servers/mcp-servers.js.map +0 -1
  101. package/dist/core/mcp-servers/ports.d.ts +0 -13
  102. package/dist/core/mcp-servers/ports.js.map +0 -1
  103. package/dist/core/mcp-servers/resend-mcp-servers.d.ts +0 -15
  104. package/dist/core/mcp-servers/resend-mcp-servers.js +0 -19
  105. package/dist/core/mcp-servers/resend-mcp-servers.js.map +0 -1
  106. package/dist/core/mcp-servers/resend-secrets.d.ts +0 -15
  107. package/dist/core/mcp-servers/resend-secrets.js +0 -19
  108. package/dist/core/mcp-servers/resend-secrets.js.map +0 -1
  109. package/dist/core/mcp-servers/sealing-key.js.map +0 -1
  110. package/dist/core/mcp-servers/secrets.d.ts +0 -31
  111. package/dist/core/mcp-servers/secrets.js +0 -90
  112. package/dist/core/mcp-servers/secrets.js.map +0 -1
  113. package/dist/core/mcp-servers/share-mcp-servers.d.ts +0 -25
  114. package/dist/core/mcp-servers/share-mcp-servers.js +0 -45
  115. package/dist/core/mcp-servers/share-mcp-servers.js.map +0 -1
  116. package/dist/core/mcp-servers/share-secrets.d.ts +0 -36
  117. package/dist/core/mcp-servers/share-secrets.js +0 -71
  118. package/dist/core/mcp-servers/share-secrets.js.map +0 -1
  119. /package/dist/core/{mcp-servers → mcp-configuration}/ports.js +0 -0
  120. /package/dist/core/{mcp-servers → mcp-configuration}/sealing-key.d.ts +0 -0
  121. /package/dist/core/{mcp-servers → mcp-configuration}/sealing-key.js +0 -0
@@ -0,0 +1,205 @@
1
+ /**
2
+ * A fleet's MCP configuration (the fleet crew MCP design, section 4): the
3
+ * remote servers (Streamable HTTP) a session of that fleet may be crewed
4
+ * with, each by name with its URL, the tools a session may call and the
5
+ * credential its proxy adds, and the secrets those credentials name, with
6
+ * their values. One current set per fleet, in the trierarch plugin's own
7
+ * database, at a version that moves on by one with every replacement. A
8
+ * replacement is whole: the complete server list, the complete list of the
9
+ * secrets it retains and the values it sets. A value is never shown, logged
10
+ * or told in a reason; it leaves the trierarch plugin only sealed to a
11
+ * trierarch's key, so the set, once sealed, fits one message.
12
+ */
13
+ import { PAYLOAD_MAX_BYTES, payloadBytes, trierarchNameSchema } from '@aeolus-fleet/common';
14
+ import { z } from 'zod';
15
+ import { refuse } from '../shared/errors.js';
16
+ import { ok } from '../shared/result.js';
17
+ /** A fleet's set before its first replacement. */
18
+ export const EMPTY_MCP_CONFIGURATION = { version: 0, servers: [], secrets: [] };
19
+ /** The content type of the message that carries a fleet's set, whole and sealed, to a trierarch. */
20
+ export const MCP_CONFIGURATION_CONTENT_TYPE = 'application/vnd.aeolus.trierarch.mcp-configuration+json';
21
+ /** The content type of the message a trierarch asks for its fleet's set with. */
22
+ export const MCP_CONFIGURATION_REQUEST_CONTENT_TYPE = 'application/vnd.aeolus.trierarch.mcp-configuration-request+json';
23
+ /** The content type of the message a trierarch confirms with that it applied a version, sealed to a key. */
24
+ export const MCP_CONFIGURATION_APPLIED_CONTENT_TYPE = 'application/vnd.aeolus.trierarch.mcp-configuration-applied+json';
25
+ /** The one transport a server speaks (decision M8), named in each server of the message. */
26
+ const TRANSPORT = 'streamable-http';
27
+ const BYTES_PER_KB = 1024;
28
+ /** The most a value may hold, in bytes of UTF-8, as the trierarch takes it. */
29
+ const VALUE_MAX_BYTES = 8192;
30
+ /** What a sealed box adds to the value: the ephemeral public key and the tag. */
31
+ const SEALED_BOX_OVERHEAD_BYTES = 48;
32
+ /** A public key of the sealing scheme, in bytes. */
33
+ const PUBLIC_KEY_BYTES = 32;
34
+ /** A ship id as the fleet makes one, every id the same length: what the size check counts for the plugin's ship. */
35
+ const SHIP_ID_SHAPE = `shp_${'0'.repeat(26)}`;
36
+ const URL_REFUSED = 'an MCP server is an http:// or https:// URL with no user, query or fragment, never a credential';
37
+ const VALUE_REFUSED = `a value is 1 to ${String(VALUE_MAX_BYTES)} bytes of UTF-8 with no CR, LF or NUL`;
38
+ /** Whether the URL is a remote server's, which carries no credential in itself. */
39
+ function isCredentialFree(url) {
40
+ if (!URL.canParse(url)) {
41
+ return false;
42
+ }
43
+ const parsed = new URL(url);
44
+ return (parsed.protocol === 'https:' || parsed.protocol === 'http:') && parsed.hostname !== '' && parsed.username === '' && parsed.password === '' && parsed.search === '' && parsed.hash === '';
45
+ }
46
+ /** An HTTP field name: an RFC 9110 token. */
47
+ const HEADER_TOKEN = /^[!#$%&'*+\-.^_`|~0-9A-Za-z]+$/;
48
+ /** The headers the proxy itself owns, or that frame the request or its session: never a credential's. */
49
+ const HEADERS_REFUSED = new Set(['host', 'content-length', 'transfer-encoding', 'connection', 'upgrade', 'te', 'trailer', 'keep-alive', 'cookie', 'content-type', 'accept', 'accept-encoding', 'last-event-id', 'mcp-session-id', 'mcp-protocol-version']);
50
+ /** Whether a credential may go in the header: a token the proxy does not own. */
51
+ function isCredentialHeader(header) {
52
+ const lower = header.toLowerCase();
53
+ return HEADER_TOKEN.test(header) && !HEADERS_REFUSED.has(lower) && !lower.startsWith('proxy-');
54
+ }
55
+ const serverSchema = z.object({
56
+ url: z.string().refine(isCredentialFree, { error: URL_REFUSED }),
57
+ credential: z.object({ secret: trierarchNameSchema, header: z.string().refine(isCredentialHeader, { error: 'a credential header is an HTTP field name the proxy does not set itself' }) }).optional(),
58
+ tools: z
59
+ .array(z.string().min(1, { error: 'a tool has a name' }))
60
+ .min(1, { error: 'a server lists the tools a session may call' })
61
+ .refine((tools) => new Set(tools).size === tools.length, { error: 'a tool is listed once' }),
62
+ });
63
+ /** Whether the value can go in an HTTP header verbatim and the trierarch takes it. */
64
+ function isValue(value) {
65
+ const bytes = Buffer.byteLength(value, 'utf8');
66
+ return bytes >= 1 && bytes <= VALUE_MAX_BYTES && !['\r', '\n', '\u0000'].some((refused) => value.includes(refused));
67
+ }
68
+ /** The length of standard base64 with padding of so many bytes. */
69
+ function base64Length(bytes) {
70
+ const BASE64_GROUP_BYTES = 3;
71
+ const BASE64_GROUP_CHARACTERS = 4;
72
+ return Math.ceil(bytes / BASE64_GROUP_BYTES) * BASE64_GROUP_CHARACTERS;
73
+ }
74
+ const byName = (first, second) => first.name.localeCompare(second.name);
75
+ const invalid = (message) => refuse('INVALID_CONFIGURATION', message);
76
+ /** The servers, read and in name order, or why not: each told by its name, or by its position when its name is not one. */
77
+ function readServers(listed) {
78
+ const servers = [];
79
+ for (const [index, server] of listed.entries()) {
80
+ const named = trierarchNameSchema.safeParse(server.name);
81
+ if (!named.success) {
82
+ return invalid(`server ${String(index + 1)}: ${named.error.issues[0]?.message ?? 'not a name'}`);
83
+ }
84
+ if (servers.some((each) => each.name === server.name)) {
85
+ return invalid(`${server.name}: a server is named once`);
86
+ }
87
+ const read = serverSchema.safeParse(server);
88
+ if (!read.success) {
89
+ return invalid(`${server.name}: ${read.error.issues[0]?.message ?? 'not a server'}`);
90
+ }
91
+ const { url, tools, credential } = read.data;
92
+ servers.push(credential === undefined ? { name: server.name, url, tools } : { name: server.name, url, tools, credential: { secret: credential.secret, header: credential.header } });
93
+ }
94
+ return ok(servers.sort(byName));
95
+ }
96
+ /**
97
+ * The secrets the replacement retains, each with its new value or the one it
98
+ * holds, in name order, or why not. A name that fails the rules may be a
99
+ * value put in its place, so it is told by position; so is a value's name
100
+ * the retained list does not hold.
101
+ */
102
+ function readSecrets(current, replacement) {
103
+ const secrets = [];
104
+ for (const [index, name] of replacement.secrets.entries()) {
105
+ if (!trierarchNameSchema.safeParse(name).success) {
106
+ return invalid(`secret ${String(index + 1)}: not a name: a secret is named as a server is`);
107
+ }
108
+ if (secrets.some((each) => each.name === name)) {
109
+ return invalid(`${name}: a secret is retained once`);
110
+ }
111
+ const value = Object.hasOwn(replacement.secretValues, name) ? replacement.secretValues[name] : current.secrets.find((each) => each.name === name)?.value;
112
+ if (value === undefined) {
113
+ return invalid(`${name}: a retained secret needs a value until it holds one`);
114
+ }
115
+ if (!isValue(value)) {
116
+ return invalid(`${name}: ${VALUE_REFUSED}`);
117
+ }
118
+ secrets.push({ name, value });
119
+ }
120
+ const unretained = Object.keys(replacement.secretValues).findIndex((name) => !replacement.secrets.includes(name));
121
+ if (unretained !== -1) {
122
+ return invalid(`secret value ${String(unretained + 1)}: names no secret the replacement retains`);
123
+ }
124
+ return ok(secrets.sort(byName));
125
+ }
126
+ /** The names whose entry the replacement added, removed or changed, in name order. */
127
+ function changedNames({ before, after }, isSame) {
128
+ const names = new Set([...before, ...after].map((each) => each.name));
129
+ return [...names]
130
+ .filter((name) => {
131
+ const old = before.find((each) => each.name === name);
132
+ const updated = after.find((each) => each.name === name);
133
+ return old === undefined || updated === undefined || !isSame(old, updated);
134
+ })
135
+ .sort((first, second) => first.localeCompare(second));
136
+ }
137
+ /** The size of the message that carries the set to a trierarch of the fleet once sealed, which a sealed box makes exact. */
138
+ function sealedPayloadBytes(fleetId, configuration) {
139
+ return payloadBytes(mcpConfigurationPayload({
140
+ fleetId,
141
+ pluginShipId: SHIP_ID_SHAPE,
142
+ version: configuration.version,
143
+ publicKey: 'A'.repeat(base64Length(PUBLIC_KEY_BYTES)),
144
+ servers: configuration.servers,
145
+ secrets: configuration.secrets.map(({ name, value }) => ({ name, sealed: 'A'.repeat(base64Length(Buffer.byteLength(value, 'utf8') + SEALED_BOX_OVERHEAD_BYTES)) })),
146
+ }));
147
+ }
148
+ /**
149
+ * Policy: the fleet's set after a whole replacement, one version on, and what
150
+ * it changed by name; or why not, the whole replacement refused: a version
151
+ * other than the current one, a server or secret that fails the rules, a
152
+ * credential naming a secret it does not retain, a retained secret with
153
+ * neither a value nor one held, a value for a secret it does not retain, or
154
+ * a set too large for one message once sealed. No reason holds a value.
155
+ */
156
+ export function replaceMcpConfiguration({ fleetId, current }, replacement) {
157
+ if (replacement.expectedVersion !== current.version) {
158
+ return refuse('VERSION_CONFLICT', `The MCP configuration is at version ${String(current.version)}, not ${String(replacement.expectedVersion)}: read it again before replacing it`);
159
+ }
160
+ const servers = readServers(replacement.servers);
161
+ if (!servers.isOk) {
162
+ return servers;
163
+ }
164
+ const secrets = readSecrets(current, replacement);
165
+ if (!secrets.isOk) {
166
+ return secrets;
167
+ }
168
+ for (const server of servers.value) {
169
+ if (server.credential !== undefined && !replacement.secrets.includes(server.credential.secret)) {
170
+ return invalid(`${server.name}: its credential names the secret ${server.credential.secret}, which the replacement does not retain`);
171
+ }
172
+ }
173
+ const configuration = { version: current.version + 1, servers: servers.value, secrets: secrets.value };
174
+ if (sealedPayloadBytes(fleetId, configuration) > PAYLOAD_MAX_BYTES) {
175
+ return invalid(`the MCP configuration does not fit one message of ${String(PAYLOAD_MAX_BYTES / BYTES_PER_KB)} KB once sealed`);
176
+ }
177
+ return ok({
178
+ configuration,
179
+ changed: {
180
+ servers: changedNames({ before: current.servers, after: configuration.servers }, (first, second) => JSON.stringify(first) === JSON.stringify(second)),
181
+ secrets: changedNames({ before: current.secrets, after: configuration.secrets }, (first, second) => first.value === second.value && !Object.hasOwn(replacement.secretValues, second.name)),
182
+ },
183
+ });
184
+ }
185
+ /** The set as `mcp.get` shows it: the secrets by name only. */
186
+ export function mcpConfigurationMetadata(configuration) {
187
+ return { version: configuration.version, servers: configuration.servers, secrets: configuration.secrets.map((secret) => secret.name) };
188
+ }
189
+ /**
190
+ * The set as a trierarch receives it (design section 5): `{ fleetId,
191
+ * pluginShipId, version, publicKey, servers: [{ name, url, transport, tools,
192
+ * credential? }], secrets: [{ name, sealed }] }`, each value sealed to the
193
+ * public key named.
194
+ */
195
+ export function mcpConfigurationPayload(message) {
196
+ return JSON.stringify({
197
+ fleetId: message.fleetId,
198
+ pluginShipId: message.pluginShipId,
199
+ version: message.version,
200
+ publicKey: message.publicKey,
201
+ servers: message.servers.map(({ name, url, tools, credential }) => ({ name, url, transport: TRANSPORT, tools, ...(credential && { credential: { secret: credential.secret, header: credential.header } }) })),
202
+ secrets: message.secrets.map(({ name, sealed }) => ({ name, sealed })),
203
+ });
204
+ }
205
+ //# sourceMappingURL=mcp-configuration.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"mcp-configuration.js","sourceRoot":"","sources":["../../../src/core/mcp-configuration/mcp-configuration.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,59 @@
1
+ /**
2
+ * The delivery of a fleet's MCP configuration to one of its trierarchs (the
3
+ * fleet crew MCP design, section 5): the attempt last made, under the
4
+ * idempotency key it keeps until the fleet took it, and the version and key
5
+ * the trierarch confirmed it applied. Reconciliation converges on the latest
6
+ * set: confirmed application, never a send or its acknowledgement, ends it.
7
+ */
8
+ import type { ShipId } from '@aeolus-fleet/common';
9
+ /** A sealed copy of one version for one key: what it carried, under which key, and when the fleet took it; null while that is not known. */
10
+ export interface McpAttempt {
11
+ readonly version: number;
12
+ readonly publicKey: string;
13
+ readonly idempotencyKey: string;
14
+ /** The message as sent: a retry under its key sends the very same, as the fleet takes a key only for one message. */
15
+ readonly payload: string;
16
+ readonly sentAt: Date | null;
17
+ }
18
+ /** A version and key a trierarch confirmed it applied. */
19
+ export interface McpApplied {
20
+ readonly version: number;
21
+ readonly publicKey: string;
22
+ }
23
+ /** One trierarch's delivery: its last attempt, its confirmation, and whether it asked for the set since. */
24
+ export interface McpDelivery {
25
+ readonly trierarchShipId: ShipId;
26
+ readonly attempt: McpAttempt | null;
27
+ readonly applied: McpApplied | null;
28
+ readonly isRequested: boolean;
29
+ }
30
+ /** What a trierarch needs: the fleet's current version, sealed to the key its report states. */
31
+ export interface McpTarget {
32
+ readonly version: number;
33
+ readonly publicKey: string;
34
+ }
35
+ /** What a pass does for a trierarch: nothing; the attempt it made again, under its key; or a new attempt under a new key. */
36
+ export type McpSend = {
37
+ readonly kind: 'none';
38
+ } | {
39
+ readonly kind: 'retry';
40
+ readonly attempt: McpAttempt;
41
+ } | {
42
+ readonly kind: 'new';
43
+ };
44
+ /** How long after a copy the fleet took, with no confirmation since, a pass sends another: a lost delivery or confirmation is made up for, without a copy every pass. */
45
+ export declare const RESEND_UNCONFIRMED_AFTER_MS: number;
46
+ /** Whether the trierarch confirmed the version for the key: what placement and the next send rely on. */
47
+ export declare function isMcpConfigurationCurrent(delivery: McpDelivery | undefined, target: McpTarget): boolean;
48
+ /**
49
+ * Policy: what a pass sends a trierarch. Confirmed for the version and its
50
+ * key, and not asked since: nothing. Asked: a new attempt, even if one was
51
+ * sent. An attempt of the version and key the fleet has not taken yet: the
52
+ * same again, under its key. One the fleet took: nothing until
53
+ * RESEND_UNCONFIRMED_AFTER_MS passed without a confirmation, then a new
54
+ * attempt. Any other version or key: a new attempt.
55
+ */
56
+ export declare function nextMcpSend(delivery: McpDelivery | undefined, at: {
57
+ target: McpTarget;
58
+ now: Date;
59
+ }): McpSend;
@@ -0,0 +1,32 @@
1
+ /** How long after a copy the fleet took, with no confirmation since, a pass sends another: a lost delivery or confirmation is made up for, without a copy every pass. */
2
+ export const RESEND_UNCONFIRMED_AFTER_MS = 5 * 60_000;
3
+ /** Whether the trierarch confirmed the version for the key: what placement and the next send rely on. */
4
+ export function isMcpConfigurationCurrent(delivery, target) {
5
+ return delivery?.applied?.version === target.version && delivery.applied.publicKey === target.publicKey;
6
+ }
7
+ /**
8
+ * Policy: what a pass sends a trierarch. Confirmed for the version and its
9
+ * key, and not asked since: nothing. Asked: a new attempt, even if one was
10
+ * sent. An attempt of the version and key the fleet has not taken yet: the
11
+ * same again, under its key. One the fleet took: nothing until
12
+ * RESEND_UNCONFIRMED_AFTER_MS passed without a confirmation, then a new
13
+ * attempt. Any other version or key: a new attempt.
14
+ */
15
+ export function nextMcpSend(delivery, at) {
16
+ const { target, now } = at;
17
+ if (delivery?.isRequested === true) {
18
+ return { kind: 'new' };
19
+ }
20
+ if (isMcpConfigurationCurrent(delivery, target)) {
21
+ return { kind: 'none' };
22
+ }
23
+ const attempt = delivery?.attempt;
24
+ if (attempt?.version !== target.version || attempt.publicKey !== target.publicKey) {
25
+ return { kind: 'new' };
26
+ }
27
+ if (attempt.sentAt === null) {
28
+ return { kind: 'retry', attempt };
29
+ }
30
+ return now.getTime() - attempt.sentAt.getTime() >= RESEND_UNCONFIRMED_AFTER_MS ? { kind: 'new' } : { kind: 'none' };
31
+ }
32
+ //# sourceMappingURL=mcp-delivery.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"mcp-delivery.js","sourceRoot":"","sources":["../../../src/core/mcp-configuration/mcp-delivery.ts"],"names":[],"mappings":"AA0CA,yKAAyK;AACzK,MAAM,CAAC,MAAM,2BAA2B,GAAG,CAAC,GAAG,MAAM,CAAC;AAEtD,yGAAyG;AACzG,MAAM,UAAU,yBAAyB,CAAC,QAAiC,EAAE,MAAiB;IAC5F,OAAO,QAAQ,EAAE,OAAO,EAAE,OAAO,KAAK,MAAM,CAAC,OAAO,IAAI,QAAQ,CAAC,OAAO,CAAC,SAAS,KAAK,MAAM,CAAC,SAAS,CAAC;AAC1G,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,WAAW,CAAC,QAAiC,EAAE,EAAoC;IACjG,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC;IAC3B,IAAI,QAAQ,EAAE,WAAW,KAAK,IAAI,EAAE,CAAC;QACnC,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;IACzB,CAAC;IACD,IAAI,yBAAyB,CAAC,QAAQ,EAAE,MAAM,CAAC,EAAE,CAAC;QAChD,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;IAC1B,CAAC;IACD,MAAM,OAAO,GAAG,QAAQ,EAAE,OAAO,CAAC;IAClC,IAAI,OAAO,EAAE,OAAO,KAAK,MAAM,CAAC,OAAO,IAAI,OAAO,CAAC,SAAS,KAAK,MAAM,CAAC,SAAS,EAAE,CAAC;QAClF,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;IACzB,CAAC;IACD,IAAI,OAAO,CAAC,MAAM,KAAK,IAAI,EAAE,CAAC;QAC5B,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC;IACpC,CAAC;IACD,OAAO,GAAG,CAAC,OAAO,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,OAAO,EAAE,IAAI,2BAA2B,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;AACtH,CAAC"}
@@ -0,0 +1,79 @@
1
+ import type { FleetId, ShipId } from '@aeolus-fleet/common';
2
+ import type { Result } from '../shared/result.js';
3
+ import type { McpChange, McpConfiguration } from './mcp-configuration.js';
4
+ import type { McpApplied, McpAttempt, McpDelivery } from './mcp-delivery.js';
5
+ /** Who replaced a set: the console session's kind and account, as `console.session` answers them; never a credential. */
6
+ export interface McpActor {
7
+ readonly kind: string;
8
+ readonly accountId: string | null;
9
+ }
10
+ /** The event of a replacement: its fleet, the version it saved, its actor and the names it changed, never a value. */
11
+ export interface McpConfigurationReplaced {
12
+ readonly type: 'McpConfigurationReplaced';
13
+ readonly fleetId: FleetId;
14
+ readonly version: number;
15
+ readonly actor: McpActor;
16
+ readonly changed: McpChange;
17
+ readonly at: Date;
18
+ }
19
+ /**
20
+ * Outbound port: each fleet's one current MCP configuration (design section
21
+ * 4), the plugin's credential store: readable to the service, never shown.
22
+ */
23
+ export interface McpConfigurations {
24
+ /** The fleet's current set; the empty one at version 0 before its first replacement. */
25
+ read(fleetId: FleetId): Promise<McpConfiguration>;
26
+ /**
27
+ * Saves the set and its event in one unit of work, only while the fleet's
28
+ * stored version is still `expectedVersion`: one of two writers of the same
29
+ * version saves, the other is answered `conflict` with nothing written. A
30
+ * failure saves neither and throws.
31
+ */
32
+ replace(fleetId: FleetId, replacement: {
33
+ expectedVersion: number;
34
+ configuration: McpConfiguration;
35
+ event: McpConfigurationReplaced;
36
+ }): Promise<'replaced' | 'conflict'>;
37
+ }
38
+ /**
39
+ * Outbound port: each fleet's deliveries of its MCP configuration, one per
40
+ * trierarch ship, kept across restarts. Each change touches only its own
41
+ * part, so a pass and the inbox round may change one delivery at once.
42
+ */
43
+ export interface McpDeliveries {
44
+ list(fleetId: FleetId): Promise<McpDelivery[]>;
45
+ /** Keeps a new attempt, before it is sent: the trierarch's request, if any, is answered by it. */
46
+ recordAttempt(fleetId: FleetId, recorded: {
47
+ trierarchShipId: ShipId;
48
+ attempt: McpAttempt;
49
+ }): Promise<void>;
50
+ /** The fleet took the attempt under this key; a later attempt is left as it is. */
51
+ markSent(fleetId: FleetId, sent: {
52
+ trierarchShipId: ShipId;
53
+ idempotencyKey: string;
54
+ at: Date;
55
+ }): Promise<void>;
56
+ recordApplied(fleetId: FleetId, recorded: {
57
+ trierarchShipId: ShipId;
58
+ applied: McpApplied;
59
+ }): Promise<void>;
60
+ /**
61
+ * The trierarch asked for the set, as it does when its lease starts: its
62
+ * confirmation is forgotten at once, so placement waits for the new lease's,
63
+ * and the next pass sends it a new attempt.
64
+ */
65
+ markRequested(fleetId: FleetId, trierarchShipId: ShipId): Promise<void>;
66
+ forget(fleetId: FleetId, trierarchShipIds: readonly ShipId[]): Promise<void>;
67
+ }
68
+ /**
69
+ * Outbound port: seals a value to a trierarch's public key so that only the
70
+ * holder of its private key opens it (decision M5): the NaCl anonymous sealed
71
+ * box, the value as UTF-8, the public key (as `readSealingKey` read it) and
72
+ * the sealed box as standard base64. A key no box can be sealed to, such as a
73
+ * low-order point, is KEY_REFUSED.
74
+ */
75
+ export interface Sealer {
76
+ seal(value: string, publicKey: string): Promise<Result<string, {
77
+ kind: 'KEY_REFUSED';
78
+ }>>;
79
+ }
@@ -0,0 +1 @@
1
+ {"version":3,"file":"ports.js","sourceRoot":"","sources":["../../../src/core/mcp-configuration/ports.ts"],"names":[],"mappings":""}
@@ -0,0 +1,8 @@
1
+ import type { FleetId } from '@aeolus-fleet/common';
2
+ import { type McpConfigurationMetadata } from './mcp-configuration.js';
3
+ import type { McpConfigurations } from './ports.js';
4
+ export type ReadMcpConfiguration = (fleetId: FleetId) => Promise<McpConfigurationMetadata>;
5
+ /** Use case: a fleet's MCP configuration as `mcp.get` answers it (design section 4): its version, servers and secret names, never a value. */
6
+ export declare function createReadMcpConfiguration(deps: {
7
+ configurations: McpConfigurations;
8
+ }): ReadMcpConfiguration;
@@ -0,0 +1,6 @@
1
+ import { mcpConfigurationMetadata } from './mcp-configuration.js';
2
+ /** Use case: a fleet's MCP configuration as `mcp.get` answers it (design section 4): its version, servers and secret names, never a value. */
3
+ export function createReadMcpConfiguration(deps) {
4
+ return async (fleetId) => mcpConfigurationMetadata(await deps.configurations.read(fleetId));
5
+ }
6
+ //# sourceMappingURL=read-mcp-configuration.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"read-mcp-configuration.js","sourceRoot":"","sources":["../../../src/core/mcp-configuration/read-mcp-configuration.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,wBAAwB,EAAiC,MAAM,wBAAwB,CAAC;AAKjG,8IAA8I;AAC9I,MAAM,UAAU,0BAA0B,CAAC,IAA2C;IACpF,OAAO,KAAK,EAAE,OAAO,EAAE,EAAE,CAAC,wBAAwB,CAAC,MAAM,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;AAC9F,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 McpReplacement } from './mcp-configuration.js';
6
+ import type { McpActor, McpConfigurations } from './ports.js';
7
+ export type ReplaceMcpConfiguration = (request: {
8
+ fleetId: FleetId;
9
+ actor: McpActor;
10
+ replacement: McpReplacement;
11
+ }) => Promise<Result<{
12
+ version: number;
13
+ }, DomainError<'VERSION_CONFLICT' | 'INVALID_CONFIGURATION'>>>;
14
+ /**
15
+ * Use case: a manager replaces their fleet's MCP configuration whole (design
16
+ * section 4): read the current set, replace it by the model's rules, then save
17
+ * it with its value-free event, only while the version is still the one
18
+ * read. A writer that lost to another of the same version is answered the
19
+ * conflict, nothing written. Success means saved, not yet applied anywhere.
20
+ */
21
+ export declare function createReplaceMcpConfiguration(deps: {
22
+ configurations: McpConfigurations;
23
+ clock: Clock;
24
+ }): ReplaceMcpConfiguration;
@@ -0,0 +1,30 @@
1
+ import { refuse } from '../shared/errors.js';
2
+ import { ok } from '../shared/result.js';
3
+ import { replaceMcpConfiguration } from './mcp-configuration.js';
4
+ /**
5
+ * Use case: a manager replaces their fleet's MCP configuration whole (design
6
+ * section 4): read the current set, replace it by the model's rules, then save
7
+ * it with its value-free event, only while the version is still the one
8
+ * read. A writer that lost to another of the same version is answered the
9
+ * conflict, nothing written. Success means saved, not yet applied anywhere.
10
+ */
11
+ export function createReplaceMcpConfiguration(deps) {
12
+ return async ({ fleetId, actor, replacement }) => {
13
+ const current = await deps.configurations.read(fleetId);
14
+ const replaced = replaceMcpConfiguration({ fleetId, current }, replacement);
15
+ if (!replaced.isOk) {
16
+ return replaced;
17
+ }
18
+ const { configuration, changed } = replaced.value;
19
+ const saved = await deps.configurations.replace(fleetId, {
20
+ expectedVersion: current.version,
21
+ configuration,
22
+ event: { type: 'McpConfigurationReplaced', fleetId, version: configuration.version, actor, changed, at: deps.clock.now() },
23
+ });
24
+ if (saved === 'conflict') {
25
+ return refuse('VERSION_CONFLICT', `The MCP configuration changed from version ${String(current.version)} meanwhile: read it again before replacing it`);
26
+ }
27
+ return ok({ version: configuration.version });
28
+ };
29
+ }
30
+ //# sourceMappingURL=replace-mcp-configuration.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"replace-mcp-configuration.js","sourceRoot":"","sources":["../../../src/core/mcp-configuration/replace-mcp-configuration.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,MAAM,EAAoB,MAAM,qBAAqB,CAAC;AAC/D,OAAO,EAAE,EAAE,EAAe,MAAM,qBAAqB,CAAC;AACtD,OAAO,EAAE,uBAAuB,EAAuB,MAAM,wBAAwB,CAAC;AAKtF;;;;;;GAMG;AACH,MAAM,UAAU,6BAA6B,CAAC,IAAyD;IACrG,OAAO,KAAK,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,EAAE,EAAE;QAC/C,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACxD,MAAM,QAAQ,GAAG,uBAAuB,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE,WAAW,CAAC,CAAC;QAC5E,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;YACnB,OAAO,QAAQ,CAAC;QAClB,CAAC;QACD,MAAM,EAAE,aAAa,EAAE,OAAO,EAAE,GAAG,QAAQ,CAAC,KAAK,CAAC;QAClD,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,cAAc,CAAC,OAAO,CAAC,OAAO,EAAE;YACvD,eAAe,EAAE,OAAO,CAAC,OAAO;YAChC,aAAa;YACb,KAAK,EAAE,EAAE,IAAI,EAAE,0BAA0B,EAAE,OAAO,EAAE,OAAO,EAAE,aAAa,CAAC,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,EAAE;SAC3H,CAAC,CAAC;QACH,IAAI,KAAK,KAAK,UAAU,EAAE,CAAC;YACzB,OAAO,MAAM,CAAC,kBAAkB,EAAE,8CAA8C,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,+CAA+C,CAAC,CAAC;QAC1J,CAAC;QACD,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,aAAa,CAAC,OAAO,EAAE,CAAC,CAAC;IAChD,CAAC,CAAC;AACJ,CAAC"}
@@ -0,0 +1 @@
1
+ {"version":3,"file":"sealing-key.js","sourceRoot":"","sources":["../../../src/core/mcp-configuration/sealing-key.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,gFAAgF;AAChF,MAAM,MAAM,GAAG,iBAAiB,CAAC;AAEjC,+GAA+G;AAC/G,MAAM,iBAAiB,GAAG,wCAAwC,CAAC;AAEnE,2EAA2E;AAC3E,MAAM,QAAQ,GAAG,GAAG,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,GAAG,CAAC;AAEtC,MAAM,aAAa,GAAG,CAAC,CAAC,MAAM,CAAC;IAC7B,UAAU,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC,MAAM,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,KAAK,QAAQ,CAAC,EAAE,CAAC;CAClJ,CAAC,CAAC;AAEH;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,OAAgB;IAC7C,MAAM,IAAI,GAAG,aAAa,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;IAC9C,OAAO,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC;AACnE,CAAC"}
@@ -0,0 +1,30 @@
1
+ import type { PluginCrew, PluginDelivery } from '../connection/ports.js';
2
+ import type { McpConfigurations, McpDeliveries } from './ports.js';
3
+ /** What became of a delivery to the plugin's ship: not of the MCP configuration; a confirmation recorded; a request marked; or ignored, and why. */
4
+ export type TakenMcpMessage = {
5
+ readonly kind: 'notMcpConfiguration';
6
+ } | {
7
+ readonly kind: 'applied';
8
+ } | {
9
+ readonly kind: 'requested';
10
+ } | {
11
+ readonly kind: 'ignored';
12
+ readonly reason: string;
13
+ };
14
+ export type TakeMcpConfigurationMessage = (crew: PluginCrew, delivery: PluginDelivery) => Promise<TakenMcpMessage>;
15
+ /**
16
+ * Use case: a trierarch's message about its fleet's MCP configuration to the
17
+ * plugin's ship (the fleet crew MCP design, section 5). The fleet names the
18
+ * sender and its status; the payload's identity must agree with this fleet
19
+ * and this plugin ship, and never authorises itself. A confirmation counts
20
+ * only from a crewed trierarch, for the fleet's current version and the key
21
+ * its last attempt was sealed to: it is recorded against that trierarch. A
22
+ * request, which a trierarch sends when its lease starts, forgets its
23
+ * confirmation and marks it so the next pass sends it a new copy. Anything
24
+ * else of the contract is ignored, recording nothing, with a reason that
25
+ * holds no payload.
26
+ */
27
+ export declare function createTakeMcpConfigurationMessage(deps: {
28
+ configurations: McpConfigurations;
29
+ deliveries: McpDeliveries;
30
+ }): TakeMcpConfigurationMessage;
@@ -0,0 +1,74 @@
1
+ import { idSchema } from '@aeolus-fleet/common';
2
+ import { z } from 'zod';
3
+ import { TRIERARCH_TYPE } from '../machines/join-machine.js';
4
+ import { MCP_CONFIGURATION_APPLIED_CONTENT_TYPE, MCP_CONFIGURATION_REQUEST_CONTENT_TYPE } from './mcp-configuration.js';
5
+ const appliedSchema = z.strictObject({ fleetId: idSchema('fleet'), pluginShipId: idSchema('ship'), version: z.int().nonnegative(), publicKey: z.string() });
6
+ const requestSchema = z.strictObject({ fleetId: idSchema('fleet'), pluginShipId: idSchema('ship') });
7
+ const OTHER_IDENTITY = 'it names another fleet or plugin ship';
8
+ /** Whether the payload names this fleet and this plugin ship, as the configured identity is. */
9
+ function isOwn(crew, named) {
10
+ return named.fleetId === crew.fleetId && named.pluginShipId === crew.shipId;
11
+ }
12
+ /** The payload read by the schema, or undefined for text that is not JSON or does not fit it. */
13
+ function readPayload(payload, schema) {
14
+ try {
15
+ const read = schema.safeParse(JSON.parse(payload));
16
+ return read.success ? read.data : undefined;
17
+ }
18
+ catch {
19
+ // Not JSON: not a message of this contract.
20
+ return undefined;
21
+ }
22
+ }
23
+ /**
24
+ * Use case: a trierarch's message about its fleet's MCP configuration to the
25
+ * plugin's ship (the fleet crew MCP design, section 5). The fleet names the
26
+ * sender and its status; the payload's identity must agree with this fleet
27
+ * and this plugin ship, and never authorises itself. A confirmation counts
28
+ * only from a crewed trierarch, for the fleet's current version and the key
29
+ * its last attempt was sealed to: it is recorded against that trierarch. A
30
+ * request, which a trierarch sends when its lease starts, forgets its
31
+ * confirmation and marks it so the next pass sends it a new copy. Anything
32
+ * else of the contract is ignored, recording nothing, with a reason that
33
+ * holds no payload.
34
+ */
35
+ export function createTakeMcpConfigurationMessage(deps) {
36
+ return async (crew, delivery) => {
37
+ const isApplied = delivery.contentType === MCP_CONFIGURATION_APPLIED_CONTENT_TYPE;
38
+ if (!isApplied && delivery.contentType !== MCP_CONFIGURATION_REQUEST_CONTENT_TYPE) {
39
+ return { kind: 'notMcpConfiguration' };
40
+ }
41
+ if (delivery.senderType !== TRIERARCH_TYPE || delivery.senderStatus !== 'crewed') {
42
+ return { kind: 'ignored', reason: 'its sender is not a crewed trierarch' };
43
+ }
44
+ if (!isApplied) {
45
+ const request = readPayload(delivery.payload, requestSchema);
46
+ if (request === undefined) {
47
+ return { kind: 'ignored', reason: 'its payload is not { fleetId, pluginShipId }' };
48
+ }
49
+ if (!isOwn(crew, request)) {
50
+ return { kind: 'ignored', reason: OTHER_IDENTITY };
51
+ }
52
+ await deps.deliveries.markRequested(crew.fleetId, delivery.senderShipId);
53
+ return { kind: 'requested' };
54
+ }
55
+ const read = readPayload(delivery.payload, appliedSchema);
56
+ if (read === undefined) {
57
+ return { kind: 'ignored', reason: 'its payload is not { fleetId, pluginShipId, version, publicKey }' };
58
+ }
59
+ if (!isOwn(crew, read)) {
60
+ return { kind: 'ignored', reason: OTHER_IDENTITY };
61
+ }
62
+ const { version } = await deps.configurations.read(crew.fleetId);
63
+ if (read.version !== version) {
64
+ return { kind: 'ignored', reason: `it confirms version ${String(read.version)}, not the current version ${String(version)}` };
65
+ }
66
+ const attempt = (await deps.deliveries.list(crew.fleetId)).find((each) => each.trierarchShipId === delivery.senderShipId)?.attempt;
67
+ if (attempt?.version !== read.version || attempt.publicKey !== read.publicKey) {
68
+ return { kind: 'ignored', reason: 'it confirms a version and key it was not sent' };
69
+ }
70
+ await deps.deliveries.recordApplied(crew.fleetId, { trierarchShipId: delivery.senderShipId, applied: { version: read.version, publicKey: read.publicKey } });
71
+ return { kind: 'applied' };
72
+ };
73
+ }
74
+ //# sourceMappingURL=take-mcp-configuration-message.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"take-mcp-configuration-message.js","sourceRoot":"","sources":["../../../src/core/mcp-configuration/take-mcp-configuration-message.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAChD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAC7D,OAAO,EAAE,sCAAsC,EAAE,sCAAsC,EAAE,MAAM,wBAAwB,CAAC;AAQxH,MAAM,aAAa,GAAG,CAAC,CAAC,YAAY,CAAC,EAAE,OAAO,EAAE,QAAQ,CAAC,OAAO,CAAC,EAAE,YAAY,EAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE,EAAE,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;AAE5J,MAAM,aAAa,GAAG,CAAC,CAAC,YAAY,CAAC,EAAE,OAAO,EAAE,QAAQ,CAAC,OAAO,CAAC,EAAE,YAAY,EAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;AAErG,MAAM,cAAc,GAAG,uCAAuC,CAAC;AAE/D,gGAAgG;AAChG,SAAS,KAAK,CAAC,IAAgB,EAAE,KAAgD;IAC/E,OAAO,KAAK,CAAC,OAAO,KAAK,IAAI,CAAC,OAAO,IAAI,KAAK,CAAC,YAAY,KAAK,IAAI,CAAC,MAAM,CAAC;AAC9E,CAAC;AAED,iGAAiG;AACjG,SAAS,WAAW,CAAI,OAAe,EAAE,MAAoB;IAC3D,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;QACnD,OAAO,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC;IAC9C,CAAC;IAAC,MAAM,CAAC;QACP,4CAA4C;QAC5C,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,iCAAiC,CAAC,IAAsE;IACtH,OAAO,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE;QAC9B,MAAM,SAAS,GAAG,QAAQ,CAAC,WAAW,KAAK,sCAAsC,CAAC;QAClF,IAAI,CAAC,SAAS,IAAI,QAAQ,CAAC,WAAW,KAAK,sCAAsC,EAAE,CAAC;YAClF,OAAO,EAAE,IAAI,EAAE,qBAAqB,EAAE,CAAC;QACzC,CAAC;QACD,IAAI,QAAQ,CAAC,UAAU,KAAK,cAAc,IAAI,QAAQ,CAAC,YAAY,KAAK,QAAQ,EAAE,CAAC;YACjF,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,sCAAsC,EAAE,CAAC;QAC7E,CAAC;QACD,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,MAAM,OAAO,GAAG,WAAW,CAAC,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC;YAC7D,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;gBAC1B,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,8CAA8C,EAAE,CAAC;YACrF,CAAC;YACD,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,OAAO,CAAC,EAAE,CAAC;gBAC1B,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,cAAc,EAAE,CAAC;YACrD,CAAC;YACD,MAAM,IAAI,CAAC,UAAU,CAAC,aAAa,CAAC,IAAI,CAAC,OAAO,EAAE,QAAQ,CAAC,YAAY,CAAC,CAAC;YACzE,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC;QAC/B,CAAC;QACD,MAAM,IAAI,GAAG,WAAW,CAAC,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC;QAC1D,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;YACvB,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,kEAAkE,EAAE,CAAC;QACzG,CAAC;QACD,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,CAAC;YACvB,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,cAAc,EAAE,CAAC;QACrD,CAAC;QACD,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACjE,IAAI,IAAI,CAAC,OAAO,KAAK,OAAO,EAAE,CAAC;YAC7B,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,uBAAuB,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,6BAA6B,MAAM,CAAC,OAAO,CAAC,EAAE,EAAE,CAAC;QAChI,CAAC;QACD,MAAM,OAAO,GAAG,CAAC,MAAM,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,eAAe,KAAK,QAAQ,CAAC,YAAY,CAAC,EAAE,OAAO,CAAC;QACnI,IAAI,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC,SAAS,KAAK,IAAI,CAAC,SAAS,EAAE,CAAC;YAC9E,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,+CAA+C,EAAE,CAAC;QACtF,CAAC;QACD,MAAM,IAAI,CAAC,UAAU,CAAC,aAAa,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,eAAe,EAAE,QAAQ,CAAC,YAAY,EAAE,OAAO,EAAE,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;QAC7J,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;IAC7B,CAAC,CAAC;AACJ,CAAC"}
@@ -5,6 +5,7 @@ import type { ConsoleSessions } from "./ports.js";
5
5
  export type AuthenticateOperator = (cookie: string | undefined) => Promise<Result<{
6
6
  fleetId: FleetId;
7
7
  kind: ConsoleSessionOutput["kind"];
8
+ accountId?: string;
8
9
  scopes: readonly ScopeName[];
9
10
  }, DomainError<"NOT_THE_OPERATOR">>>;
10
11
  /**
@@ -15,7 +16,8 @@ export type AuthenticateOperator = (cookie: string | undefined) => Promise<Resul
15
16
  * operator there is let through as the operator of their own fleet. A
16
17
  * viewer session is let through too, with the viewer ship's scopes, which
17
18
  * the fleet answers; what each scope may call is the API's to check
18
- * (decision 0022).
19
+ * (decision 0022). An account's session carries its account, which a
20
+ * change records as its actor.
19
21
  */
20
22
  export declare function createAuthenticateOperator(deps: {
21
23
  sessions: ConsoleSessions;