instar 1.3.895 → 1.3.897

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 (102) hide show
  1. package/dashboard/index.html +30 -0
  2. package/dist/commands/server.d.ts.map +1 -1
  3. package/dist/commands/server.js +111 -1
  4. package/dist/commands/server.js.map +1 -1
  5. package/dist/config/ConfigDefaults.d.ts.map +1 -1
  6. package/dist/config/ConfigDefaults.js +12 -0
  7. package/dist/config/ConfigDefaults.js.map +1 -1
  8. package/dist/core/CoherenceJournal.d.ts +17 -1
  9. package/dist/core/CoherenceJournal.d.ts.map +1 -1
  10. package/dist/core/CoherenceJournal.js +29 -2
  11. package/dist/core/CoherenceJournal.js.map +1 -1
  12. package/dist/core/FailureEpisodeLatch.d.ts +8 -0
  13. package/dist/core/FailureEpisodeLatch.d.ts.map +1 -1
  14. package/dist/core/FailureEpisodeLatch.js +14 -0
  15. package/dist/core/FailureEpisodeLatch.js.map +1 -1
  16. package/dist/core/JournalSyncApplier.d.ts.map +1 -1
  17. package/dist/core/JournalSyncApplier.js +11 -0
  18. package/dist/core/JournalSyncApplier.js.map +1 -1
  19. package/dist/core/MachineSshEndpoint.d.ts +47 -0
  20. package/dist/core/MachineSshEndpoint.d.ts.map +1 -0
  21. package/dist/core/MachineSshEndpoint.js +221 -0
  22. package/dist/core/MachineSshEndpoint.js.map +1 -0
  23. package/dist/core/MachineSshIdentity.d.ts +26 -0
  24. package/dist/core/MachineSshIdentity.d.ts.map +1 -0
  25. package/dist/core/MachineSshIdentity.js +97 -0
  26. package/dist/core/MachineSshIdentity.js.map +1 -0
  27. package/dist/core/MeshRpc.d.ts +6 -0
  28. package/dist/core/MeshRpc.d.ts.map +1 -1
  29. package/dist/core/MeshRpc.js +2 -0
  30. package/dist/core/MeshRpc.js.map +1 -1
  31. package/dist/core/MutualSshHealthController.d.ts +33 -0
  32. package/dist/core/MutualSshHealthController.d.ts.map +1 -0
  33. package/dist/core/MutualSshHealthController.js +113 -0
  34. package/dist/core/MutualSshHealthController.js.map +1 -0
  35. package/dist/core/MutualSshProbeScheduler.d.ts +21 -0
  36. package/dist/core/MutualSshProbeScheduler.d.ts.map +1 -0
  37. package/dist/core/MutualSshProbeScheduler.js +57 -0
  38. package/dist/core/MutualSshProbeScheduler.js.map +1 -0
  39. package/dist/core/MutualSshRuntime.d.ts +106 -0
  40. package/dist/core/MutualSshRuntime.d.ts.map +1 -0
  41. package/dist/core/MutualSshRuntime.js +423 -0
  42. package/dist/core/MutualSshRuntime.js.map +1 -0
  43. package/dist/core/MutualSshVerifier.d.ts +44 -0
  44. package/dist/core/MutualSshVerifier.d.ts.map +1 -0
  45. package/dist/core/MutualSshVerifier.js +97 -0
  46. package/dist/core/MutualSshVerifier.js.map +1 -0
  47. package/dist/core/SelfHealGate.d.ts +148 -0
  48. package/dist/core/SelfHealGate.d.ts.map +1 -0
  49. package/dist/core/SelfHealGate.js +391 -0
  50. package/dist/core/SelfHealGate.js.map +1 -0
  51. package/dist/core/SshBootstrapAdvert.d.ts +23 -0
  52. package/dist/core/SshBootstrapAdvert.d.ts.map +1 -0
  53. package/dist/core/SshBootstrapAdvert.js +43 -0
  54. package/dist/core/SshBootstrapAdvert.js.map +1 -0
  55. package/dist/core/SshHostKeyLifecycle.d.ts +43 -0
  56. package/dist/core/SshHostKeyLifecycle.d.ts.map +1 -0
  57. package/dist/core/SshHostKeyLifecycle.js +68 -0
  58. package/dist/core/SshHostKeyLifecycle.js.map +1 -0
  59. package/dist/core/SshPeerAdmissionStore.d.ts +29 -0
  60. package/dist/core/SshPeerAdmissionStore.d.ts.map +1 -0
  61. package/dist/core/SshPeerAdmissionStore.js +86 -0
  62. package/dist/core/SshPeerAdmissionStore.js.map +1 -0
  63. package/dist/core/devGatedFeatures.d.ts.map +1 -1
  64. package/dist/core/devGatedFeatures.js +6 -0
  65. package/dist/core/devGatedFeatures.js.map +1 -1
  66. package/dist/core/machineCoherenceManifest.d.ts.map +1 -1
  67. package/dist/core/machineCoherenceManifest.js +8 -0
  68. package/dist/core/machineCoherenceManifest.js.map +1 -1
  69. package/dist/core/types.d.ts +10 -0
  70. package/dist/core/types.d.ts.map +1 -1
  71. package/dist/core/types.js.map +1 -1
  72. package/dist/feedback-factory/drain/FeedbackFactoryDefaultsSelfHeal.d.ts +19 -0
  73. package/dist/feedback-factory/drain/FeedbackFactoryDefaultsSelfHeal.d.ts.map +1 -0
  74. package/dist/feedback-factory/drain/FeedbackFactoryDefaultsSelfHeal.js +118 -0
  75. package/dist/feedback-factory/drain/FeedbackFactoryDefaultsSelfHeal.js.map +1 -0
  76. package/dist/feedback-factory/drain/FeedbackFactoryGeneratedDefaults.d.ts +11 -1
  77. package/dist/feedback-factory/drain/FeedbackFactoryGeneratedDefaults.d.ts.map +1 -1
  78. package/dist/feedback-factory/drain/FeedbackFactoryGeneratedDefaults.js +88 -25
  79. package/dist/feedback-factory/drain/FeedbackFactoryGeneratedDefaults.js.map +1 -1
  80. package/dist/monitoring/selfaction/policies.d.ts.map +1 -1
  81. package/dist/monitoring/selfaction/policies.js +14 -0
  82. package/dist/monitoring/selfaction/policies.js.map +1 -1
  83. package/dist/server/AgentServer.d.ts +1 -0
  84. package/dist/server/AgentServer.d.ts.map +1 -1
  85. package/dist/server/AgentServer.js +46 -6
  86. package/dist/server/AgentServer.js.map +1 -1
  87. package/dist/server/CapabilityIndex.js +2 -2
  88. package/dist/server/CapabilityIndex.js.map +1 -1
  89. package/dist/server/routes.d.ts +2 -0
  90. package/dist/server/routes.d.ts.map +1 -1
  91. package/dist/server/routes.js +9 -0
  92. package/dist/server/routes.js.map +1 -1
  93. package/dist/testing/selfActionRegistry.d.ts.map +1 -1
  94. package/dist/testing/selfActionRegistry.js +64 -0
  95. package/dist/testing/selfActionRegistry.js.map +1 -1
  96. package/package.json +3 -1
  97. package/src/data/builtin-manifest.json +47 -47
  98. package/src/data/state-coherence-registry.json +53 -0
  99. package/upgrades/1.3.896.md +25 -0
  100. package/upgrades/1.3.897.md +39 -0
  101. package/upgrades/side-effects/mutual-ssh-autobootstrap.md +137 -0
  102. package/upgrades/side-effects/self-heal-gate.md +87 -0
@@ -0,0 +1,391 @@
1
+ import crypto from 'node:crypto';
2
+ import fs from 'node:fs';
3
+ import path from 'node:path';
4
+ import Database from 'better-sqlite3';
5
+ import { FailureEpisodeLatch } from './FailureEpisodeLatch.js';
6
+ import { registerSqliteHandle } from './SqliteRegistry.js';
7
+ function cloneRecord(record) { return structuredClone(record); }
8
+ function validateRecord(value) {
9
+ if (!value || typeof value !== 'object')
10
+ throw new Error('invalid self-heal episode');
11
+ const r = value;
12
+ if (r.schemaVersion !== 1 || typeof r.key !== 'string' || r.key.length < 1 || r.key.length > 240)
13
+ throw new Error('invalid self-heal episode');
14
+ for (const n of [r.revision, r.startedAt, r.attempts, r.nextEligibleAt, r.updatedAt])
15
+ if (!Number.isFinite(n) || n < 0)
16
+ throw new Error('invalid self-heal episode');
17
+ if (!Number.isInteger(r.revision) || !Number.isInteger(r.attempts) || !['active', 'recovered', 'exhausted'].includes(r.status))
18
+ throw new Error('invalid self-heal episode');
19
+ if (!Array.isArray(r.recoveries) || r.recoveries.length > 64 || r.recoveries.some((n) => !Number.isFinite(n) || n < 0))
20
+ throw new Error('invalid self-heal episode');
21
+ const latch = new FailureEpisodeLatch({ signalAfterMs: 1 });
22
+ latch.restore(r.latch);
23
+ return r;
24
+ }
25
+ export class InMemorySelfHealEpisodeStore {
26
+ rows = new Map();
27
+ audits = [];
28
+ load(key) { const row = this.rows.get(key); return row ? cloneRecord(row) : null; }
29
+ create(record) { if (this.rows.has(record.key))
30
+ return null; const row = validateRecord(cloneRecord(record)); this.rows.set(row.key, row); return cloneRecord(row); }
31
+ mutate(key, expectedRevision, update, guard) {
32
+ const current = this.rows.get(key);
33
+ if (!current || current.revision !== expectedRevision)
34
+ return null;
35
+ if (guard && !guard())
36
+ return null;
37
+ const next = validateRecord(update(cloneRecord(current)));
38
+ if (next.key !== key || next.revision !== expectedRevision + 1)
39
+ throw new Error('self-heal mutation must increment revision once');
40
+ if (current.status === 'exhausted' && next.status !== 'exhausted')
41
+ throw new Error('self-heal exhausted state is monotonic');
42
+ this.rows.set(key, cloneRecord(next));
43
+ return cloneRecord(next);
44
+ }
45
+ appendAudit(event) { this.audits.push(structuredClone(event)); }
46
+ }
47
+ export class SqliteSelfHealEpisodeStore {
48
+ db;
49
+ unregisterSqlite;
50
+ constructor(dbPath) {
51
+ const parent = path.dirname(dbPath);
52
+ fs.mkdirSync(parent, { recursive: true, mode: 0o700 });
53
+ const ps = fs.lstatSync(parent);
54
+ if (!ps.isDirectory() || ps.isSymbolicLink())
55
+ throw new Error('unsafe self-heal store parent');
56
+ if (fs.existsSync(dbPath)) {
57
+ const st = fs.lstatSync(dbPath);
58
+ if (!st.isFile() || st.isSymbolicLink())
59
+ throw new Error('unsafe self-heal store file');
60
+ }
61
+ this.db = new Database(dbPath, { timeout: 100 });
62
+ this.db.pragma('journal_mode = WAL');
63
+ this.db.pragma('busy_timeout = 100');
64
+ this.db.exec('CREATE TABLE IF NOT EXISTS self_heal_episodes (episode_key TEXT PRIMARY KEY, revision INTEGER NOT NULL, payload TEXT NOT NULL, updated_at INTEGER NOT NULL); CREATE TABLE IF NOT EXISTS self_heal_audit (id INTEGER PRIMARY KEY, at_ms INTEGER NOT NULL, controller_id TEXT NOT NULL, event TEXT NOT NULL, reason TEXT, attempt INTEGER, elapsed_ms INTEGER);');
65
+ try {
66
+ fs.chmodSync(dbPath, 0o600);
67
+ }
68
+ catch { /* non-posix */ }
69
+ this.unregisterSqlite = registerSqliteHandle(() => { try {
70
+ this.db.close();
71
+ }
72
+ catch { /* already closed */ } });
73
+ }
74
+ load(key) { const row = this.db.prepare('SELECT payload FROM self_heal_episodes WHERE episode_key=?').get(key); return row ? validateRecord(JSON.parse(row.payload)) : null; }
75
+ create(record) {
76
+ const row = validateRecord(cloneRecord(record));
77
+ const tx = this.db.transaction(() => {
78
+ const count = this.db.prepare('SELECT COUNT(*) AS n FROM self_heal_episodes').get().n;
79
+ if (count >= 256)
80
+ return false;
81
+ return this.db.prepare('INSERT OR IGNORE INTO self_heal_episodes(episode_key,revision,payload,updated_at) VALUES(?,?,?,?)').run(row.key, row.revision, JSON.stringify(row), row.updatedAt).changes === 1;
82
+ });
83
+ try {
84
+ return tx() ? cloneRecord(row) : null;
85
+ }
86
+ catch (error) {
87
+ if (/busy|locked/i.test(String(error)))
88
+ return null;
89
+ throw error;
90
+ }
91
+ }
92
+ mutate(key, expectedRevision, update, guard) {
93
+ const tx = this.db.transaction(() => {
94
+ const current = this.load(key);
95
+ if (!current || current.revision !== expectedRevision)
96
+ return null;
97
+ if (guard && !guard())
98
+ return null;
99
+ const next = validateRecord(update(cloneRecord(current)));
100
+ if (next.key !== key || next.revision !== expectedRevision + 1)
101
+ throw new Error('self-heal mutation must increment revision once');
102
+ if (current.status === 'exhausted' && next.status !== 'exhausted')
103
+ throw new Error('self-heal exhausted state is monotonic');
104
+ const changed = this.db.prepare('UPDATE self_heal_episodes SET revision=?,payload=?,updated_at=? WHERE episode_key=? AND revision=?').run(next.revision, JSON.stringify(next), next.updatedAt, key, expectedRevision).changes;
105
+ return changed === 1 ? next : null;
106
+ });
107
+ try {
108
+ const row = tx();
109
+ return row ? cloneRecord(row) : null;
110
+ }
111
+ catch (error) {
112
+ if (/busy|locked/i.test(String(error)))
113
+ return null;
114
+ throw error;
115
+ }
116
+ }
117
+ appendAudit(event) { this.db.prepare('INSERT OR REPLACE INTO self_heal_audit(id,at_ms,controller_id,event,reason,attempt,elapsed_ms) VALUES(?,?,?,?,?,?,?)').run(event.at % 1024, event.at, event.controllerId, event.event, event.reason ?? null, event.attempt ?? null, event.elapsedMs ?? null); }
118
+ close() { this.unregisterSqlite(); this.db.close(); }
119
+ }
120
+ export class SelfHealGate {
121
+ spec;
122
+ deps;
123
+ now;
124
+ store;
125
+ bootId;
126
+ stateFailureNotices = new Set();
127
+ constructor(spec, deps) {
128
+ this.spec = spec;
129
+ this.deps = deps;
130
+ if (spec.controllerResource !== 'hardware-bound')
131
+ throw new Error('v1 SelfHealGate refuses pool-shared controllers');
132
+ if (!Number.isInteger(spec.maxAttempts) || spec.maxAttempts < 1 || spec.maxAttempts > 32)
133
+ throw new Error('invalid maxAttempts');
134
+ for (const value of [spec.maxWallClockMs, spec.notificationLatencyCeilingMs, spec.flap.maxRecoveries, spec.flap.windowMs])
135
+ if (!Number.isFinite(value) || value <= 0)
136
+ throw new Error('invalid SelfHealGate bound');
137
+ this.now = deps.now ?? Date.now;
138
+ this.store = deps.episodeStore ?? new InMemorySelfHealEpisodeStore();
139
+ this.bootId = deps.bootId ?? crypto.randomUUID();
140
+ }
141
+ needsRestartVerification(ctx) { return this.store.load(this.key(ctx))?.restart !== null; }
142
+ async attempt(ctx) { const began = this.now(); try {
143
+ return await this.attemptInner(ctx);
144
+ }
145
+ catch {
146
+ return this.stateFailureWithNotice('store-operation-failed');
147
+ }
148
+ finally {
149
+ this.audit({ event: 'attempt-finished', elapsedMs: Math.max(0, this.now() - began) });
150
+ } }
151
+ recordHealthy(ctx) {
152
+ const current = this.store.load(this.key(ctx));
153
+ if (!current)
154
+ return { outcome: 'healed', reason: 'already-healthy' };
155
+ if (current.status === 'exhausted')
156
+ return { outcome: 'exhausted', reason: 'terminal' };
157
+ if (current.restart)
158
+ return { outcome: 'governed', reason: 'restart-verification-required' };
159
+ const next = this.cas(current, (row) => ({ ...row, status: 'recovered', recoveries: [...row.recoveries, this.now()].slice(-64), restart: null }));
160
+ return next ? { outcome: 'healed', reason: 'recorded-healthy' } : { outcome: 'busy', reason: 'revision-conflict' };
161
+ }
162
+ async attemptInner(ctx) {
163
+ const key = this.key(ctx);
164
+ let row = this.store.load(key);
165
+ if (!row) {
166
+ const fresh = this.newEpisode(key);
167
+ row = this.store.create(fresh) ?? this.store.load(key);
168
+ }
169
+ if (!row)
170
+ return this.stateFailureWithNotice('create-failed');
171
+ if (row.status === 'active') {
172
+ const now = this.now();
173
+ const recent = row.recoveries.filter((at) => now - at <= this.spec.flap.windowMs);
174
+ if (now - row.startedAt >= this.spec.maxWallClockMs)
175
+ return this.exhaust(row, 'wall-clock');
176
+ if (recent.length >= this.spec.flap.maxRecoveries)
177
+ return this.exhaust(row, 'flap');
178
+ if (row.attempts >= this.spec.maxAttempts && !row.restart)
179
+ return this.exhaust(row, 'max-attempts');
180
+ }
181
+ if (row.restart) {
182
+ if (row.restart.state === 'required')
183
+ return this.requestPendingRestart(row);
184
+ if (row.restart.requestingBootId === this.bootId)
185
+ return { outcome: 'attempted', reason: 'restart-awaiting-new-boot' };
186
+ let verified = false;
187
+ try {
188
+ verified = this.spec.restartVerified?.(ctx) === true;
189
+ }
190
+ catch {
191
+ verified = false;
192
+ }
193
+ if (!verified) {
194
+ let severity;
195
+ try {
196
+ severity = this.spec.severity(ctx);
197
+ }
198
+ catch {
199
+ severity = 'unknown';
200
+ }
201
+ if (severity === 'unknown')
202
+ return this.noticeAndReturn(row, 'unknown-severity', 'invalid-severity');
203
+ return { outcome: 'attempted', reason: 'restart-verification-not-healthy' };
204
+ }
205
+ const closed = this.cas(row, (r) => ({ ...r, status: 'recovered', restart: null, recoveries: [...r.recoveries, this.now()].slice(-64) }));
206
+ return closed ? { outcome: 'healed', reason: 'restart-verified' } : { outcome: 'busy', reason: 'revision-conflict' };
207
+ }
208
+ let severity;
209
+ try {
210
+ severity = this.spec.severity(ctx);
211
+ }
212
+ catch {
213
+ severity = 'unknown';
214
+ }
215
+ if (!['recoverable', 'irreversible', 'data-loss', 'security'].includes(severity))
216
+ return this.noticeAndReturn(row, 'unknown-severity', 'invalid-severity');
217
+ if (severity !== 'recoverable') {
218
+ const notice = await this.ensureNotice(row, severity);
219
+ row = notice.row;
220
+ }
221
+ if (row.status === 'recovered') {
222
+ const now = this.now();
223
+ const reset = this.cas(row, (r) => ({ ...r, status: 'active', startedAt: now, attempts: 0, nextEligibleAt: 0, latch: emptyLatch(), notices: {}, restart: null }));
224
+ if (!reset)
225
+ return { outcome: 'busy', reason: 'revision-conflict' };
226
+ row = reset;
227
+ }
228
+ if (row.status === 'exhausted')
229
+ return { outcome: 'exhausted', reason: 'terminal' };
230
+ const latch = new FailureEpisodeLatch({ signalAfterMs: this.spec.notificationLatencyCeilingMs, now: this.now });
231
+ latch.restore(row.latch);
232
+ const failure = latch.recordFailure();
233
+ const detected = this.cas(row, (r) => ({ ...r, latch: latch.snapshot() }));
234
+ if (!detected)
235
+ return { outcome: 'busy', reason: 'revision-conflict' };
236
+ row = detected;
237
+ if (failure.shouldSignal) {
238
+ const notice = await this.ensureNotice(row, 'latency');
239
+ row = notice.row;
240
+ }
241
+ const now = this.now();
242
+ const recent = row.recoveries.filter((at) => now - at <= this.spec.flap.windowMs);
243
+ if (now - row.startedAt >= this.spec.maxWallClockMs)
244
+ return this.exhaust(row, 'wall-clock');
245
+ if (recent.length >= this.spec.flap.maxRecoveries)
246
+ return this.exhaust(row, 'flap');
247
+ if (row.attempts >= this.spec.maxAttempts)
248
+ return this.exhaust(row, 'max-attempts');
249
+ if (row.nextEligibleAt > now)
250
+ return { outcome: 'backoff', reason: 'not-eligible-yet' };
251
+ const eligibility = safeEligible(this.spec, ctx);
252
+ if (!eligibility.eligible || !eligibility.fence)
253
+ return { outcome: 'governed', reason: 'fence-stale' };
254
+ const target = { key: keyHash(key), classId: this.spec.classId, keyIsVolatile: false };
255
+ const admission = await this.deps.admit(target, { incarnation: eligibility.fence, eligible: () => safeEligible(this.spec, ctx).fence === eligibility.fence, onAdmitted: (token) => { void this.runAdmitted(ctx, target, token).catch(() => { void this.stateFailureWithNotice('queued-attempt-failed'); }); }, lane: 'job', nowMs: now });
256
+ if (admission.outcome !== 'allow')
257
+ return { outcome: 'governed', reason: admission.outcome };
258
+ return this.runAdmitted(ctx, target, admission.token);
259
+ }
260
+ async runAdmitted(ctx, target, token) {
261
+ let row = this.store.load(this.key(ctx));
262
+ if (!row || row.status !== 'active')
263
+ return { outcome: 'governed', reason: 'episode-not-active' };
264
+ const latch = new FailureEpisodeLatch({ signalAfterMs: this.spec.notificationLatencyCeilingMs, now: this.now });
265
+ latch.restore(row.latch);
266
+ const failure = latch.recordFailure();
267
+ const observed = this.cas(row, (r) => ({ ...r, latch: latch.snapshot() }));
268
+ if (!observed)
269
+ return { outcome: 'busy', reason: 'revision-conflict' };
270
+ row = observed;
271
+ if (failure.shouldSignal) {
272
+ const notice = await this.ensureNotice(row, 'latency');
273
+ row = notice.row;
274
+ }
275
+ const now = this.now();
276
+ const recent = row.recoveries.filter((at) => now - at <= this.spec.flap.windowMs);
277
+ if (now - row.startedAt >= this.spec.maxWallClockMs)
278
+ return this.exhaust(row, 'wall-clock');
279
+ if (recent.length >= this.spec.flap.maxRecoveries)
280
+ return this.exhaust(row, 'flap');
281
+ if (row.nextEligibleAt > now)
282
+ return { outcome: 'backoff', reason: 'not-eligible-yet' };
283
+ const eligibility = safeEligible(this.spec, ctx);
284
+ if (!eligibility.eligible || !eligibility.fence)
285
+ return { outcome: 'governed', reason: 'fence-stale' };
286
+ const consumed = this.deps.consumeToken(token, this.spec.id, { targetKey: target.key, nowMs: this.now() });
287
+ if (!consumed.proceed)
288
+ return { outcome: 'governed', reason: consumed.reason ?? 'token-refused', tokenValid: consumed.valid };
289
+ const again = safeEligible(this.spec, ctx);
290
+ if (!again.eligible || again.fence !== eligibility.fence)
291
+ return { outcome: 'governed', reason: 'fence-stale', tokenValid: consumed.valid };
292
+ if (row.attempts >= this.spec.maxAttempts)
293
+ return this.exhaust(row, 'max-attempts');
294
+ const claim = this.cas(row, (r) => ({ ...r, attempts: r.attempts + 1 }), () => {
295
+ const live = safeEligible(this.spec, ctx);
296
+ return live.eligible && live.fence === eligibility.fence;
297
+ });
298
+ if (!claim)
299
+ return { outcome: 'governed', reason: 'fence-stale-or-revision-conflict' };
300
+ row = claim;
301
+ let result;
302
+ try {
303
+ result = this.spec.remediation(ctx);
304
+ if (result && typeof result.then === 'function')
305
+ throw new Error('async remediation forbidden');
306
+ }
307
+ catch {
308
+ result = { outcome: 'not-healed', evidence: 'io-error' };
309
+ }
310
+ if (result.outcome === 'healed') {
311
+ const closed = this.cas(row, (r) => ({ ...r, status: 'recovered', recoveries: [...r.recoveries, this.now()].slice(-64) }));
312
+ return closed ? { outcome: 'healed', reason: result.evidence, tokenValid: consumed.valid } : { outcome: 'busy', reason: 'revision-conflict' };
313
+ }
314
+ if (result.outcome === 'pending-restart') {
315
+ const stableRequestId = `self-heal:${keyHash(row.key)}:${row.startedAt}`;
316
+ const pending = this.cas(row, (r) => ({ ...r, restart: { state: 'required', requestingBootId: this.bootId, stableRequestId } }));
317
+ return pending ? this.requestPendingRestart(pending) : { outcome: 'busy', reason: 'revision-conflict' };
318
+ }
319
+ const failed = this.cas(row, (r) => ({ ...r, nextEligibleAt: this.now() + Math.max(0, this.spec.backoffMs(row.attempts)) }));
320
+ return failed ? { outcome: 'attempted', reason: result.evidence, tokenValid: consumed.valid } : { outcome: 'busy', reason: 'revision-conflict' };
321
+ }
322
+ requestPendingRestart(row) {
323
+ if (!row.restart)
324
+ return { outcome: 'state-failure', reason: 'restart-state-missing' };
325
+ const ok = this.deps.requestRestart?.(row.restart.stableRequestId) ?? false;
326
+ if (!ok)
327
+ return { outcome: 'attempted', reason: 'restart-request-failed' };
328
+ if (row.restart.state === 'requested')
329
+ return { outcome: 'attempted', reason: 'restart-requested' };
330
+ const requested = this.cas(row, (r) => ({ ...r, restart: r.restart ? { ...r.restart, state: 'requested' } : null }));
331
+ return requested ? { outcome: 'attempted', reason: 'restart-requested' } : { outcome: 'busy', reason: 'revision-conflict' };
332
+ }
333
+ async ensureNotice(row, reason) {
334
+ const existing = row.notices[reason];
335
+ if (existing?.state === 'enqueued')
336
+ return { row, attempted: false };
337
+ const id = existing?.id ?? `self-heal:${keyHash(row.key)}:${reason}:${row.startedAt}`;
338
+ if (!existing) {
339
+ const pending = this.cas(row, (r) => ({ ...r, notices: { ...r.notices, [reason]: { state: 'pending', id } } }));
340
+ if (!pending)
341
+ return { row: this.store.load(row.key) ?? row, attempted: false };
342
+ row = pending;
343
+ }
344
+ try {
345
+ await this.deps.notify({ id, controllerId: this.spec.id, reason, priority: ['irreversible', 'data-loss', 'security'].includes(reason) ? 'URGENT' : 'HIGH' });
346
+ }
347
+ catch {
348
+ this.audit({ event: 'notice-enqueue-failed', reason });
349
+ return { row, attempted: true };
350
+ }
351
+ const enqueued = this.cas(row, (r) => ({ ...r, notices: { ...r.notices, [reason]: { state: 'enqueued', id } } }));
352
+ return { row: enqueued ?? row, attempted: true };
353
+ }
354
+ async noticeAndReturn(row, reason, outcome) { const notice = await this.ensureNotice(row, reason); return { outcome, reason, noticeAttempted: notice.attempted, noticeReason: reason }; }
355
+ async exhaust(row, reason) { const notice = await this.ensureNotice(row, reason); row = notice.row; const terminal = this.cas(row, (r) => ({ ...r, status: 'exhausted' })); return terminal ? { outcome: 'exhausted', reason, noticeAttempted: notice.attempted, noticeReason: reason } : { outcome: 'busy', reason: 'revision-conflict' }; }
356
+ stateFailure(reason) { this.audit({ event: 'state-failure', reason }); return { outcome: 'state-failure', reason }; }
357
+ async stateFailureWithNotice(reason) {
358
+ this.audit({ event: 'state-failure', reason });
359
+ const id = `self-heal:${this.spec.id}:state-failure:${this.bootId}`;
360
+ if (!this.stateFailureNotices.has(id)) {
361
+ try {
362
+ await this.deps.notify({ id, controllerId: this.spec.id, reason: 'state-failure', priority: 'HIGH' });
363
+ this.stateFailureNotices.add(id);
364
+ }
365
+ catch {
366
+ this.audit({ event: 'notice-enqueue-failed', reason: 'state-failure' });
367
+ }
368
+ }
369
+ return { outcome: 'state-failure', reason, noticeAttempted: true, noticeReason: 'state-failure' };
370
+ }
371
+ key(ctx) { const d = this.spec.dedupeKey(ctx); if (!/^[a-z0-9][a-z0-9._:-]{0,119}$/i.test(d))
372
+ throw new Error('invalid self-heal dedupe key'); return `${this.spec.id}:${d}`; }
373
+ newEpisode(key) { const now = this.now(); return { schemaVersion: 1, key, revision: 0, status: 'active', startedAt: now, attempts: 0, nextEligibleAt: 0, latch: emptyLatch(), notices: {}, recoveries: [], restart: null, updatedAt: now }; }
374
+ cas(row, update, guard) { return this.store.mutate(row.key, row.revision, (r) => ({ ...update(r), revision: r.revision + 1, updatedAt: this.now() }), guard); }
375
+ audit(input) { const event = { ...input, at: this.now(), controllerId: this.spec.id }; try {
376
+ this.store.appendAudit?.(event);
377
+ }
378
+ catch { /* secondary sink below */ } try {
379
+ this.deps.audit(event);
380
+ }
381
+ catch { /* metadata audit best effort */ } }
382
+ }
383
+ function safeEligible(spec, ctx) { try {
384
+ return spec.eligible(ctx);
385
+ }
386
+ catch {
387
+ return { eligible: false, fence: null };
388
+ } }
389
+ function emptyLatch() { return { schemaVersion: 1, failingSince: null, failures: 0, signaledFor: null }; }
390
+ function keyHash(value) { return crypto.createHash('sha256').update(value).digest('hex').slice(0, 24); }
391
+ //# sourceMappingURL=SelfHealGate.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"SelfHealGate.js","sourceRoot":"","sources":["../../src/core/SelfHealGate.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,aAAa,CAAC;AACjC,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AACtC,OAAO,EAAE,mBAAmB,EAA+B,MAAM,0BAA0B,CAAC;AAC5F,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAkC3D,SAAS,WAAW,CAAC,MAA6B,IAA2B,OAAO,eAAe,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;AAC9G,SAAS,cAAc,CAAC,KAAc;IACpC,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,MAAM,IAAI,KAAK,CAAC,2BAA2B,CAAC,CAAC;IACtF,MAAM,CAAC,GAAG,KAA8B,CAAC;IACzC,IAAI,CAAC,CAAC,aAAa,KAAK,CAAC,IAAI,OAAO,CAAC,CAAC,GAAG,KAAK,QAAQ,IAAI,CAAC,CAAC,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,MAAM,GAAG,GAAG;QAAE,MAAM,IAAI,KAAK,CAAC,2BAA2B,CAAC,CAAC;IAC/I,KAAK,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC,cAAc,EAAE,CAAC,CAAC,SAAS,CAAC;QAAE,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,2BAA2B,CAAC,CAAC;IACrK,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,WAAW,EAAE,WAAW,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,2BAA2B,CAAC,CAAC;IAC7K,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,UAAU,CAAC,MAAM,GAAG,EAAE,IAAI,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,2BAA2B,CAAC,CAAC;IACrK,MAAM,KAAK,GAAG,IAAI,mBAAmB,CAAC,EAAE,aAAa,EAAE,CAAC,EAAE,CAAC,CAAC;IAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;IACpF,OAAO,CAAC,CAAC;AACX,CAAC;AAED,MAAM,OAAO,4BAA4B;IACtB,IAAI,GAAG,IAAI,GAAG,EAAiC,CAAC;IAAU,MAAM,GAAyB,EAAE,CAAC;IAC7G,IAAI,CAAC,GAAW,IAAkC,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;IACzH,MAAM,CAAC,MAA6B,IAAkC,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC,CAAC,MAAM,GAAG,GAAG,cAAc,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC,OAAO,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IAC1N,MAAM,CAAC,GAAW,EAAE,gBAAwB,EAAE,MAAgE,EAAE,KAAqB;QACnI,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAAC,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC,QAAQ,KAAK,gBAAgB;YAAE,OAAO,IAAI,CAAC;QACvG,IAAI,KAAK,IAAI,CAAC,KAAK,EAAE;YAAE,OAAO,IAAI,CAAC;QACnC,MAAM,IAAI,GAAG,cAAc,CAAC,MAAM,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;QAC1D,IAAI,IAAI,CAAC,GAAG,KAAK,GAAG,IAAI,IAAI,CAAC,QAAQ,KAAK,gBAAgB,GAAG,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,iDAAiD,CAAC,CAAC;QACnI,IAAI,OAAO,CAAC,MAAM,KAAK,WAAW,IAAI,IAAI,CAAC,MAAM,KAAK,WAAW;YAAE,MAAM,IAAI,KAAK,CAAC,wCAAwC,CAAC,CAAC;QAC7H,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC;QAAC,OAAO,WAAW,CAAC,IAAI,CAAC,CAAC;IAClE,CAAC;IACD,WAAW,CAAC,KAAyB,IAAU,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;CAC3F;AAED,MAAM,OAAO,0BAA0B;IACpB,EAAE,CAAoB;IACtB,gBAAgB,CAAa;IAC9C,YAAY,MAAc;QACxB,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QAAC,EAAE,CAAC,SAAS,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;QAC5F,MAAM,EAAE,GAAG,EAAE,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;QAAC,IAAI,CAAC,EAAE,CAAC,WAAW,EAAE,IAAI,EAAE,CAAC,cAAc,EAAE;YAAE,MAAM,IAAI,KAAK,CAAC,+BAA+B,CAAC,CAAC;QAChI,IAAI,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;YAAC,MAAM,EAAE,GAAG,EAAE,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;YAAC,IAAI,CAAC,EAAE,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,cAAc,EAAE;gBAAE,MAAM,IAAI,KAAK,CAAC,6BAA6B,CAAC,CAAC;QAAC,CAAC;QACxJ,IAAI,CAAC,EAAE,GAAG,IAAI,QAAQ,CAAC,MAAM,EAAE,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC,CAAC;QAAC,IAAI,CAAC,EAAE,CAAC,MAAM,CAAC,oBAAoB,CAAC,CAAC;QAAC,IAAI,CAAC,EAAE,CAAC,MAAM,CAAC,oBAAoB,CAAC,CAAC;QAC7H,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,+VAA+V,CAAC,CAAC;QAC9W,IAAI,CAAC;YAAC,EAAE,CAAC,SAAS,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;QAAC,CAAC;QAAC,MAAM,CAAC,CAAC,eAAe,CAAC,CAAC;QAC9D,IAAI,CAAC,gBAAgB,GAAG,oBAAoB,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC;YAAC,IAAI,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC;QAAC,CAAC;QAAC,MAAM,CAAC,CAAC,oBAAoB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAClH,CAAC;IACD,IAAI,CAAC,GAAW,IAAkC,MAAM,GAAG,GAAG,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC,4DAA4D,CAAC,CAAC,GAAG,CAAC,GAAG,CAAoC,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC,cAAc,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;IACvP,MAAM,CAAC,MAA6B;QAClC,MAAM,GAAG,GAAG,cAAc,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC;QAAC,MAAM,EAAE,GAAG,IAAI,CAAC,EAAE,CAAC,WAAW,CAAC,GAAG,EAAE;YACnF,MAAM,KAAK,GAAI,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC,8CAA8C,CAAC,CAAC,GAAG,EAAoB,CAAC,CAAC,CAAC;YAAC,IAAI,KAAK,IAAI,GAAG;gBAAE,OAAO,KAAK,CAAC;YACzI,OAAO,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC,mGAAmG,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,GAAG,CAAC,SAAS,CAAC,CAAC,OAAO,KAAK,CAAC,CAAC;QAC3M,CAAC,CAAC,CAAC;QACH,IAAI,CAAC;YAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QAAC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YAAC,IAAI,cAAc,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;gBAAE,OAAO,IAAI,CAAC;YAAC,MAAM,KAAK,CAAC;QAAC,CAAC;IACpI,CAAC;IACD,MAAM,CAAC,GAAW,EAAE,gBAAwB,EAAE,MAAgE,EAAE,KAAqB;QACnI,MAAM,EAAE,GAAG,IAAI,CAAC,EAAE,CAAC,WAAW,CAAC,GAAG,EAAE;YAAG,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YAAC,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC,QAAQ,KAAK,gBAAgB;gBAAE,OAAO,IAAI,CAAC;YACxI,IAAI,KAAK,IAAI,CAAC,KAAK,EAAE;gBAAE,OAAO,IAAI,CAAC;YACnC,MAAM,IAAI,GAAG,cAAc,CAAC,MAAM,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;YAAC,IAAI,IAAI,CAAC,GAAG,KAAK,GAAG,IAAI,IAAI,CAAC,QAAQ,KAAK,gBAAgB,GAAG,CAAC;gBAAE,MAAM,IAAI,KAAK,CAAC,iDAAiD,CAAC,CAAC;YAC9L,IAAI,OAAO,CAAC,MAAM,KAAK,WAAW,IAAI,IAAI,CAAC,MAAM,KAAK,WAAW;gBAAE,MAAM,IAAI,KAAK,CAAC,wCAAwC,CAAC,CAAC;YAC7H,MAAM,OAAO,GAAG,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC,oGAAoG,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC,SAAS,EAAE,GAAG,EAAE,gBAAgB,CAAC,CAAC,OAAO,CAAC;YAC9N,OAAO,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;QAAC,CAAC,CAAC,CAAC;QACzC,IAAI,CAAC;YAAC,MAAM,GAAG,GAAG,EAAE,EAAE,CAAC;YAAC,OAAO,GAAG,CAAC,CAAC,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QAAC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YAAC,IAAI,cAAc,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;gBAAE,OAAO,IAAI,CAAC;YAAC,MAAM,KAAK,CAAC;QAAC,CAAC;IACrJ,CAAC;IACD,WAAW,CAAC,KAAyB,IAAU,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC,sHAAsH,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,GAAG,IAAI,EAAE,KAAK,CAAC,EAAE,EAAE,KAAK,CAAC,YAAY,EAAE,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,MAAM,IAAI,IAAI,EAAE,KAAK,CAAC,OAAO,IAAI,IAAI,EAAE,KAAK,CAAC,SAAS,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC;IAC/T,KAAK,KAAW,IAAI,CAAC,gBAAgB,EAAE,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;CAC5D;AAQD,MAAM,OAAO,YAAY;IAGM;IAA0C;IAFtD,GAAG,CAAe;IAAkB,KAAK,CAAuB;IAAkB,MAAM,CAAS;IACjG,mBAAmB,GAAG,IAAI,GAAG,EAAU,CAAC;IACzD,YAA6B,IAAuB,EAAmB,IAAsB;QAAhE,SAAI,GAAJ,IAAI,CAAmB;QAAmB,SAAI,GAAJ,IAAI,CAAkB;QAC3F,IAAI,IAAI,CAAC,kBAAkB,KAAK,gBAAgB;YAAE,MAAM,IAAI,KAAK,CAAC,iDAAiD,CAAC,CAAC;QACrH,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,IAAI,CAAC,WAAW,GAAG,CAAC,IAAI,IAAI,CAAC,WAAW,GAAG,EAAE;YAAE,MAAM,IAAI,KAAK,CAAC,qBAAqB,CAAC,CAAC;QACjI,KAAK,MAAM,KAAK,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,IAAI,CAAC,4BAA4B,EAAE,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC;YAAE,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC;gBAAE,MAAM,IAAI,KAAK,CAAC,4BAA4B,CAAC,CAAC;QACpN,IAAI,CAAC,GAAG,GAAG,IAAI,CAAC,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC;QAAC,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,YAAY,IAAI,IAAI,4BAA4B,EAAE,CAAC;QAAC,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC;IAC1J,CAAC;IACD,wBAAwB,CAAC,GAAQ,IAAa,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,KAAK,IAAI,CAAC,CAAC,CAAC;IACxG,KAAK,CAAC,OAAO,CAAC,GAAQ,IAA6B,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,IAAI,CAAC;QAAC,OAAO,MAAM,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC;IAAC,CAAC;IAAC,MAAM,CAAC;QAAC,OAAO,IAAI,CAAC,sBAAsB,CAAC,wBAAwB,CAAC,CAAC;IAAC,CAAC;YAAS,CAAC;QAAC,IAAI,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,kBAAkB,EAAE,SAAS,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC,EAAE,CAAC,CAAC;IAAC,CAAC,CAAC,CAAC;IACtS,aAAa,CAAC,GAAQ;QACpB,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;QAAC,IAAI,CAAC,OAAO;YAAE,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,iBAAiB,EAAE,CAAC;QAAC,IAAI,OAAO,CAAC,MAAM,KAAK,WAAW;YAAE,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC;QAC/M,IAAI,OAAO,CAAC,OAAO;YAAE,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,+BAA+B,EAAE,CAAC;QAC7F,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,GAAG,EAAE,MAAM,EAAE,WAAW,EAAE,UAAU,EAAE,CAAC,GAAG,GAAG,CAAC,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;QAClJ,OAAO,IAAI,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,kBAAkB,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,mBAAmB,EAAE,CAAC;IACrH,CAAC;IACO,KAAK,CAAC,YAAY,CAAC,GAAQ;QACjC,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAAC,IAAI,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAAC,IAAI,CAAC,GAAG,EAAE,CAAC;YAAC,MAAM,KAAK,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;YAAC,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAAC,CAAC;QAAC,IAAI,CAAC,GAAG;YAAE,OAAO,IAAI,CAAC,sBAAsB,CAAC,eAAe,CAAC,CAAC;QACnO,IAAI,GAAG,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;YAC5B,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YAAC,MAAM,MAAM,GAAG,GAAG,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,GAAG,GAAG,EAAE,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YAC1G,IAAI,GAAG,GAAG,GAAG,CAAC,SAAS,IAAI,IAAI,CAAC,IAAI,CAAC,cAAc;gBAAE,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,YAAY,CAAC,CAAC;YAC5F,IAAI,MAAM,CAAC,MAAM,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa;gBAAE,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;YACpF,IAAI,GAAG,CAAC,QAAQ,IAAI,IAAI,CAAC,IAAI,CAAC,WAAW,IAAI,CAAC,GAAG,CAAC,OAAO;gBAAE,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,cAAc,CAAC,CAAC;QACtG,CAAC;QACD,IAAI,GAAG,CAAC,OAAO,EAAE,CAAC;YAChB,IAAI,GAAG,CAAC,OAAO,CAAC,KAAK,KAAK,UAAU;gBAAE,OAAO,IAAI,CAAC,qBAAqB,CAAC,GAAG,CAAC,CAAC;YAC7E,IAAI,GAAG,CAAC,OAAO,CAAC,gBAAgB,KAAK,IAAI,CAAC,MAAM;gBAAE,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,2BAA2B,EAAE,CAAC;YACvH,IAAI,QAAQ,GAAG,KAAK,CAAC;YAAC,IAAI,CAAC;gBAAC,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,eAAe,EAAE,CAAC,GAAG,CAAC,KAAK,IAAI,CAAC;YAAC,CAAC;YAAC,MAAM,CAAC;gBAAC,QAAQ,GAAG,KAAK,CAAC;YAAC,CAAC;YAC/G,IAAI,CAAC,QAAQ,EAAE,CAAC;gBAAC,IAAI,QAA0B,CAAC;gBAAC,IAAI,CAAC;oBAAC,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;gBAAC,CAAC;gBAAC,MAAM,CAAC;oBAAC,QAAQ,GAAG,SAAS,CAAC;gBAAC,CAAC;gBAC1H,IAAI,QAAQ,KAAK,SAAS;oBAAE,OAAO,IAAI,CAAC,eAAe,CAAC,GAAG,EAAE,kBAAkB,EAAE,kBAAkB,CAAC,CAAC;gBACrG,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,kCAAkC,EAAE,CAAC;YAAC,CAAC;YAChF,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC,GAAG,CAAC,CAAC,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;YAC1I,OAAO,MAAM,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,kBAAkB,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,mBAAmB,EAAE,CAAC;QACvH,CAAC;QACD,IAAI,QAA0B,CAAC;QAAC,IAAI,CAAC;YAAC,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;QAAC,CAAC;QAAC,MAAM,CAAC;YAAC,QAAQ,GAAG,SAAS,CAAC;QAAC,CAAC;QAC3G,IAAI,CAAC,CAAC,aAAa,EAAE,cAAc,EAAE,WAAW,EAAE,UAAU,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC;YAAE,OAAO,IAAI,CAAC,eAAe,CAAC,GAAG,EAAE,kBAAkB,EAAE,kBAAkB,CAAC,CAAC;QAC3J,IAAI,QAAQ,KAAK,aAAa,EAAE,CAAC;YAAC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,GAAG,EAAE,QAAwB,CAAC,CAAC;YAAC,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC;QAAC,CAAC;QAC5H,IAAI,GAAG,CAAC,MAAM,KAAK,WAAW,EAAE,CAAC;YAAC,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YAAC,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,GAAG,EAAE,QAAQ,EAAE,CAAC,EAAE,cAAc,EAAE,CAAC,EAAE,KAAK,EAAE,UAAU,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;YAAC,IAAI,CAAC,KAAK;gBAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,mBAAmB,EAAE,CAAC;YAAC,GAAG,GAAG,KAAK,CAAC;QAAC,CAAC;QAChT,IAAI,GAAG,CAAC,MAAM,KAAK,WAAW;YAAE,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC;QACpF,MAAM,KAAK,GAAG,IAAI,mBAAmB,CAAC,EAAE,aAAa,EAAE,IAAI,CAAC,IAAI,CAAC,4BAA4B,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;QAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QAAC,MAAM,OAAO,GAAG,KAAK,CAAC,aAAa,EAAE,CAAC;QACjL,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,CAAC;QAAC,IAAI,CAAC,QAAQ;YAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,mBAAmB,EAAE,CAAC;QAAC,GAAG,GAAG,QAAQ,CAAC;QACnK,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;YAAC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;YAAC,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC;QAAC,CAAC;QACvG,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAAC,MAAM,MAAM,GAAG,GAAG,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,GAAG,GAAG,EAAE,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC1G,IAAI,GAAG,GAAG,GAAG,CAAC,SAAS,IAAI,IAAI,CAAC,IAAI,CAAC,cAAc;YAAE,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,YAAY,CAAC,CAAC;QAAC,IAAI,MAAM,CAAC,MAAM,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa;YAAE,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;QAAC,IAAI,GAAG,CAAC,QAAQ,IAAI,IAAI,CAAC,IAAI,CAAC,WAAW;YAAE,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,cAAc,CAAC,CAAC;QACtQ,IAAI,GAAG,CAAC,cAAc,GAAG,GAAG;YAAE,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,kBAAkB,EAAE,CAAC;QACxF,MAAM,WAAW,GAAG,YAAY,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;QAAC,IAAI,CAAC,WAAW,CAAC,QAAQ,IAAI,CAAC,WAAW,CAAC,KAAK;YAAE,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,aAAa,EAAE,CAAC;QACzJ,MAAM,MAAM,GAAkB,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,aAAa,EAAE,KAAK,EAAE,CAAC;QACtG,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,EAAE,WAAW,EAAE,WAAW,CAAC,KAAK,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,KAAK,KAAK,WAAW,CAAC,KAAK,EAAE,UAAU,EAAE,CAAC,KAAK,EAAE,EAAE,GAAG,KAAK,IAAI,CAAC,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAG,KAAK,IAAI,CAAC,sBAAsB,CAAC,uBAAuB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC;QAC1U,IAAI,SAAS,CAAC,OAAO,KAAK,OAAO;YAAE,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,SAAS,CAAC,OAAO,EAAE,CAAC;QAAC,OAAO,IAAI,CAAC,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,CAAC,KAAK,CAAC,CAAC;IACtJ,CAAC;IACO,KAAK,CAAC,WAAW,CAAC,GAAQ,EAAE,MAAqB,EAAE,KAAqB;QAC9E,IAAI,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;QAAC,IAAI,CAAC,GAAG,IAAI,GAAG,CAAC,MAAM,KAAK,QAAQ;YAAE,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,oBAAoB,EAAE,CAAC;QAC5I,MAAM,KAAK,GAAG,IAAI,mBAAmB,CAAC,EAAE,aAAa,EAAE,IAAI,CAAC,IAAI,CAAC,4BAA4B,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;QAChH,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QAAC,MAAM,OAAO,GAAG,KAAK,CAAC,aAAa,EAAE,CAAC;QAChE,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,CAAC;QAC3E,IAAI,CAAC,QAAQ;YAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,mBAAmB,EAAE,CAAC;QAAC,GAAG,GAAG,QAAQ,CAAC;QACvF,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;YAAC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;YAAC,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC;QAAC,CAAC;QACvG,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,MAAM,MAAM,GAAG,GAAG,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,GAAG,GAAG,EAAE,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAClF,IAAI,GAAG,GAAG,GAAG,CAAC,SAAS,IAAI,IAAI,CAAC,IAAI,CAAC,cAAc;YAAE,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,YAAY,CAAC,CAAC;QAC5F,IAAI,MAAM,CAAC,MAAM,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa;YAAE,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;QACpF,IAAI,GAAG,CAAC,cAAc,GAAG,GAAG;YAAE,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,kBAAkB,EAAE,CAAC;QACxF,MAAM,WAAW,GAAG,YAAY,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;QAAC,IAAI,CAAC,WAAW,CAAC,QAAQ,IAAI,CAAC,WAAW,CAAC,KAAK;YAAE,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,aAAa,EAAE,CAAC;QACzJ,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,KAAK,EAAE,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,SAAS,EAAE,MAAM,CAAC,GAAG,EAAE,KAAK,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;QAAC,IAAI,CAAC,QAAQ,CAAC,OAAO;YAAE,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,IAAI,eAAe,EAAE,UAAU,EAAE,QAAQ,CAAC,KAAK,EAAE,CAAC;QAC1O,MAAM,KAAK,GAAG,YAAY,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;QAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,IAAI,KAAK,CAAC,KAAK,KAAK,WAAW,CAAC,KAAK;YAAE,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,aAAa,EAAE,UAAU,EAAE,QAAQ,CAAC,KAAK,EAAE,CAAC;QACxL,IAAI,GAAG,CAAC,QAAQ,IAAI,IAAI,CAAC,IAAI,CAAC,WAAW;YAAE,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,cAAc,CAAC,CAAC;QACpF,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,QAAQ,GAAG,CAAC,EAAE,CAAC,EAAE,GAAG,EAAE;YAC5E,MAAM,IAAI,GAAG,YAAY,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;YAAC,OAAO,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,KAAK,KAAK,WAAW,CAAC,KAAK,CAAC;QACtG,CAAC,CAAC,CAAC;QACH,IAAI,CAAC,KAAK;YAAE,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,kCAAkC,EAAE,CAAC;QAAC,GAAG,GAAG,KAAK,CAAC;QACpG,IAAI,MAAiC,CAAC;QAAC,IAAI,CAAC;YAAC,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;YAAC,IAAI,MAAM,IAAI,OAAQ,MAAwC,CAAC,IAAI,KAAK,UAAU;gBAAE,MAAM,IAAI,KAAK,CAAC,6BAA6B,CAAC,CAAC;QAAC,CAAC;QAAC,MAAM,CAAC;YAAC,MAAM,GAAG,EAAE,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,UAAU,EAAE,CAAC;QAAC,CAAC;QAC3R,IAAI,MAAM,CAAC,OAAO,KAAK,QAAQ,EAAE,CAAC;YAAC,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,MAAM,EAAE,WAAW,EAAE,UAAU,EAAE,CAAC,GAAG,CAAC,CAAC,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;YAAC,OAAO,MAAM,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,QAAQ,EAAE,UAAU,EAAE,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,mBAAmB,EAAE,CAAC;QAAC,CAAC;QAC/S,IAAI,MAAM,CAAC,OAAO,KAAK,iBAAiB,EAAE,CAAC;YAAC,MAAM,eAAe,GAAG,aAAa,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC,SAAS,EAAE,CAAC;YAAC,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,OAAO,EAAE,EAAE,KAAK,EAAE,UAAU,EAAE,gBAAgB,EAAE,IAAI,CAAC,MAAM,EAAE,eAAe,EAAE,EAAE,CAAC,CAAC,CAAC;YAAC,OAAO,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,qBAAqB,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,mBAAmB,EAAE,CAAC;QAAC,CAAC;QAClW,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,cAAc,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QAAC,OAAO,MAAM,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,CAAC,QAAQ,EAAE,UAAU,EAAE,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,mBAAmB,EAAE,CAAC;IACjR,CAAC;IACO,qBAAqB,CAAC,GAA0B;QACtD,IAAI,CAAC,GAAG,CAAC,OAAO;YAAE,OAAO,EAAE,OAAO,EAAE,eAAe,EAAE,MAAM,EAAE,uBAAuB,EAAE,CAAC;QAAC,MAAM,EAAE,GAAG,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,eAAe,CAAC,IAAI,KAAK,CAAC;QAAC,IAAI,CAAC,EAAE;YAAE,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,wBAAwB,EAAE,CAAC;QAChP,IAAI,GAAG,CAAC,OAAO,CAAC,KAAK,KAAK,WAAW;YAAE,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,mBAAmB,EAAE,CAAC;QAAC,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;QAAC,OAAO,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,mBAAmB,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,mBAAmB,EAAE,CAAC;IACzV,CAAC;IACO,KAAK,CAAC,YAAY,CAAC,GAA0B,EAAE,MAAoB;QACzE,MAAM,QAAQ,GAAG,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QAAC,IAAI,QAAQ,EAAE,KAAK,KAAK,UAAU;YAAE,OAAO,EAAE,GAAG,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC;QAAC,MAAM,EAAE,GAAG,QAAQ,EAAE,EAAE,IAAI,aAAa,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,MAAM,IAAI,GAAG,CAAC,SAAS,EAAE,CAAC;QAClM,IAAI,CAAC,QAAQ,EAAE,CAAC;YAAC,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,OAAO,EAAE,EAAE,GAAG,CAAC,CAAC,OAAO,EAAE,CAAC,MAAM,CAAC,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC;YAAC,IAAI,CAAC,OAAO;gBAAE,OAAO,EAAE,GAAG,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,GAAG,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC;YAAC,GAAG,GAAG,OAAO,CAAC;QAAC,CAAC;QACnO,IAAI,CAAC;YAAC,MAAM,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,YAAY,EAAE,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,cAAc,EAAE,WAAW,EAAE,UAAU,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;QAAC,CAAC;QAAC,MAAM,CAAC;YAAC,IAAI,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,uBAAuB,EAAE,MAAM,EAAE,CAAC,CAAC;YAAC,OAAO,EAAE,GAAG,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;QAAC,CAAC;QACxQ,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,OAAO,EAAE,EAAE,GAAG,CAAC,CAAC,OAAO,EAAE,CAAC,MAAM,CAAC,EAAE,EAAE,KAAK,EAAE,UAAU,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC;QAAC,OAAO,EAAE,GAAG,EAAE,QAAQ,IAAI,GAAG,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;IACtK,CAAC;IACO,KAAK,CAAC,eAAe,CAAC,GAA0B,EAAE,MAAoB,EAAE,OAAkC,IAA6B,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,CAAC,SAAS,EAAE,YAAY,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC;IAClR,KAAK,CAAC,OAAO,CAAC,GAA0B,EAAE,MAA8C,IAA6B,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC,CAAC,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC,CAAC,OAAO,QAAQ,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,CAAC,SAAS,EAAE,YAAY,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,mBAAmB,EAAE,CAAC,CAAC,CAAC;IACra,YAAY,CAAC,MAAc,IAAoB,IAAI,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,eAAe,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,OAAO,EAAE,OAAO,EAAE,eAAe,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC;IAC7I,KAAK,CAAC,sBAAsB,CAAC,MAAc;QACjD,IAAI,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,eAAe,EAAE,MAAM,EAAE,CAAC,CAAC;QAC/C,MAAM,EAAE,GAAG,aAAa,IAAI,CAAC,IAAI,CAAC,EAAE,kBAAkB,IAAI,CAAC,MAAM,EAAE,CAAC;QACpE,IAAI,CAAC,IAAI,CAAC,mBAAmB,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC;YACtC,IAAI,CAAC;gBAAC,MAAM,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,YAAY,EAAE,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,MAAM,EAAE,eAAe,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC;gBAAC,IAAI,CAAC,mBAAmB,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAAC,CAAC;YAChJ,MAAM,CAAC;gBAAC,IAAI,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,uBAAuB,EAAE,MAAM,EAAE,eAAe,EAAE,CAAC,CAAC;YAAC,CAAC;QACpF,CAAC;QACD,OAAO,EAAE,OAAO,EAAE,eAAe,EAAE,MAAM,EAAE,eAAe,EAAE,IAAI,EAAE,YAAY,EAAE,eAAe,EAAE,CAAC;IACpG,CAAC;IACO,GAAG,CAAC,GAAQ,IAAY,MAAM,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,gCAAgC,CAAC,IAAI,CAAC,CAAC,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,8BAA8B,CAAC,CAAC,CAAC,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;IAC5L,UAAU,CAAC,GAAW,IAA2B,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,OAAO,EAAE,aAAa,EAAE,CAAC,EAAE,GAAG,EAAE,QAAQ,EAAE,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,GAAG,EAAE,QAAQ,EAAE,CAAC,EAAE,cAAc,EAAE,CAAC,EAAE,KAAK,EAAE,UAAU,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,UAAU,EAAE,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC;IAC5Q,GAAG,CAAC,GAA0B,EAAE,MAA2D,EAAE,KAAqB,IAAkC,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,QAAQ,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,MAAM,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,QAAQ,GAAG,CAAC,EAAE,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC;IACzR,KAAK,CAAC,KAAsD,IAAU,MAAM,KAAK,GAAG,EAAE,GAAG,KAAK,EAAE,EAAE,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,YAAY,EAAE,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC;QAAC,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC;IAAC,CAAC;IAAC,MAAM,CAAC,CAAC,0BAA0B,CAAC,CAAC,CAAC,IAAI,CAAC;QAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAAC,CAAC;IAAC,MAAM,CAAC,CAAC,gCAAgC,CAAC,CAAC,CAAC,CAAC;CACjT;AACD,SAAS,YAAY,CAAM,IAAuB,EAAE,GAAQ,IAAiD,IAAI,CAAC;IAAC,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;AAAC,CAAC;AAAC,MAAM,CAAC;IAAC,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;AAAC,CAAC,CAAC,CAAC;AACpM,SAAS,UAAU,KAA6B,OAAO,EAAE,aAAa,EAAE,CAAC,EAAE,YAAY,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;AAClI,SAAS,OAAO,CAAC,KAAa,IAAY,OAAO,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC"}
@@ -0,0 +1,23 @@
1
+ export interface SshBootstrapAdvert {
2
+ machineId: string;
3
+ agentId: string;
4
+ pairingEpoch: number;
5
+ observerBootId: string;
6
+ clientKeyGeneration: number;
7
+ hostKeyGeneration: number;
8
+ clientPublicKey: string;
9
+ sshHostPublicKeys: string[];
10
+ endpoints: Array<{
11
+ host: string;
12
+ port: number;
13
+ source: 'tailscale' | 'lan' | 'configured';
14
+ }>;
15
+ issuedAt: string;
16
+ expiresAt: string;
17
+ hostKeyTransitionSignature?: string;
18
+ machineSignature: string;
19
+ }
20
+ export declare function canonicalSshBootstrapAdvert(advert: Omit<SshBootstrapAdvert, 'machineSignature'>): string;
21
+ /** Structural security floor; MachineAuth signature/principal validation precedes this call. */
22
+ export declare function validateSshBootstrapAdvert(input: unknown, principalMachineId: string, principalAgentId: string, now?: number): SshBootstrapAdvert;
23
+ //# sourceMappingURL=SshBootstrapAdvert.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"SshBootstrapAdvert.d.ts","sourceRoot":"","sources":["../../src/core/SshBootstrapAdvert.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,eAAe,EAAE,MAAM,CAAC;IACxB,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,SAAS,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,WAAW,GAAG,KAAK,GAAG,YAAY,CAAA;KAAE,CAAC,CAAC;IAC7F,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,0BAA0B,CAAC,EAAE,MAAM,CAAC;IACpC,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,IAAI,CAAC,kBAAkB,EAAE,kBAAkB,CAAC,GAAG,MAAM,CASxG;AAED,gGAAgG;AAChG,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,OAAO,EAAE,kBAAkB,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,EAAE,GAAG,SAAa,GAAG,kBAAkB,CAarJ"}
@@ -0,0 +1,43 @@
1
+ import net from 'node:net';
2
+ export function canonicalSshBootstrapAdvert(advert) {
3
+ return JSON.stringify({
4
+ machineId: advert.machineId, agentId: advert.agentId, pairingEpoch: advert.pairingEpoch,
5
+ observerBootId: advert.observerBootId, clientKeyGeneration: advert.clientKeyGeneration,
6
+ hostKeyGeneration: advert.hostKeyGeneration, clientPublicKey: advert.clientPublicKey,
7
+ sshHostPublicKeys: advert.sshHostPublicKeys, endpoints: advert.endpoints,
8
+ issuedAt: advert.issuedAt, expiresAt: advert.expiresAt,
9
+ ...(advert.hostKeyTransitionSignature ? { hostKeyTransitionSignature: advert.hostKeyTransitionSignature } : {}),
10
+ });
11
+ }
12
+ /** Structural security floor; MachineAuth signature/principal validation precedes this call. */
13
+ export function validateSshBootstrapAdvert(input, principalMachineId, principalAgentId, now = Date.now()) {
14
+ if (!input || typeof input !== 'object')
15
+ throw new Error('invalid-ssh-advert');
16
+ const row = input;
17
+ if (row.machineId !== principalMachineId || row.agentId !== principalAgentId)
18
+ throw new Error('ssh-advert-principal-mismatch');
19
+ if (!Number.isSafeInteger(row.pairingEpoch) || row.pairingEpoch < 1 || !Number.isSafeInteger(row.clientKeyGeneration) || !Number.isSafeInteger(row.hostKeyGeneration))
20
+ throw new Error('ssh-advert-generation-invalid');
21
+ const issuedAt = Date.parse(row.issuedAt);
22
+ const expiresAt = Date.parse(row.expiresAt);
23
+ if (!Number.isFinite(issuedAt) || !Number.isFinite(expiresAt) || issuedAt > now + 30_000 || expiresAt <= now || expiresAt - now > 300_000)
24
+ throw new Error('ssh-advert-expired');
25
+ if (!Array.isArray(row.sshHostPublicKeys) || !/^ssh-ed25519 [A-Za-z0-9+/=]+(?:\s|$)/.test(row.clientPublicKey) || row.sshHostPublicKeys.length < 1 || row.sshHostPublicKeys.length > 2 || row.sshHostPublicKeys.some(key => !/^ssh-ed25519 [A-Za-z0-9+/=]+(?:\s|$)/.test(key)))
26
+ throw new Error('ssh-advert-key-invalid');
27
+ if (!Array.isArray(row.endpoints) || row.endpoints.length > 8 || row.endpoints.some(endpoint => !validEndpoint(endpoint)))
28
+ throw new Error('ssh-advert-endpoint-invalid');
29
+ if (typeof row.observerBootId !== 'string' || row.observerBootId.length < 8 || row.observerBootId.length > 128 || typeof row.machineSignature !== 'string' || row.machineSignature.length < 32 || row.machineSignature.length > 512)
30
+ throw new Error('ssh-advert-signature-invalid');
31
+ if (row.hostKeyTransitionSignature !== undefined && (typeof row.hostKeyTransitionSignature !== 'string' || row.hostKeyTransitionSignature.length < 32 || row.hostKeyTransitionSignature.length > 512))
32
+ throw new Error('ssh-advert-transition-signature-invalid');
33
+ return row;
34
+ }
35
+ function validEndpoint(endpoint) {
36
+ if (!['tailscale', 'lan', 'configured'].includes(endpoint.source) || !Number.isInteger(endpoint.port) || endpoint.port < 1024 || endpoint.port > 65535)
37
+ return false;
38
+ if (net.isIP(endpoint.host) !== 4)
39
+ return false;
40
+ const [a, b] = endpoint.host.split('.').map(Number);
41
+ return a === 10 || (a === 100 && b >= 64 && b <= 127) || (a === 172 && b >= 16 && b <= 31) || (a === 192 && b === 168);
42
+ }
43
+ //# sourceMappingURL=SshBootstrapAdvert.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"SshBootstrapAdvert.js","sourceRoot":"","sources":["../../src/core/SshBootstrapAdvert.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,43 @@
1
+ export type SshHostKeyState = 'current' | 'quarantined' | 'overlap' | 'retired' | 'rollback-rejected';
2
+ export interface SignedHostKeyProposal {
3
+ agentId: string;
4
+ machineId: string;
5
+ pairingEpoch: number;
6
+ generation: number;
7
+ previousGeneration: number;
8
+ publicKey: string;
9
+ issuedAt: string;
10
+ machineSignature: string;
11
+ previousHostSignature?: string;
12
+ }
13
+ export interface HostKeyProposalVerifier {
14
+ verifyMachine(proposal: SignedHostKeyProposal): boolean;
15
+ verifyPreviousHost(proposal: SignedHostKeyProposal): boolean;
16
+ }
17
+ export interface HostKeyGeneration {
18
+ generation: number;
19
+ fingerprint: string;
20
+ publicKey: string;
21
+ state: SshHostKeyState;
22
+ quarantinedAt?: number;
23
+ }
24
+ export declare function canonicalHostKeyProposal(proposal: Omit<SignedHostKeyProposal, 'machineSignature' | 'previousHostSignature'>): string;
25
+ /** Monotonic, fail-closed host-key rotation state machine. */
26
+ export declare class SshHostKeyLifecycle {
27
+ private readonly overlapCeilingMs;
28
+ private current;
29
+ private candidate?;
30
+ constructor(initial: {
31
+ generation: number;
32
+ publicKey: string;
33
+ }, overlapCeilingMs?: number);
34
+ propose(proposal: SignedHostKeyProposal, verifier: HostKeyProposalVerifier, now?: number): HostKeyGeneration;
35
+ proveCandidate(generation: number): HostKeyGeneration;
36
+ promote(generation: number, allRequiredInboundProofs: boolean, now?: number): HostKeyGeneration;
37
+ expire(now?: number): void;
38
+ snapshot(): {
39
+ current: HostKeyGeneration;
40
+ candidate?: HostKeyGeneration;
41
+ };
42
+ }
43
+ //# sourceMappingURL=SshHostKeyLifecycle.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"SshHostKeyLifecycle.d.ts","sourceRoot":"","sources":["../../src/core/SshHostKeyLifecycle.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,eAAe,GAAG,SAAS,GAAG,aAAa,GAAG,SAAS,GAAG,SAAS,GAAG,mBAAmB,CAAC;AAEtG,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,gBAAgB,EAAE,MAAM,CAAC;IACzB,qBAAqB,CAAC,EAAE,MAAM,CAAC;CAChC;AAED,MAAM,WAAW,uBAAuB;IACtC,aAAa,CAAC,QAAQ,EAAE,qBAAqB,GAAG,OAAO,CAAC;IACxD,kBAAkB,CAAC,QAAQ,EAAE,qBAAqB,GAAG,OAAO,CAAC;CAC9D;AAED,MAAM,WAAW,iBAAiB;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,eAAe,CAAC;IACvB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,IAAI,CAAC,qBAAqB,EAAE,kBAAkB,GAAG,uBAAuB,CAAC,GAAG,MAAM,CAMpI;AAED,8DAA8D;AAC9D,qBAAa,mBAAmB;IAIkC,OAAO,CAAC,QAAQ,CAAC,gBAAgB;IAHjG,OAAO,CAAC,OAAO,CAAoB;IACnC,OAAO,CAAC,SAAS,CAAC,CAAoB;gBAE1B,OAAO,EAAE;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,EAAmB,gBAAgB,SAAU;IAI3G,OAAO,CAAC,QAAQ,EAAE,qBAAqB,EAAE,QAAQ,EAAE,uBAAuB,EAAE,GAAG,SAAa,GAAG,iBAAiB;IAgBhH,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,iBAAiB;IAMrD,OAAO,CAAC,UAAU,EAAE,MAAM,EAAE,wBAAwB,EAAE,OAAO,EAAE,GAAG,SAAa,GAAG,iBAAiB;IASnG,MAAM,CAAC,GAAG,SAAa,GAAG,IAAI;IAI9B,QAAQ,IAAI;QAAE,OAAO,EAAE,iBAAiB,CAAC;QAAC,SAAS,CAAC,EAAE,iBAAiB,CAAA;KAAE;CAG1E"}
@@ -0,0 +1,68 @@
1
+ import { createHash } from 'node:crypto';
2
+ export function canonicalHostKeyProposal(proposal) {
3
+ return JSON.stringify({
4
+ agentId: proposal.agentId, machineId: proposal.machineId, pairingEpoch: proposal.pairingEpoch,
5
+ generation: proposal.generation, previousGeneration: proposal.previousGeneration,
6
+ publicKey: proposal.publicKey, issuedAt: proposal.issuedAt,
7
+ });
8
+ }
9
+ /** Monotonic, fail-closed host-key rotation state machine. */
10
+ export class SshHostKeyLifecycle {
11
+ overlapCeilingMs;
12
+ current;
13
+ candidate;
14
+ constructor(initial, overlapCeilingMs = 600_000) {
15
+ this.overlapCeilingMs = overlapCeilingMs;
16
+ this.current = { ...initial, fingerprint: keyFingerprint(initial.publicKey), state: 'current' };
17
+ }
18
+ propose(proposal, verifier, now = Date.now()) {
19
+ const fp = keyFingerprint(proposal.publicKey);
20
+ if (!verifier.verifyMachine(proposal))
21
+ throw new Error('host-key-machine-signature-invalid');
22
+ if (proposal.generation <= this.current.generation || proposal.previousGeneration !== this.current.generation) {
23
+ throw new Error('host-key-rollback-rejected');
24
+ }
25
+ if (proposal.generation !== this.current.generation + 1)
26
+ throw new Error('host-key-generation-gap');
27
+ if (this.candidate) {
28
+ if (this.candidate.generation === proposal.generation && this.candidate.fingerprint === fp)
29
+ return this.candidate;
30
+ throw new Error('host-key-competing-proposal');
31
+ }
32
+ this.candidate = { generation: proposal.generation, publicKey: proposal.publicKey, fingerprint: fp, state: 'quarantined', quarantinedAt: now };
33
+ if (proposal.previousHostSignature && verifier.verifyPreviousHost(proposal))
34
+ this.candidate.state = 'overlap';
35
+ return this.candidate;
36
+ }
37
+ proveCandidate(generation) {
38
+ if (!this.candidate || this.candidate.generation !== generation)
39
+ throw new Error('host-key-not-quarantined');
40
+ this.candidate.state = 'overlap';
41
+ return this.candidate;
42
+ }
43
+ promote(generation, allRequiredInboundProofs, now = Date.now()) {
44
+ if (!this.candidate || this.candidate.generation !== generation || this.candidate.state !== 'overlap')
45
+ throw new Error('host-key-not-in-overlap');
46
+ if (now - (this.candidate.quarantinedAt ?? now) > this.overlapCeilingMs)
47
+ throw new Error('host-key-overlap-expired');
48
+ if (!allRequiredInboundProofs)
49
+ throw new Error('host-key-proofs-incomplete');
50
+ this.current = { ...this.candidate, state: 'current', quarantinedAt: undefined };
51
+ this.candidate = undefined;
52
+ return this.current;
53
+ }
54
+ expire(now = Date.now()) {
55
+ if (this.candidate && now - (this.candidate.quarantinedAt ?? now) > this.overlapCeilingMs)
56
+ this.candidate = undefined;
57
+ }
58
+ snapshot() {
59
+ return { current: { ...this.current }, candidate: this.candidate ? { ...this.candidate } : undefined };
60
+ }
61
+ }
62
+ function keyFingerprint(publicKey) {
63
+ const body = publicKey.trim().split(/\s+/)[1];
64
+ if (!body)
65
+ throw new Error('host-key-invalid');
66
+ return createHash('sha256').update(Buffer.from(body, 'base64')).digest('hex');
67
+ }
68
+ //# sourceMappingURL=SshHostKeyLifecycle.js.map