@ksp-gonogo/sitrep-sdk 1.0.0-rc.21 → 2.0.0-rc.23

package/dist/__generated__/contract.d.ts

@@ -36,10 +36,11 @@ export interface StreamBinary {
     meta: Meta;
 }
 /**
-* Args for `system.bodies.statesAt`: where one body is at each of a list of
-* instants, from the propagation provider in use on this install. The instants
-* are the caller's own, such as the departure and arrival times a transfer
-* search tries.
+* Ask where a body is at each of a list of instants. Args for
+* `system.bodies.statesAt`: where one body is at each of a list of instants,
+* from the propagation provider in use on this install. The instants are the
+* caller's own, such as the departure and arrival times a transfer search
+* tries.
 *
 * The command centre is the sender's, taken from the connection the command
 * arrives on; there is no field to name another.
@@ -144,14 +145,15 @@ export interface BodyState {
     vz: Value<"m/s">;
 }
 /**
-* `career.strategy.activate`'s args: the strategy's stable id plus the slider
-* fraction to activate it at. `ActivateStrategyArgs.strategyId` is
-* `StrategyConfig.Name` (e.g. `"OutsourceRnDStrategy"`): the same id
-* `career.status` publishes for each strategy as `strategies[].id`, so a
-* client activates using the id it read. `ActivateStrategyArgs.factor` is the
-* 0 to 1 slider fraction the strategy is committed at (its up-front funds,
-* science and reputation cost scales with it); a strategy with no factor
-* slider ignores it and activates at its fixed factor.
+* Activate a strategy at a chosen commitment. `career.strategy.activate`'s
+* args: the strategy's stable id plus the slider fraction to activate it at.
+* `ActivateStrategyArgs.strategyId` is `StrategyConfig.Name` (e.g.
+* `"OutsourceRnDStrategy"`): the same id `career.status` publishes for each
+* strategy as `strategies[].id`, so a client activates using the id it read.
+* `ActivateStrategyArgs.factor` is the 0 to 1 slider fraction the strategy is
+* committed at (its up-front funds, science and reputation cost scales with
+* it); a strategy with no factor slider ignores it and activates at its fixed
+* factor.
 *
 * @category Command arguments
 */
@@ -165,8 +167,9 @@ export interface ActivateStrategyArgs {
     factor: number;
 }
 /**
-* `career.strategy.deactivate`'s args: the strategy's stable
-* `StrategyConfig.Name` id (see `ActivateStrategyArgs.strategyId`).
+* Deactivate an active strategy. `career.strategy.deactivate`'s args: the
+* strategy's stable `StrategyConfig.Name` id (see
+* `ActivateStrategyArgs.strategyId`).
 *
 * @category Command arguments
 */
@@ -178,9 +181,9 @@ export interface DeactivateStrategyArgs {
     strategyId: string;
 }
 /**
-* `career.tech.unlock`'s args: the tech node's `techID`, the same id
-* `career.status` publishes for each tech node as `tech.nodes[].id`. Unlocking
-* deducts the node's science cost.
+* Unlock a tech node, spending its science cost. `career.tech.unlock`'s args:
+* the tech node's `techID`, the same id `career.status` publishes for each
+* tech node as `tech.nodes[].id`. Unlocking deducts the node's science cost.
 *
 * @category Command arguments
 */
@@ -192,10 +195,11 @@ export interface UnlockTechArgs {
     techId: string;
 }
 /**
-* Args shared by `career.contract.accept`/`decline`/`cancel`: the contract's
-* stable `ContractID` as a string, the same id `career.status` publishes for
-* each contract as `contracts[].id`. Which of the three verbs is valid depends
-* on the contract's current state (accept/decline require an offered contract,
+* Accept, decline or cancel a contract. Args shared by
+* `career.contract.accept`/`decline`/`cancel`: the contract's stable
+* `ContractID` as a string, the same id `career.status` publishes for each
+* contract as `contracts[].id`. Which of the three verbs is valid depends on
+* the contract's current state (accept/decline require an offered contract,
 * cancel an active one); an out-of-state request comes back
 * `CommandErrorCode.ModeUnavailable`.
 *
@@ -209,8 +213,9 @@ export interface ContractActionArgs {
     contractId: string;
 }
 /**
-* `career.facility.upgrade`'s args: the facility's `SpaceCenterFacility` enum
-* name (e.g. `"VehicleAssemblyBuilding"`, `"LaunchPad"`), the same key
+* Raise a Space Center facility by one tier. `career.facility.upgrade`'s args:
+* the facility's `SpaceCenterFacility` enum name (e.g.
+* `"VehicleAssemblyBuilding"`, `"LaunchPad"`), the same key
 * `CareerFacilities`'s `facilities` map uses on the `career.facilities`
 * channel (the buildings are not on `career.status`). Upgrading raises the
 * facility one tier and deducts its upgrade cost from funds.
@@ -225,8 +230,9 @@ export interface UpgradeFacilityArgs {
     facilityId: string;
 }
 /**
-* `career.crew.hire`'s args: the applicant's `ProtoCrewMember.name`, the same
-* id `spaceCenter.astronautComplex` publishes for each applicant as
+* Hire an applicant into the crew roster. `career.crew.hire`'s args: the
+* applicant's `ProtoCrewMember.name`, the same id
+* `spaceCenter.astronautComplex` publishes for each applicant as
 * `applicants[].name`, so a client hires the applicant it read. Hiring debits
 * the current recruit cost from funds and moves the applicant into the crew
 * roster. An applicant that has left the pool since it was read (someone else
@@ -245,6 +251,7 @@ export interface HireApplicantArgs {
     applicantName: string;
 }
 /**
+* Fire a hired kerbal, returning them to the applicant pool.
 * `career.crew.fire`'s args: a hired kerbal's `ProtoCrewMember.name`, the same
 * id `spaceCenter.crewRoster` publishes for each roster entry. Firing costs
 * nothing and returns the kerbal to the applicant pool, so it is reversible: a
@@ -293,10 +300,10 @@ export declare enum GameMode {
     Unknown = 3
 }
 /**
-* The `career.mode` channel payload: the active save's `GameMode`, as `{
-* "mode": <int> }`. The whole payload is `null` when no game is loaded (main
-* menu, no save). Once a save is loaded the mode is always one of the four
-* `GameMode` members.
+* The `career.mode` Topic payload: the active save's `GameMode`, as `{ "mode":
+* <int> }`. The whole payload is `null` when no game is loaded (main menu, no
+* save). Once a save is loaded the mode is always one of the four `GameMode`
+* members.
 *
 * @category Career
 */
@@ -305,10 +312,10 @@ export interface CareerMode {
     mode: GameMode;
 }
 /**
-* The `career.status` channel payload: the KSC and career-mode snapshot, in
-* four groups (balances, contracts, strategies, tech). The space centre's
-* buildings are not here: they are on `CareerFacilities`, which can be held on
-* its own while this channel keeps arriving.
+* The `career.status` Topic payload: the KSC and career-mode snapshot, in four
+* groups (balances, contracts, strategies, tech). The space centre's buildings
+* are not here: they are on `CareerFacilities`, which can be held on its own
+* while this channel keeps arriving.
 *
 * **Three states.** The whole payload is `null` in a sandbox save, where there
 * is no career at all. A non-null payload with a sub-group `null` means career
@@ -361,7 +368,7 @@ export interface CareerStatus {
     meta: PayloadMeta;
 }
 /**
-* The `career.facilities` channel payload: the space centre's buildings, each
+* The `career.facilities` Topic payload: the space centre's buildings, each
 * with the tier it stands at and the ladder it stands on.
 *
 * **When it arrives.** A facility's tier count and prices are readable from
@@ -897,7 +904,7 @@ export interface ChannelEmissionReport {
 * CommNet home nodes (KSC, Extra Ground Stations, Kerbal Konstructs sites) and
 * crewed control-source vessels.
 *
-* The channel payload is a bare array of these entries, like
+* The Topic payload is a bare array of these entries, like
 * `SpaceCenterPoiEntry`, one per centre, keyed by `CommandCentreEntry.id`.
 *
 * Each command centre is sent its own roster, the centres it knows of. A
@@ -993,7 +1000,7 @@ export interface CommandCentreEntry {
 * station whose node went away, a crewed vessel that lost its crew or was
 * destroyed or recovered.
 *
-* The channel payload is a bare array of these entries, one per remembered
+* The Topic payload is a bare array of these entries, one per remembered
 * centre that is currently off the roster, keyed by
 * `UnreachableCentreEntry.id`. A centre that comes back leaves this channel
 * and rejoins the roster, and a centre that has not been on the roster since
@@ -1445,9 +1452,11 @@ export interface CommcastMessageSendArgs {
     author: CommcastAuthor;
 }
 /**
-* What `commcast.message.send` did with a message: who it left for, and who it
-* could not leave for. It says nothing of arrival, which only each listener's
-* acknowledgement does.
+* What `commcast.message.send`, the command that says a text message to a
+* group (its args are `CommcastMessageSendArgs`), did with a message: which
+* command centres it left for, and which it could not leave for. A centre is a
+* `commandCentre.roster` entry, a place commands are sent from. It says
+* nothing of arrival, which only each listener's acknowledgement does.
 *
 * @category Command results
 * @categoryDescription Command results
@@ -1456,14 +1465,15 @@ export interface CommcastMessageSendArgs {
 */
 export interface CommcastSendReceipt {
     /**
-    * Every centre the message left for, the speaker's own included, in ordinal id
-    * order. The same list its listeners read as the message's `to`.
+    * Every centre the message left for, the speaker's own included, sorted by id.
+    * The same list its listeners read as the message's `to`.
     */
     addressed: string[];
     /**
     * Every member it was meant for that no signal from the speaker could reach
-    * when it was said, in ordinal id order. The message never left for these, so
-    * no wait will bring an acknowledgement from them.
+    * when it was said, sorted by id. The message was never sent to these centres,
+    * so none of them will ever acknowledge it; to reach them, send it again later
+    * naming them in `to`.
     */
     unreached: string[];
 }
@@ -1709,8 +1719,9 @@ export interface CommsConnectivity {
 * The `comms.signal` payload: the active vessel's own reading of its link,
 * from the elected comms backend. A strength from 0 to 1 whose meaning depends
 * on the backend: stock CommNet reports a coarse fraction of the link's range,
-* RealAntennas how much headroom the link has over its data rate. Nothing on
-* the wire says which, so compare values only within one install.
+* RealAntennas how much headroom the link has over its data rate.
+* `CommsSignal.quantity` says which, so a reader names the figure correctly
+* and never compares two that are different quantities.
 *
 * Each command centre is sent its own, the newest reading to have reached it.
 * A reading is of the vessel's whole path at one instant, so it reaches a
@@ -1736,6 +1747,13 @@ export interface CommsSignal {
     */
     strength: Value<"ratio">;
     /**
+    * Which quantity `CommsSignal.strength` is: a fraction of the link's range, a
+    * fraction of its data-rate headroom, or a stand-in where no link is modelled.
+    * A strength worked out for a path carries the quantity its hops were stated
+    * in, and `SignalQuantity.Unknown` where they disagree.
+    */
+    quantity: SignalQuantity;
+    /**
     * Whether `CommsSignal.strength` is worked out and not measured. A command
     * centre is sent the strength of the path it believes in. Where the active
     * vessel's radio last reported on that very path, the reported strength is
@@ -1767,6 +1785,35 @@ export interface CommsSignal {
     measuredPath?: CommsMeasuredPath | null;
 }
 /**
+* Which quantity a signal strength from 0 to 1 is. Two backends that both
+* report "0 to 1" are not saying the same thing, and a figure is only
+* comparable with another of the same quantity.
+*
+* @category Comms
+*/
+export declare enum SignalQuantity {
+    /**
+    * Nothing says which: the hops of a worked-out path disagree, or a read
+    * failed.
+    */
+    Unknown = 0,
+    /**
+    * How far inside its range the link is, 0 at the edge of range and 1 at no
+    * distance: stock CommNet's.
+    */
+    RangeFraction = 1,
+    /**
+    * How much headroom the link has over its data rate, 0 where the lowest rate
+    * fails and 1 at the top of the ladder: RealAntennas'.
+    */
+    DataRateHeadroom = 2,
+    /**
+    * A stand-in: the save models no comms network, so there is no link to grade
+    * and the figure is 1.
+    */
+    NoModel = 3
+}
+/**
 * A path a vessel's radio reported a strength on, as the nodes it runs
 * through. It is the path the game had the vessel on when the radio was read,
 * which a command centre may not believe in.
@@ -1898,6 +1945,11 @@ export interface CommsHop {
     */
     strength?: Value<"ratio"> | null;
     /**
+    * Which quantity `CommsHop.strength` is, as the comms backend stated it for
+    * this hop. Null exactly when `CommsHop.strength` is.
+    */
+    quantity?: SignalQuantity | null;
+    /**
     * The provider-namespaced extension bag: how the elected comms backend carries
     * per-hop facts this shared shape does not declare (see
     * ProviderExtensionBagAttribute for the whole mechanism). A RealAntennas
@@ -1917,20 +1969,25 @@ export interface CommsHop {
     extensions?: ProviderExtensions;
 }
 /**
-* The `comms.path` payload: the active vessel's path as the receiving command
-* centre believes it to stand now. Ordered hops from the active vessel to the
+* The `comms.path` payload: the route the active vessel's samples take to the
+* receiving command centre. Ordered hops from the active vessel to the
 * receiving centre itself, or, for the home centre, to whichever ground
 * station the signal reaches first. An empty `CommsPath.hops` means the centre
 * knows of no path that is open all the way now, which includes a path that
 * would have the signal wait at a relay (`comms.route` says where it would
 * wait).
 *
-* Each command centre is sent its own, and no other centre's. It is worked out
-* from that centre's contact plan, which is made of what the centre has heard
-* of each craft, so a hop changes here only once the news of it has reached
-* the centre: a relay that drops out is still on the path until its silence
-* has crossed to you. Nothing is sent until the centre has a contact plan, so
-* the topic is absent, not empty, for the first moments of a session.
+* Each command centre is sent its own, and no other centre's. Where the game
+* routes the vessel's samples to the centre (at home, the vessel's own path to
+* the ground), the hops are that route, the one `comms.delay` and the arrival
+* of every sample are timed over. Where the game states no route, they are
+* worked out from that centre's contact plan, which is made of what the centre
+* has heard of each craft, so a hop changes here only once the news of it has
+* reached the centre: a relay that drops out is still on the path until its
+* silence has crossed to you. Predictions (`comms.route`, held commands,
+* cancel deadlines) are always the plan's. Nothing is sent until the centre
+* has a contact plan or a game route, so the topic is absent, not empty, for
+* the first moments of a session.
 *
 * Not reckonable: a route changes in steps (a relay drops below the horizon
 * and the whole chain re-solves to different hops), and every reckoning basis
@@ -2056,13 +2113,14 @@ export declare enum CommsDelaySource {
 * `connected:true`.
 *
 * Each command centre is sent its own, and no other centre's. It is the
-* light-time of the active vessel's path as the receiving centre believes it
-* to stand, which is the path that centre is sent on `comms.path`, so the two
-* always agree. The path is worked out from what the centre has heard of each
-* craft, so the figure moves only once the news that moves it has reached the
-* centre: a relay that drops out goes on counting towards the delay until its
-* silence has crossed to you. A zero that is a setting (delay switched off, or
-* a save with no comms network) is sent at once.
+* light-time of the active vessel's path that centre is sent on `comms.path`,
+* so the two always agree. Where the game routes the vessel's samples to the
+* centre (at home, the vessel's own path to the ground), that path is the
+* game's route and this is the delay the samples arrive by. Wherever the game
+* states no route, it is the path the centre's own plan has, worked out from
+* what the centre has heard of each craft, so the figure moves only once the
+* news that moves it has reached the centre. A zero that is a setting (delay
+* switched off, or a save with no comms network) is sent at once.
 *
 * @category Comms
 */
@@ -2207,6 +2265,14 @@ export interface CommsContactPair {
     */
     windows: CommsContactWindow[];
     /**
+    * The stretches in which either end could turn an idle dish to the other and
+    * carry a message, in time order: the dish has no contact on its own aim then,
+    * the turned dish would close the link, and the other end could already
+    * receive. A message held at the turning node may use one; nothing else does.
+    * Empty when no dish would be turned or the backend turns none.
+    */
+    retargetWindows: CommsRetargetWindow[];
+    /**
     * True while either end was last heard of with its orbit still changing. It is
     * reckoned on the orbit it reported mid-burn, which it has since left, so
     * these windows are a rough guide until its next report.
@@ -2223,6 +2289,35 @@ export interface CommsContactWindow {
     openUt?: Value<"ut"> | null;
     /** When contact ends, or `null` when it is still open at the pair's horizon. */
     closeUt?: Value<"ut"> | null;
+    /**
+    * The dish on the pair's `CommsContactPair.a` end that carries this stretch of
+    * contact, as `"<nodeId>#<partPersistentId>/<ordinal>"`, or absent when that
+    * end has no steered dish on it.
+    */
+    fromDish?: string;
+    /**
+    * The dish on the pair's `CommsContactPair.b` end that carries this stretch,
+    * or absent.
+    */
+    toDish?: string;
+}
+/**
+* A stretch in which a node could turn an idle dish to a peer to carry a
+* message.
+*
+* @category Comms
+*/
+export interface CommsRetargetWindow {
+    /** The node that would turn, in the `commandCentre.roster` vocabulary. */
+    node: string;
+    /** The dish it would turn, as `"<nodeId>#<partPersistentId>/<ordinal>"`. */
+    dish: string;
+    /** The node it would turn the dish to. */
+    peer: string;
+    /** When the turn may start. */
+    openUt: Value<"ut">;
+    /** When the turned dish must be back on its own aim. */
+    closeUt: Value<"ut">;
 }
 /**
 * The `comms.degrade` payload: how degraded the active vessel's link home is
@@ -2437,7 +2532,13 @@ export interface UplinkResendRequest {
     laneSeq: Value<"count">;
 }
 /**
-* What a cancel or a send again did at this centre.
+* The reply to `system.uplink.cancel` (`UplinkCancelRequest`, stop a delayed
+* command still on its way to the craft) and to `system.uplink.resend`
+* (`UplinkResendRequest`, send a held or overdue command again). It reports
+* what the command centre that asked did, not what happened at the craft; that
+* arrives later as `comms.journey` reports (`CommsJourneyEvent`). A lane is
+* the ordered run of delayed commands one centre sends to one craft, and a
+* lane number is a command's place in it (`PendingUplink.laneSeq`).
 *
 * @category Command results
 */
@@ -2697,7 +2798,8 @@ export interface ControlFrameOption {
     targetFrameSelected?: boolean | null;
 }
 /**
-* `system.frame.set`'s args: the frame to put the view in.
+* Put the view in a different reference frame. `system.frame.set`'s args: the
+* frame to put the view in.
 *
 * It names the two head bodies, not the sets: where `ControlFrame` reports
 * `PrimaryBodies` and `SecondaryBodies`, the mod that owns the view works out
@@ -2860,6 +2962,21 @@ export interface CrashFlightStats {
     liftOff: boolean;
 }
 /**
+* The payload for the `crash.hasRecent` channel: one flag saying a notable
+* crash is on record for the current save, published beside `CrashReport` on
+* `crash.lastCrash`. It is true from the first crash a flight records and is
+* not published before one.
+*
+* @category Flights
+*/
+export interface CrashRecent {
+    /**
+    * True when a notable crash is on record, so `crash.lastCrash` has a report to
+    * read.
+    */
+    recent: boolean;
+}
+/**
 * What a kerbal's place on the books is, as the dashboard means it: this
 * contract's own vocabulary, not a mirror of any game enum.
 *
@@ -3110,6 +3227,27 @@ export interface CommandRequest<Args> {
     sentAt: number;
 }
 /**
+* Several commands the client sends as one message: they travel together,
+* arrive whole or not at all, are refused together, and run in order within a
+* single physics tick. Each member is an ordinary `CommandRequest` with its
+* own `requestId`, and each is answered under that id as if it had been sent
+* alone.
+*
+* Every member must be a delayed command addressed to the same craft and sent
+* from the same command centre. A group that breaks either rule, or is empty,
+* is refused whole. If any member is refused for any reason, none is sent.
+*
+* @category Stream messages
+*/
+export interface CommandGroupRequest {
+    /** The frame type, always `"command-group"`. */
+    type: "command-group";
+    /** An id the client chooses for the group as a whole. */
+    groupId: string;
+    /** The commands, in the order they run. */
+    members: CommandRequest<unknown>[];
+}
+/**
 * The server's reply to a `CommandRequest`, matched to it by
 * `CommandResponse.requestId`.
 *
@@ -3643,8 +3781,10 @@ export interface FleetSilenceEntry {
     predictionGraceSeconds?: Value<"s"> | null;
 }
 /**
-* The fleet-wide silence roster on `fleet.silence`: every vessel the tracker
-* holds a reckoning for, in one payload.
+* The fleet-wide silence roster on `fleet.silence`: every vessel still in the
+* game that the tracker holds a reckoning for, in one payload. A vessel that
+* has been destroyed leaves the roster; its last `silence.<guid>.state` says
+* it was lost as `destroyed`.
 *
 * A per-vessel topic can only be read by something that already knows which
 * vessel to ask for. This one static topic lists every vessel, so a consumer
@@ -3661,8 +3801,8 @@ export interface FleetSilenceEntry {
 */
 export interface FleetSilence {
     /**
-    * One entry per vessel the tracker holds a reckoning for, in no guaranteed
-    * order. Never null; empty when there are none.
+    * One entry per vessel still in the game, in no guaranteed order. Never null;
+    * empty when there are none.
     */
     vessels: FleetSilenceEntry[];
 }
@@ -3692,7 +3832,7 @@ export declare enum FlightEndReason {
     Destroyed = 3
 }
 /**
-* The `flight.current` channel payload: a UT-indexed value, delivered
+* The `flight.current` Topic payload: a UT-indexed value, delivered
 * latest-wins and delayed like every `vessel.*` channel. It says which flight
 * is active and what phase it is in, for the vessel gonogo is reporting as
 * active. That is the vessel the game is flying, with one exception: a kerbal
@@ -3729,9 +3869,9 @@ export interface FlightCurrent {
     phase: Situation;
 }
 /**
-* The `flight.started` channel payload: a reliable, ordered, delayed event
-* sent when a new flight begins. A flight is new when its vessel id has not
-* been started before in this game session (a launch, or a first switch onto a
+* The `flight.started` Topic payload: a reliable, ordered, delayed event sent
+* when a new flight begins. A flight is new when its vessel id has not been
+* started before in this game session (a launch, or a first switch onto a
 * vessel), and every vessel active just after a revert or a quickload starts a
 * new flight, even one with the same id.
 *
@@ -3760,7 +3900,7 @@ export interface FlightStarted {
     ut: Value<"ut">;
 }
 /**
-* The `flight.ended` channel payload: a reliable, ordered, delayed event sent
+* The `flight.ended` Topic payload: a reliable, ordered, delayed event sent
 * once per flight when it stops being trackable: recovered, crashed, destroyed
 * or reverted. It shares the delay class of `crash.lastCrash` and
 * `recovery.lastSummary`, so an end that a rewind discards before its
@@ -3792,13 +3932,13 @@ export interface FlightEnded {
     ut: Value<"ut">;
 }
 /**
-* The `flight.vesselChanged` channel payload: a reliable, ordered, delayed
-* event sent whenever the active vessel changes after the first observation of
-* the session (docking, undocking, a tracking-station reselect). Switching
-* away from a vessel that is still flying does not end its flight, and
-* switching back to a known one does not start a new one. Switching onto a
-* vessel for the first time also sends `FlightStarted`. Going on EVA does not
-* change the active vessel (see `FlightCurrent`).
+* The `flight.vesselChanged` Topic payload: a reliable, ordered, delayed event
+* sent whenever the active vessel changes after the first observation of the
+* session (docking, undocking, a tracking-station reselect). Switching away
+* from a vessel that is still flying does not end its flight, and switching
+* back to a known one does not start a new one. Switching onto a vessel for
+* the first time also sends `FlightStarted`. Going on EVA does not change the
+* active vessel (see `FlightCurrent`).
 *
 * @category Flights
 */
@@ -3818,10 +3958,11 @@ export interface FlightVesselChanged {
     ut: Value<"ut">;
 }
 /**
-* `ksp.revertToEditor`'s args, which editor the flight reverts back into.
-* `RevertToEditorArgs.editor` is a small opaque string (`"vab"` or `"sph"`,
-* case-insensitive) rather than the KSP `EditorFacility` enum; an unrecognised
-* value fails with `CommandErrorCode.Range` before the game is ever touched.
+* Revert the flight back into the VAB or SPH. `ksp.revertToEditor`'s args,
+* which editor the flight reverts back into. `RevertToEditorArgs.editor` is a
+* small opaque string (`"vab"` or `"sph"`, case-insensitive) rather than the
+* KSP `EditorFacility` enum; an unrecognised value fails with
+* `CommandErrorCode.Range` before the game is ever touched.
 *
 * `ksp.revertToLaunch`, `ksp.toTrackingStation`, `ksp.toSpaceCenter` and
 * `ksp.recover` take no args (they operate on the current flight / active
@@ -3837,9 +3978,10 @@ export interface RevertToEditorArgs {
     editor: string;
 }
 /**
-* `ksp.switchVessel`'s args: the stable vessel id (`vessel.id.ToString()`, the
-* same id `SetTargetArgs.vesselId` uses), never a roster array index. An empty
-* id fails with `CommandErrorCode.NotFound` before the game is ever touched.
+* Switch the flight to another tracked vessel. `ksp.switchVessel`'s args: the
+* stable vessel id (`vessel.id.ToString()`, the same id
+* `SetTargetArgs.vesselId` uses), never a roster array index. An empty id
+* fails with `CommandErrorCode.NotFound` before the game is ever touched.
 * Works from the flight scene, where it changes the active vessel, and from
 * the Space Center and the Tracking Station, where it saves and then loads the
 * vessel's flight. Refused with `CommandErrorCode.WrongScene` from the editors
@@ -3913,6 +4055,7 @@ export interface SetFlyByWireArgs {
     enabled: boolean;
 }
 /**
+* Drive the held control axes of the fly-by-wire override.
 * `vessel.control.setAxes`'s args: a partial update of the held fly-by-wire
 * override. Every field is nullable, and only the fields you set change their
 * held value, so one axis can be driven on its own without disturbing the
@@ -3962,8 +4105,8 @@ export interface SetControlAxesArgs {
     rollTrim?: number;
 }
 /**
-* The `game.dlc` channel payload: which KSP expansions ("DLC") are installed.
-* A fact about the install, independent of scene, so a widget can tell "the
+* The `game.dlc` Topic payload: which KSP expansions ("DLC") are installed. A
+* fact about the install, independent of scene, so a widget can tell "the
 * player has no DLC" from "the DLC is present but nothing is deployed yet"
 * (deployed science, for instance, needs Breaking Ground).
 *
@@ -3977,8 +4120,8 @@ export interface SetControlAxesArgs {
 */
 export interface GameDlc {
     /**
-    * Whether the Breaking Ground expansion ("Serenity") is installed: deployed
-    * science, robotics and surface features.
+    * Whether the Breaking Ground expansion is installed: deployed science,
+    * robotics and surface features.
     */
     breakingGround: boolean;
     /**
@@ -4483,8 +4626,8 @@ export interface OrbitPayloadMeta {
     quality: Quality;
 }
 /**
-* Where one Making History mission objective stands, defined by this contract
-* rather than by KSP.
+* Where one Making History mission objective stands. Gonogo works this out
+* from the mission's progress: KSP itself keeps no per-objective state.
 *
 * On the wire it is an integer ordinal.
 *
@@ -4494,8 +4637,8 @@ export declare enum MissionObjectiveState {
     /** The mission has not reached this objective yet. */
     Pending = 0,
     /**
-    * The mission is on this objective now: it is the mission's active node and
-    * the mission is still running.
+    * The mission is on this objective now: it is the step the mission is on now
+    * and the mission is still running.
     */
     Active = 1,
     /**
@@ -4525,11 +4668,11 @@ export interface MissionObjectiveEntry {
     state?: MissionObjectiveState | null;
 }
 /**
-* The `missions.active` channel payload: the Making History mission that is
+* The `missions.active` Topic payload: the Making History mission that is
 * running, or has just ended, in the current game. The whole payload is `null`
 * when there is no mission game, when no mission has been set up, or when the
-* expansion is not installed; read `game.dlc` to tell the last from the
-* others.
+* expansion is not installed; read the `game.dlc` Topic (`GameDlc`) to tell
+* the last from the others.
 *
 * A mission that has ended stays in the payload with `MissionStatus.finished`
 * true until the game leaves the mission, so a client can show the outcome.
@@ -4571,11 +4714,11 @@ export interface MissionStatus {
     * The mission's objectives in flow order. A node of the mission that nothing
     * leads to is left out. Empty when it has none.
     */
-    objectives?: MissionObjectiveEntry[] | null;
+    objectives: MissionObjectiveEntry[];
 }
 /**
-* The `settings.<uplink>` channel payload: one Uplink's host mod's own
-* settings, as the Uplink read them.
+* The `settings.<uplink>` Topic payload: one Uplink's host mod's own settings,
+* as the Uplink read them.
 *
 * **One topic per Uplink**, declared only for an Uplink that implements
 * IModSettingsSource; its entry on `system.uplinks` says so with
@@ -4599,7 +4742,11 @@ export interface ModSettingsModel {
     * `ModSettingsModel.settings` is then empty.
     */
     failure?: string | null;
-    /** The game install's own configuration, about no vessel. */
+    /**
+    * The payload's provenance. Its `source` is always `"game"`: these settings
+    * describe the game install, never a craft, and like the rest of this Topic
+    * they are always current and never delayed.
+    */
     meta: PayloadMeta;
 }
 /**
@@ -4660,10 +4807,11 @@ export interface WriteModSettingArgs {
     value: string;
 }
 /**
-* The empty args shape, for the core commands that operate on the current
-* flight or the active vessel and so take nothing: `vessel.control.stage`,
-* `vessel.target.clear`, `ksp.recover`, `ksp.revertToLaunch`,
-* `ksp.toTrackingStation` and `ksp.toSpaceCenter`.
+* Take no args: stage, clear the target, recover, revert to launch, or go to
+* the Tracking Station or Space Center. The empty args shape, for the core
+* commands that operate on the current flight or the active vessel and so take
+* nothing: `vessel.control.stage`, `vessel.target.clear`, `ksp.recover`,
+* `ksp.revertToLaunch`, `ksp.toTrackingStation` and `ksp.toSpaceCenter`.
 *
 * **Send no `args` at all for these six.** The SDK's `send()` takes no second
 * argument for a command typed this way, and anything you do put on the wire
@@ -4692,9 +4840,11 @@ export interface NoCommandArgs {
 * (`VesselOrbit.referenceBodyIndex` among them). `OrbitPatch.referenceBody`
 * and `OrbitPatch.closestEncounterBody` are the body's name, for display.
 *
-* Every element is a plain, non-nullable double, unlike `VesselOrbit.lan` and
-* `VesselOrbit.argPe`: a patch missing any element needed to propagate it is
-* not sent at all, rather than sent with a stand-in.
+* `OrbitPatch.lan`, `OrbitPatch.argPe` and `OrbitPatch.meanAnomalyAtEpoch` are
+* null when KSP's value for them is undefined, as `VesselOrbit.lan` and
+* `VesselOrbit.argPe` are, and the patch is still sent. A patch with a null
+* element cannot be propagated, so a reader that propagates one declines to
+* rather than substituting a value.
 *
 * @category Orbits and trajectories
 */
@@ -4706,20 +4856,20 @@ export interface OrbitPatch {
     /** Inclination in degrees, KSP's `Orbit.inclination`. */
     inc: Value<"°">;
     /**
-    * Longitude of the ascending node in degrees, KSP's `Orbit.LAN`. `0` when
+    * Longitude of the ascending node in degrees, KSP's `Orbit.LAN`. Null when
     * KSP's value is undefined (NaN).
     */
-    lan: Value<"°">;
+    lan?: Value<"°"> | null;
     /**
-    * Argument of periapsis in degrees, KSP's `Orbit.argumentOfPeriapsis`. `0`
+    * Argument of periapsis in degrees, KSP's `Orbit.argumentOfPeriapsis`. Null
     * when KSP's value is undefined (NaN).
     */
-    argPe: Value<"°">;
+    argPe?: Value<"°"> | null;
     /**
     * Mean anomaly at `OrbitPatch.epoch` in radians, KSP's
-    * `Orbit.meanAnomalyAtEpoch`. `0` when KSP's value is undefined (NaN).
+    * `Orbit.meanAnomalyAtEpoch`. Null when KSP's value is undefined (NaN).
     */
-    meanAnomalyAtEpoch: Value<"rad">;
+    meanAnomalyAtEpoch?: Value<"rad"> | null;
     /**
     * The universal time at which `OrbitPatch.meanAnomalyAtEpoch` holds, KSP's
     * `Orbit.epoch`.
@@ -4942,154 +5092,24 @@ export interface PartActions {
     meta: PayloadMeta;
 }
 /**
-* One deployable solar panel module in the `parts.power` payload's
-* `solarPanels` array. A part with several panel modules contributes one entry
-* per module. Every field is `null` when its value could not be read, never a
-* sentinel.
-*
-* @category Parts
-*/
-export interface SolarPanelEntry {
-    /**
-    * The part's display title (KSP's `Part.partInfo.title`), or its internal name
-    * when it has no part info.
-    */
-    partName?: string | null;
-    /**
-    * The part's `Part.flightID` as a string: unique per part for the life of the
-    * flight, so it tells apart symmetric parts that share a name. Null when the
-    * part has no flight id yet.
-    */
-    partId?: string | null;
-    /**
-    * The panel's deploy state, KSP's `ModuleDeployablePart.DeployState` name
-    * as-is: `"RETRACTED"`, `"EXTENDING"`, `"EXTENDED"`, `"RETRACTING"` or
-    * `"BROKEN"`.
-    */
-    deployState?: string | null;
-    /**
-    * The panel's current electric-charge output (KSP's `flowRate`), in EC per
-    * second. This is what counts toward `PartsPower.totalProductionEc`.
-    */
-    flowRate?: Value<"units/s"> | null;
-    /**
-    * The panel's rated charge rate from its part configuration (KSP's
-    * `chargeRate`), in EC per second, before sun exposure and distance are
-    * applied.
-    */
-    chargeRate?: Value<"units/s"> | null;
-    /**
-    * KSP's `ModuleDeployableSolarPanel.sunAOA`: despite the name and the declared
-    * unit, a sun-exposure factor from 0 (no sunlight on the panel) to 1 (facing
-    * the sun squarely), not an angle.
-    */
-    sunAOA?: Value<"°"> | null;
-}
-/**
-* One electric-charge store in the `parts.power` payload's `batteries` array:
-* every part with an `ElectricCharge` capacity above zero, so command pods and
-* probe cores appear here as well as batteries. Every field is `null` when its
-* value could not be read.
-*
-* @category Parts
-*/
-export interface BatteryEntry {
-    /**
-    * The part's display title (KSP's `Part.partInfo.title`), or its internal name
-    * when it has no part info.
-    */
-    partName?: string | null;
-    /**
-    * The part's `Part.flightID` as a string, the same join key as
-    * `SolarPanelEntry.partId`. Null when the part has no flight id yet.
-    */
-    partId?: string | null;
-    /** Electric charge currently held in this part, in EC. */
-    current?: Value<"units"> | null;
-    /** This part's electric-charge capacity, in EC. */
-    max?: Value<"units"> | null;
-}
-/**
-* One electric-charge-producing converter in the `parts.power` payload's
-* `fuelCells` array: every `ModuleResourceConverter` whose outputs include
-* `ElectricCharge`, one entry per module. Every field is `null` when its value
-* could not be read.
-*
-* @category Parts
-*/
-export interface FuelCellEntry {
-    /**
-    * The part's display title (KSP's `Part.partInfo.title`), or its internal name
-    * when it has no part info.
-    */
-    partName?: string | null;
-    /**
-    * The part's `Part.flightID` as a string, the same join key as
-    * `SolarPanelEntry.partId`. Null when the part has no flight id yet.
-    */
-    partId?: string | null;
-    /** True when the converter is switched on (KSP's `IsActivated`). */
-    active?: boolean | null;
-    /**
-    * The converter's own status text as KSP displays it
-    * (`ModuleResourceConverter.status`). Free text, not a fixed vocabulary.
-    */
-    status?: string | null;
-}
-/**
-* One engine alternator module in the `parts.power` payload's `alternators`
-* array. Every field is `null` when its value could not be read.
-*
-* @category Parts
-*/
-export interface AlternatorEntry {
-    /**
-    * The part's display title (KSP's `Part.partInfo.title`), or its internal name
-    * when it has no part info.
-    */
-    partName?: string | null;
-    /**
-    * The part's `Part.flightID` as a string, the same join key as
-    * `SolarPanelEntry.partId`. Null when the part has no flight id yet.
-    */
-    partId?: string | null;
-    /**
-    * The alternator's current electric-charge output (KSP's
-    * `ModuleAlternator.outputRate`), in EC per second.
-    */
-    outputRate?: Value<"units/s"> | null;
-}
-/**
-* The `parts.power` channel payload: the active vessel's electric-charge
-* production surface (solar panels, batteries, fuel cells, engine alternators,
-* and a rolled-up production total). A single object, or `null` when there is
-* no active vessel or it carries none of the four kinds of part.
-*
-* When the payload is present all four arrays are present too, each possibly
-* empty; they are typed nullable so a client stays safe if one is ever
-* missing.
+* The `parts.power` Topic payload: the active vessel's rolled-up
+* electric-charge production. A single object, or `null` when there is no
+* active vessel or it carries no solar panel, battery, electric-charge
+* converter or alternator. The parts themselves are itemised on
+* `vessel.parts`.
 *
 * @category Parts
 */
 export interface PartsPower {
-    /** Every deployable solar panel module on the vessel. */
-    solarPanels?: SolarPanelEntry[] | null;
-    /** Every part that stores electric charge. */
-    batteries?: BatteryEntry[] | null;
-    /** Every converter module that produces electric charge. */
-    fuelCells?: FuelCellEntry[] | null;
-    /** Every engine alternator module on the vessel. */
-    alternators?: AlternatorEntry[] | null;
     /**
     * Total electric-charge production in EC per second: the sum of every solar
-    * panel's `SolarPanelEntry.flowRate` and every alternator's
-    * `AlternatorEntry.outputRate`. Fuel cells are not included. Null when no
-    * finite total could be read.
+    * panel's live flow rate and every alternator's live output rate. Fuel cells
+    * are not included. Null when no finite total could be read.
     */
     totalProductionEc?: Value<"units/s"> | null;
 }
 /**
-* One entry in the `robotics.servos` channel payload, a single Breaking Ground
+* One entry in the `robotics.servos` Topic payload, a single Breaking Ground
 * robotic servo on the active vessel. The payload is a bare array of these, or
 * `null` when there is no active vessel or it carries no servo; read
 * `robotics.available` to tell those two apart.
@@ -5190,7 +5210,7 @@ export interface ServoEntry {
     maxTorque?: Value<"kN"> | null;
 }
 /**
-* The `robotics.available` channel payload: a single object (or `null` when
+* The `robotics.available` Topic payload: a single object (or `null` when
 * there is no active vessel) whose one field states whether the active vessel
 * carries any Breaking Ground robotic servo. It is its own Topic because the
 * `robotics.servos` array is `null` both when the vessel has no robotic parts
@@ -5227,6 +5247,11 @@ export interface RoboticsAvailability {
 * unknown type publishes nothing. The four breakdown lists can be empty while
 * the totals are present, if KSP's dialog could not be read for them.
 *
+* A figure the save cannot award is `null`, never 0: funds and science are
+* null in a Sandbox save (and funds in a Science save). A Sandbox recovery
+* still produces a record, with the craft, where it came down, its parts and
+* its crew, and nothing awarded.
+*
 * @category Flights
 */
 export interface RecoveryReport {
@@ -5244,23 +5269,27 @@ export interface RecoveryReport {
     * multiplier for landing precision.
     */
     recoveryFactor: string;
-    /** Science this recovery earned, as KSP's recovery dialog totals it. */
-    scienceEarned: Value<"science">;
     /**
-    * The career's science balance as the recovery dialog reports it. 0 in a save
-    * with no science (Sandbox).
+    * Science this recovery earned, as KSP's recovery dialog totals it. Null in a
+    * save with no science (Sandbox).
+    */
+    scienceEarned?: Value<"science"> | null;
+    /**
+    * The career's science balance as the recovery dialog reports it. Null in a
+    * save with no science (Sandbox).
     */
-    totalScience: Value<"science">;
+    totalScience?: Value<"science"> | null;
     /**
     * Funds this recovery earned, after the recovery factor and any strategy
-    * modifiers KSP applies to a recovery.
+    * modifiers KSP applies to a recovery. Null in a save with no funds (Science
+    * or Sandbox).
     */
-    fundsEarned: Value<"funds">;
+    fundsEarned?: Value<"funds"> | null;
     /**
-    * The career's funds balance as the recovery dialog reports it. 0 in a save
+    * The career's funds balance as the recovery dialog reports it. Null in a save
     * with no funds (Science or Sandbox).
     */
-    totalFunds: Value<"funds">;
+    totalFunds?: Value<"funds"> | null;
     /**
     * Reputation this recovery earned, after any strategy modifiers KSP applies.
     * Show it only when `RecoveryReport.displayReputation` is true.
@@ -5328,19 +5357,22 @@ export interface RecoveryPartEntry {
     partTitle: string;
     /** How many parts are in this group. At least 1. */
     count: Value<"count">;
-    /** The recovered dry value of one part in the group, excluding its resources. */
-    partValue: Value<"funds">;
+    /**
+    * The recovered dry value of one part in the group, excluding its resources.
+    * Null in a save with no funds.
+    */
+    partValue?: Value<"funds"> | null;
     /**
     * The recovered value of the resources the group's parts held, summed over the
-    * group.
+    * group. Null in a save with no funds.
     */
-    resourcesValue: Value<"funds">;
+    resourcesValue?: Value<"funds"> | null;
     /**
     * The group's recovered dry value: `RecoveryPartEntry.partValue` times
     * `RecoveryPartEntry.count`. Does not include
-    * `RecoveryPartEntry.resourcesValue`.
+    * `RecoveryPartEntry.resourcesValue`. Null in a save with no funds.
     */
-    totalValue: Value<"funds">;
+    totalValue?: Value<"funds"> | null;
 }
 /**
 * One recovered-resource group: an entry of
@@ -5377,17 +5409,35 @@ export interface RecoveryCrewEntry {
     trait: string;
     /** Whether the kerbal is a tourist, who earns no experience. */
     isTourist: boolean;
-    /** Experience points this flight added. */
-    xpGained: Value<"count">;
+    /**
+    * Experience points this flight added. Null in a save that awards no
+    * experience (Sandbox).
+    */
+    xpGained?: Value<"count"> | null;
     /**
     * How many experience levels this flight added: `RecoveryCrewEntry.newLevel`
-    * minus the level before.
+    * minus the level before. Null in a save that awards no experience (Sandbox).
     */
-    levelsGained: Value<"count">;
+    levelsGained?: Value<"count"> | null;
     /** The kerbal's experience level after this flight, 0 to 5 in stock. */
     newLevel: Value<"count">;
 }
 /**
+* The payload for the `recovery.hasRecent` channel: one flag saying a vessel
+* recovery is on record for the current save, published beside
+* `RecoveryReport` on `recovery.lastSummary`. It is true from the first
+* recovery of a real craft and is not published before one.
+*
+* @category Flights
+*/
+export interface RecoveryRecent {
+    /**
+    * True when a recovery is on record, so `recovery.lastSummary` has a summary
+    * to read.
+    */
+    recent: boolean;
+}
+/**
 * The `ksp.revertAvailability` Topic payload: whether the two stock in-flight
 * revert actions are available right now, so a widget can enable its Revert to
 * Launch and Revert to Editor controls exactly when KSP's own pause menu shows
@@ -5416,28 +5466,47 @@ export interface RevertAvailability {
     canRevertToLaunch: boolean;
 }
 /**
-* Args for `robotics.servo.setTarget`: the absolute angle (hinge) or extension
-* (piston) to drive to, keyed by the part's `ServoSetTargetArgs.partId`.
-* `ServoSetTargetArgs.partId` is the same `flightID` string `parts.robotics`
+* Drive a hinge or rotation servo to an angle. Args for
+* `robotics.servo.setAngle`: the absolute angle a hinge or rotation servo is
+* to drive to, keyed by the part's `ServoSetAngleArgs.partId`.
+* `ServoSetAngleArgs.partId` is the same `flightID` string `parts.robotics`
 * publishes on each servo entry, so a widget sends back the exact id it
-* displays. A rotor has no target (it spins continuously); a `setTarget` aimed
-* at one fails with `CommandResult.errorCode`
-* `CommandErrorCode.ModeUnavailable`.
+* displays. A piston has no angle and a rotor no target: a `setAngle` aimed at
+* either fails with `CommandResult.errorCode`
+* `CommandErrorCode.CapabilityMismatch`.
 *
 * @category Command arguments
 */
-export interface ServoSetTargetArgs {
+export interface ServoSetAngleArgs {
     /**
     * The part's `flightID.ToString()`: the id the read side stamps on each
     * `parts.robotics` entry.
     */
     partId: string;
-    /** Absolute target: hinge angle (degrees) or piston extension. */
-    value: number;
+    /** The absolute target angle. */
+    degrees: number;
+}
+/**
+* Drive a piston to an extension. Args for `robotics.servo.setExtension`: the
+* absolute extension a piston is to drive to, keyed by the part's
+* `ServoSetExtensionArgs.partId`. A hinge or rotation servo has no extension
+* and a rotor no target: a `setExtension` aimed at one fails with
+* `CommandResult.errorCode` `CommandErrorCode.CapabilityMismatch`.
+*
+* @category Command arguments
+*/
+export interface ServoSetExtensionArgs {
+    /**
+    * The part's `flightID.ToString()`: the id the read side stamps on each
+    * `parts.robotics` entry.
+    */
+    partId: string;
+    /** The absolute target extension. */
+    metres: number;
 }
 /**
-* Args shared by every robotics boolean actuation
-* (`robotics.servo.setMotor`/`setLock` and
+* Switch a robotics servo or rotor motor or lock on or off. Args shared by
+* every robotics boolean actuation (`robotics.servo.setMotor`/`setLock` and
 * `robotics.rotor.setMotor`/`setLock`): an absolute state to apply, never a
 * toggle, like every other actuation command (see `SetEnabledArgs`). Keyed by
 * `ServoSetEnabledArgs.partId`, the `flightID` string `parts.robotics`
@@ -5460,25 +5529,51 @@ export interface ServoSetEnabledArgs {
     enabled: boolean;
 }
 /**
-* Args for the rotor scalar-limit commands
-* (`robotics.rotor.setRpmLimit`/`setTorqueLimit`/`setBrake`): the absolute
-* value to apply, keyed by `RotorSetValueArgs.partId`. The bounded ones
-* (torque 0 to 100, brake 0 to 200) are range-checked; a value out of range
-* fails with `CommandErrorCode.Range`.
+* Set a rotor's rpm cap. Args for `robotics.rotor.setRpmLimit`: the absolute
+* rpm cap to apply, keyed by `RotorSetRpmLimitArgs.partId`.
 *
 * @category Command arguments
 */
-export interface RotorSetValueArgs {
+export interface RotorSetRpmLimitArgs {
     /**
     * The part's `flightID.ToString()`: the id the read side stamps on each
     * `parts.robotics` entry.
     */
     partId: string;
+    /** The rpm cap to apply, in revolutions per minute. */
+    rpm: number;
+}
+/**
+* Set a rotor's torque limit. Args for `robotics.rotor.setTorqueLimit`: the
+* absolute torque limit to apply, keyed by `RotorSetTorqueLimitArgs.partId`. A
+* value outside 0 to 100 fails with `CommandErrorCode.Range`.
+*
+* @category Command arguments
+*/
+export interface RotorSetTorqueLimitArgs {
     /**
-    * The absolute value to apply: the rpm limit, the torque-limit percent (0 to
-    * 100), or the brake percent (0 to 200).
+    * The part's `flightID.ToString()`: the id the read side stamps on each
+    * `parts.robotics` entry.
     */
-    value: number;
+    partId: string;
+    /** The torque limit as a percentage of the rotor's maximum torque, 0 to 100. */
+    percent: number;
+}
+/**
+* Set a rotor's brake strength. Args for `robotics.rotor.setBrake`: the
+* absolute brake strength to apply, keyed by `RotorSetBrakeArgs.partId`. A
+* value outside 0 to 200 fails with `CommandErrorCode.Range`.
+*
+* @category Command arguments
+*/
+export interface RotorSetBrakeArgs {
+    /**
+    * The part's `flightID.ToString()`: the id the read side stamps on each
+    * `parts.robotics` entry.
+    */
+    partId: string;
+    /** The brake strength as KSP's brake percentage, 0 to 200. */
+    percent: number;
 }
 /**
 * Args for `robotics.rotor.reverse`: flips the rotor's spin direction. It is
@@ -5999,13 +6094,13 @@ export interface ScetAddressableTopic {
     topic: string;
 }
 /**
-* Args shared by every science-experiment actuation command
-* (`science.experiment.deploy` and `science.experiment.transmit`): the
-* experiment is named by `ExperimentActionArgs.partId`, the part's
-* `flightID.ToString()`, the same id `science.instruments` carries on each
-* experiment entry. It is looked up among the active vessel's parts, never by
-* array index. An empty or unknown `ExperimentActionArgs.partId` fails with
-* `CommandErrorCode.NotFound`.
+* Deploy or transmit a science experiment on a part. Args shared by every
+* science-experiment actuation command (`science.experiment.deploy` and
+* `science.experiment.transmit`): the experiment is named by
+* `ExperimentActionArgs.partId`, the part's `flightID.ToString()`, the same id
+* `science.instruments` carries on each experiment entry. It is looked up
+* among the active vessel's parts, never by array index. An empty or unknown
+* `ExperimentActionArgs.partId` fails with `CommandErrorCode.NotFound`.
 *
 * @category Command arguments
 */
@@ -6052,7 +6147,7 @@ export interface ScienceTransmission {
     dataAmount: Value<"Mit">;
 }
 /**
-* One entry in the `science.experiments` channel payload: a single stored
+* One entry in the `science.experiments` Topic payload: a single stored
 * science result on the active vessel, held either by the science module that
 * collected it or by a container part. The channel payload is a bare array of
 * these (`ExperimentEntry[]`) or `null`, never a wrapper object. The whole
@@ -6164,7 +6259,7 @@ export interface ExperimentEntry {
     extensions?: ProviderExtensions;
 }
 /**
-* One entry in the `science.instruments` channel payload: a single
+* One entry in the `science.instruments` Topic payload: a single
 * `ModuleScienceExperiment` on the active vessel, as an inventory and status
 * row keyed by `InstrumentEntry.partId` (the part's KSP `flightID`).
 *
@@ -6175,8 +6270,8 @@ export interface ExperimentEntry {
 * rerunnable, resettable, collectable) an operator needs to decide what to run
 * next.
 *
-* The channel payload is a bare array (`InstrumentEntry[]`) or `null` when
-* there is no active vessel or it carries no experiment module. Every field is
+* The Topic payload is a bare array (`InstrumentEntry[]`) or `null` when there
+* is no active vessel or it carries no experiment module. Every field is
 * nullable, and is `null` whenever the raw value is absent.
 *
 * @category Science
@@ -6243,11 +6338,11 @@ export interface InstrumentEntry {
     extensions?: ProviderExtensions;
 }
 /**
-* One entry in the `science.lab` channel payload: a Mobile Processing Lab
-* (KSP's `ModuleScienceLab`) on the active vessel. The channel payload is a
-* bare array (`LabEntry[]`) or `null` when there is no active vessel or it
-* carries no lab. Every field is nullable, and is `null` whenever the raw
-* value is absent or non-finite.
+* One entry in the `science.lab` Topic payload: a Mobile Processing Lab (KSP's
+* `ModuleScienceLab`) on the active vessel. The channel payload is a bare
+* array (`LabEntry[]`) or `null` when there is no active vessel or it carries
+* no lab. Every field is nullable, and is `null` whenever the raw value is
+* absent or non-finite.
 *
 * @category Science
 */
@@ -6317,10 +6412,10 @@ export interface LabEntry {
     extensions?: ProviderExtensions;
 }
 /**
-* One entry in the `deployed.bases` channel payload: a Breaking Ground
-* deployed-science experiment (`ModuleGroundExperiment`). The channel payload
-* is a bare array (`DeployedEntry[]`) or `null` when no loaded vessel carries
-* a deployed experiment (including an install without Breaking Ground).
+* One entry in the `deployed.bases` Topic payload: a Breaking Ground
+* deployed-science experiment (`ModuleGroundExperiment`). The Topic payload is
+* a bare array (`DeployedEntry[]`) or `null` when no loaded vessel carries a
+* deployed experiment (including an install without Breaking Ground).
 *
 * Unlike the `science.*` channels, `deployed.bases` covers every loaded
 * vessel, not just the active one: a deployed cluster is its own ground
@@ -6469,11 +6564,11 @@ export declare enum DeployedPowerState {
     NotConnected = 4
 }
 /**
-* One entry in the `science.sensors` channel payload: a single
+* One entry in the `science.sensors` Topic payload: a single
 * environmental-sensor module (`ModuleEnviroSensor`: thermometer, barometer,
 * gravioli detector, accelerometer, and any modded sensor sharing the module)
-* on the active vessel. The channel payload is a bare array (`SensorEntry[]`)
-* or `null` when there is no active vessel or it carries no sensor module.
+* on the active vessel. The Topic payload is a bare array (`SensorEntry[]`) or
+* `null` when there is no active vessel or it carries no sensor module.
 *
 * One entry per sensor module, with `SensorEntry.type` carrying the raw
 * `SensorType` enum name (`TEMP`/`PRES`/`GRAV`/`ACC`/...) as a string, so
@@ -6509,18 +6604,17 @@ export interface SensorEntry {
     active?: boolean | null;
 }
 /**
-* One entry in the `science.experimentBreakdown` channel payload: a
-* per-subject rollup of the stored science results that `science.experiments`
-* lists one row per result. One row per distinct subject id: several stored
-* results for the same subject (for example two crew reports from the same
-* biome) collapse into one entry with `ExperimentBreakdownEntry.dataMits`
-* summed across them.
+* One entry in the `science.experimentBreakdown` Topic payload: a per-subject
+* rollup of the stored science results that `science.experiments` lists one
+* row per result. One row per distinct subject id: several stored results for
+* the same subject (for example two crew reports from the same biome) collapse
+* into one entry with `ExperimentBreakdownEntry.dataMits` summed across them.
 *
-* The channel payload is a bare array (`ExperimentBreakdownEntry[]`) or
-* `null`, never a wrapper object. The whole array is `null` when there is no
-* active vessel or the vessel holds no stored science data; there is no
-* separate empty-array state. Every field is nullable, and is `null` whenever
-* the raw value is absent or non-finite.
+* The Topic payload is a bare array (`ExperimentBreakdownEntry[]`) or `null`,
+* never a wrapper object. The whole array is `null` when there is no active
+* vessel or the vessel holds no stored science data; there is no separate
+* empty-array state. Every field is nullable, and is `null` whenever the raw
+* value is absent or non-finite.
 *
 * `ExperimentBreakdownEntry.biome` and `ExperimentBreakdownEntry.situation`
 * are parsed from the subject id by KSP's
@@ -6583,12 +6677,12 @@ export interface ExperimentBreakdownEntry {
     extensions?: ProviderExtensions;
 }
 /**
-* One entry in the `science.archive` channel payload: a single subject out of
+* One entry in the `science.archive` Topic payload: a single subject out of
 * the whole-career R&D archive (`ResearchAndDevelopment.GetSubjects()`). That
 * is every subject the career has ever collected or recovered, across every
 * mission and every body, not scoped to the active vessel.
 *
-* The channel payload is a bare array (`ArchiveEntry[]`), or `null` when the
+* The Topic payload is a bare array (`ArchiveEntry[]`), or `null` when the
 * save has no R&D to walk (Sandbox mode). A save with R&D but nothing
 * collected yet emits an empty array, so an empty array and `null` mean
 * different things here.
@@ -6642,7 +6736,7 @@ export interface ArchiveEntry {
     subjectValue?: Value<"1"> | null;
 }
 /**
-* The `settings.gonogo` channel payload: every setting the mod and its Uplinks
+* The `settings.gonogo` Topic payload: every setting the mod and its Uplinks
 * declared, what each holds now, and whether the settings file on the KSP
 * machine holds the same.
 *
@@ -6650,8 +6744,9 @@ export interface ArchiveEntry {
 * row's own description, so a setting an Uplink adds needs no client code of
 * its own.
 *
-* It is never delayed by light time: a setting configures the system the
-* operator is sitting at, not a craft.
+* It is never delayed by light time, the time a signal takes to cross between
+* a craft and the command centre (the screen an operator sends commands from):
+* a setting configures the system the operator is sitting at, not a craft.
 *
 * This is where a client learns whether a save landed. The `settings.save`
 * command can time out and still land, so read the outcome here, never from
@@ -6662,7 +6757,10 @@ export interface ArchiveEntry {
 * Settings as the stream carries them: Gonogo's own, its Uplinks', and a host
 * mod's own settings read through its Uplink. Each row says what it may hold,
 * what it holds now and whether it can be written, and the model says whether
-* the settings file on the KSP machine agrees.
+* the settings file on the KSP machine agrees. A client reads Gonogo's with
+* `useTelemetry("settings.gonogo")` and a host mod's with
+* `useModSettings(uplinkId)`; a setting that lives only in the browser is
+* declared with `registerSetting` instead.
 */
 export interface SettingsModel {
     /**
@@ -6782,8 +6880,9 @@ export interface SettingsDeclarationFailure {
     reason: string;
 }
 /**
-* Arguments to `settings.save`: one Save press, applied together and written
-* to the settings file once. Never delayed by light time.
+* Apply the settings from one Save press together and write the settings file
+* once. Arguments to `settings.save`: one Save press, applied together and
+* written to the settings file once. Never delayed by light time.
 *
 * Safe to send again. A save sets each row to the value named, so repeating
 * one that already landed changes nothing. That matters because a save that
@@ -6885,7 +6984,7 @@ export interface LaunchSiteEntry {
     padVesselTitle?: string | null;
 }
 /**
-* The `spaceCenter.scene` channel payload: the single current KSP game scene.
+* The `spaceCenter.scene` Topic payload: the single current KSP game scene.
 * `SpaceCenterScene.scene` carries exactly one of the six strings
 * `{"Flight","SpaceCenter","Editor","TrackingStation","MainMenu","Other"}`:
 * KSP's `GameScenes` enum folded onto that fixed set, with any scene outside
@@ -7126,9 +7225,9 @@ export interface SavedShipEntry {
     missingParts?: string[] | null;
 }
 /**
-* The `spaceCenter.partsAvailable` channel payload: a wrapper carrying the
-* count of parts the player can place right now (tech-unlocked and purchased
-* in career; the full `PartLoader` catalogue in sandbox).
+* The `spaceCenter.partsAvailable` Topic payload: a wrapper carrying the count
+* of parts the player can place right now (tech-unlocked and purchased in
+* career; the full `PartLoader` catalogue in sandbox).
 *
 * A wrapper object, because a bare scalar has no Topic shape: read
 * `spaceCenter.partsAvailable.count`. The whole payload is `null` when no
@@ -7144,8 +7243,8 @@ export interface SpaceCenterPartsAvailable {
     count?: Value<"count"> | null;
 }
 /**
-* The `spaceCenter.astronautComplex` channel payload: the Astronaut Complex
-* hire tab, the rolling pool of applicants the operator can recruit, plus the
+* The `spaceCenter.astronautComplex` Topic payload: the Astronaut Complex hire
+* tab, the rolling pool of applicants the operator can recruit, plus the
 * roster-cap context a hire is gated on.
 *
 * A wrapper object, not a bare array, so the applicant list arrives with the
@@ -7320,7 +7419,7 @@ export interface StageDeltaVEntry {
     } | null;
 }
 /**
-* The `dv.summary` channel payload: the whole-vessel ΔV rollup KSP's stock
+* The `dv.summary` Topic payload: the whole-vessel ΔV rollup KSP's stock
 * `VesselDeltaV` exposes alongside the per-stage `StageDeltaVEntry` list: the
 * ΔV-producing stage count plus the vacuum, sea-level and current totals and
 * total burn time. A single object, or `null` when the stock simulation is not
@@ -7349,7 +7448,7 @@ export interface StageDeltaVSummary {
     totalBurnTime?: Value<"s"> | null;
 }
 /**
-* The `system.bodies` channel payload: every celestial body in the game, as a
+* The `system.bodies` Topic payload: every celestial body in the game, as a
 * tree, wrapped as `{ "bodies": [ ... ] }`. The whole payload is `null`, not
 * an empty list, when no sample has been taken yet, so "no data yet" and "zero
 * bodies" stay distinct.
@@ -7594,7 +7693,7 @@ export interface OrbitEntry {
     epoch?: Value<"ut"> | null;
 }
 /**
-* The `system.vessels` channel payload: every vessel the receiving command
+* The `system.vessels` Topic payload: every vessel the receiving command
 * centre knows of, wrapped as `{ "vessels": [ ... ] }`. Like `SystemBodies`,
 * it carries no per-payload `Meta`: that rides the envelope.
 *
@@ -7865,8 +7964,8 @@ export interface TargetListEntry {
     orbitBodyIndex?: number | null;
 }
 /**
-* The `target.available` channel payload: the list of everything targetable
-* from the active vessel, as the active vessel knows it. Wrapper object `{
+* The `target.available` Topic payload: the list of everything targetable from
+* the active vessel, as the active vessel knows it. Wrapper object `{
 * "entries": [ ... ] }`, like `system.vessels`.
 *
 * A vessel is on the list once the active vessel has come to know of it, by
@@ -7896,7 +7995,7 @@ export interface TargetAvailable {
     entries: TargetListEntry[];
 }
 /**
-* The `time.calendar` channel payload: how long a minute, hour, day and year
+* The `time.calendar` Topic payload: how long a minute, hour, day and year
 * are, and what real-world instant UT 0 is (when the game has one), as the
 * running game defines them.
 *
@@ -7959,13 +8058,14 @@ export interface TimeCalendar {
     * deadline can be shown as `14 Mar 1957` rather than `Y3 D122`.
     *
     * It is read from the date formatter itself. Formatters that model a real
-    * calendar (RSSTimeFormatter, Kronometer) hold an anchor date; the stock
-    * formatter holds none.
+    * calendar hold an anchor date: RSS installs RSSTimeFormatter, which does, and
+    * Kronometer can. The stock formatter holds none.
     *
     * `null` is the normal value, and it is not zero. Stock KSP has no real
-    * calendar: its own UI prints Year 1, Day 1, and so should every consumer.
-    * That holds for a planet pack too whenever no date-based formatter is
-    * installed alongside it. Do not render a default anchor for those games.
+    * calendar: its own UI prints Year 1, Day 1, and so should every consumer. A
+    * planet pack that changes the day length without installing a date-based
+    * formatter has no anchor either. Do not render a default anchor for those
+    * games.
     */
     epoch?: string | null;
     /**
@@ -8237,8 +8337,12 @@ export interface PendingUplink {
     */
     attempts: Value<"count">;
     /**
-    * The `PendingUplink.id` of every command sent together with this one, itself
-    * included. Currently always one entry, its own.
+    * The commands this entry stands for. A command sent alone lists its own
+    * `PendingUplink.id`. A group sent with `command-group` is one entry on one
+    * lane number and lists the `requestId` of each member as the client sent it,
+    * in the order they run, with the first also on
+    * `PendingUplink.clientRequestId`; its `PendingUplink.label` joins the
+    * members' labels.
     */
     members: string[];
 }
@@ -8299,9 +8403,9 @@ export interface Vec3 {
     z: number;
 }
 /**
-* The `vessel.attitude` channel payload: pitch, heading and roll of the
-* vessel's control reference (`Vessel.GetTransform()`) against the local
-* surface up and north, in two named frames.
+* The `vessel.attitude` Topic payload: pitch, heading and roll of the vessel's
+* control reference (`Vessel.GetTransform()`) against the local surface up and
+* north, in two named frames.
 *
 * `VesselAttitude.pitch`, `VesselAttitude.heading` and `VesselAttitude.roll`
 * are the primary frame, with up and north measured at `Vessel.CoM` (MechJeb's
@@ -8339,6 +8443,7 @@ export interface VesselAttitude {
     meta: PayloadMeta;
 }
 /**
+* Switch SAS, RCS, landing gear, brakes, lights or the abort group on or off.
 * Args shared by every plain on/off actuation command (`setSas`, `setRcs`,
 * `setGear`, `setBrakes`, `setLights`, `setAbort`): an absolute state to
 * apply, never a toggle. Under light-time delay a toggle that arrives after
@@ -8352,7 +8457,8 @@ export interface SetEnabledArgs {
     enabled: boolean;
 }
 /**
-* `vessel.control.setSasMode`'s arguments: the SAS mode to hold.
+* Set the SAS mode to hold. `vessel.control.setSasMode`'s arguments: the SAS
+* mode to hold.
 *
 * @category Command arguments
 */
@@ -8361,7 +8467,8 @@ export interface SetSasModeArgs {
     mode: SasMode;
 }
 /**
-* `vessel.control.setThrottle`'s arguments: the main throttle setting.
+* Set the main throttle. `vessel.control.setThrottle`'s arguments: the main
+* throttle setting.
 *
 * @category Command arguments
 */
@@ -8391,9 +8498,9 @@ export interface SetActionGroupArgs {
     state: boolean;
 }
 /**
-* `vessel.maneuver.add`'s args: a new manoeuvre node's time and its delta-v as
-* named components in the node's own prograde, normal and radial-out frame,
-* the same shape as `ManeuverNode`.
+* Add a manoeuvre node. `vessel.maneuver.add`'s args: a new manoeuvre node's
+* time and its delta-v as named components in the node's own prograde, normal
+* and radial-out frame, the same shape as `ManeuverNode`.
 *
 * The result is a `CommandResult<string>` whose `Payload` is the new node's
 * opaque id, the same id `ManeuverNode.id` carries on `vessel.maneuver`. A
@@ -8444,7 +8551,8 @@ export interface UpdateManeuverNodeArgs {
     radialOut: number;
 }
 /**
-* `vessel.maneuver.remove`'s arguments: the manoeuvre node to delete.
+* Delete a manoeuvre node. `vessel.maneuver.remove`'s arguments: the manoeuvre
+* node to delete.
 *
 * @category Command arguments
 */
@@ -8453,8 +8561,8 @@ export interface RemoveManeuverNodeArgs {
     nodeId: string;
 }
 /**
-* `vessel.target.set`'s args: a discriminated union, written as
-* `SetTargetArgs.kind` plus the fields that kind uses.
+* Set the active vessel's target. `vessel.target.set`'s args: a discriminated
+* union, written as `SetTargetArgs.kind` plus the fields that kind uses.
 * `SetTargetArgs.vesselId` is the stable vessel id, never an array index, and
 * a vessel id and a body index travel in separate fields so they cannot be
 * confused.
@@ -8519,7 +8627,8 @@ export interface SetWarpIndexArgs {
     index: number;
 }
 /**
-* `time.setPaused`'s arguments: whether the game is paused.
+* Pause or resume the game. `time.setPaused`'s arguments: whether the game is
+* paused.
 *
 * @category Command arguments
 */
@@ -8565,7 +8674,7 @@ export declare enum ControlState {
     Unknown = 11
 }
 /**
-* The `vessel.comms` channel payload: the active vessel's own CommNet
+* The `vessel.comms` Topic payload: the active vessel's own CommNet
 * connection, from KSP's `vessel.connection`. The whole payload is null when
 * the vessel has no CommNet connection object; there is no zero or
 * disconnected placeholder reading.
@@ -8587,6 +8696,11 @@ export interface VesselComms {
     */
     signalStrength: Value<"ratio">;
     /**
+    * Which quantity `VesselComms.signalStrength` is, as the elected comms backend
+    * declares it: `SignalQuantity.Unknown` while no backend has answered.
+    */
+    signalQuantity: SignalQuantity;
+    /**
     * What is controlling the vessel and how much control it has, from
     * `vessel.connection.ControlState`.
     */
@@ -8662,7 +8776,7 @@ export interface ActionGroupState {
     state?: boolean | null;
 }
 /**
-* The `vessel.control` channel payload: the active vessel's control state (the
+* The `vessel.control` Topic payload: the active vessel's control state (the
 * stock toggles, SAS mode, throttle, the commanded fly-by-wire axes and the
 * custom action groups). The payload is present whenever there is an active
 * vessel; each field is individually nullable, and `null` means that input
@@ -8863,12 +8977,12 @@ export interface VesselCrew {
     meta: PayloadMeta;
 }
 /**
-* The `vessel.dock` channel payload: the relative position, velocity and
-* coarse orientation between the active vessel's nearest free (undocked)
-* docking port and the targeted docking port, for docking-alignment widgets.
-* The whole payload is absent when docking is not relevant right now: nothing
-* is targeted, the target is not a docking port, or the active vessel has no
-* free port. It is never an old or zero-distance placeholder record, the same
+* The `vessel.dock` Topic payload: the relative position, velocity and coarse
+* orientation between the active vessel's nearest free (undocked) docking port
+* and the targeted docking port, for docking-alignment widgets. The whole
+* payload is absent when docking is not relevant right now: nothing is
+* targeted, the target is not a docking port, or the active vessel has no free
+* port. It is never an old or zero-distance placeholder record, the same
 * convention as `VesselTarget`.
 *
 * `DockAlignment.forwardDot` is the dot product of the two ports' forward
@@ -9031,7 +9145,7 @@ export declare enum ManeuverFrame {
     Unknown = 1
 }
 /**
-* The `vessel.flight` channel payload: quantities the game measures, either
+* The `vessel.flight` Topic payload: quantities the game measures, either
 * because they cannot be derived from orbital elements (terrain height,
 * aerodynamic state) or because they are the measured value to check a
 * prediction against (speeds). One field per quantity.
@@ -9106,8 +9220,8 @@ export interface VesselFlight {
     meta: PayloadMeta;
 }
 /**
-* The `vessel.identity` channel payload: who the active vessel is, what kind
-* of craft it is, and where it is.
+* The `vessel.identity` Topic payload: who the active vessel is, what kind of
+* craft it is, and where it is.
 *
 * There is no mission time field. `VesselIdentity.launchUt` is fixed after
 * liftoff, so mission elapsed time is `viewUt - launchUt`, computed by the
@@ -9238,11 +9352,11 @@ export interface InventoryItem {
     packedVolume?: Value<"1"> | null;
 }
 /**
-* The `vessel.landing` channel payload: landing data for the active vessel
-* that needs KSP's PQS terrain heightmap (slope, roughness and elevation at
-* the touchdown site), plus an atmosphere-aware descent estimate built from
-* the vessel's measured drag. The vacuum ballistic figures (which need no
-* terrain) are not here; a client solves those itself.
+* The `vessel.landing` Topic payload: landing data for the active vessel that
+* needs KSP's PQS terrain heightmap (slope, roughness and elevation at the
+* touchdown site), plus an atmosphere-aware descent estimate built from the
+* vessel's measured drag. The vacuum ballistic figures (which need no terrain)
+* are not here; a client solves those itself.
 *
 * The whole payload is absent unless the vessel is descending toward a solid
 * surface: the body must have a solid surface and PQS terrain, and the vessel
@@ -9336,22 +9450,50 @@ export interface VesselLanding {
     */
     predictedBiome?: string | null;
     /**
-    * A flattened row-major NxN grid of terrain elevations in metres around the
-    * sampled point, for a shaded relief view; its length is
-    * `VesselLanding.terrainPatchSize` squared. Not currently produced, so always
-    * null.
+    * The distance in metres of each `VesselLanding.groundTrackElevations` sample
+    * along the predicted ground track, signed: 0 is the point on the ground
+    * beneath the vessel, positive is toward the predicted site and on past it,
+    * negative is behind the vessel. Ascending, the same length as
+    * `VesselLanding.groundTrackElevations`. The strip always holds the ground
+    * directly beneath the vessel, with at least one vessel height (and never less
+    * than 120 m) of ground behind it, and runs on to the far edge of the
+    * footprint of a cone of 60 degrees either side of the vessel's travel vector:
+    * where the cone's two edges, in the plane of the vessel's motion, meet the
+    * ground. A flat or climbing approach has an edge that never meets it, and
+    * that edge is cut at the horizon. The strip also reaches the predicted site
+    * and a tenth of its distance past it. The number of samples is fixed, so they
+    * are closer together the narrower the strip, which narrows as the vessel
+    * descends. Null when no track could be sampled.
     */
-    terrainPatch?: Value<"m">[] | null;
+    groundTrackDistances?: Value<"m">[] | null;
     /**
-    * The N of the NxN `VesselLanding.terrainPatch` grid. Null when there is no
-    * patch, which is currently always.
+    * Terrain elevation in metres at each `VesselLanding.groundTrackDistances`
+    * entry, from the body's terrain model (ocean floor reads negative). Null when
+    * no track could be sampled.
     */
-    terrainPatchSize?: Value<"count"> | null;
+    groundTrackElevations?: Value<"m">[] | null;
     /**
-    * The full width in metres the `VesselLanding.terrainPatch` grid spans. Null
-    * when there is no patch, which is currently always.
+    * A square of terrain elevations in metres around the predicted site, for a
+    * top-down view of it: `VesselLanding.siteHeightsSize` by
+    * `VesselLanding.siteHeightsSize` values row by row, the northern row first
+    * and the western column first in each row, so laying them out in that order
+    * puts north at the top. The grid is centred on the site and its width is
+    * `VesselLanding.siteHeightsExtentMeters`: wide enough to hold the ground
+    * between the vessel and the site, and about the vessel's height of it either
+    * side, so it narrows as the vessel descends and closes on the site, and it
+    * may be a second old. Null when no site could be sampled.
     */
-    terrainPatchExtentMeters?: Value<"m"> | null;
+    siteHeights?: Value<"m">[] | null;
+    /**
+    * The number of values along each side of `VesselLanding.siteHeights`. Null
+    * when there is no grid.
+    */
+    siteHeightsSize?: Value<"count"> | null;
+    /**
+    * The full width in metres that `VesselLanding.siteHeights` spans. Null when
+    * there is no grid.
+    */
+    siteHeightsExtentMeters?: Value<"m"> | null;
     /**
     * Terminal velocity in m/s at the current altitude and configuration, from the
     * measured aggregate drag force against local gravity. An estimate that
@@ -9393,6 +9535,32 @@ export interface VesselLanding {
     * outside an atmosphere.
     */
     parachuteState?: string | null;
+    /**
+    * How far the craft's parachutes have opened, taken from the one furthest
+    * along: `"none"` (the craft carries no parachute), `"stowed"` (packed, not
+    * yet staged), `"armed"` (staged and waiting for air thick enough to open in),
+    * `"semi-deployed"` (open as a streamer, slowing the craft a little),
+    * `"deployed"` (fully open) or `"cut"` (every one cut away). Unlike
+    * `VesselLanding.parachuteState` it tells semi-deployed from fully deployed,
+    * and a packed parachute from none. Null outside an atmosphere.
+    */
+    parachuteDeployment?: string | null;
+    /**
+    * Whether opening the parachutes not yet open would survive the current speed
+    * and air, as the game rates it from the heating a canopy would take:
+    * `"safe"`, `"risky"` (the canopy would heat but hold for a few seconds) or
+    * `"unsafe"` (it would burn through). The worst rating among the stowed and
+    * armed parachutes. Null outside an atmosphere, when every parachute is
+    * already open or cut, and for a parachute the game does not rate.
+    */
+    parachuteDeploySafety?: string | null;
+    /**
+    * The height above the ground or the sea at which an armed or semi-deployed
+    * parachute opens fully, the greatest when there are several, since that one
+    * opens first. Null when none is armed or semi-deployed, outside an
+    * atmosphere, and for a parachute the game does not report one for.
+    */
+    parachuteFullDeployAltitude?: Value<"m"> | null;
     /** The payload's provenance (`"vessel:<guid>"`). */
     meta: PayloadMeta;
 }
@@ -9511,7 +9679,7 @@ export interface ManeuverNode {
     patches: OrbitPatch[];
 }
 /**
-* The `vessel.maneuver` channel payload: the active vessel's planned burns.
+* The `vessel.maneuver` Topic payload: the active vessel's planned burns.
 * `VesselManeuver.nodes` is always an array, empty when no burn is queued,
 * never null.
 *
@@ -9548,7 +9716,7 @@ export interface VesselManeuver {
     meta: PayloadMeta;
 }
 /**
-* The `vessel.orbit` channel payload: the active vessel's orbital elements.
+* The `vessel.orbit` Topic payload: the active vessel's orbital elements.
 * Elements are the cause; every kinematic quantity (position, velocity,
 * apsides, anomalies, period) is derived by the consumer at its view UT
 * through the propagation capability, and is not streamed here. The one
@@ -9809,7 +9977,7 @@ export interface OrbitEncounter {
     bodyIndex?: number | null;
 }
 /**
-* The `vessel.orbit.truth` channel payload: KSP's own maintained state vector
+* The `vessel.orbit.truth` Topic payload: KSP's own maintained state vector
 * for the active vessel (`Orbit.pos` and `Orbit.vel`), relative to the body it
 * orbits. A development channel for checking element-to-position math against
 * KSP's own state, not a source of altitude or velocity for a widget: read
@@ -9852,7 +10020,7 @@ export interface VesselOrbitTruth {
     meta: PayloadMeta;
 }
 /**
-* The `vessel.parts` channel payload: the active vessel's full part tree, with
+* The `vessel.parts` Topic payload: the active vessel's full part tree, with
 * each part's position, mass, temperatures, resources, module states and
 * action-group bindings. A single object, or `null` when there is no active
 * vessel.
@@ -10192,10 +10360,9 @@ export interface VesselPhysicsMode {
     meta: PayloadMeta;
 }
 /**
-* The `vessel.propulsion` channel payload: the active vessel's mass and
-* thrust, the inputs to thrust-to-weight and burn-time figures. Mass is in
-* tonnes and thrust in kN, so `thrust / (mass · g)` is a thrust-to-weight
-* ratio directly.
+* The `vessel.propulsion` Topic payload: the active vessel's mass and thrust,
+* the inputs to thrust-to-weight and burn-time figures. Mass is in tonnes and
+* thrust in kN, so `thrust / (mass · g)` is a thrust-to-weight ratio directly.
 *
 * TWR, maximum TWR and a vessel-level burn-time estimate are derived by the
 * client from these fields, and are not streamed here.
@@ -10308,7 +10475,7 @@ export interface ResourceAmount {
     active: boolean;
 }
 /**
-* The `vessel.resources` channel payload: a keyframed map, keyed by resource
+* The `vessel.resources` Topic payload: a keyframed map, keyed by resource
 * name. No value is ever a sentinel such as `-1`.
 *
 * Only these stock resources are reported: `LiquidFuel`, `Oxidizer`,
@@ -10349,7 +10516,7 @@ export interface VesselResources {
     meta: PayloadMeta;
 }
 /**
-* The `vessel.structure` channel payload: the active vessel's stage and part
+* The `vessel.structure` Topic payload: the active vessel's stage and part
 * counts. Absent when there is no active vessel.
 *
 * `VesselStructure.currentStage` uses KSP's own staging numbering unchanged,
@@ -10378,9 +10545,9 @@ export interface VesselStructure {
     meta: PayloadMeta;
 }
 /**
-* The `vessel.surface` channel payload: surface data a landing widget needs
-* that `vessel.flight` doesn't already carry. `vessel.flight.AltitudeTerrain`
-* is the height of the vessel's root part above the terrain;
+* The `vessel.surface` Topic payload: surface data a landing widget needs that
+* `vessel.flight` doesn't already carry. `vessel.flight.AltitudeTerrain` is
+* the height of the vessel's root part above the terrain;
 * `VesselSurface.heightFromTerrain` is the height of the vessel's lowest
 * point, the number a landing-gear or suicide-burn readout cares about. The
 * two differ by how far the vessel reaches below its root.
@@ -10477,9 +10644,9 @@ export interface ClosestApproach {
     distance: Value<"m">;
 }
 /**
-* The `vessel.target` channel payload: the active vessel's current target
-* only. `VesselTarget.relativePosition`/`VesselTarget.relativeVelocity` both
-* use the one `Vec3` shape.
+* The `vessel.target` Topic payload: the active vessel's current target only.
+* `VesselTarget.relativePosition`/`VesselTarget.relativeVelocity` both use the
+* one `Vec3` shape.
 *
 * `VesselTarget.orbit` reuses `VesselOrbit` itself (not a separate "target
 * orbit" shape), so the SDK propagates a target with the same code path as the
@@ -10573,11 +10740,10 @@ export interface ThermalHottestPart {
     /** The part's current skin temperature, Kelvin (`Part.skinTemperature`). */
     skinTemp: Value<"K">;
     /**
-    * The part's maximum skin temperature, Kelvin (`Part.skinMaxTemp`), passed
-    * through raw: KSP reports `-1` for a part with no skin-thermal model, and
-    * that value arrives here unchanged.
+    * The part's maximum skin temperature, Kelvin (`Part.skinMaxTemp`); `null` for
+    * a part with no skin-thermal model, where KSP reports `-1`.
     */
-    skinMaxTemp: Value<"K">;
+    skinMaxTemp?: Value<"K"> | null;
     /**
     * Display name of the hottest part (`Part.partInfo.title`, falling back to
     * `Part.name`, same convention as `VesselPart.title`). Never null when
@@ -10593,9 +10759,9 @@ export interface ThermalHottestPart {
     id?: string | null;
 }
 /**
-* The `vessel.thermal` channel payload: the active vessel's thermal rollup,
-* its hottest part, heat shield and engine. Each ratio is null when no part
-* had a valid maximum temperature this tick, never 0, so "no valid part" and
+* The `vessel.thermal` Topic payload: the active vessel's thermal rollup, its
+* hottest part, heat shield and engine. Each ratio is null when no part had a
+* valid maximum temperature this tick, never 0, so "no valid part" and
 * "coldest possible part" stay distinct.
 *
 * The whole payload is null when the vessel has no parts at all, a different,
@@ -10678,12 +10844,12 @@ export declare enum WarpMode {
     Unknown = 2
 }
 /**
-* The `time.warp` channel payload: the game's time-warp and pause state, as
+* The `time.warp` Topic payload: the game's time-warp and pause state, as
 * separate typed fields.
 *
-* Current UT is not a field here (or anywhere in this contract):
-* `meta.validAt` stamps every sample, and the SDK's view clock is the "what
-* time is it" surface.
+* Current UT is not a field here, nor on any other Topic of the wire contract:
+* `meta.validAt` stamps every sample with the UT it describes, and a client
+* asks what time it is with the SDK's `useViewUt`.
 *
 * Warp and pause are game-wide state, so `WarpState.meta` is stamped `Source =
 * "game"`, not `"vessel:<guid>"`, and the channel emits at the Space Center
@@ -10740,13 +10906,13 @@ export interface WarpState {
     * seconds, or `null` where the host did not report its physics step.
     *
     * Equal to `WarpState.sampleIntervalUt` up to 10x warp. Above that the mod
-    * samples at most ten times a real second, so this is a tenth of a second of
-    * game time at the current rate (10,000 at 100,000x), or one physics tick
-    * where a tick advances the game further than that. Nothing between two
-    * consecutive samples was observed, so a line drawn between two samples that
-    * differ asserts a path across this span that only a model of the value can
-    * stand behind. Two samples further apart than this are a channel that did not
-    * change in between.
+    * samples at most ten times a real second, so this is the game time that
+    * passes in a tenth of a real second at the current rate (0.1 s x 100,000 =
+    * 10,000 s at 100,000x), or one physics tick where a tick advances the game
+    * further than that. Nothing between two consecutive samples was observed, so
+    * a line drawn between two samples that differ asserts a path across this span
+    * that only a model of the value can stand behind. Two samples further apart
+    * than this are a channel that did not change in between.
     *
     * It changes only when the warp rate does. A client judging a gap reads the
     * quantum in force when the later sample was taken.