@ksp-gonogo/sitrep-sdk 0.0.1 → 0.2.0-rc.12

package/dist/__generated__/error-codes.js

@@ -0,0 +1,688 @@
+//     This code was generated by the Sitrep contract error-code codegen
+//     (Sitrep.Contract.RtConfig.EmitErrorCodeMap, invoked from mod/codegen.sh).
+//     Changes to this file may cause incorrect behavior and will be lost if
+//     the code is regenerated.
+/**
+ * The root refusals: the closed set every client can switch on. Each says what
+ * kind of refusal it was, and so whether waiting, changing the craft, or doing
+ * something in the game is what makes a retry worthwhile.
+ *
+ * A producer that can say more names a refinement of one of these (see
+ * `RefusalCode.Refine`); the root still travels, so nothing a client does with
+ * a root depends on knowing the refinement.
+ *
+ * @category Error codes
+ */
+export const CommandErrorCode = {
+    /**
+     * There is no active vessel to act on.
+     */
+    NoVessel: "noVessel",
+    /**
+     * The requested mode or state is not available, and the game gave no more
+     * specific reason.
+     */
+    ModeUnavailable: "modeUnavailable",
+    /**
+     * An argument was out of its valid range.
+     */
+    Range: "range",
+    /**
+     * The referenced entity (a node id, a vessel or body target, a craft name) did
+     * not resolve.
+     */
+    NotFound: "notFound",
+    /**
+     * The maneuver plan is owned by a planner other than stock's
+     * `patchedConicSolver`, so a node written there would never be used.
+     *
+     * Refused rather than attempted: an n-body planner clears stock's node list
+     * every frame and writes its own guidance node into it, so a written node
+     * would show on the board and do nothing. The owning planner is on the wire as
+     * `VesselManeuver.Planner`.
+     */
+    PlanNotOwned: "planNotOwned",
+    /**
+     * A capacity is full: the Astronaut Complex holds its cap of active crew, a
+     * facility holds its cap of anything else countable.
+     *
+     * A retry succeeds only once something changes, such as freeing a slot.
+     *
+     * `CommandResult.breach` carries the numbers, so a client can say "16 of 16".
+     */
+    LimitReached: "limitReached",
+    /**
+     * Already at the top of an upgradeable scale, so there is nothing above this
+     * to move to. The Launch Pad at tier 3 of 3.
+     *
+     * Not `CommandErrorCode.LimitReached`: a cap that is full can be freed; a
+     * maximum tier cannot be exceeded by any action at all.
+     */
+    AlreadyAtMaximum: "alreadyAtMaximum",
+    /**
+     * The command costs more than the funds on hand.
+     *
+     * `CommandResult.breach` carries the cost as `Actual` against the balance as
+     * `Limit`, so the client can say how short and in the operator's own currency
+     * rendering.
+     */
+    InsufficientFunds: "insufficientFunds",
+    /**
+     * The command costs more science than is banked. Separate from
+     * `CommandErrorCode.InsufficientFunds`, as the game keeps science and funds
+     * separate currencies.
+     *
+     * Authority: `CurrencyModifierQuery.RunQuery(reason,
+     * ...).CanAfford(Currency.Science)`, which is what `RDTech.ResearchTech`
+     * checks, modifiers included.
+     */
+    InsufficientScience: "insufficientScience",
+    /**
+     * The save is not a career save, so this command's whole subsystem does not
+     * exist here.
+     *
+     * Authority: `HighLogic.CurrentGame.Mode`, and in practice the null `Instance`
+     * of the `ScenarioModule` that would have served it (`Funding`,
+     * `ContractSystem`, `StrategySystem`, `ResearchAndDevelopment`,
+     * `ScenarioUpgradeableFacilities`).
+     *
+     * A permanent property of the save, not a state that may change, so a client
+     * can hide the control rather than show it refused.
+     */
+    CareerModeRequired: "careerModeRequired",
+    /**
+     * The game is in a scene this command cannot run from.
+     *
+     * Authority: `HighLogic.LoadedScene` (`GameScenes`). `CommandResult.detail`
+     * names the scene when the producer had one.
+     */
+    WrongScene: "wrongScene",
+    /**
+     * The entity is not in a state this transition applies to: an already-active
+     * strategy asked to activate, an already-researched node asked to unlock, a
+     * contract asked to accept when it is not offered, an assigned kerbal asked to
+     * be sacked, a spent experiment asked to deploy.
+     *
+     * Authority: the entity's own state enum. `Strategies.Strategy.IsActive`,
+     * `RDTech.State`, `Contract.State`, `ProtoCrewMember.RosterStatus`,
+     * `ModuleScienceExperiment.Deployed`/`Inoperable`. Every one of those is
+     * `[Description]`-tagged or otherwise nameable, so `CommandResult.detail` can
+     * carry the state in the game's own words.
+     */
+    WrongState: "wrongState",
+    /**
+     * Right command, wrong moment: the flight is not in a state that permits it
+     * yet, and will be later.
+     *
+     * Authority: `FlightGlobals.ClearToSave()`, which returns one of five refusals
+     * (in atmosphere, under acceleration, moving over the surface, about to crash,
+     * on a ladder), plus `FlightDriver.CanRevertToPostInit`/`CanRevertToPrelaunch`
+     * and the `GameParameters` flags for leaving to the space center and to the
+     * tracking station. The game's reason is on `CommandResult.detail`.
+     *
+     * Also returned by the SCET alarm command for a vantage it cannot check
+     * because no command centre is known to the simulation yet: the main menu, and
+     * the ticks before the first capture. A vantage that is known and inactive is
+     * `CommandErrorCode.Range` instead, because that one does not resolve by
+     * waiting.
+     *
+     * Distinct from `CommandErrorCode.WrongState`, which is about the entity and
+     * does not resolve by waiting.
+     */
+    NotClearToProceed: "notClearToProceed",
+    /**
+     * The part or vessel does not have the capability this command needs: a rotor
+     * asked for a target angle, an unmotorised servo asked to drive, a part with
+     * no such action, an action present but inert, an autopilot mode this craft
+     * cannot hold.
+     *
+     * Authority: the part's own module list and fields
+     * (`ModuleRoboticServoRotor`/`Hinge`/`Piston`, `servoIsMotorized`,
+     * `BaseEvent.active`, `BaseEvent.EventIsDisabledByVariant`) and
+     * `VesselAutopilot.CanSetMode`.
+     *
+     * Nothing an operator waits for. The craft would have to be different for this
+     * to work, which is why it is not `CommandErrorCode.NotClearToProceed` and not
+     * `CommandErrorCode.WrongState`.
+     */
+    CapabilityMismatch: "capabilityMismatch",
+    /**
+     * There is no usable link for what this command needs to send.
+     *
+     * Authority: `ScienceUtil.GetBestTransmitter(Vessel)` and
+     * `IScienceDataTransmitter.CanTransmit()`: the vessel has no antenna that can
+     * carry the payload. This is not the comms-loss refusal that stops a command
+     * before it reaches the vessel.
+     */
+    NoConnection: "noConnection",
+    /**
+     * The capability exists in the game but this save has not unlocked it: fuel
+     * transfer, custom action groups, flight planning, EVA, the maneuver tool.
+     *
+     * Authority: `GameVariables.UnlockedFuelTransfer`,
+     * `UnlockedActionGroupsStock`/`Custom`, `UnlockedFlightPlanning`,
+     * `UnlockedEVA`/`Flags`/`Clamber`, `ManeuverToolAvailable`, each read at the
+     * owning facility's normalised level.
+     *
+     * Distinct from `CommandErrorCode.LimitReached`, which is a number against a
+     * number. This is a switch that is off, and the fix is an upgrade rather than
+     * freeing a slot.
+     */
+    NotUnlocked: "notUnlocked",
+    /**
+     * Another vessel is on the launch site.
+     *
+     * Authority: `PreFlightTests.LaunchSiteClear`, whose
+     * `GetWarningTitle()`/`GetWarningDescription()` are the game's own words for
+     * it and ride on `CommandResult.detail`.
+     */
+    SiteOccupied: "siteOccupied",
+    /**
+     * The facility this command needs is destroyed or damaged.
+     *
+     * Authority: `PreFlightTests.FacilityOperational`, over
+     * `PSystemSetup.Instance.GetSpaceCenterFacility(name).GetFacilityDamage()`.
+     */
+    FacilityDamaged: "facilityDamaged",
+    /**
+     * The command consumes a countable ITEM and there are not enough of them
+     * aboard.
+     *
+     * Authority: the provider's own charge, which it should also state wherever it
+     * shows the cost, so the cost shown and the cost taken agree. The item is the
+     * provider's to name: this code says only that there were too few, never which
+     * item.
+     *
+     * Separate from `CommandErrorCode.InsufficientFunds` and
+     * `CommandErrorCode.InsufficientScience`: a physical item cannot be bought.
+     *
+     * Not `CommandErrorCode.LimitReached`, which is a capacity that is full. This
+     * is a store that is empty.
+     */
+    InsufficientResource: "insufficientResource",
+    /**
+     * The provider was asked and could not read the state it needed. Nothing about
+     * the craft, the save or the moment was established, so the one fact this
+     * refusal carries is that the question went unresolved.
+     *
+     * Not `CommandErrorCode.CapabilityMismatch`, which is an established fact
+     * about the craft (a genuine omni antenna asked to aim). Not
+     * `CommandErrorCode.NotFound`, which says the craft carries nothing this
+     * command could act on. Not `CommandErrorCode.NotClearToProceed`, which
+     * resolves by waiting; this does not, and a retry is a second attempt at the
+     * same question.
+     *
+     * `CommandResult.detail` names what could not be read when the producer had a
+     * name for it, and never says what the result would have been. Nothing was
+     * learned about the vehicle, so offering the command again is the only sound
+     * next move.
+     */
+    Unreadable: "unreadable",
+    /**
+     * The command acts at a PLACE, and the command centre it was sent from has no
+     * authority there: a launch from a pad in another planet's system.
+     *
+     * Authority, never delay. The command itself is still instant; what this
+     * refuses is the sender, not the moment, so no amount of waiting makes it
+     * succeed. Sending from a centre in the place's own system does.
+     *
+     * `CommandResult.detail` names the centre and the place, and the system each
+     * is in, so an operator learns which seat to move to rather than seeing a
+     * control that simply does nothing.
+     *
+     * Distinct from `CommandErrorCode.NoConnection`, which is a link that cannot
+     * carry the command. A centre may be perfectly linked to the place and still
+     * have no authority over it.
+     */
+    OutOfReach: "outOfReach",
+};
+/**
+ * Why a command, or any other request, could not be carried: nothing about the
+ * game was decided. The refused/failed split is the kind of code, not a
+ * judgement a client makes: a `RefusalCode` says the game said no, this says
+ * the machinery did not get that far, and a retry may work.
+ *
+ * Closed, and declared only here. An Uplink never declares a fault: a handler
+ * that throws already becomes `FaultCode.CommandUnavailable`, and
+ * `CommandFaultException` is how a handler raises one of these deliberately.
+ *
+ * @category Error codes
+ */
+export const FaultCode = {
+    /**
+     * A frame of a known type that could not be read, including a
+     * `command-request` whose `args` do not fit the command. Only that call is
+     * refused; the command stays available.
+     */
+    InvalidEnvelope: "invalidEnvelope",
+    /**
+     * A frame whose `type` this build does not recognise.
+     */
+    UnknownEnvelopeType: "unknownEnvelopeType",
+    /**
+     * A frame that parsed as a type this build has nothing to do with.
+     */
+    UnhandledEnvelope: "unhandledEnvelope",
+    /**
+     * A binary frame sent up the socket, which nothing accepts.
+     */
+    BinaryFrameNotAccepted: "binaryFrameNotAccepted",
+    /**
+     * A command that is unknown or unavailable, or whose handler threw. A handler
+     * that threw leaves its command unavailable for the session.
+     */
+    CommandUnavailable: "commandUnavailable",
+    /**
+     * A command the host could not run in time: it was handed to the game's main
+     * thread and the game did not take it before the host stopped waiting, as
+     * during a scene load. Nothing was decided, and the command may still run
+     * later.
+     */
+    MainThreadTimeout: "mainThreadTimeout",
+    /**
+     * A command that ran and whose result could not be written.
+     */
+    ResultSerializationError: "resultSerializationError",
+    /**
+     * A subscription to a topic nothing declares.
+     */
+    UnknownTopic: "unknownTopic",
+    /**
+     * A topic whose payload could not be written.
+     */
+    PayloadSerializationError: "payloadSerializationError",
+    /**
+     * A `set-vantage`, or a command's `vantage`, naming a command centre that is
+     * not active.
+     */
+    UnknownVantage: "unknownVantage",
+    /**
+     * A held command reached its expiry, or its place on the lane passed, before
+     * it could run.
+     */
+    CommandExpired: "commandExpired",
+    /**
+     * A cancel stopped the command before it ran.
+     */
+    CommandCancelled: "commandCancelled",
+    /**
+     * A game load started a new timeline while the command was on its way, and the
+     * save it loaded does not carry the command, so it will not run. A quickload
+     * to before the command was sent is the common case. A command the loaded save
+     * does carry stays on its way and is answered as usual.
+     */
+    UndoneByLoad: "undoneByLoad",
+    /**
+     * A continuous input, a throttle or a control axis, was dropped at a node
+     * where it would have had to wait on its way to the craft. Held and sent on
+     * later it would arrive as a run of out-of-date values, so a node that cannot
+     * send it on at once drops it. It was accepted with a warning when it was
+     * sent, and this is the news of its loss, arriving when a report from that
+     * node could have reached the sending centre.
+     */
+    ContinuousInputWouldWait: "continuousInputWouldWait",
+    /**
+     * The transport held the command for a link that never came back, and has
+     * stopped retrying. It never left this machine.
+     */
+    Undelivered: "undelivered",
+    /**
+     * The client was shut down while the command waited for an answer.
+     */
+    Disposed: "disposed",
+    /**
+     * The transport's queue of commands waiting for a link is full, so this one
+     * was not queued.
+     */
+    SendQueueFull: "sendQueueFull",
+    /**
+     * A station's link to the main screen dropped while the command was on it.
+     */
+    PeerDisconnected: "peerDisconnected",
+    /**
+     * The main screen had no connection to the mod to relay a station's command
+     * over.
+     */
+    NoClient: "noClient",
+    /**
+     * A rejection that carried no code a client could read, such as a throw from
+     * inside a handler on the client.
+     */
+    Unclassified: "unclassified",
+};
+/**
+ * Every code declared here, with the sentence an operator reads for it.
+ *
+ * @category Error codes
+ */
+export const CORE_ERROR_CODES = [
+    {
+        id: "noVessel",
+        kind: "refusal",
+        refines: null,
+        origin: null,
+        sentence: "there is no vessel to act on",
+        meaning: "There is no active vessel to act on.",
+    },
+    {
+        id: "modeUnavailable",
+        kind: "refusal",
+        refines: null,
+        origin: null,
+        sentence: "the game would not say why",
+        meaning: "The requested mode or state is not available, and the game gave no more specific reason.",
+    },
+    {
+        id: "range",
+        kind: "refusal",
+        refines: null,
+        origin: null,
+        sentence: "an argument was outside its valid range",
+        meaning: "An argument was out of its valid range.",
+    },
+    {
+        id: "notFound",
+        kind: "refusal",
+        refines: null,
+        origin: null,
+        sentence: "nothing here answers to that",
+        meaning: "The referenced entity (a node id, a vessel or body target, a craft name) did not resolve.",
+    },
+    {
+        id: "planNotOwned",
+        kind: "refusal",
+        refines: null,
+        origin: null,
+        sentence: "another planner owns the flight plan",
+        meaning: "The maneuver plan is owned by a planner other than stock's `patchedConicSolver`, so a node written there would never be used.\n\nRefused rather than attempted: an n-body planner clears stock's node list every frame and writes its own guidance node into it, so a written node would show on the board and do nothing. The owning planner is on the wire as `VesselManeuver.Planner`.",
+    },
+    {
+        id: "limitReached",
+        kind: "refusal",
+        refines: null,
+        origin: null,
+        sentence: "a limit has been reached",
+        meaning: "A capacity is full: the Astronaut Complex holds its cap of active crew, a facility holds its cap of anything else countable.\n\nA retry succeeds only once something changes, such as freeing a slot.\n\n`CommandResult.breach` carries the numbers, so a client can say \"16 of 16\".",
+    },
+    {
+        id: "alreadyAtMaximum",
+        kind: "refusal",
+        refines: null,
+        origin: null,
+        sentence: "it is already at its maximum",
+        meaning: "Already at the top of an upgradeable scale, so there is nothing above this to move to. The Launch Pad at tier 3 of 3.\n\nNot `CommandErrorCode.LimitReached`: a cap that is full can be freed; a maximum tier cannot be exceeded by any action at all.",
+    },
+    {
+        id: "insufficientFunds",
+        kind: "refusal",
+        refines: null,
+        origin: null,
+        sentence: "there are not enough funds",
+        meaning: "The command costs more than the funds on hand.\n\n`CommandResult.breach` carries the cost as `Actual` against the balance as `Limit`, so the client can say how short and in the operator's own currency rendering.",
+    },
+    {
+        id: "insufficientScience",
+        kind: "refusal",
+        refines: null,
+        origin: null,
+        sentence: "there is not enough science",
+        meaning: "The command costs more science than is banked. Separate from `CommandErrorCode.InsufficientFunds`, as the game keeps science and funds separate currencies.\n\nAuthority: `CurrencyModifierQuery.RunQuery(reason, ...).CanAfford(Currency.Science)`, which is what `RDTech.ResearchTech` checks, modifiers included.",
+    },
+    {
+        id: "careerModeRequired",
+        kind: "refusal",
+        refines: null,
+        origin: null,
+        sentence: "this save is not a career game",
+        meaning: "The save is not a career save, so this command's whole subsystem does not exist here.\n\nAuthority: `HighLogic.CurrentGame.Mode`, and in practice the null `Instance` of the `ScenarioModule` that would have served it (`Funding`, `ContractSystem`, `StrategySystem`, `ResearchAndDevelopment`, `ScenarioUpgradeableFacilities`).\n\nA permanent property of the save, not a state that may change, so a client can hide the control rather than show it refused.",
+    },
+    {
+        id: "wrongScene",
+        kind: "refusal",
+        refines: null,
+        origin: null,
+        sentence: "the game is not in a scene that allows it",
+        meaning: "The game is in a scene this command cannot run from.\n\nAuthority: `HighLogic.LoadedScene` (`GameScenes`). `CommandResult.detail` names the scene when the producer had one.",
+    },
+    {
+        id: "wrongState",
+        kind: "refusal",
+        refines: null,
+        origin: null,
+        sentence: "it is not in a state that allows it",
+        meaning: "The entity is not in a state this transition applies to: an already-active strategy asked to activate, an already-researched node asked to unlock, a contract asked to accept when it is not offered, an assigned kerbal asked to be sacked, a spent experiment asked to deploy.\n\nAuthority: the entity's own state enum. `Strategies.Strategy.IsActive`, `RDTech.State`, `Contract.State`, `ProtoCrewMember.RosterStatus`, `ModuleScienceExperiment.Deployed`/`Inoperable`. Every one of those is `[Description]`-tagged or otherwise nameable, so `CommandResult.detail` can carry the state in the game's own words.",
+    },
+    {
+        id: "notClearToProceed",
+        kind: "refusal",
+        refines: null,
+        origin: null,
+        sentence: "the flight is not clear for it yet",
+        meaning: "Right command, wrong moment: the flight is not in a state that permits it yet, and will be later.\n\nAuthority: `FlightGlobals.ClearToSave()`, which returns one of five refusals (in atmosphere, under acceleration, moving over the surface, about to crash, on a ladder), plus `FlightDriver.CanRevertToPostInit`/`CanRevertToPrelaunch` and the `GameParameters` flags for leaving to the space center and to the tracking station. The game's reason is on `CommandResult.detail`.\n\nAlso returned by the SCET alarm command for a vantage it cannot check because no command centre is known to the simulation yet: the main menu, and the ticks before the first capture. A vantage that is known and inactive is `CommandErrorCode.Range` instead, because that one does not resolve by waiting.\n\nDistinct from `CommandErrorCode.WrongState`, which is about the entity and does not resolve by waiting.",
+    },
+    {
+        id: "capabilityMismatch",
+        kind: "refusal",
+        refines: null,
+        origin: null,
+        sentence: "this craft cannot do it",
+        meaning: "The part or vessel does not have the capability this command needs: a rotor asked for a target angle, an unmotorised servo asked to drive, a part with no such action, an action present but inert, an autopilot mode this craft cannot hold.\n\nAuthority: the part's own module list and fields (`ModuleRoboticServoRotor`/`Hinge`/`Piston`, `servoIsMotorized`, `BaseEvent.active`, `BaseEvent.EventIsDisabledByVariant`) and `VesselAutopilot.CanSetMode`.\n\nNothing an operator waits for. The craft would have to be different for this to work, which is why it is not `CommandErrorCode.NotClearToProceed` and not `CommandErrorCode.WrongState`.",
+    },
+    {
+        id: "noConnection",
+        kind: "refusal",
+        refines: null,
+        origin: null,
+        sentence: "there is no usable link",
+        meaning: "There is no usable link for what this command needs to send.\n\nAuthority: `ScienceUtil.GetBestTransmitter(Vessel)` and `IScienceDataTransmitter.CanTransmit()`: the vessel has no antenna that can carry the payload. This is not the comms-loss refusal that stops a command before it reaches the vessel.",
+    },
+    {
+        id: "notUnlocked",
+        kind: "refusal",
+        refines: null,
+        origin: null,
+        sentence: "it has not been unlocked yet",
+        meaning: "The capability exists in the game but this save has not unlocked it: fuel transfer, custom action groups, flight planning, EVA, the maneuver tool.\n\nAuthority: `GameVariables.UnlockedFuelTransfer`, `UnlockedActionGroupsStock`/`Custom`, `UnlockedFlightPlanning`, `UnlockedEVA`/`Flags`/`Clamber`, `ManeuverToolAvailable`, each read at the owning facility's normalised level.\n\nDistinct from `CommandErrorCode.LimitReached`, which is a number against a number. This is a switch that is off, and the fix is an upgrade rather than freeing a slot.",
+    },
+    {
+        id: "siteOccupied",
+        kind: "refusal",
+        refines: null,
+        origin: null,
+        sentence: "another vessel is on the launch site",
+        meaning: "Another vessel is on the launch site.\n\nAuthority: `PreFlightTests.LaunchSiteClear`, whose `GetWarningTitle()`/`GetWarningDescription()` are the game's own words for it and ride on `CommandResult.detail`.",
+    },
+    {
+        id: "facilityDamaged",
+        kind: "refusal",
+        refines: null,
+        origin: null,
+        sentence: "the building is out of action",
+        meaning: "The facility this command needs is destroyed or damaged.\n\nAuthority: `PreFlightTests.FacilityOperational`, over `PSystemSetup.Instance.GetSpaceCenterFacility(name).GetFacilityDamage()`.",
+    },
+    {
+        id: "insufficientResource",
+        kind: "refusal",
+        refines: null,
+        origin: null,
+        sentence: "there are not enough of what it uses aboard",
+        meaning: "The command consumes a countable ITEM and there are not enough of them aboard.\n\nAuthority: the provider's own charge, which it should also state wherever it shows the cost, so the cost shown and the cost taken agree. The item is the provider's to name: this code says only that there were too few, never which item.\n\nSeparate from `CommandErrorCode.InsufficientFunds` and `CommandErrorCode.InsufficientScience`: a physical item cannot be bought.\n\nNot `CommandErrorCode.LimitReached`, which is a capacity that is full. This is a store that is empty.",
+    },
+    {
+        id: "unreadable",
+        kind: "refusal",
+        refines: null,
+        origin: null,
+        sentence: "the game would not answer",
+        meaning: "The provider was asked and could not read the state it needed. Nothing about the craft, the save or the moment was established, so the one fact this refusal carries is that the question went unresolved.\n\nNot `CommandErrorCode.CapabilityMismatch`, which is an established fact about the craft (a genuine omni antenna asked to aim). Not `CommandErrorCode.NotFound`, which says the craft carries nothing this command could act on. Not `CommandErrorCode.NotClearToProceed`, which resolves by waiting; this does not, and a retry is a second attempt at the same question.\n\n`CommandResult.detail` names what could not be read when the producer had a name for it, and never says what the result would have been. Nothing was learned about the vehicle, so offering the command again is the only sound next move.",
+    },
+    {
+        id: "outOfReach",
+        kind: "refusal",
+        refines: null,
+        origin: null,
+        sentence: "this command centre has no authority over that place",
+        meaning: "The command acts at a PLACE, and the command centre it was sent from has no authority there: a launch from a pad in another planet's system.\n\nAuthority, never delay. The command itself is still instant; what this refuses is the sender, not the moment, so no amount of waiting makes it succeed. Sending from a centre in the place's own system does.\n\n`CommandResult.detail` names the centre and the place, and the system each is in, so an operator learns which seat to move to rather than seeing a control that simply does nothing.\n\nDistinct from `CommandErrorCode.NoConnection`, which is a link that cannot carry the command. A centre may be perfectly linked to the place and still have no authority over it.",
+    },
+    {
+        id: "invalidEnvelope",
+        kind: "fault",
+        refines: null,
+        origin: "mod",
+        sentence: "the request could not be read",
+        meaning: "A frame of a known type that could not be read, including a `command-request` whose `args` do not fit the command. Only that call is refused; the command stays available.",
+    },
+    {
+        id: "unknownEnvelopeType",
+        kind: "fault",
+        refines: null,
+        origin: "mod",
+        sentence: "the mod does not recognise that kind of request",
+        meaning: "A frame whose `type` this build does not recognise.",
+    },
+    {
+        id: "unhandledEnvelope",
+        kind: "fault",
+        refines: null,
+        origin: "mod",
+        sentence: "the mod has nothing to do with that request",
+        meaning: "A frame that parsed as a type this build has nothing to do with.",
+    },
+    {
+        id: "binaryFrameNotAccepted",
+        kind: "fault",
+        refines: null,
+        origin: "mod",
+        sentence: "the mod accepts no binary frames",
+        meaning: "A binary frame sent up the socket, which nothing accepts.",
+    },
+    {
+        id: "commandUnavailable",
+        kind: "fault",
+        refines: null,
+        origin: "mod",
+        sentence: "the command is not available",
+        meaning: "A command that is unknown or unavailable, or whose handler threw. A handler that threw leaves its command unavailable for the session.",
+    },
+    {
+        id: "mainThreadTimeout",
+        kind: "fault",
+        refines: null,
+        origin: "mod",
+        sentence: "the game did not get to it in time",
+        meaning: "A command the host could not run in time: it was handed to the game's main thread and the game did not take it before the host stopped waiting, as during a scene load. Nothing was decided, and the command may still run later.",
+    },
+    {
+        id: "resultSerializationError",
+        kind: "fault",
+        refines: null,
+        origin: "mod",
+        sentence: "its answer could not be sent",
+        meaning: "A command that ran and whose result could not be written.",
+    },
+    {
+        id: "unknownTopic",
+        kind: "fault",
+        refines: null,
+        origin: "mod",
+        sentence: "nothing publishes that",
+        meaning: "A subscription to a topic nothing declares.",
+    },
+    {
+        id: "payloadSerializationError",
+        kind: "fault",
+        refines: null,
+        origin: "mod",
+        sentence: "its value could not be sent",
+        meaning: "A topic whose payload could not be written.",
+    },
+    {
+        id: "unknownVantage",
+        kind: "fault",
+        refines: null,
+        origin: "mod",
+        sentence: "that command centre is not active",
+        meaning: "A `set-vantage`, or a command's `vantage`, naming a command centre that is not active.",
+    },
+    {
+        id: "commandExpired",
+        kind: "fault",
+        refines: null,
+        origin: "mod",
+        sentence: "it expired before it could run",
+        meaning: "A held command reached its expiry, or its place on the lane passed, before it could run.",
+    },
+    {
+        id: "commandCancelled",
+        kind: "fault",
+        refines: null,
+        origin: "mod",
+        sentence: "it was cancelled before it ran",
+        meaning: "A cancel stopped the command before it ran.",
+    },
+    {
+        id: "undoneByLoad",
+        kind: "fault",
+        refines: null,
+        origin: "mod",
+        sentence: "a game load undid it before it ran",
+        meaning: "A game load started a new timeline while the command was on its way, and the save it loaded does not carry the command, so it will not run. A quickload to before the command was sent is the common case. A command the loaded save does carry stays on its way and is answered as usual.",
+    },
+    {
+        id: "continuousInputWouldWait",
+        kind: "fault",
+        refines: null,
+        origin: "mod",
+        sentence: "it would wait on its way, and a continuous input cannot",
+        meaning: "A continuous input, a throttle or a control axis, was dropped at a node where it would have had to wait on its way to the craft. Held and sent on later it would arrive as a run of out-of-date values, so a node that cannot send it on at once drops it. It was accepted with a warning when it was sent, and this is the news of its loss, arriving when a report from that node could have reached the sending centre.",
+    },
+    {
+        id: "undelivered",
+        kind: "fault",
+        refines: null,
+        origin: "client",
+        sentence: "it was never sent",
+        meaning: "The transport held the command for a link that never came back, and has stopped retrying. It never left this machine.",
+    },
+    {
+        id: "disposed",
+        kind: "fault",
+        refines: null,
+        origin: "client",
+        sentence: "the connection closed before an answer came",
+        meaning: "The client was shut down while the command waited for an answer.",
+    },
+    {
+        id: "sendQueueFull",
+        kind: "fault",
+        refines: null,
+        origin: "client",
+        sentence: "too many commands are waiting for the link",
+        meaning: "The transport's queue of commands waiting for a link is full, so this one was not queued.",
+    },
+    {
+        id: "peerDisconnected",
+        kind: "fault",
+        refines: null,
+        origin: "client",
+        sentence: "the link to the main screen dropped",
+        meaning: "A station's link to the main screen dropped while the command was on it.",
+    },
+    {
+        id: "noClient",
+        kind: "fault",
+        refines: null,
+        origin: "client",
+        sentence: "the main screen is not connected to the game",
+        meaning: "The main screen had no connection to the mod to relay a station's command over.",
+    },
+    {
+        id: "unclassified",
+        kind: "fault",
+        refines: null,
+        origin: "client",
+        sentence: "something went wrong",
+        meaning: "A rejection that carried no code a client could read, such as a throw from inside a handler on the client.",
+    },
+];
+//# sourceMappingURL=error-codes.js.map