@forgezero/agent 0.1.65 → 0.1.68

package/dist/operator-bootstrap.d.ts

@@ -1,5 +1,5 @@
-import { type PlatformBootstrapSecrets } from './bootstrap';
-import { type PlatformGenesisEnvironment } from './platform-genesis';
+import { type PlatformBootstrapConfig, type PlatformBootstrapSecrets } from './bootstrap';
+import { type PlatformGenesisGuest } from './platform-genesis';
 export interface OperatorSshHop {
     address: string;
     port: number;
@@ -21,10 +21,22 @@ export interface OperatorMetalBootstrapRequest {
     target: OperatorPlatformBootstrapRequest['target'];
     metalConfigFile: string;
     genesis: {
-        environment: PlatformGenesisEnvironment;
+        nodes: readonly [PlatformGenesisGuest, PlatformGenesisGuest, PlatformGenesisGuest];
+        rehearsalNode?: PlatformGenesisGuest;
         sshPublicKeyFiles: string[];
     };
 }
+export interface OperatorGuestHostKeyEvidence {
+    format: 1;
+    kind: 'forgezero-operator-guest-host-keys';
+    metalHostKeySha256: string;
+    nodes: readonly {
+        name: string;
+        address: string;
+        hostKey: string;
+        hostKeySha256: string;
+    }[];
+}
 export interface OperatorPlatformBootstrapFleetRequest {
     kind: 'platform-fleet-remote';
     requests: readonly [string, string, string];
@@ -33,7 +45,7 @@ export interface OperatorPlatformBootstrapFleetPlan {
     kind: 'platform-fleet-remote';
     mode: OperatorPlatformBootstrapMode;
     mutation: boolean;
-    environment: PlatformGenesisEnvironment;
+    environment: PlatformBootstrapConfig['environment'];
     nodes: readonly {
         computeReference: string;
         address: string;
@@ -53,8 +65,19 @@ export interface OperatorPlatformBootstrapFleetResult {
     ok: boolean;
     outcomes: readonly OperatorPlatformBootstrapFleetOutcome[];
 }
+export interface OperatorPlatformFleetCoordinates {
+    environment: PlatformBootstrapConfig['environment'];
+    appOrigin: string;
+    apiOrigin: string;
+    nodes: readonly {
+        computeReference: string;
+        address: string;
+        nodeHostname: string;
+        databaseRole: 'master' | 'joiner';
+    }[];
+}
 export type OperatorPlatformBootstrapMode = 'apply' | 'status';
-export type OperatorMetalBootstrapMode = 'apply' | 'genesis' | 'rehearsal' | 'rehearsal-cleanup' | 'status';
+export type OperatorMetalBootstrapMode = 'apply' | 'genesis' | 'rehearsal' | 'rehearsal-cleanup' | 'host-keys' | 'rehearsal-host-keys' | 'status';
 export interface OperatorPlatformBootstrapPlan {
     kind: 'platform-remote';
     mode: OperatorPlatformBootstrapMode;
@@ -103,9 +126,27 @@ export declare function readOperatorPlatformBootstrapFleetRequest(path: string):
 export declare function writeOperatorPlatformBootstrapFleetRequest(path: string, requestFiles: readonly [string, string, string]): string;
 export declare function readOperatorMetalBootstrapRequest(path: string): OperatorMetalBootstrapRequest;
 export declare function writeOperatorMetalBootstrapRequest(path: string, request: OperatorMetalBootstrapRequest): string;
+export declare function readOperatorGuestHostKeyEvidence(path: string, request?: OperatorMetalBootstrapRequest): OperatorGuestHostKeyEvidence;
+export declare function writeOperatorGuestHostKeyEvidence(path: string, evidence: OperatorGuestHostKeyEvidence, request?: OperatorMetalBootstrapRequest): string;
 export declare function planOperatorMetalBootstrap(request: OperatorMetalBootstrapRequest, mode: OperatorMetalBootstrapMode): OperatorMetalBootstrapPlan;
 export declare function planOperatorPlatformBootstrap(request: OperatorPlatformBootstrapRequest, mode: OperatorPlatformBootstrapMode): OperatorPlatformBootstrapPlan;
+/** Exact non-secret coordinates derived from the same reviewed files bootstrap applies. */
+export declare function operatorPlatformFleetCoordinates(fleet: OperatorPlatformBootstrapFleetRequest): OperatorPlatformFleetCoordinates;
 export declare function planOperatorPlatformFleetBootstrap(fleet: OperatorPlatformBootstrapFleetRequest, mode: OperatorPlatformBootstrapMode): OperatorPlatformBootstrapFleetPlan;
+export declare function collectOperatorGuestHostKeys(request: OperatorMetalBootstrapRequest, options?: OperatorPlatformBootstrapOptions, includeRehearsal?: boolean): Promise<OperatorGuestHostKeyEvidence>;
+export interface OperatorGuestTransport {
+    run(nodeName: string, argv: readonly string[], options?: {
+        stdin?: string;
+        secret?: boolean;
+        allowFailure?: boolean;
+    }): Promise<OperatorCommandResult>;
+    copy(nodeName: string, localPath: string, remotePath: string): Promise<void>;
+}
+/**
+ * Execute a bounded callback through the same pinned Metal jump, operator
+ * public identity selector and reviewed guest host keys used by bootstrap.
+ */
+export declare function withOperatorGuestTransport<T>(request: OperatorMetalBootstrapRequest, evidence: OperatorGuestHostKeyEvidence, callback: (transport: OperatorGuestTransport) => Promise<T>, options?: OperatorPlatformBootstrapOptions): Promise<T>;
 /**
  * Run one reviewed operator action. No private SSH key, credential value or
  * management token is placed in argv; OpenSSH selects the matching private key
@@ -125,6 +166,8 @@ export declare function applyOperatorPlatformBootstrap(request: OperatorPlatform
 export declare function applyOperatorPlatformFleetBootstrap(fleet: OperatorPlatformBootstrapFleetRequest, mode: OperatorPlatformBootstrapMode, options?: OperatorPlatformBootstrapOptions & {
     secrets?: PlatformBootstrapSecrets;
 }): Promise<OperatorPlatformBootstrapFleetResult>;
+/** Run the fixed host acceptance operation through each request's pinned SSH identity. */
+export declare function verifyOperatorPlatformFleet(fleet: OperatorPlatformBootstrapFleetRequest, expectedVersion: string, options?: OperatorPlatformBootstrapOptions): Promise<OperatorPlatformBootstrapFleetResult>;
 /**
  * Install/bootstrap one blank metal host or provision its exact three-node
  * platform seed through the same pinned SSH transport used for guest bootstrap.